Intégrer Mintegral aux enchères (version bêta)

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

Intégrations et formats d'annonces compatibles

L'adaptateur de médiation Ad Manager pour Mintegral offre les fonctionnalités suivantes:

Intégration
Enchères		^1
Cascade		^2
Formats
Ouverture de l'application	^1  ^2
Bannière
Interstitiel
Accordé
Interstitiel avec récompense
Natif	^1  ^3

¹ L'intégration des enchères est en version bêta fermée.

² L'intégration de Waterfall est en version bêta fermée.

Conditions requises

• API Android niveau 21 ou supérieur

• Dernier SDK Google Mobile Ads

• Suivez le guide de démarrage sur la médiation.

Étape 1: Définissez les 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.

Notez l'ID d'application de votre application.

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.

Renseignez les champs Nom d'emplacement et Format de l'annonce.

Important :Pour le format d'annonce native, sélectionnez Native (affichage personnalisé) comme format d'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.

Cliquez sur la liste déroulante 1 bloc d'annonces et notez l'ID du bloc d'annonces.

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.

Important :Ciblez le bloc d'annonces sélectionné selon au moins un groupe de rendement. LeApp ID and App Key doit être associé à l'application ciblée, comme dans l'Mintegral UI.

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.

Important : App ID and App Key doit être associé à l'application ciblée, comme dans l'Mintegral UI.

Ajouter Mintegral à la liste des partenaires publicitaires liés au RGPD et aux réglementations dans les États américains

Important :Vérifiez que vous disposez de l'autorisation Gestion des comptes pour terminer la configuration du consentement dans l'UE, du RGPD, du CPRA et de la plate-forme de messagerie des utilisateurs. Pour en savoir plus, consultez Gérer l'accès des utilisateurs à votre compte.

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 et l'adaptateur Mintegral

Remarque :Si vous n'intégrez pas les versions compatibles du SDK Mintegral et Google Mobile Ads, vous risquez de rencontrer des problèmes de compilation.

Intégration d'Android Studio (recommandé)

Dans le fichier settings.gradle.kts au niveau du projet, ajoutez les dépôts suivants:

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 les dépendances et configurations d'implémentation suivantes. Utilisez les dernières versions du SDK Mintegral et de son adaptateur:

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

Intégration manuelle

1. Pour inclure le SDK Mintegral, accédez au SDK Mintegral pour Android.

2. Accédez aux artefacts d'adaptateur Mintegral dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez le fichier .aar de l'adaptateur Mintegral et ajoutez-le à votre projet.

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

Consentement des utilisateurs 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 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.

Le SDK Mintegral inclut la méthode setConsentStatus pour transmettre des informations de consentement au SDK Mintegral.

L'exemple de code suivant montre comment transmettre des informations de consentement au SDK Mintegral. Vous devez définir ces options avant d'initialiser le SDK Google Mobile Ads pour vous assurer qu'elles sont correctement transmises 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)

Pour en savoir plus, consultez la documentation de Mintegral sur la confidentialité.

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

Le SDK Mintegral inclut la méthode setDoNotTrackStatus pour transmettre des informations de consentement au SDK Mintegral.

L'exemple de code suivant montre comment transmettre des informations de consentement au SDK Mintegral. Si vous devez appeler cette méthode, appelez-laaprè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)

Pour en savoir plus, consultez la documentation de Mintegral sur la confidentialité.

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

Important :Désactivez le mode test pour Ad Manager etMintegral avant de publier votre application.

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 CCPA

Suivez la procédure décrite dans Paramètres concernant la loi CCPA pour ajouter Mintegral à la liste des partenaires publicitaires CCPA dans l'Ad Manager UI.

Annonces natives

Rendu des annonces

L'adaptateur Mintegral renvoie ses annonces natives sous forme d'objets NativeAd . Elle renseigne les champs suivants pour NativeAd.

Champ	Assets toujours inclus par l'adaptateur Mintegral
Titre
Images	1
Corps
Icon
Incitation à l'action
Star rating [Note]
Stocker
Prix
Annonceur

¹ L'adaptateur Mintegral ne fournit pas d'accès direct à l'asset image principal pour ses annonces natives. Au lieu de cela, l'adaptateur insère une vidéo ou une image dans l'élément MediaView .

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 à l'aide de ResponseInfo.getAdapterResponse() 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 lorsqu'une annonce ne se charge pas:

Code d'erreur	Domaine	Motif
101	com.google.ads.mediation.mintegral	Paramètres serveur non valides (ID d'application ou 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".
101	com.google.mediation.mintegral	Paramètres serveur non valides (ID d'application ou d'emplacement manquant, par exemple).
102	com.google.mediation.mintegral	Le SDK Mintegral a renvoyé une erreur "Pas de remplissage".
103	com.google.mediation.mintegral	Le SDK Mintegral n'a pas réussi à afficher une annonce.
104	com.google.mediation.mintegral	La taille d'annonce demandée ne correspond pas à une taille de bannière prise en charge par Mintegral.

Journal des modifications de l'adaptateur de médiation Android Mintegral

Version 16.6.51.0

• Compatibilité validé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é validé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é validé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é validé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 pour 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é validé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é validé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é validée avec le SDK Mintegral 16.5.31.
• L'adaptateur a été rétabli pour qu'il dépende du SDK Google Mobile Ads version 22.3.0.
• Ajout de la compatibilité avec 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é validé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 d'enchères.
• Compatibilité validé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é validé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é validé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é validé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é validé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

• Correction d'un problème qui entraînait l'affichage des bannières avec des tailles incorrectes.
• Compatibilité validé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é validé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

• 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.
• Compatibilité validé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é validé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é validé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é validé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 les cascades d'annonces pour les bannières (y compris MREC), les interstitiels, 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é validé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

• Compatibilité validée avec le SDK Mintegral 16.3.11.
• Mise à jour de l'adaptateur pour transférer onUserEarnedReward() avant onAdClosed() 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
• Les enchères sont désormais compatibles avec les formats d'annonces de type bannière (y compris MREC), interstitiels, avec récompense et natives.

Conçu et testé avec:

• SDK Google Mobile Ads version 21.3.0.
• SDK Mintegral version 16.2.61.