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 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 du bloc d'annonces 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:

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.2.0")
    implementation("com.google.ads.mediation:fyber:8.2.7.0")
}

Intégration manuelle

• Téléchargez la dernière version de 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 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.

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

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.

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 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:

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 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:

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

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