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:

Intégration
Enchères  1
Cascade  2.
Formats
Ouverture de l'application
Bannière
Interstitiel
Avec récompense
Interstitiel avec récompense
Natif
1 L'intégration des enchères est en cours en version bêta fermée (sauf pour le format d'annonce native en bêta ouverte).

2 L'intégration de Waterfall est bêta fermée.

Conditions requises

  • Niveau d'API Android 21 ou supérieur

Étape 1: Définir des configurations dans l'interface utilisateur de Mintegral

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

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

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

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

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 au composant Image principal de 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.31.0

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

Conçu et testé avec:

  • SDK Google Mobile Ads version 23.2.0.
  • SDK Mintegral version 16.8.31.

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

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

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