Intégrer le transfert de données avec la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces à partir de DT Exchange à l'aide de la médiation, pour couvrir les intégrations de cascades d'annonces. 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 pour DT Exchange offre les fonctionnalités suivantes:

Conditions requises

• Niveau d'API Android 21 ou supérieur

• Le dernier SDK Google Mobile Ads

• Suivez la procédure de 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 les configurations et dépendances d'implémentation suivantes. Utilisez les dernières versions du SDK et de l'adaptateur DT Exchange:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:fyber:8.2.7.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 Exchange DT et 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 aux Règles de Google relatives au consentement de l'utilisateur dans l'UE, vous devez vous assurer que certaines informations sont fournies aux utilisateurs de l'Espace économique européen (EEE) et qu'ils ont obtenu leur consentement concernant l'utilisation des identifiants d'appareils et des 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, 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. Pour le moment, 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 vers son SDK. L'exemple de code suivant montre comment transmettre manuellement les informations de consentement au SDK DT Exchange. Si vous choisissez de transmettre manuellement les informations de consentement au SDK DT Exchange, nous vous recommandons d'appeler ce code avant de demander des annonces via le SDK Google Mobile Ads.

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")

Consultez la page de ressources pour le RGPD de DT Exchange ainsi que le 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

Les lois sur la confidentialité dans les États américains exigent que les utilisateurs aient le droit de s'opposer à la"vente " de leurs"informations personnelles " (selon la définition de ces termes par la loi), en proposant cette option via un lien bien visible"Ne pas vendre mes données personnelles " sur la page d'accueil de l'annonceur. 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, mais 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 vers son SDK. L'exemple de code suivant montre comment transmettre manuellement les informations de consentement au SDK DT Exchange. Si vous choisissez de transmettre manuellement les informations de consentement au SDK DT Exchange, nous vous recommandons d'appeler ce code avant de demander des annonces via le SDK Google Mobile Ads.

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

Consultez la page de ressources concernant la loi CCPA de DT Exchange, ainsi que le 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 que bundle Android. L'adaptateur recherche les clés suivantes dans le bundle:

Voici un exemple de code montrant comment définir ces paramètres de demande d'annonce:

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();

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 reçoit pas d'annonce de DT Exchange, vous pouvez vérifier l'erreur sous-jacente dans la réponse d'annonce à l'aide de 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 du chargement d'une annonce:

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

Prochaine version:

• Transmission de la version MobileAds au SDK DT Exchange.

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

• 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é 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 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 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