Tester l’implémentation de l’Audience Network

Lorsque vous intégrez l’Audience Network de Facebook à votre application ou à votre site web mobile, vous devez tester votre implémentation sur de vrais appareils avec des publicités de production avant le lancement. Utilisez les derniers SDK Audience Network dans votre intégration afin d’inclure les corrections de bug et les améliorations les plus récentes. Les sections suivantes vous montrent, étape par étape, comment tester l’intégration de publicités de l’Audience Network avec votre application ou votre site web mobile.

Étape 1 : effectuer un test avec des publicités de production

Étape 2 : vérifier les codes d’erreur des demandes de publicités de production

Étape 3 : utiliser le programme de débug des demandes Audience Network pour diagnostiquer les demandes de publicités

Étape 4 : effectuer un test avec des publicités test

Étape 5 : vérifier les éléments nécessaires à l’intégration de publicités de l’Audience Network

Étape 1 : effectuer un test avec des publicités de production

Les tests réalisés avec des publicités de production comportent deux étapes. La première étape consiste à ajouter des personnes à la page des paramètres de votre entreprise pour leur permettre de voir des publicités de production avant que l’app ne soit approuvée. La deuxième étape implique que les testeurs désignés utilisent votre app ou votre site web mobile en étant connectés à Facebook.

Ajouter des testeurs à votre app

Vous pouvez tester votre app ou votre site web mobile sur de vrais appareils avec des publicités de production en vous assurant qu’un rôle a été attribué au testeur dans votre app Facebook. Ceci est la méthode recommandée pour ajouter des testeurs à votre app :

  1. Accédez aux paramètres de votre entreprise.
  2. Cliquez sur +Ajouter dans l’onglet Personnes sur la gauche.
  3. Saisissez l’adresse e-mail de la personne que vous souhaitez ajouter à votre compte dans Business Manager. Vous pouvez entrer plusieurs personnes dans cet espace.
  4. Vous pouvez ensuite leur attribuer des rôles si vous le souhaitez ou cliquer sur Ignorer pour les ajouter uniquement à votre compte Business Manager.

Si vous utilisez une couche de médiation, assurez-vous que celle-ci envoie des demandes à l’Audience Network. Si vous avez activé les tests sur la couche de médiation, il se peut qu’elle n’envoie aucune demande à nos serveurs.

Tester les apps mobiles

  1. Diffusez l’application sur l’appareil de vos testeurs à l’aide de votre méthode de diffusion préférée et vérifiez que vos testeurs ont été ajoutés sur la page des paramètres de votre compte Business Manager.
  2. Chacune des personnes que vous avez ajoutées doit avoir installé l’application Facebook sur son appareil et s’y connecter à l’aide de l’ID utilisateur Facebook que vous avez ajouté au rôle Testeurs. Cette opération est nécessaire, car Facebook doit reconnaître l’utilisateur en tant que personne associée à votre entreprise afin de renvoyer une publicité.
  3. Le testeur peut maintenant lancer votre application et déclencher les placements que vous souhaitez tester. Il devrait voir une publicité de production.

Lorsque vous testez vos placements publicitaires, Facebook envoie intentionnellement une réponse sans remplissage pour environ 20 % des demandes afin que vous puissiez tester la manière dont votre app ou votre site web mobile gère ces cas.

Si vous utilisez Testflight pour distribuer et tester votre application, vous ne pourrez pas voir de vraies publicités dans ces versions test. À la place, vous devrez régler le mode test tel qu’indiqué ci-dessous afin d’obtenir des publicités de l’Audience Network. À chaque fois qu’une application distribuée par Testflight demandera l’identifiant publicitaire des annonceurs (IDFA), elle obtiendra un IDFA différent. D’habitude, l’IDFA reste le même pour un appareil jusqu’à ce que l’utilisateur le réinitialise manuellement. Mais lorsqu’une version Testflight demande l’IDFA du système d’exploitation, elle n’obtient pas le véritable IDFA. À la place, elle obtient un IDFA factice qui change à chaque fois que l’application le demande.

Pour résoudre ce problème, vous pouvez activer le mode test pour que la publicité test s’affiche.



Étape 2 : vérifier les codes d’erreur des demandes de publicités de production

Lorsque vous testez votre implémentation de l’Audience Network de Facebook, il est possible que vous rencontriez un ou plusieurs codes d’erreur au moment d’introduire une demande. Ces codes d’erreur sont décrits ci-dessous.

1000 - Network Error

Réponse du serveur Documentation SDK

Code=1000 “Network Error"

  • Error 1000 - Network Error. Le SDK Audience Network n’a pas pu atteindre facebook.com (http://facebook.com/)
  • Votre application doit tenter de lancer une autre demande jusqu’à ce qu’elle puisse atteindre le réseau. Nous vous recommandons d’introduire des demandes incrémentielles jusqu’à ce qu’une connexion soit rétablie ou que vous indiquiez un délai d’expiration.

1001 - No Fill

Il s’agit d’une erreur courante observée lors des tests, qui correspond à une réponse « Aucun remplissage ». La cause la plus courante est que l’utilisateur n’est pas connecté à l’app Facebook lorsqu’il teste votre app mobile ou qu’il n’est pas connecté au site web mobile Facebook lorsqu’il teste votre site web mobile.

Réponse du serveur Documentation SDK

Code=1001 “No Fill”

  • Error 1001 - No Fill. Peut être due à une ou plusieurs conditions parmi les suivantes :
  • L’utilisateur n’est pas connecté à l’app native Facebook sur l’appareil mobile
  • Option Limiter le suivi publicitaire activée (iOS)
  • Option Désactiver les publicités basées sur les intérêts activée (Android)
  • Aucun inventaire publicitaire pour l’utilisateur actuel
  • L’application native Facebook doit être installée sur votre appareil de test.
  • Votre application doit tenter d’effectuer une autre demande après 30 secondes.

1002 - Ad Load Too Frequently

Réponse du serveur Documentation SDK

Code=1002 “Load Too Frequently”

  • Les requêtes publicitaires reposent sur une combinaison des éléments suivants :
  • ID d’appareil
  • ID de placement
  • Format d’affichage (bannière, publicité interstitielle, publicité native)
  • Votre application doit tenter de lancer une autre demande après 30 minutes. Nous vous conseillons également d’ajuster votre fréquence d’actualisation ou votre taux de requêtes.

1011 - Display Format Mismatch

Réponse du serveur Documentation SDK

Code=1011 “Display Format Mismatch”

  • Error 1011 - Display Format Mismatch pour les raisons suivantes :
  • Le format d’affichage contenu dans la requête publicitaire ne correspond pas à celui indiqué pour ce placement.
  • Chaque placement ne peut être utilisé qu’avec un seul format d’affichage.
  • Vous pouvez créer plusieurs placements afin d’utiliser différents formats d’affichage.

1203 - Not An App Admin, Developer or Tester

Réponse du serveur Documentation SDK

Code=1203 “Not An App Admin, Developer or Tester”

  • La demande initiale d’un pack doit provenir d’un administrateur d’application, d’un développeur ou d’un testeur.

2000 - Server Error

Réponse du serveur Documentation SDK

Code=2000 “Server Error"

  • Error 2000 - Server Error. Peut être due aux conditions suivantes :
  • ID de placement invalide ; chaque placement et type possède un ID unique
  • Version du SDK non prise en charge ou obsolète ; veuillez télécharger la dernière version ou mettre à jour votre Pod si vous utilisez CocoaPods
  • Appel/usage incorrect de la méthode loadAd. Nous vous suggérerons de placer des points d’arrêt sur loadAd et toutes les méthodes ou tous les renvois associés
  • Votre application doit tenter d’effectuer une autre demande après 30 secondes.

2001 - Internal Error

Réponse du serveur Documentation SDK

Code=2001 “Internal Error”

  • Error 2001 - Internal Error. Le SDK Audience Network n’a pas pu traiter une réponse depuis facebook.com
  • Votre application doit tenter d’effectuer une autre demande après 30 secondes.
  • Si ce problème se reproduit systématiquement, veuillez remplir un rapport de bug et nous le faire parvenir.


Étape 3 : utiliser le programme de débug des demandes Audience Network pour diagnostiquer les demandes de publicités

Après avoir implémenté les placements dans votre app, vous pouvez utiliser l’outil de débogage des demandes Audience Network pour vérifier que Facebook reçoit les demandes de votre app.

  1. Accédez au Gestionnaire de monétisation.
  2. Cliquez sur Gérer la propriété.
  3. Cliquez sur Paramètres de la propriété > Débug des requêtes en haut à droite.
  4. Cliquez sur Commencer pour suivre les requêtes depuis votre application ou votre site web.

Sur votre appareil de test iOS ou Android, parcourez l’application pour déclencher les placements publicitaires de l’Audience Network. Les demandes publicitaires apparaîtront dans l’outil. Assurez-vous que les demandes sont envoyées avec les informations adéquates (ID de placement, nom de pack, etc.).

Cette opération nécessite l’utilisation d’un appareil physique et ne fonctionnera pas avec le simulateur iOS ou l’émulateur Android.

Vous devez être connecté(e) à l’app Facebook à partir du même appareil de test que vous utilisez afin que l’outil puisse contrôler les demandes.

Si les demandes publicitaires n’apparaissent pas dans l’outil, cela signifie que Facebook ne reçoit pas les demandes comme prévu. Suivez les étapes suivantes pour tenter de résoudre le problème :

  1. Assurez-vous que vous utilisez un appareil physique, pas le simulateur/émulateur.
  2. Assurez-vous que l’app Facebook est installée sur votre appareil de test.
  3. Vérifiez que le testeur est connecté à Facebook sur son appareil de test et possède un rôle dans votre entreprise.
  4. Si vous utilisez la médiation, vérifiez que la couche de médiation envoie les demandes à l’Audience Network de Facebook.


Étape 4 : Effectuer un test avec des publicités test

Vous devez vous assurer qu’un rôle a été attribué au testeur de votre application dans le compte Business Manager de votre application. Cette méthode de test est recommandée, car elle vous permet de voir des publicités de production sur de vrais appareils. Pour en savoir plus sur la méthode de test recommandée, consultez la section Effectuer un test avec des publicités de production.

Cependant, comme mentionné dans la section précédente, vous vous êtes sans doute rendu compte qu’il n’est pas toujours possible de tester l’interface des publicités de production à l’aide de l’interface de votre app. De plus, vous ne pouvez être sûr que la publicité reçue par votre app sera une publicité image, une publicité vidéo ou une publicité carrousel. La demande de publicités de production ne garantira pas le contenu ni le format de la publicité renvoyée. Et si vous souhaitez effectuer un test avec une publicité qui comprend une vidéo en mode portrait pour vous assurer qu’elle apparaît correctement sur l’interface de votre app ?

Pour demander une publicité test, vous utiliserez la chaîne de type de publicité test suivante pour concaténer l’ID de placement avec '#' lors de l’initialisation de tout objet publicitaire Facebook. Le modèle d’ID de placement pour demander des publicités test est TEST_AD_TYPE#YOUR_PLACEMENT_ID.

Vous ne devez jamais expédier votre app au grand public avec le code de test ci-dessus, car il n’affichera que les publicités test. Vous devez plutôt utiliser une macro de préprocesseur telle que DEBUG ou TESTING, puis utiliser #ifdef pour différencier une version test d’une version de lancement.

Tableau des types de publicités test

Type de publicité test Description Format publicitaire pris en charge

VID_HD_16_9_46S_APP_INSTALL

Publicité vidéo HD d’une durée de 46 secondes au format 16 x 9 avec option d’appel à l’action pour l’installation d’application.

Publicité interstitielle, vidéo avec récompense, publicité native

VID_HD_16_9_46S_LINK

Publicité vidéo HD d’une durée de 46 secondes au format 16 x 9 avec l’option appel à l’action avec lien.

Publicité interstitielle, vidéo avec récompense, publicité native

VID_HD_16_9_15S_APP_INSTALL

Publicité vidéo HD d’une durée de 15 secondes au format 16 x 9 avec option d’appel à l’action pour l’installation d’application.

Publicité interstitielle, vidéo avec récompense, publicité native

VID_HD_16_9_15S_LINK

Publicité vidéo HD d’une durée de 15 secondes au format 16 x 9 avec l’option appel à l’action avec lien.

Publicité interstitielle, vidéo avec récompense, publicité native

VID_HD_9_16_39S_APP_INSTALL

Publicité vidéo HD d’une durée de 39 secondes au format 9 x 16 avec option d’appel à l’action pour l’installation d’application.

Publicité interstitielle, vidéo avec récompense, publicité native

VID_HD_9_16_39S_LINK

Publicité vidéo HD d’une durée de 39 secondes au format 9 x 16 avec l’option appel à l’action avec lien.

Publicité interstitielle, vidéo avec récompense, publicité native

IMG_16_9_APP_INSTALL

Publicité image au format 16 x 9 avec option d’appel à l’action pour l’installation d’application.

Bannière, publicité interstitielle, publicité native

IMG_16_9_LINK

Publicité image au format 16 x 9 avec option d’appel à l’action avec lien.

Bannière, publicité interstitielle, publicité native

CAROUSEL_IMG_SQUARE_APP_INSTALL

publicité carrousel avec image carrée et option d’appel à l’action pour l’installation d’application

Publicité interstitielle, publicité native

CAROUSEL_IMG_SQUARE_LINK

publicité carrousel avec image carrée et option d’appel à l’action avec lien

Publicité interstitielle, publicité native

Lorsque vous testez vos placements publicitaires avec un type de publicité test, faites attention au format publicitaire pris en charge. Par exemple, si vous créez une instance de vidéo avec récompense pour demander une publicité avec le type de publicité test IMG_16_9_APP_INSTALL, vous obtiendrez une erreur d’affichage.

Exemple pour demander des publicités test dans le code sur les appareils iOS

Par exemple, pour demander une publicité test vidéo au format 9:16 avec un bouton d’appel à l’action Installer l’application dans votre app iOS, vous devez initialiser un objet FBNativeAd en ajoutant la ligne de code suivante :

[FBNativeAd *nativeAd = [[FBNativeAd alloc] initWithPlacementID:@"VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID"];

Vous pouvez exécuter le code ci-dessus pour demander une publicité test dans le projet NativeAdSample, disponible dans le dossier d’exemples du SDK Audience Network.

Si vous devez demander des publicités test avec un format de contenu aléatoire, vous verrez un message comme celui-ci affiché dans le logcat lors du test sur un véritable appareil Android :

#ifdef DEBUG
[FBAdSettings setLogLevel:FBAdLogLevelLog];
[FBAdSettings addTestDevice:@"HASHED_ID"];
#endif

Vous verrez ensuite le message de journal suivant :

[FBAudienceNetworkLog/FBAdSettings:94] 
When testing your app with Facebook ad units,  
you must specify the device hashed ID to ensure the delivery of test ads, 
add the following code before loading an ad: `[FBAdSettings addTestDevice:@"HASHED_ID"]`
Test mode device hash: bd675f960298a92003630d76fa612b1706b745ab

Remplacez HASHED_ID par le hachage de l’appareil en mode Test indiqué dans le journal ci-dessus.

Après avoir effectué les tests, vous devez effacer les paramètres de l’appareil de test en utilisant la ligne de code suivante :

[FBAdSettings clearTestDevice:[FBAdSettings testDeviceHash]]; 

Exemple pour demander des publicités test dans le code sur les appareils Android

Pour demander une publicité test vidéo au format 9:16 avec un bouton d’appel à l’action Installer l’application dans votre app Android, vous devez initialiser un objet NativeAd en ajoutant la ligne de code suivante :

nativeAd = new NativeAd(this, "VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID");

Si vous devez demander des publicités test avec un format de contenu aléatoire, vous verrez un message comme celui-ci affiché dans le logcat lors du test sur un véritable appareil Android :

Journal : Hachage de l’appareil en mode test : HASHED_ID Journal : Lorsque vous testez votre app avec des unités publicitaires Facebook, vous devez indiquer l’ID haché de l’appareil pour garantir la diffusion des publicités test et ajouter le code suivant avant de charger une publicité : AdSettings.addTestDevice("HASHED ID");

Vous pouvez activer les publicités test sur un appareil en ajoutant la ligne de code suivante avant de charger une publicité :

AdSettings.addTestDevice("HASHED ID");

Si vous souhaitez ajouter plusieurs appareils test, il vous suffit de créer une liste de chaînes à ajouter avant de charger une publicité :

List<String> testDevices = new ArrayList<>();
testDevices.add("HASHED_ID_1");
testDevices.add("HASHED_ID_2");
AdSettings.addTestDevices(testDevices);

Après avoir effectué les tests, vous devez effacer les paramètres de l’appareil de test en utilisant la ligne de code suivante :

AdSettings.clearTestDevices();

Exemple pour demander des publicités test dans le tableau de bord de médiation

Outre la possibilité de demander la publicité test à partir du code, vous pouvez configurer la valeur de l’ID de placement avec le type de publicité test depuis votre tableau de bord de médiation si votre app utilise la médiation. Si, par exemple, votre application utilise MoPub, vous pouvez modifier le réseau Facebook et définir sur VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID la valeur de l’ID de placement pour la publicité native. Votre app recevra une publicité test vidéo au format 9:16 avec un bouton d’appel à l’action Installer l’application.



Étape 5 : vérifier les éléments nécessaires à l’intégration de publicités de l’Audience Network

  1. Installez l’app Facebook sur votre appareil de test et connectez-vous.
  2. Ajoutez les personnes qui testent vos publicités de l’Audience Network à votre compte Business Manager.
  3. Assurez-vous d’initialiser l’instance publicitaire avec l’ID de placement créé depuis votre compte Business Manager. Consultez l’étape de démarrage.
  4. Vérifiez si les publicités de production de l’Audience Network ont bien été demandées par votre app. Utilisez les codes d’erreur de l’Audience Network et le programme de débug des demandes Audience Network pour le diagnostic.
  5. Vérifiez si les utilisateurs de votre app voient et comprennent parfaitement les publicités.
  6. Vérifiez l’expérience utilisateur de votre intégration des publicités en utilisant des publicités test. Assurez-vous que l’extrait de code de la publicité test est supprimé avant le lancement dans la boutique d’applications. Sinon, votre app de production ne montrera que des publicités test.