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

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

Intégrations et formats d'annonces acceptés

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

Conditions requises

• Niveau d'API Android 23 ou supérieur

• [Pour les enchères]: Pour intégrer tous les formats d'annonces compatibles dans les enchères, utilisez l'adaptateur Mintegral 16.5.91.1 ou version ultérieure (dernière version recommandée).

• Dernière version du SDK Google Mobile Ads.

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

Étape 1 : Configurez les paramètres dans l'UI Mintegral

Inscrivez-vous ou connectez-vous à votre compte Mintegral.

Localiser la clé d'application

Accédez à l'onglet APP Setting (Paramètres de l'application) et notez la clé de l'application.

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 blocs d'annonces, puis cliquez sur le bouton Ajouter un emplacement, comme indiqué ci-dessous, pour créer votre emplacement d'annonce.

Saisissez un nom d'emplacement et un format d'annonce.

Sélectionnez Enchères d'en-tête comme type d'enchères. Remplissez le reste du formulaire, puis cliquez sur Enregistrer.

Une fois votre emplacement d'annonce créé, notez l'ID de l'emplacement.

Cliquez sur le menu déroulant 1 bloc d'annonces et notez l'ID du bloc d'annonces.

Trouver votre clé API Reporting Mintegral

Mettre à jour votre fichier app-ads.txt

Authorized Sellers for Apps (app-ads.txt) est une initiative de l'IAB Tech Lab qui vous permet de vendre l'inventaire publicitaire de votre application uniquement par l'intermédiaire de canaux de distribution que vous avez identifiés comme étant autorisés. Pour éviter une perte importante de revenus publicitaires, vous devez implémenter un fichier app-ads.txt. Si vous ne l'avez pas encore fait, créez un fichier app-ads.txt pour Ad Manager.

Pour implémenter app-ads.txt pour Mintegral, consultez Comment app-ads.txt peut aider à lutter contre la fraude publicitaire.

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

Connectez-vous à votre compte Ad Manager.

Ajouter Mintegral dans "Sociétés"

Activer le partage des signaux sécurisés

Partager des signaux sécurisés dans les demandes d'enchères

Autoriser le partage de signaux sécurisés pour les enchères par SDK

Configurer les enchères Mintegral

Configurer la mise en correspondance des blocs d'annonces

Ajouter Mobvista/Mintegral à la liste des partenaires publicitaires pour le RGPD et les réglementations des États américains

Suivez les étapes décrites dans les sections Paramètres liés aux réglementations européennes et Paramètres liés aux réglementations dans les États américains pour ajouter Mobvista/Mintegral à la liste des partenaires publicitaires liés aux réglementations européennes et dans les États américains dans l'UI Ad Manager.

Étape 3 : Importer le SDK et l'adaptateur Mintegral

Intégration d'Android Studio (recommandée)

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

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

Intégration manuelle

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

2. Accédez aux artefacts de l'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émenter les paramètres de confidentialité sur le SDK Mintegral

Consentement dans l'UE et RGPD

Pour respecter les règles de Google relatives au consentement de l'utilisateur dans l'UE, vous devez fournir certaines informations à vos utilisateurs dans l'Espace économique européen (EEE), au Royaume-Uni et en Suisse, et obtenir leur consentement pour l'utilisation de cookies ou d'autres méthodes de stockage local lorsque la loi l'exige, ainsi que pour la collecte, le partage et l'utilisation de données à caractère personnel pour la personnalisation des annonces. 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). Il vous incombe de vérifier que le consentement est transmis à chaque source d'annonces de votre chaîne de médiation. Google ne peut pas transmettre automatiquement le choix de consentement de l'utilisateur à ces réseaux.

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

L'exemple de code suivant montre comment transmettre des informations sur le consentement au SDK Mintegral. Ces options doivent être définies avant d'initialiser le SDK Google Mobile Ads pour s'assurer qu'elles sont correctement transmises 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)

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

Lois sur la confidentialité dans les États américains

Les lois sur la confidentialité des États américains exigent d'offrir aux utilisateurs le droit de s'opposer à la "vente" de leurs "informations personnelles" (selon la définition de ces termes par la loi). Cette possibilité doit être proposée via un lien bien visible indiquant "Do Not Sell My Personal Information" (Ne pas vendre mes informations personnelles) et figurant sur la page d'accueil de l'entreprise (le "vendeur"). Le guide de conformité aux lois sur la confidentialité des États américains vous permet d'activer le traitement restreint des données pour la diffusion d'annonces Google, mais Google ne peut pas appliquer ce paramètre à chaque réseau publicitaire de votre chaîne de médiation. Vous devez donc identifier chaque réseau publicitaire de votre chaîne de médiation susceptible de participer à la vente d'informations personnelles et suivre les conseils de chacun de ces réseaux pour assurer la conformité.

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

L'exemple de code suivant montre comment transmettre des informations sur le consentement au SDK Mintegral. Si vous devez appeler cette méthode, faites-le après avoir initialisé 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)

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

Étape 5 : Ajoutez le code requis

Aucun code supplémentaire n'est requis pour l'intégration de Mintegral.

Étape 6 : Tester votre implémentation

Activer les annonces tests

Assurez-vous d'enregistrer votre appareil de test pour Ad Manager.

Pour obtenir des annonces tests Mintegral pour les formats de bannière, interstitiel, avec récompense et natif, Mintegral recommande d'utiliser les clés d'application, les ID d'application, les ID d'emplacement et les ID de bloc d'annonces fournis sur la page ID de test Mintegral.

Valider les annonces tests

Pour vérifier que vous recevez des annonces tests de Mintegral, activez le test d'une source d'annonces spécifique dans l'inspecteur d'annonces à l'aide des sources d'annonces Mintegral (enchères) et Mintegral (cascade).

Étapes facultatives

Ajouter Mintegral à la liste des partenaires publicitaires CCPA

Suivez les étapes décrites dans Paramètres concernant la loi CCPA pour ajouter Mintegral à la liste des partenaires publicitaires conformes à la loi CCPA dans l'UI Ad Manager.

Annonces natives

Affichage des annonces

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

¹ L'adaptateur Mintegral ne fournit pas d'accès direct au composant image principal de ses annonces natives. L'adaptateur remplit plutôt MediaView avec une vidéo ou une image.

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir d'annonce de Mintegral, vous pouvez vérifier l'erreur sous-jacente à partir de la réponse de l'annonce à l'aide de ResponseInfo.getAdapterResponses() sous 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 parvient pas à se charger :

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

Version 16.9.91.1

• Suppression de la vérification de la taille de l'adaptateur pour les annonces RTB de type bannière.

Conçu et testé avec :

• SDK Google Mobile Ads version 24.5.0.
• Version 16.9.91 du SDK Mintegral.

Version 16.9.91.0

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

Conçu et testé avec :

• SDK Google Mobile Ads version 24.5.0.
• Version 16.9.91 du SDK Mintegral.

Version 16.9.81.0

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

Conçu et testé avec :

• SDK Google Mobile Ads version 24.4.0.
• Version 16.9.81 du SDK Mintegral.

Version 16.9.71.0

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

Conçu et testé avec :

• SDK Google Mobile Ads version 24.2.0.
• Version 16.9.71 du SDK Mintegral.

Version 16.9.61.0

• Ajout de la prise en charge du transfert des informations COPPA au SDK Mintegral.
• Compatibilité vérifiée avec le SDK Mintegral 16.9.61.

Conçu et testé avec :

• SDK Google Mobile Ads version 24.1.0.
• Version 16.9.61 du SDK Mintegral.

Version 16.9.51.0

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

Conçu et testé avec :

• SDK Google Mobile Ads version 24.0.0.
• Version 16.9.51 du SDK Mintegral.

Version 16.9.41.1

• Le niveau d'API Android minimal requis est désormais 23.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 24.0.0.

Conçu et testé avec :

• SDK Google Mobile Ads version 24.0.0.
• Version 16.9.41 du SDK Mintegral.

Version 16.9.41.0

• L'adaptateur a été mis à jour pour initialiser le SDK Mintegral sur un thread d'arrière-plan.
• L'adaptateur a été mis à jour pour utiliser le contexte d'activité transmis au moment de l'affichage des annonces App Open.
• Compatibilité vérifiée avec le SDK Mintegral 16.9.41.

Conçu et testé avec :

• SDK Google Mobile Ads version 23.6.0.
• Version 16.9.41 du SDK Mintegral.

Version 16.8.61.0

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

Conçu et testé avec :

• SDK Google Mobile Ads version 23.3.0.
• Version 16.8.61 du SDK Mintegral.

Version 16.8.51.0

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

Conçu et testé avec :

• SDK Google Mobile Ads version 23.3.0.
• Version 16.8.51 du SDK Mintegral.

Version 16.8.41.0

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

Conçu et testé avec :

• SDK Google Mobile Ads version 23.3.0.
• Version 16.8.41 du SDK 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.
• Version 16.8.31 du SDK 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.
• Version 16.8.11 du SDK Mintegral.

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.
• Version 16.7.91 du SDK 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.
• Version 16.7.81 du SDK Mintegral.

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.
• Version 16.7.71 du SDK Mintegral.

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.
• Version 16.7.61 du SDK Mintegral.

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.
• Version 16.7.51 du SDK Mintegral.

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.
• Version 16.7.41 du SDK Mintegral.

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.
• Version 16.7.31 du SDK Mintegral.

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.
• Version 16.7.21 du SDK Mintegral.

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.
• Version 16.7.11 du SDK Mintegral.

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.
• Version 16.6.71 du SDK Mintegral.

Version 16.6.61.0

• La version minimale requise du SDK Google Mobile Ads est désormais 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.
• Version 16.6.61 du SDK Mintegral.

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.
• Version 16.6.51 du SDK Mintegral.

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.
• Version 16.6.41 du SDK Mintegral.

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.
• Version 16.6.34 du SDK Mintegral.

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.
• Version 16.6.21 du SDK Mintegral.

Version 16.5.91.1

• Ajout de la prise en charge des enchères pour le format d'annonce d'ouverture d'application.

Conçu et testé avec :

• SDK Google Mobile Ads version 22.6.0.
• Version 16.5.91 du SDK Mintegral.

Version 16.5.91.0

• Compatibilité vérifiée avec le SDK Mintegral 16.5.91.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 22.6.0.

Conçu et testé avec :

• SDK Google Mobile Ads version 22.6.0.
• Version 16.5.91 du SDK Mintegral.

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.
• Version 16.5.51 du SDK Mintegral.

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.
• Version 16.5.41 du SDK Mintegral.

Version 16.5.31.0

• Compatibilité vérifiée avec le SDK Mintegral 16.5.31.
• L'adaptateur est revenu à la version 22.3.0 du SDK Google Mobile Ads.
• Ajout de la prise en charge de la cascade pour le format d'annonce application ouverte.

Conçu et testé avec :

• SDK Google Mobile Ads version 22.3.0.
• Version 16.5.31 du SDK Mintegral.

Version 16.5.21.0

• Compatibilité vérifiée avec le SDK Mintegral 16.5.21.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 22.4.0.

Conçu et testé avec :

• SDK Google Mobile Ads version 22.4.0.
• Version 16.5.21 du SDK Mintegral.

Version 16.5.11.0

• Ajout de la prise en charge des filigranes pour les annonces aux 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.
• Version 16.5.11 du SDK Mintegral.

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.
• Version 16.4.91 du SDK Mintegral.

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.
• Version 16.4.81 du SDK Mintegral.

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.
• Version 16.4.71 du SDK Mintegral.

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.
• Version 16.4.61 du SDK Mintegral.

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.
• Version 16.4.51 du SDK Mintegral.

Version 16.4.41.0

• Correction d'un problème qui affichait les bannières publicitaires avec des tailles incorrectes.
• Compatibilité vérifiée avec le SDK Mintegral 16.4.41.

Conçu et testé avec :

• SDK Google Mobile Ads version 22.0.0.
• Version 16.4.41 du SDK Mintegral.

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.
• Version 16.4.31 du SDK Mintegral.

Version 16.4.21.0

• Adaptateur mis à jour pour utiliser la nouvelle classe VersionInfo.
• La version minimale requise du SDK Google Mobile Ads est désormais 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.
• Version 16.4.21 du SDK Mintegral.

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.
• Version 16.3.91 du SDK Mintegral.

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.
• Version 16.3.81 du SDK Mintegral.

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.
• Version 16.3.71 du SDK Mintegral.

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.
• Version 16.3.61 du SDK Mintegral.

Version 16.3.51.1

• Ajout de la prise en charge de la cascade pour les formats d'annonces bannière (y compris MREC), interstitiel, avec récompense et natif.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 21.5.0.

Conçu et testé avec :

• SDK Google Mobile Ads version 21.5.0.
• Version 16.3.51 du SDK Mintegral.

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.
• Version 16.3.51 du SDK Mintegral.

Version 16.3.41.0

• Compatibilité vérifiée avec le SDK Mintegral 16.3.41.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 21.4.0.

Conçu et testé avec :

• SDK Google Mobile Ads version 21.4.0.
• Version 16.3.41 du SDK Mintegral.

Version 16.3.11.0

• Compatibilité vérifiée avec le SDK Mintegral 16.3.11.
• L'adaptateur a été mis à jour pour transférer onUserEarnedReward() avant onAdClosed() lors de l'affichage d'annonces avec récompense.

Conçu et testé avec :

• SDK Google Mobile Ads version 21.3.0.
• Version 16.3.11 du SDK Mintegral.

Version 16.2.61.0

• Version initiale
• Ajout de la prise en charge des enchères pour les formats d'annonces bannière (y compris MREC), interstitiel, avec récompense et natif.

Conçu et testé avec :

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