Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher annonces provenant de DT Exchange à l'aide de médiation sur les intégrations de cascades d'annonces. Il explique comment ajouter DT Exchange à une annonce. la configuration de médiation de l'unité et comment intégrer le SDK DT Exchange et l'adaptateur dans une Android application.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation pour DT Exchange offre les fonctionnalités suivantes:
Intégration | |
---|---|
Enchères | |
Cascade | |
Formats | |
Bannière | |
Interstitiel | |
Avec récompense | |
Natif |
Conditions requises
- Niveau d'API Android 21 ou supérieur
Le dernier SDK Google Mobile Ads
Finaliser la médiation Guide de démarrage
Étape 1: Définir des configurations dans l'interface utilisateur de DT Exchange
Ajouter une application et un emplacement d'annonce
Inscrivez-vous ou connectez-vous à la console Exchange DT.
Cliquez sur le bouton Add App (Ajouter une application) pour ajouter votre application.
Sélectionnez votre plate-forme, remplissez le reste du formulaire, puis cliquez sur Ajouter des emplacements.
Attribuez un nom au nouvel emplacement dans le champ Attribuer un nom à l'emplacement, puis sélectionnez le type d'emplacement souhaité dans la liste déroulante. Enfin, cliquez sur Enregistrer l'emplacement.
ID de l'application et de l'emplacement
Ouvrez la barre de navigation de gauche en plaçant le pointeur de la souris dessus. Cliquez ensuite sur Applications dans le menu de gauche.
Sur la page Gestion des applications, notez l'ID de l'application qui se trouve à côté de votre application.
Sélectionnez votre application, accédez à l'onglet Emplacements, puis cliquez sur l'icône de copie à côté de Nom de l'emplacement. Notez l'ID d'emplacement.
Référence éditeur, clé client et code secret client
Cliquez sur votre nom d'utilisateur dans le menu de gauche, puis sélectionnez User Profile (Profil utilisateur).
Notez la référence éditeur, la clé client et le code secret client, car vous en aurez besoin à l'étape suivante.
Étape 2: Configurez la demande de transfert de données sur une place de marché dans Ad Manager l'interface utilisateur
Configurer les paramètres de médiation pour votre bloc d'annonces
Connectez-vous à votre compte Ad Manager.
Accédez à Diffusion > Groupes de rendement, puis cliquez sur le bouton Nouveau groupe de rendement.
Attribuez un nom unique à votre groupe de rendement, définissez l'état sur Actif, puis le format d'annonce et le type d'inventaire sur Application mobile. Dans la section Ciblage > Inventaire, sélectionnez le bloc d'annonces auquel vous souhaitez ajouter une médiation sous Inventaire et Application mobile.
Cliquez ensuite sur le bouton Ajouter un partenaire de rendement.
Si vous disposez déjà d'un partenaire de rendement pourDT Exchange, vous pouvez le sélectionner. Sinon, sélectionnez Créer un partenaire de rendement.
Sélectionnez DT Exchange en tant que réseau publicitaire, saisissez un nom unique et activez la médiation.
Activez la collecte des données automatique et saisissez lePublisher ID, Consumer Secret and Consumer Keyobtenu à la section précédente.
Une fois que vous avez sélectionné Partenaire de rendement, sélectionnez Médiation SDK pour mobile comme type d'intégration, Android comme Plate-forme et Actif comme État. Saisissez leApplication ID and Placement ID obtenu dans la section précédente. Saisissez ensuite une valeur dans le champ CPM par défaut.
Lorsque vous avez terminé, cliquez sur Enregistrer en bas de la page.
Ajouter Fyber à la liste des partenaires publicitaires concernant le RGPD et les réglementations des États américains
Suivez les étapes indiquées dans Paramètres RGPD et Paramètres des réglementations des États américains pour ajouter Fyber à la liste des partenaires publicitaires sur le RGPD et les réglementations des États américains dans l' Ad Manager UI.
Étape 3: Importer le SDK DT Exchange et l'adaptateur
Intégration d'Android Studio (recommandé)
Dans le fichier build.gradle.kts
au niveau de l'application, ajoutez l'implémentation suivante :
les dépendances et les configurations. Utilisez les dernières versions du SDK DT Exchange
et l'adaptateur:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:fyber:8.3.0.0")
}
Intégration manuelle
- Téléchargez la dernière version de
SDK DT Exchange pour Android et ajoutez
les fichiers suivants à votre projet:
<ph type="x-smartling-placeholder">
- </ph>
ia-mraid-kit-release-x.y.z.aar
ia-sdk-core-release-x.y.z.aar
ia-video-kit-release-x.y.z.aar
- Accédez au
Artefacts de l'adaptateur DT Exchange
dans le dépôt Maven de Google. Sélectionnez la dernière version, puis téléchargez le transfert de données.
le fichier
.aar
de l'adaptateur Exchange, puis ajoutez-le à votre projet.
Étape 4: Implémentez les paramètres de confidentialité sur le SDK DT Exchange
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 des 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.
DT Exchange contient une API qui vous permet de transférer le consentement de l'utilisateur à son SDK. La L'exemple de code suivant montre comment transmettre les informations de consentement à DT Exchange manuellement. Si vous choisissez de transmettre les informations de consentement à la place de marché DT Exchange SDK manuellement, il est recommandé d'appeler ce code avant de demander des annonces via le SDK Google Mobile Ads.
Java
import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...
InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");
Kotlin
import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...
InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")
Consultez la page des ressources relatives au RGPD de DT Exchange ainsi que les Guide d'implémentation du RGPD pour en savoir plus et connaître les valeurs pouvant être fournies dans la méthode.
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 locale, qui 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é.
DT Exchange contient une API qui vous permet de transférer le consentement de l'utilisateur à son SDK. La L'exemple de code suivant montre comment transmettre les informations de consentement à DT Exchange manuellement. Si vous choisissez de transmettre les informations de consentement à la place de marché DT Exchange SDK manuellement, il est recommandé d'appeler ce code avant de demander des annonces via le SDK Google Mobile Ads.
Java
import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");
Kotlin
import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")
Consultez la page de ressources sur la loi CCPA de DT Exchange et les Guide d'implémentation de la loi CCPA pour en savoir plus et connaître les valeurs pouvant être fournies dans la méthode.
Étape 5: Ajoutez le code requis
Aucun code supplémentaire n'est requis pour l'intégration de DT Exchange.
Étape 6: Testez votre implémentation
Activer les annonces tests
Veillez à enregistrer votre appareil de test pour Ad Manager.
Valider les annonces tests
Pour vérifier que vous recevez des annonces tests deDT Exchange, activez le test d'une source d'annonce unique dans l'inspecteur d'annonces à l'aide de DT Exchange (Waterfall) sources d'annonces.
Étapes facultatives
Paramètres propres au réseau
L'adaptateur DT Exchange prend en charge des paramètres de requête supplémentaires qui peuvent être transmis à l'adaptateur en tant qu'Android Bundle. L'adaptateur recherche les éléments suivants : clés du bundle:
Paramètres et valeurs de requête | |
---|---|
InneractiveMediationDefs.KEY_AGE
|
Nombre entier : Âge de l'utilisateur |
FyberMediationAdapter.KEY_MUTE_VIDEO
|
Booléen : Couper ou réactiver le son de la vidéo |
Voici un exemple de code montrant comment définir ces paramètres de demande d'annonce:
Java
Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(FyberMediationAdapter.class, extras)
.build();
Kotlin
var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)
val request = AdRequest.Builder()
.addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
.build()
Codes d'erreur
Si l'adaptateur ne parvient pas à recevoir une annonce de DT Exchange, vous pouvez vérifier le
l'erreur sous-jacente de la réponse d'annonce
ResponseInfo.getAdapterResponses()
dans la classe suivante:
com.google.ads.mediation.fyber.FyberMediationAdapter
Voici les codes et les messages associés générés par l'adaptateur DT Exchange. en cas d'échec de chargement d'une annonce:
Code d'erreur | Motif |
---|---|
101 | Les paramètres du serveur DT Exchange configurés dans l'interface utilisateur Ad Manager sont manquants ou non valides. |
103 | La taille d'annonce demandée ne correspond pas à une taille de bannière prise en charge par DT Exchange. |
105 | Le SDK DT Exchange a chargé une annonce, mais a renvoyé un contrôleur inattendu. |
106 | L'annonce n'est pas prête à être diffusée. |
200-399 | Le SDK DT Exchange a renvoyé une erreur. Voir le code pour en savoir plus. |
Journal des modifications de l'adaptateur de médiation Android DT Exchange
Version 8.3.0.0
- Ajout de la possibilité de transmettre la version du SDK Google Mobile Ads au SDK DT Exchange.
- Compatibilité vérifiée avec le SDK DT Exchange 8.3.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.2.0.
- SDK DT Exchange version 8.3.0.
Version 8.2.7.0
- Compatibilité vérifiée avec le SDK DT Exchange 8.2.7.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.0.0.
- SDK DT Exchange version 8.2.7.
Version 8.2.6.1
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 23.0.0.
- Compatibilité vérifiée avec le SDK DT Exchange 8.2.6.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.0.0.
- SDK DT Exchange version 8.2.6.
Version 8.2.6.0
- Compatibilité vérifiée avec le SDK DT Exchange 8.2.6.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.6.0.
- SDK DT Exchange version 8.2.6.
Version 8.2.5.0
- Compatibilité vérifiée avec le SDK DT Exchange 8.2.5.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.5.0
- SDK DT Exchange version 8.2.5.
Version 8.2.4.0
- Compatibilité vérifiée avec le SDK DT Exchange 8.2.4.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.3.0
- SDK DT Exchange version 8.2.4.
Version 8.2.3.0
- Adaptateur mis à jour pour utiliser la nouvelle classe
VersionInfo
. - Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.0.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.0.0.
- SDK DT Exchange version 8.2.3.
Version 8.2.2.1
- Ajout de la prise en charge de la transmission de la clé
muteVideo
dans l'extra de médiation afin d'ignorer les annonces interstitielles.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.5.0
- SDK DT Exchange version 8.2.2.
Version 8.2.2.0
- Compatibilité vérifiée avec le SDK DT Exchange 8.2.2.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 21.5.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.5.0
- SDK DT Exchange version 8.2.2.
Version 8.2.1.0
- Le nom de l'adaptateur a été renommé "DT Exchange".
- Compatibilité vérifiée avec le SDK DT Exchange 8.2.1.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 21.3.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.3.0
- SDK DT Exchange version 8.2.1.
Version 8.2.0.0
- Compatibilité vérifiée avec le SDK Fyber 8.2.0.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 21.1.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.1.0
- SDK Fyber version 8.2.0.
Version 8.1.5.0
- Compatibilité vérifiée avec le SDK Fyber 8.1.5.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.0.0
- SDK Fyber version 8.1.5.
Version 8.1.4.0
- Compatibilité vérifiée avec le SDK Fyber 8.1.4.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.0.0
- SDK Fyber version 8.1.4.
Version 8.1.3.1
- Mise à jour de
compileSdkVersion
ettargetSdkVersion
vers l'API 31. - Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 21.0.0.
- Mise à jour du niveau d'API Android minimal requis vers 19.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.0.0
- SDK Fyber version 8.1.3.
Version 8.1.3.0
- Compatibilité vérifiée avec le SDK Fyber 8.1.3.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.6.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 20.6.0
- SDK Fyber version 8.1.3.
Version 8.1.2.0
- Compatibilité vérifiée avec le SDK Fyber 8.1.2.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.5.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 20.5.0
- SDK Fyber version 8.1.2.
Version 8.1.0.0
- Compatibilité vérifiée avec le SDK Fyber 8.1.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 20.4.0.
- SDK Fyber version 8.1.0.
Version 7.8.4.1
- Correction d'un problème qui empêchait l'initialisation de l'adaptateur en cas de doublon ou de plusieurs ID d'application uniques provenant des configurations de médiation.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.4.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 20.4.0.
- SDK Fyber version 7.8.4
Version 7.8.4.0
- Compatibilité vérifiée avec le SDK Fyber 7.8.4.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.3.0.
- Correction d'un problème lié aux annonces display avec récompense, où
onVideoComplete()
n'était pas appelé. - Fyber a désormais besoin d'un contexte d'activité pour afficher des annonces.
Conçu et testé avec:
- SDK Google Mobile Ads version 20.3.0
- SDK Fyber version 7.8.4
Version 7.8.3.0
- Compatibilité vérifiée avec le SDK Fyber 7.8.3.
- Ajout de codes et messages d'erreur standardisés pour les adaptateurs.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.1.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 20.1.0
- SDK Fyber version 7.8.3
Version 7.8.2.0
- Compatibilité vérifiée avec le SDK Fyber 7.8.2.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.0.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 20.0.0.
- SDK Fyber version 7.8.2
Version 7.8.1.0
- Compatibilité vérifiée avec le SDK Fyber 7.8.1.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.7.0.
- SDK Fyber version 7.8.1
Version 7.8.0.0
- Compatibilité vérifiée avec le SDK Fyber 7.8.0.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.7.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.7.0.
- SDK Fyber version 7.8.0
Version 7.7.4.0
- Compatibilité vérifiée avec le SDK Fyber 7.7.4.
- Correction d'un problème qui entraînait le transfert de
onUserEarnedReward()
deux fois pour les annonces avec récompense.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.5.0.
- SDK Fyber version 7.7.4.
Version 7.7.3.0
- Compatibilité vérifiée avec le SDK Fyber 7.7.3.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.5.0.
- SDK Fyber version 7.7.3.
Version 7.7.2.0
- Compatibilité vérifiée avec le SDK Fyber 7.7.2.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.5.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.5.0.
- SDK Fyber version 7.7.2.
Version 7.7.1.0
- Compatibilité vérifiée avec le SDK Fyber 7.7.1.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.4.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.4.0.
- SDK Fyber version 7.7.1
Version 7.7.0.0
- Compatibilité vérifiée avec le SDK Fyber 7.7.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.3.0.
- SDK Fyber version 7.7.0
Version 7.6.1.0
- Compatibilité vérifiée avec le SDK Fyber 7.6.1.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.3.0.
- SDK Fyber version 7.6.1
Version 7.6.0.0
- Compatibilité vérifiée avec le SDK Fyber 7.6.0.
- L'adaptateur a été mis à jour pour prendre en charge les demandes de bannières adaptatives intégrées.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.3.0.
- Correction d'un bug qui empêchait l'appel des méthodes onAdOpened()/onAdClosed() pour les bannières.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.3.0.
- SDK Fyber version 7.6.0
Version 7.5.4.0
- Compatibilité vérifiée avec le SDK Fyber 7.5.4.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.1.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.1.0.
- SDK Fyber version 7.5.4
Version 7.5.3.0
- Compatibilité vérifiée avec le SDK Fyber 7.5.3.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.0.1.
- SDK Fyber version 7.5.3
Version 7.5.2.0
- Compatibilité vérifiée avec le SDK Fyber 7.5.2.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.0.1.
Conçu et testé avec:
- SDK Google Mobile Ads version 19.0.1.
- SDK Fyber version 7.5.2.
Version 7.5.0.0
- Compatibilité vérifiée avec le SDK Fyber 7.5.0.
- Correction du plantage de NullPointerException lors du chargement des annonces Fyber.
Conçu et testé avec:
- SDK Google Mobile Ads version 18.3.0
- SDK Fyber version 7.5.0
Version 7.4.1.0
- Compatibilité vérifiée avec le SDK Fyber 7.4.1.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 18.3.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 18.3.0
- SDK Fyber version 7.4.1
Version 7.3.4.0
- Version initiale
- Compatible avec les bannières, les interstitiels et les annonces avec récompense.
Conçu et testé avec:
- SDK Google Mobile Ads version 18.2.0.
- SDK Fyber version 7.3.4