Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger des annonces display de Mintegral grâce aux médiation, qui couvre à la fois l'intégration de la cascade d'annonces et des enchères. Il couvre comment ajouter Mintegral à la configuration de médiation d'un bloc d'annonces et comment à intégrer le SDK et l'adaptateur Mintegral Android application.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation pour Mintegral offre les fonctionnalités suivantes:
Intégration | |
---|---|
Enchères | 1 |
Cascade | 2. |
Formats | |
Ouverture de l'application | |
Bannière | |
Interstitiel | |
Avec récompense | |
Interstitiel avec récompense | |
Natif |
2 L'intégration de Waterfall est bêta fermée.
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 Mintegral
Inscrivez-vous ou connectez-vous à votre compte Mintegral.
Localiser la clé d'application
Accédez à l'onglet Paramètres de l'application et notez la clé APP.
Ajouter une application
Dans l'onglet Paramètres de l'application, cliquez sur le bouton Ajouter une application.
Sélectionnez la plate-forme et remplissez le reste du formulaire. Cliquez ensuite sur Enregistrer.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/new_application_Android.png?authuser=0000&hl=fr)
Notez l'ID d'application de votre application.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/app_id_Android.png?authuser=0000&hl=fr)
Créer un emplacement d'annonce
Une fois votre application créée, accédez à l'onglet Emplacements et unités, puis cliquez sur le bouton Ajouter un emplacement comme indiqué ci-dessous pour créer votre emplacement d'annonce.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/create_placement_Android.png?authuser=0000&hl=fr)
Renseignez les champs Nom d'emplacement et Format de l'annonce.
Sélectionnez Enchères d'en-tête comme Type d'enchère. Remplissez le reste du formulaire, puis cliquez sur Save (Enregistrer).
Une fois votre emplacement d'annonce créé, notez l'ID de l'emplacement.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=0000&hl=fr)
Cliquez sur la liste déroulante 1 bloc d'annonces et notez l'ID du bloc d'annonces.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=0000&hl=fr)
Trouver votre clé API Mintegral Reporting
Enchères
Cette étape n'est pas nécessaire pour les intégrations d'enchères.
Cascade
Vous aurez besoin de votre clé API Mintegral Reporting pour configurer l'Ad Manager ID de votre bloc d'annonces. Accédez à Account > API Tools (Compte > Outils d'API). Notez votre Skey et votre Secret.
Étape 2: Configurez la demande Mintegral dans Ad Manager l'UI
Connectez-vous à votre compte Ad Manager.
Ajouter Mintegral "Entreprises"
Enchères
Cette étape n'est pas nécessaire pour les intégrations d'enchères.
Chute d'eau
Accédez à Admin > Sociétés, puis cliquez sur le bouton Nouvelle société dans l'onglet Toutes les sociétés. Sélectionnez Réseau publicitaire.
Sélectionnez Mintegral en tant que réseau publicitaire, saisissez un nom unique et activez la médiation.
Vous n'avez pas besoin de saisir de nom d'utilisateur ni de mot de passe. Lorsque vous avez terminé, cliquez sur Save (Enregistrer).
Activer le partage des signaux sécurisés
Enchères
Accédez à Admin > Paramètres généraux. Accédez à l'onglet Paramètres de compte Ad Exchange, puis vérifiez et activez l'option Partage des signaux sécurisés. Cliquez sur Enregistrer.
Chute d'eau
Cette étape n'est pas nécessaire pour les intégrations en cascade.
Configurer Mintegral les enchères
Enchères
Accédez à Diffusion > Enchérisseurs, puis cliquez sur Nouvel enchérisseur dans l'onglet Enchères de SDK.
Sélectionnez Mintegral comme enchérisseur.
Activez les options Ajouter la bibliothèque de signaux de cet enchérisseur à la liste des signaux autorisés et Autoriser le partage des signaux avec cet enchérisseur. Cliquez ensuite sur Continuer.
Cliquez sur Continuer.
Cliquez sur OK.
Chute d'eau
Cette étape n'est pas nécessaire pour les intégrations en cascade.
Configurer la mise en correspondance des blocs d'annonces
Enchères
Accédez à Diffusion > Enchérisseurs, puis sélectionnez la société pourMintegral dans l'onglet Enchères par SDK.
Accédez à l'onglet Mise en correspondance des blocs d'annonces et cliquez sur Nouvelle mise en correspondance des blocs d'annonces.
Sélectionnez Bloc d'annonces spécifique. Sélectionnez un bloc d'annonces et un format, Application mobile comme Type d'inventaire et votre Application mobile. Saisissez ensuiteApp Key, App ID, Placement ID, and Ad Unit ID obtenu dans la section précédente. Enfin, cliquez sur Enregistrer.
Chute d'eau
Accédez à Diffusion > Groupes de rendement, puis cliquez sur le bouton Nouveau groupe de rendement. Sélectionnez votre application mobile.
Faites défiler la page vers le bas, puis cliquez sur Ajouter un partenaire de rendement.
Sélectionnez l'entreprise pour laquelle vous avez créé Mintegral dans la section précédente. Sélectionnez Médiation SDK pour mobile comme Type d'intégration, Android comme Plate-forme et Active comme État.
Saisissez le App Key, App ID, Placement ID, and Ad Unit IDobtenu à la section précédente, puis la valeur du CPM par défaut. Cliquez sur Enregistrer.
Ajouter Mintegral à 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 Mintegral à la liste des partenaires publicitaires sur le RGPD et les réglementations des États américains dans l' Ad Manager UI.
Étape 3: Importez le SDK Mintegral et l'adaptateur
Intégration d'Android Studio (recommandé)
Dans le fichier settings.gradle.kts
au niveau du projet, ajoutez ce qui suit :
des dépôts:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
}
}
}
Ensuite, dans le fichier build.gradle.kts
au niveau de l'application, ajoutez ce qui suit :
les dépendances et configurations d'implémentation. Utilisez les dernières versions de la
SDK et adaptateur Mintegral:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:mintegral:16.8.11.0")
}
Intégration manuelle
Pour inclure le SDK Mintegral, accédez à la page SDK Mintegral pour Android.
Accédez au Artefacts d'adaptateur Mintegral dans le dépôt Maven de Google. Sélectionnez la dernière version et téléchargez Mintegral le fichier
.aar
de l'adaptateur et ajoutez-le à votre projet.
Étape 4: Implémenter les paramètres de confidentialité du SDK Mintegral
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.
Le SDK Mintegral inclut la méthode setConsentStatus
pour transmettre le consentement
au SDK Mintegral.
L'exemple de code suivant montre comment transmettre des informations sur le consentement à Mintegral SDK. Vous devez définir ces options avant initialisez le SDK Google Mobile Ads. pour vous assurer qu'ils sont correctement transmis au SDK Mintegral.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)
Consultez la documentation de Mintegral sur la confidentialité pour en savoir plus.
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é.
Le SDK Mintegral inclut la méthode setDoNotTrackStatus
pour transmettre le consentement
au SDK Mintegral.
L'exemple de code suivant montre comment transmettre des informations sur le consentement à Mintegral SDK. Si vous devez appeler cette méthode, appelez-la après Initialiser le SDK Google Mobile Ads mais avant de demander des annonces via le SDK Google Mobile Ads.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)
Consultez la documentation de Mintegral sur la confidentialité pour en savoir plus.
Étape 5: Ajoutez le code requis
Aucun code supplémentaire n'est requis pour l'intégration de Mintegral.
Étape 6: Testez votre implémentation
Activer les annonces tests
Veillez à enregistrer votre appareil de test pour Ad Manager.
Pour obtenir des annonces tests Mintegral pour les bannières, les interstitiels, les annonces avec récompense et les annonces natives, Mintegral vous recommande d'utiliser les clés d'application, les ID d'applications, les ID d'emplacement et les ID de bloc d'annonces fournis sur la page des ID de test Mintegral .
Valider les annonces tests
Pour vérifier que vous recevez des annonces tests deMintegral, activez le test d'une source d'annonce unique dans l'inspecteur d'annonces à l'aide de Mintegral (Bidding) and Mintegral (Waterfall) sources d'annonces.
Étapes facultatives
Ajouter Mintegral à la liste des partenaires publicitaires liés à la loi CCPA
Suivez la procédure décrite dans l'article Paramètres concernant la loi CCPA d'ajouter Mintegral à la liste des partenaires publicitaires concernant la loi CCPA Ad Manager UI
Annonces natives
Rendu des annonces
L'adaptateur Mintegral renvoie ses annonces natives sous la forme
NativeAd
d'objets. Elle renseigne les éléments suivants :
champs
pendant
NativeAd
Champ | Éléments toujours inclus avec l'adaptateur Mintegral |
---|---|
Titre | |
Image | 1 |
Corps | |
Icône | |
Incitation à l'action | |
Note | |
Boutique | |
Prix | |
Annonceur |
1 L'adaptateur Mintegral ne fonctionne pas
permettent d'accéder directement à l'élément image principal pour ses annonces natives. L'élément
insère l'adaptateur
MediaView
avec une vidéo ou une image.
Codes d'erreur
Si l'adaptateur ne reçoit pas d'annonce de Mintegral, vous pouvez vérifier
l'erreur sous-jacente de la réponse d'annonce
ResponseInfo.getAdapterResponses()
dans les classes suivantes:
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
Voici les codes et les messages associés générés par l'adaptateur Mintegral. en cas d'échec de chargement d'une annonce:
Code d'erreur | Domaine | Motif |
---|---|---|
101 | com.google.ads.mediation.mintegral | Paramètres de serveur non valides (ID d'application ou ID d'emplacement manquant, par exemple). |
102 | com.google.ads.mediation.mintegral | La taille d'annonce demandée ne correspond pas à une taille de bannière prise en charge par Mintegral. |
103 | com.google.ads.mediation.mintegral | Réponse à l'enchère manquante ou non valide. |
104 | com.google.ads.mediation.mintegral | Le SDK Mintegral a renvoyé une erreur "Pas de remplissage". |
Journal des modifications de l'adaptateur de médiation Android Mintegral
Version 16.8.11.0
- Compatibilité vérifiée avec le SDK Mintegral 16.8.11.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.2.0.
- SDK Mintegral version 16.8.11.
Version 16.7.91.0
- Compatibilité vérifiée avec le SDK Mintegral 16.7.91.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.2.0.
- SDK Mintegral version 16.7.91.
Version 16.7.81.0
- Compatibilité vérifiée avec le SDK Mintegral 16.7.81.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.2.0.
- SDK Mintegral version 16.7.81.
Version 16.7.71.0
- Compatibilité vérifiée avec le SDK Mintegral 16.7.71.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.1.0.
- SDK Mintegral version 16.7.71.
Version 16.7.61.0
- Compatibilité vérifiée avec le SDK Mintegral 16.7.61.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.1.0.
- SDK Mintegral version 16.7.61.
Version 16.7.51.0
- Compatibilité vérifiée avec le SDK Mintegral 16.7.51.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.1.0.
- SDK Mintegral version 16.7.51.
Version 16.7.41.0
- Compatibilité vérifiée avec le SDK Mintegral 16.7.41.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.1.0.
- SDK Mintegral version 16.7.41.
Version 16.7.31.0
- Compatibilité vérifiée avec le SDK Mintegral 16.7.31.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.1.0.
- SDK Mintegral version 16.7.31.
Version 16.7.21.0
- Compatibilité vérifiée avec le SDK Mintegral 16.7.21.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.0.0.
- SDK Mintegral version 16.7.21.
Version 16.7.11.0
- La compatibilité avec le SDK Mintegral 16.7.11 a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.0.0.
- SDK Mintegral version 16.7.11.
Version 16.6.71.0
- La compatibilité avec le SDK Mintegral 16.6.71 a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.0.0.
- SDK Mintegral version 16.6.71.
Version 16.6.61.0
- 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 Mintegral 16.6.61.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.0.0.
- SDK Mintegral version 16.6.61.
Version 16.6.51.0
- Compatibilité vérifiée avec le SDK Mintegral 16.6.51.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.6.0.
- SDK Mintegral version 16.6.51.
Version 16.6.41.0
- Compatibilité vérifiée avec le SDK Mintegral 16.6.41.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.6.0.
- SDK Mintegral version 16.6.41.
Version 16.6.34.0
- Compatibilité vérifiée avec le SDK Mintegral 16.6.34.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.6.0.
- SDK Mintegral version 16.6.34.
Version 16.6.21.0
- Compatibilité vérifiée avec le SDK Mintegral 16.6.21.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.6.0.
- SDK Mintegral version 16.6.21.
Version 16.5.91.1
- Ajout de la prise en charge des enchères avec le format d'annonce à l'ouverture d'une application.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.6.0.
- SDK Mintegral version 16.5.91.
Version 16.5.91.0
- Compatibilité vérifiée avec le SDK Mintegral 16.5.91.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.6.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.6.0.
- SDK Mintegral version 16.5.91.
Version 16.5.51.0
- Compatibilité vérifiée avec le SDK Mintegral 16.5.51.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.3.0
- SDK Mintegral version 16.5.51.
Version 16.5.41.0
- Compatibilité vérifiée avec le SDK Mintegral 16.5.41.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.3.0
- SDK Mintegral version 16.5.41.
Version 16.5.31.0
- Compatibilité vérifiée avec le SDK Mintegral 16.5.31.
- L'adaptateur a été rétabli pour qu'il dépende de la version 22.3.0 du SDK Google Mobile Ads.
- Ajout de la prise en charge de la cascade d'annonces pour le format d'annonce à l'ouverture d'une application.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.3.0
- SDK Mintegral version 16.5.31.
Version 16.5.21.0
- Compatibilité vérifiée avec le SDK Mintegral 16.5.21.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.4.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.4.0.
- SDK Mintegral version 16.5.21.
Version 16.5.11.0
- Ajout de la prise en charge des filigranes pour les annonces associées à des enchères.
- Compatibilité vérifiée avec le SDK Mintegral 16.5.11.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.2.0.
- SDK Mintegral version 16.5.11.
Version 16.4.91.0
- Compatibilité vérifiée avec le SDK Mintegral 16.4.91.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.2.0.
- SDK Mintegral version 16.4.91.
Version 16.4.81.0
- Compatibilité vérifiée avec le SDK Mintegral 16.4.81.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.2.0.
- SDK Mintegral version 16.4.81.
Version 16.4.71.0
- Compatibilité vérifiée avec le SDK Mintegral 16.4.71.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.2.0.
- SDK Mintegral version 16.4.71.
Version 16.4.61.0
- Compatibilité vérifiée avec le SDK Mintegral 16.4.61.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.1.0.
- SDK Mintegral version 16.4.61.
Version 16.4.51.0
- Compatibilité vérifiée avec le SDK Mintegral 16.4.51.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.1.0.
- SDK Mintegral version 16.4.51.
Version 16.4.41.0
- Les bannières s'affichaient dans des tailles incorrectes. Ce problème a été résolu.
- Compatibilité vérifiée avec le SDK Mintegral 16.4.41.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.0.0.
- SDK Mintegral version 16.4.41.
Version 16.4.31.0
- Compatibilité vérifiée avec le SDK Mintegral 16.4.31.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.0.0.
- SDK Mintegral version 16.4.31.
Version 16.4.21.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.
- Compatibilité vérifiée avec le SDK Mintegral 16.4.21.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.0.0.
- SDK Mintegral version 16.4.21.
Version 16.3.91.0
- Compatibilité vérifiée avec le SDK Mintegral 16.3.91.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.5.0
- SDK Mintegral version 16.3.91.
Version 16.3.81.0
- Compatibilité vérifiée avec le SDK Mintegral 16.3.81.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.5.0
- SDK Mintegral version 16.3.81.
Version 16.3.71.0
- Compatibilité vérifiée avec le SDK Mintegral 16.3.71.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.5.0
- SDK Mintegral version 16.3.71.
Version 16.3.61.0
- Compatibilité vérifiée avec le SDK Mintegral 16.3.61.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.5.0
- SDK Mintegral version 16.3.61.
Version 16.3.51.1
- Ajout de la compatibilité avec la cascade d'annonces pour les bannières (y compris les annonces MREC), les annonces interstitielles, les annonces avec récompense et les annonces natives.
- 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 Mintegral version 16.3.51.
Version 16.3.51.0
- Compatibilité vérifiée avec le SDK Mintegral 16.3.51.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.4.0
- SDK Mintegral version 16.3.51.
Version 16.3.41.0
- Compatibilité vérifiée avec le SDK Mintegral 16.3.41.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 21.4.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.4.0
- SDK Mintegral version 16.3.41.
Version 16.3.11.0
- La compatibilité avec le SDK Mintegral 16.3.11 a été vérifiée.
- L'adaptateur a été mis à jour pour transférer
onUserEarnedReward()
avant leonAdClosed()
lors de la diffusion d'annonces avec récompense.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.3.0
- SDK Mintegral version 16.3.11.
Version 16.2.61.0
- Version initiale
- Prise en charge des enchères pour les bannières (y compris les annonces MREC), les annonces interstitielles, les annonces avec récompense et les annonces natives.
Conçu et testé avec:
- SDK Google Mobile Ads version 21.3.0
- SDK Mintegral version 16.2.61.