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:
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 : Configurez les configurations dans l'interface utilisateur de DT Exchange
Étape 2: Configurez la demande de transfert de données sur une place de marché dans Ad Manager l'interface utilisateur
Ajout de Fyber à la liste des partenaires publicitaires conformes au RGPD et aux réglementations des États américains
É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 dépendances et configurations d'implémentation suivantes. 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.1.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 susceptible de collecter, de recevoir ou d'utiliser des données à caractère personnel, et fournir 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 vers son SDK. La L'exemple de code suivant montre comment transmettre les informations de consentement à DT Exchange manuellement. Si vous choisissez de transmettre manuellement des informations sur le consentement au SDK DT Exchange, 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 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.
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 spécifiques 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. Pour en savoir plus, consultez le code. |
Journal des modifications de l'adaptateur de médiation Android DT Exchange
Version 8.3.1.0
- Compatibilité vérifiée avec le SDK DT Exchange 8.3.1.
Conçu et testé avec:
- SDK Google Mobile Ads 23.3.0
- SDK DT Exchange version 8.3.1.
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 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.
Compilé 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 possibilité de transmettre la clé
muteVideo
dans le module complémentaire de médiation pour couper le son des annonces interstitielles.
Compilé 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
- Version du SDK Fyber 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
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.
Compilé et testé avec :
- SDK Google Mobile Ads version 20.4.0.
- SDK Fyber 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 dans les 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
- Version du SDK Fyber 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 : 20.1.0.
Compilé 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.
- Version du SDK Fyber 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.
Compilé et testé avec :
- SDK Google Mobile Ads version 19.5.0.
- Version du SDK Fyber 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 19.4.0
- Version du SDK Fyber 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é validée avec le SDK Fyber 7.6.1.
Conçu et testé avec:
- SDK Google Mobile Ads 19.3.0
- Version du SDK Fyber 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.
Compilé et testé avec :
- SDK Google Mobile Ads version 19.3.0.
- Version du SDK Fyber 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.
Compilé et testé avec :
- SDK Google Mobile Ads 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.
- Version du SDK Fyber 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 18.3.0
- Version du SDK Fyber 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 : 18.3.0.
Conçu et testé avec:
- SDK Google Mobile Ads 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.
- Version du SDK Fyber 7.3.4.