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

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:

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

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.

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

Étape 2: Configurez la demande Mintegral dans Ad Manager l'UI

Connectez-vous à votre compte Ad Manager.

Ajouter Mintegral "Entreprises"

Activer le partage des signaux sécurisés

Configurer Mintegral les enchères

Configurer la mise en correspondance des blocs d'annonces

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

Intégration manuelle

1. Pour inclure le SDK Mintegral, accédez à la page SDK Mintegral pour Android.

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

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

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

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.

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

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 concernant le 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

¹ L'adaptateur Mintegral 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:

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

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

• Compatibilité vérifiée avec le SDK Mintegral 16.6.71.

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

• La compatibilité avec le SDK Mintegral 16.4.61 a été vérifiée.

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