Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces de Meta Audience Network à l'aide de Médiation, qui couvre les enchères de Google Cloud. Il explique comment ajouter Meta Audience Network configuration de la médiation, et comment intégrer les API Meta Audience Network et l'adaptateur dans une Unity application.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation AdMob pour Meta Audience Le réseau offre les capacités suivantes:
Intégration | |
---|---|
Enchères | |
Cascade 1. | |
Formats | |
Bannière | |
Interstitiel | |
Avec récompense | |
Interstitiel avec récompense |
1 Meta Audience Network devient Enchères uniquement en 2021.
Conditions requises
- Le dernier SDK Google Mobile Ads
- Unity 5.6 ou version ultérieure
- Plug-in de médiation Google Mobile Ads pour Meta Audience Network 2.11.0 (dernière version recommandée)
- Pour déployer sur Android
<ph type="x-smartling-placeholder">
- </ph>
- Niveau d'API Android 21 ou supérieur
- À déployer sur iOS
<ph type="x-smartling-placeholder">
- </ph>
- Cible de déploiement iOS 10.0 ou version ultérieure
- Le dernier SDK Meta Audience Network nécessite généralement de Xcode.
- Un projet Unity fonctionnel, configuré avec SDK Google Mobile Ads. Voir Commencer pour en savoir plus.
- Suivez le Guide de démarrage pour la médiation.
Étape 1: Définissez des configurations dans l'interface utilisateur de Meta Audience Network
Étape 2: Configurez la demande Meta Audience Network dans AdMob l'UI
Configurer les paramètres de médiation pour votre bloc d'annonces
Android
Pour obtenir des instructions, consultez l'étape 2 du guide pour Android.
iOS
Pour obtenir des instructions, reportez-vous à l'étape 2 du guide pour iOS.
Ajouter Facebook à la liste des partenaires publicitaires concernant le RGPD et les réglementations des États américains
Étape 3: Importez l'adaptateur et le SDK Meta Audience Network
OpenUPM-CLI
Si vous disposez d'OpenUPM-CLI vous pouvez installer Google Mobile Ads Meta Audience Network le plug-in de médiation pour Unity à votre projet en exécutant la commande suivante : depuis le répertoire racine de votre projet:
openupm add com.google.ads.mobile.mediation.metaaudiencenetwork
OpenUPM
Dans votre éditeur de projet Unity, sélectionnez Edit (Modifier) > Paramètres du projet > Gestionnaire de paquets pour ouvrir le Paramètres du gestionnaire de paquets Unity.
Dans l'onglet Registres cloisonnés, ajoutez OpenUPM en tant que registre limité avec les informations suivantes:
- Nom :
OpenUPM
- URL :
https://package.openupm.com
- Champs d'application :
com.google
Accédez ensuite à Fenêtre > Gestionnaire de paquets pour ouvrir le Gestionnaire de packages Unity et sélectionnez Mes registres dans le menu déroulant.
Sélectionnez le package Google Mobile Ads Meta Audience Network Mediation, puis cliquez sur Installer.
Package Unity
Téléchargez la dernière version du plug-in de médiation Google Mobile Ads pour
Meta Audience Network à partir du lien de téléchargement dans
la
Journal des modifications
et extraire la
GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
provenant du code postal
.
Dans votre éditeur de projet Unity, sélectionnez Assets > Import Package (Importer un package) >
Package personnalisé, puis recherchez
GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
que vous avez téléchargé. Vérifiez que tous les fichiers sont sélectionnés, puis cliquez sur
Importer :
Ensuite, sélectionnez Assets > Résolveur des services Play >
Résolveur Android > Forcer la résolution. Le résolveur des services Unity Play
effectuera la résolution des dépendances à partir de zéro et copiera
les dépendances déclarées dans le répertoire Assets/Plugins/Android
de votre
Application Unity.
Étape 4: Implémenter les paramètres de confidentialité dans le SDK Meta Audience Network
Consentement de l'UE et RGPD
Conformément à l'accord de l'utilisateur dans l'UE de Google de confidentialité, vous devez vous assurer que certaines divulgations sont divulguées à et le consentement obtenu auprès des utilisateurs de l'Espace économique européen (EEE) concernant l'utilisation d'identifiants d'appareil et de données à caractère personnel. Ces règles tiennent compte exigences de la directive vie privée et communications électroniques de l'UE, et de la protection générale des données Règlement général sur la protection des données (RGPD). Lorsque vous demandez le consentement, vous devez identifier chaque réseau publicitaire de votre chaîne de médiation qui peut collecter, recevoir ou utiliser des données à caractère personnel et fournissent des informations sur l'utilisation de chaque réseau. Google n'est actuellement pas en mesure de transmettre automatiquement le choix de consentement de l'utilisateur à ces réseaux.
Consultez les conseils de Meta pour en savoir plus sur RGPD et publicité Meta.
Lois sur la confidentialité dans les États américains
États-Unis lois sur la confidentialité dans les États n'ont pas besoin de donner aux utilisateurs pour désactiver la "promotion" de leurs « informations personnelles » (selon la définition de la loi ces conditions d'utilisation), avec la possibilité de désactiver cette fonctionnalité via la page "Do Not Sell My Personal Informations" sur le lien "vente" la page d'accueil du tiers. La États-Unis confidentialité des états de conformité avec la législation en vigueur vous permet d'activer traitement restreint des données pour la diffusion d'annonces Google, mais Google ne peut pas appliquer ce paramètre à chaque annonce dans votre chaîne de médiation. Vous devez donc identifier chaque réseau publicitaire de votre chaîne de médiation susceptibles de participer à la vente de les informations et de suivre les directives de chacun de ces réseaux pour vous assurer de conformité.
Pour les utilisateurs situés en Californie, consultez la section Traitement des données de Meta options.
Étape 5: Ajoutez le code requis
Android
Aucun code supplémentaire n'est requis pour l'intégration de Meta Audience Network.
iOS
Intégration SKAdNetwork
Consultez la documentation de Meta Audience Network.
pour ajouter les identifiants SKAdNetwork au fichier Info.plist
de votre projet.
Suivi de la publicité activé
Si vous développez pour iOS 14 ou une version ultérieure, consultez des instructions pour configurer leur suivi publicitaire Indicateur.
Étape 6: Testez votre implémentation
Activer les annonces tests
Veillez à enregistrer votre appareil de test pour AdMob et à activer le mode test dans l' Meta Audience Network UI.
Valider les annonces tests
Pour vérifier que vous recevez des annonces tests deMeta Audience Network, activez le test d'une source d'annonce unique dans l'inspecteur d'annonces à l'aide de Meta Audience Network (Bidding) sources d'annonces.
Étapes facultatives
Mise en cache sur Android 9
Android
À partir d'Android 9 (niveau d'API 28), la prise en charge du texte clair est désactivée par par défaut ce qui aura une incidence sur la fonctionnalité de mise en cache des médias Network SDK et pourrait affecter l'expérience utilisateur et les revenus publicitaires. Suivre les méta documentation pour mettre à jour la configuration de la sécurité réseau dans votre application.
iOS
Non applicable aux intégrations iOS.
Codes d'erreur
Si l'adaptateur ne reçoit pas d'annonce de Audience Network, vous pouvez vérifier
l'erreur sous-jacente de la réponse d'annonce
ResponseInfo
dans les classes suivantes:
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
Voici les codes et les messages associés générés par l'audience Meta Adaptateur réseau en cas d'échec de chargement d'une annonce:
Android
Code d'erreur | Motif |
---|---|
101 | Paramètres de serveur non valides (ID d'emplacement manquant, par exemple). |
102 | La taille d'annonce demandée ne correspond pas à une taille de bannière acceptée par Meta Audience Network. |
103 | L'éditeur doit demander des annonces dans un contexte Activity . |
104 | Échec de l'initialisation du SDK Meta Audience Network. |
105 | L'éditeur n'a pas demandé d'annonces natives unifiées. |
106 | L'annonce native chargée ne correspond pas à l'objet attendu. |
107 | L'objet Context utilisé n'est pas valide. |
108 | Il manque les éléments d'annonce native requis dans l'annonce chargée. |
109 | Échec de la création d'une annonce native à partir de la charge utile de l'enchère. |
110 | Le SDK Meta Audience Network n'a pas pu présenter l'annonce interstitielle/avec récompense. |
111 | Exception générée lors de la création d'un objet AdView Meta Audience Network. |
1000-9999 | Meta Audience Network a renvoyé une erreur spécifique au SDK. Voir Documentation Meta Audience Network pour en savoir plus. |
iOS
Code d'erreur | Motif |
---|---|
101 | Paramètres de serveur non valides (ID d'emplacement manquant, par exemple). |
102 | La taille d'annonce demandée ne correspond pas à une taille de bannière acceptée par Meta Audience Network. |
103 | Échec de l'initialisation de l'objet d'annonce Meta Audience Network. |
104 | Le SDK Meta Audience Network n'a pas pu présenter l'annonce interstitielle/avec récompense. |
105 | Le contrôleur de vue racine de la bannière est nil . |
106 | Échec de l'initialisation du SDK Meta Audience Network. |
1000-9999 | Meta Audience Network a renvoyé une erreur spécifique au SDK. Voir Documentation Meta Audience Network pour en savoir plus. |
Journal des modifications du plug-in de médiation Unity Meta Audience Network
Version 3.12.1
- Compatible avec la version 6.17.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.15.1.0 de l'adaptateur iOS Meta Audience Network.
- Il est conçu et testé avec le plug-in Google Mobile Ads Unity version 9.1.0.
Version 3.12.0
- Compatible avec la version 6.17.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.15.0.0 de l'adaptateur iOS Meta Audience Network.
- Il est conçu et testé avec le plug-in Google Mobile Ads Unity version 9.0.0.
Version 3.11.0
- Compatible avec la version 6.15.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.14.0.0 de l'adaptateur iOS Meta Audience Network.
- Il est conçu et testé avec le plug-in Google Mobile Ads Unity version 8.5.1.
Version 3.10.0
- Contenu de l'adaptateur déplacé vers
GoogleMobileAds/Mediation/MetaAudienceNetwork/
. - Compatible avec la version 6.14.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.12.0.1 de l'adaptateur iOS Meta Audience Network.
- Il est conçu et testé avec le plug-in Google Mobile Ads Unity version 8.1.0.
Version 3.9.1
- Compatible avec la version 6.12.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.12.0.1 de l'adaptateur iOS Meta Audience Network.
- Il est conçu et testé avec le plug-in Google Mobile Ads Unity version 7.4.1.
Version 3.9.0
- Compatible avec la version 6.12.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.12.0.0 de l'adaptateur iOS Meta Audience Network.
- Il est conçu et testé avec le plug-in Google Mobile Ads Unity version 7.3.0.
Version 3.8.0
- Le nom du plug-in de médiation Unity a été renommé "Meta Audience Network".
- Compatible avec la version 6.11.0.1 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.11.1.0 de l'adaptateur iOS Meta Audience Network.
- Il est conçu et testé avec le plug-in Google Mobile Ads Unity version 7.0.2.
Version 3.7.0
- Compatible avec la version 6.10.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.10.0.0 de l'adaptateur iOS Meta Audience Network.
- Il est conçu et testé avec le plug-in Google Mobile Ads Unity version 7.0.0.
Version 3.6.1
- Compatible avec la version 6.8.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.9.0.1 de l'adaptateur iOS Meta Audience Network.
- Il est conçu et testé avec le plug-in Google Mobile Ads Unity version 7.0.0.
Version 3.6.0
- Compatible avec la version 6.8.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.8.0.0 de l'adaptateur iOS Meta Audience Network.
Version 3.5.0
- Compatible avec la version 6.7.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.7.0.0 de l'adaptateur iOS Meta Audience Network.
Version 3.4.0
- Compatible avec la version 6.6.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.6.0.0 de l'adaptateur iOS Meta Audience Network.
Version 3.3.2
- Compatible avec la version 6.5.1.1 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.5.1.0 de l'adaptateur iOS Meta Audience Network.
Version 3.3.1
- Compatible avec la version 6.5.1.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.5.1.0 de l'adaptateur iOS Meta Audience Network.
Version 3.3.0
- Compatible avec la version 6.4.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.4.1.0 de l'adaptateur iOS Meta Audience Network.
Version 3.2.0
- Compatible avec la version 6.2.0.1 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.2.1.0 de l'adaptateur iOS Meta Audience Network.
Version 3.1.0
- Compatible avec la version 6.2.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.2.0.0 de l'adaptateur iOS Meta Audience Network.
Version 3.0.0
- Compatible avec la version 6.1.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 6.0.0.0 de l'adaptateur iOS Meta Audience Network.
Version 2.12.0
- Compatible avec la version 5.11.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.10.1.0 de l'adaptateur iOS Meta Audience Network.
Version 2.11.1
- Compatible avec la version 5.10.1.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.10.1.0 de l'adaptateur iOS Meta Audience Network.
Version 2.11.0
- Compatible avec la version 5.10.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.10.0.0 de l'adaptateur iOS Meta Audience Network.
Version 2.10.0
- Compatible avec la version 5.9.1.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.9.0.1 de l'adaptateur iOS Meta Audience Network.
Version 2.9.2
- Compatible avec la version 5.9.0.2 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.9.0.1 de l'adaptateur iOS Meta Audience Network.
Version 2.9.1
- Compatible avec la version 5.9.0.1 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.9.0.1 de l'adaptateur iOS Meta Audience Network.
Version 2.9.0
- Compatible avec la version 5.9.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.9.0.0 de l'adaptateur iOS Meta Audience Network.
Version 2.8.1
- Compatible avec la version 5.8.0.1 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.8.0.2 de l'adaptateur iOS Meta Audience Network.
Version 2.8.0
- Compatible avec la version 5.8.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.8.0.1 de l'adaptateur iOS Meta Audience Network.
Version 2.7.1 (obsolète, utilisez la version 2.8.0 ou ultérieure)
- Compatible avec la version 5.7.1.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.7.1.1 de l'adaptateur iOS Meta Audience Network.
Version 2.7.0 (obsolète, utilisez la version 2.8.0 ou ultérieure)
- Compatible avec la version 5.7.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.7.0.0 de l'adaptateur iOS Meta Audience Network.
Version 2.6.1 (obsolète, utilisez la version 2.8.0 ou ultérieure)
- Compatible avec la version 5.6.1.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.6.1.0 de l'adaptateur iOS Meta Audience Network.
Version 2.6.0
- Compatible avec la version 5.6.0.0 de l'adaptateur Android Meta Audience Network.
- Compatible avec la version 5.6.0.0 de l'adaptateur iOS Meta Audience Network.
Version 2.5.1
- Compatible avec la version 5.5.0.0 de l'adaptateur Facebook pour Android
- Compatible avec la version 5.5.1.0 de l'adaptateur Facebook pour iOS.
Version 2.5.0
- Compatible avec la version 5.5.0.0 de l'adaptateur Facebook pour Android
- Compatible avec la version 5.5.0.0 de l'adaptateur Facebook pour iOS.
Version 2.4.1
- Compatible avec la version 5.4.1.1 de l'adaptateur Facebook pour Android
- Compatible avec la version 5.4.0.0 de l'adaptateur Facebook pour iOS.
Version 2.4.0
- Compatible avec la version 5.4.0.0 de l'adaptateur Facebook pour Android
- Compatible avec la version 5.4.0.0 de l'adaptateur Facebook pour iOS.
Version 2.3.2
- Compatible avec la version 5.3.1.2 de l'adaptateur Facebook pour Android
- Compatible avec la version 5.3.2.0 de l'adaptateur Facebook pour iOS.
Version 2.3.1
- Compatible avec la version 5.3.1.0 de l'adaptateur Facebook pour Android
- Compatible avec la version 5.3.2.0 de l'adaptateur Facebook pour iOS.
Version 2.3.0
- Compatible avec la version 5.3.0.0 de l'adaptateur Facebook pour Android
- Compatible avec la version 5.3.0.0 de l'adaptateur Facebook pour iOS.
Version 2.2.0
- Mise à jour du plug-in pour prendre en charge la nouvelle API Récompense en bêta ouverte.
- Compatible avec la version 5.2.0.1 de l'adaptateur Facebook pour Android
- Compatible avec la version 5.2.0.1 de l'adaptateur Facebook pour iOS.
Version 2.1.1
- Compatible avec la version 5.1.0.1 de l'adaptateur Facebook pour Android
- Compatible avec la version 5.1.0.0 de l'adaptateur Facebook pour iOS.
Version 2.1.0
- Compatible avec la version 5.1.0.0 de l'adaptateur Facebook pour Android
- Compatible avec la version 5.1.0.0 de l'adaptateur Facebook pour iOS.
Version 2.0.0
- Compatible avec la version 5.0.1.0 de l'adaptateur Facebook pour Android
- Compatible avec la version 5.0.1.0 de l'adaptateur Facebook pour iOS.
Version 1.2.1
- Compatible avec la version 4.99.3.0 de l'adaptateur Facebook pour Android
- Compatible avec la version 4.99.3.0 de l'adaptateur Facebook pour iOS.
Version 1.2.0
- Compatible avec la version 4.99.1.1 de l'adaptateur Facebook pour Android.
- Compatible avec la version 4.99.2.0 de l'adaptateur Facebook pour iOS.
Version 1.1.3
- Compatible avec la version 4.28.2.1 de l'adaptateur Facebook pour Android.
- Compatible avec la version 4.28.1.2 de l'adaptateur Facebook pour iOS.
Version 1.1.2
- Correction d'un conflit potentiel avec le plug-in de médiation Unity Ads Unity.
Version 1.1.1
- Compatible avec la version 4.28.2.0 de l'adaptateur Facebook pour Android.
- Compatible avec la version 4.28.1.1 de l'adaptateur Facebook pour iOS.
Version 1.1.0
- Compatible avec la version 4.28.1 du SDK Facebook pour Android
- Compatible avec la version 4.28.1 du SDK iOS Facebook
Version 1.0.0
- Première version !
- Compatible avec la version 4.27.0 du SDK Facebook pour Android
- Compatible avec la version 4.27.1 du SDK Facebook pour iOS