Intégrer l'échange de transfert de données à la médiation

Ce guide explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces à partir de DT Exchange à l'aide de la médiation, qui couvre les intégrations en cascade. Il explique comment ajouter DT Exchange à la configuration de médiation d'un bloc d'annonces, et comment intégrer le SDK et l'adaptateur DT Exchange dans une application Android .

Intégrations et formats d'annonces compatibles

L'adaptateur de médiation AdMob pour DT Exchange offre les fonctionnalités suivantes:

Intégration
Enchères
Cascade
Formats
Bannière
Interstitiel
Accordé
Natif

Conditions requises

  • Niveau d'API Android 19 ou supérieur

Étape 1: Définissez les configurations dans l'interface utilisateur 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.

Gérer les applications

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.

Préparation

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.

Menu

Sur la page Gestion des applications, notez l'ID de l'application qui se trouve à côté de votre application.

ID de l'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.

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).

Menu du profil utilisateur

Notez la référence éditeur, la clé client et le code secret client, car vous en aurez besoin à l'étape suivante.

Profil utilisateur

Étape 2: Configurez la demande DT Exchange dans AdMob l'interface utilisateur

Configurer les paramètres de médiation pour votre bloc d'annonces

Vous devez ajouter DT Exchange à la configuration de la médiation pour votre bloc d'annonces.

Connectez-vous à votre compte AdMob. Accédez ensuite à l'onglet Médiation. Si vous souhaitez modifier un groupe de médiation existant, cliquez sur son nom pour le modifier, puis passez à l'étape Ajouter DT Exchange comme source d'annonces.

Pour créer un groupe de médiation, sélectionnez Créer un groupe de médiation.

Saisissez le format de votre annonce et votre plate-forme, puis cliquez sur Continuer.

Attribuez un nom à votre groupe de médiation, puis sélectionnez les zones géographiques à cibler. Définissez ensuite l'état du groupe de médiation sur Activé, puis cliquez sur Ajouter des blocs d'annonces.

Associez ce groupe de médiation à un ou plusieurs de vos blocs d'annoncesAdMob existants. Cliquez ensuite sur Done (OK).

Vous devriez maintenant voir la fiche des blocs d'annonces que vous avez sélectionnés:

Ajouter DT Exchange comme source d'annonces

Sous la fiche Waterfall (Cascade d'annonces) de la section Ad Sources (Sources d'annonces), sélectionnez Add Ad Source (Ajouter une source d'annonces). Sélectionnez ensuite DT Exchange.

Sélectionnez DT Exchange et activez le bouton Optimiser. Saisissez l' Publisher ID, Consumer Secret and Consumer Key obtenue à la section précédente pour configurer l'optimisation de la source d'annonces pour DT Exchange. Ensuite, saisissez une valeur d'eCPM pour DT Exchange et cliquez sur Continuer.

Si vous disposez déjà d'un mappage pour DT Exchange, vous pouvez le sélectionner. Sinon, cliquez sur Ajouter un mappage.

Saisissez ensuite les Application ID and Placement IDobtenus à la section précédente. Cliquez ensuite sur Done (OK).

Ajouter Fyber à la liste des partenaires publicitaires liés au RGPD et aux réglementations dans les É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' AdMob UI.

Étape 3: Importez le SDK et l'adaptateur DT Exchange

Dans le fichier build.gradle.kts au niveau de l'application, ajoutez les configurations et dépendances d'implémentation suivantes. Utilisez les dernières versions du SDK DT Exchange et de l'adaptateur:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:fyber:8.2.6.0")
}

Intégration manuelle

  • Téléchargez la dernière version du SDK DT Exchange pour Android et ajoutez les fichiers suivants à votre projet :
    • 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 aux artefacts d'adaptateur DT Exchange dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez le fichier .aar de l'adaptateur DT Exchange et ajoutez-le à votre projet.

Étape 4: Implémentez les paramètres de confidentialité dans le SDK DT Exchange

Conformément aux Règles de Google relatives au consentement de l'utilisateur dans l'UE, vous devez vous assurer que certaines informations sont divulguées aux utilisateurs de l'Espace économique européen (EEE) et qu'ils ont obtenu leur consentement concernant l'utilisation d'identifiants d'appareils et de données à caractère personnel. Ces règles reflètent les exigences de la directive vie privée et communications électroniques de l'UE, et celles du Règlement général sur la protection des données (RGPD). Lorsque vous demandez le consentement des utilisateurs, vous devez identifier chaque réseau publicitaire de votre chaîne de médiation susceptible de collecter, de recevoir ou d'utiliser des données à caractère personnel, et de fournir des informations sur l'utilisation de chaque réseau. À l'heure actuelle, Google n'est 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. L'exemple de code suivant montre comment transmettre manuellement des informations de consentement au SDK DT Exchange. Si vous choisissez de transmettre manuellement les informations de consentement au SDK Exchange DT, nous vous recommandons 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 concernant le RGPD de DT Exchange et le Guide d'implémentation du RGPD pour en savoir plus et connaître les valeurs qui peuvent être fournies dans la méthode.

Lois sur la confidentialité dans les États américains

Lois sur la confidentialité dans les États américains exigent que les utilisateurs aient le droit de refuser la "vente" de leurs "informations personnelles" (selon la définition de ces termes par la loi), via un lien bien visible intitulé "Ne pas vendre mes informations personnelles" sur la page d'accueil du tiers concerné. Le guide sur la conformité avec les lois sur la confidentialité dans les États américains permet d'activer le traitement restreint des données pour la diffusion d'annonces Google. Toutefois, Google ne peut pas appliquer ce paramètre à chaque réseau publicitaire de votre chaîne de médiation. Par conséquent, vous devez identifier chaque réseau publicitaire de votre chaîne de médiation susceptible de participer à la vente d'informations personnelles et suivre les consignes de chacun de ces réseaux pour garantir la conformité.

DT Exchange contient une API qui vous permet de transférer le consentement de l'utilisateur à son SDK. L'exemple de code suivant montre comment transmettre manuellement des informations de consentement au SDK DT Exchange. Si vous choisissez de transmettre manuellement les informations de consentement au SDK Exchange DT, nous vous recommandons 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 des ressources concernant le CCPA de DT Exchange et le Guide d'implémentation concernant la loi CCPA pour en savoir plus et connaître les valeurs 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 AdMob.

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 réseau

L'adaptateur DT Exchange accepte des paramètres de requête supplémentaires qui peuvent lui être transmis en tant qu'Android Bundle. L'adaptateur recherche les clés suivantes dans le bundle:

Paramètres et valeurs de requête
InneractiveMediationDefs.KEY_AGE Entier : L'â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 illustrant 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)

var adrequest = AdRequest.Builder()
       .addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
       .build()

Codes d'erreur

Si l'adaptateur ne reçoit pas d'annonce de DT Exchange, vous pouvez vérifier l'erreur sous-jacente de la réponse d'annonce en utilisant 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 lorsqu'une annonce ne se charge pas:

Code d'erreur Motif
101 Les paramètres du serveur DT Exchange configurés dans l'interface utilisateur AdMob sont manquants/non valides.
103 La taille d'annonce demandée ne correspond pas à une taille de bannière compatible avec 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. Pour plus d'informations, reportez-vous à la section sur le code.
0-10 Le SDK DT Exchange a renvoyé une erreur. Consultez la documentation pour en savoir plus.
101 Les paramètres du serveur DT Exchange configurés dans l'interface utilisateur AdMob sont manquants/non valides.
102 La taille d'annonce demandée ne correspond pas à une taille de bannière compatible avec DT Exchange.
103 Échec de la diffusion de l'annonce, car l'objet d'annonce a déjà été utilisé.
104 Échec de l'affichage des annonces DT Exchange, car l'annonce n'est pas prête.
105 Le SDK DT Exchange a renvoyé une erreur d'initialisation.

Journal des modifications de l'adaptateur de médiation Android DT Exchange

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

  • Mise à jour de l'adaptateur 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

  • Il est désormais possible de transmettre la clé muteVideo dans les éléments supplémentaires de médiation pour 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

  • Nom de l'adaptateur 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é validé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é validé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é validé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 et targetSdkVersion 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 la version 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é validé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é validé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é validé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é validé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 diffuser 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é validée avec le SDK Fyber 7.8.3.
  • Ajout de codes et de 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é validé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é validé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é validé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é validée avec le SDK Fyber 7.7.4.
  • Correction d'un problème pour lequel onUserEarnedReward() était transféré 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é validé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é validé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é validé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é validé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é validé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é validée avec le SDK Fyber 7.6.0.
  • Mise à jour de l'adaptateur pour accepter les requêtes 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 publicitaires.

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é validé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é validé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é validé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é validé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é validé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.