Intégrer InMobi à la médiation

Sélectionnez une plate-forme : Android (bêta) Android iOS Unity Flutter

Ce guide explique comment utiliser GMA Next-Gen SDK pour charger et afficher des annonces InMobi à l'aide de la médiation AdMob. Il aborde notamment les intégrations en cascade et par enchères. Vous apprendrez à ajouter InMobi à la configuration de médiation d'un bloc d'annonces et à intégrer le SDK InMobi et son adaptateur dans une application Android.

Intégrations et formats d'annonces pris en charge

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

Conditions requises

• Niveau d'API Android 24 ou supérieur

• [Pour les enchères] Pour intégrer tous les formats d'annonces compatibles avec le mode enchères, utilisez l'adaptateur InMobi 10.6.3.0 ou version ultérieure (la dernière version est recommandée).

• Nouveautés de la chaîne GMA Next-Gen SDK

• Avoir suivi le guide de démarrage sur la médiation

Étape 1 : Configurer les paramètres dans l'UI InMobi

Créez un compte InMobi.

Une fois votre compte validé, connectez-vous.

Ajouter une application

Pour ajouter votre application au tableau de bord InMobi, cliquez sur Inventory > Settings (Inventaire > Paramètres d'inventaire).

Cliquez sur Add Inventory (Ajouter un inventaire), puis sélectionnez le canal Mobile App (Application mobile) dans le menu déroulant.

Dans la barre de recherche, commencez à saisir l'URL de publication de votre application, puis sélectionnez-la parmi les résultats suggérés. Cliquez sur Continuer.

Si votre application n'est pas publiée, cliquez sur Link manually (Associer manuellement) et saisissez les informations requises. Cliquez sur Continuer.

Vérifiez les paramètres App & Website Compliance (Conformité des applications et des sites Web), puis cliquez sur Save and Create Placements (Enregistrer et créer des emplacements).

Emplacements

Une fois votre inventaire configuré, le système vous redirige vers le workflow de création d'emplacements.

Une fois l'emplacement créé, ses détails s'affichent. Notez l'ID de l'emplacement, car vous en aurez besoin pour configurer votre bloc d'annonces AdMob.

ID de compte

L'ID de votre compte InMobi est disponible sous Finance > Payment Settings > Payment Information (Finances > Paramètres de paiement > Informations de paiement).

Localiser la clé API Reporting InMobi

Mettre à jour votre fichier app-ads.txt

Le fichier Authorized Sellers for Apps (app-ads.txt) est une initiative de l'IAB Tech Lab visant à garantir que l'inventaire publicitaire de votre application est vendu uniquement par l'intermédiaire des canaux de distribution que vous avez 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, configurez un fichier app-ads.txt pour votre application.

Pour implémenter app-ads.txt pour InMobi, ajoutez votre extrait de code personnalisé.

Activer le mode test

Vous pouvez activer le mode test pour votre emplacement sur toutes les impressions en direct ou sur certains appareils de test uniquement.

Étape 2 : Configurer la demande InMobi dans l'UI AdMob

Configurer les paramètres de médiation pour votre bloc d'annonces

Vous devez ajouter InMobi à la configuration de médiation de votre bloc d'annonces.

Commencez par vous connecter à votre compte AdMob. Ensuite, accédez à l'onglet Médiation. Si vous souhaitez modifier un groupe de médiation existant, cliquez sur son nom pour l'éditer, puis passez à la section Ajouter InMobi comme source d'annonces.

Pour créer un groupe de médiation, sélectionnez Créer un groupe de médiation.

Saisissez votre format d'annonce et votre plate-forme, puis cliquez sur Continuer.

Attribuez un nom à votre groupe de médiation et sélectionnez les zones géographiques à cibler. Ensuite, définissez l'état du groupe de médiation sur Activé, puis cliquez sur Ajouter des blocs d'annonces.

Associez ce groupe de médiation à un ou plusieurs de vos blocs d'annonces AdMob existants. Cliquez ensuite sur OK.

La fiche "Blocs d'annonces" doit maintenant être remplie avec les blocs d'annonces que vous avez sélectionnés :

Ajouter InMobi comme source d'annonces

Enchères

Dans la fiche Enchères de la section Sources d'annonces, sélectionnez Ajouter une source d'annonce. Sélectionnez ensuite InMobi (SDK).

Cliquez sur Signer un contrat partenaire et configurer un partenariat Bidding avec InMobi.



Cliquez sur Accepter et continuer, puis sur Continuer.



Si vous avez déjà une mise en correspondance pour InMobi, vous pouvez la sélectionner. Sinon, cliquez sur Ajouter un mappage.



Ensuite, saisissez l'ID de compte et l'ID d'emplacement obtenus dans la section précédente. Cliquez ensuite sur OK.

Cascade

Dans la fiche Cascade de la section Sources d'annonces, sélectionnez Ajouter une source d'annonces.

Sélectionnez InMobi, puis activez l'option Optimiser. Saisissez le nom d'utilisateur et la clé API obtenus dans la section précédente pour configurer l'optimisation de la source d'annonces pour InMobi. Saisissez ensuite une valeur d'eCPM pour InMobi, puis cliquez sur Continuer.



Si vous avez déjà une mise en correspondance pour InMobi, vous pouvez la sélectionner. Sinon, cliquez sur Ajouter un mappage.

Ensuite, saisissez l'ID de compte et l'ID d'emplacement obtenus dans la section précédente. Cliquez ensuite sur OK.

Ajouter InMobi à la liste des partenaires publicitaires soumis au RGPD et aux réglementations des États américains

Suivez les étapes décrites dans Paramètres liés aux réglementations européennes et Paramètres liés aux réglementations des États américains pour ajouter InMobi à la liste des partenaires publicitaires concernés dans l'UI AdMob.

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

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

Dans le fichier Gradle au niveau de l'application, ajoutez les dépendances et configurations d'implémentation suivantes :

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:inmobi:11.1.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:inmobi:11.1.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Intégration manuelle

1. Téléchargez le SDK InMobi pour Android, extrayez le fichier InMobiSDK.aar du dossier libs, puis ajoutez-le à votre projet.

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

3. InMobi exige également l'inclusion d'autres dépendances. Pour en savoir plus, veuillez consulter la documentation InMobi.

Étape 4 : Implémenter les paramètres de confidentialité sur le SDK InMobi

Consentement des utilisateurs de l'UE et RGPD

Pour respecter les Règles relatives au consentement de l'utilisateur dans l'UE de Google, vous devez fournir certaines informations à vos utilisateurs situés 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 à des fins de 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 l'utilisateur à ces réseaux.

Dans la version 7.1.0.0, l'adaptateur InMobi a ajouté la classe InMobiConsent qui permet de transmettre des informations sur le consentement à InMobi. L'exemple de code suivant appelle updateGDPRConsent() sur la classe InMobiConsent. Si vous choisissez d'appeler cette méthode, nous vous recommandons de le faire avant de demander des annonces avec GMA Next-Gen SDK.

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception)
}

InMobiConsent.updateGDPRConsent(consentObject)

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception);
}

InMobiConsent.updateGDPRConsent(consentObject);

Pour en savoir plus sur les clés et les valeurs qu'InMobi accepte dans cet objet de consentement, consultez les détails de l'implémentation du RGPD par InMobi.

Lois sur la confidentialité des É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 du "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 propres à chacun pour assurer la conformité.

Dans la version 10.5.7.1, l'adaptateur InMobi a ajouté la prise en charge de la lecture de la chaîne de confidentialité IAB pour les États-Unis à partir des préférences partagées. Suivez les instructions de la documentation sur les lois sur la confidentialité dans les États américains pour définir la chaîne de confidentialité aux États-Unis dans les préférences partagées.

Consultez également la documentation sur la loi CCPA d'InMobi pour obtenir des consignes sur l'activation des paramètres CCPA dans le tableau de bord InMobi.

Étape 5 : Code supplémentaire requis

Aucun code supplémentaire n'est requis pour l'intégration d'InMobi.

Étape 6 : Testez votre implémentation

Activer les annonces test

Enregistrez votre appareil de test pour AdMob et activez le mode test dans l'UI InMobi.

Vérifier la réception des annonces test

Pour vérifier que vous recevez des annonces test d'InMobi, activez le test d'une seule source d'annonces dans l'inspecteur d'annonces en utilisant la ou les sources d'annonces InMobi (enchères) et InMobi (cascade).

Étapes facultatives

Autorisations

Pour des performances optimales, InMobi recommande d'ajouter les autorisations facultatives suivantes au fichier AndroidManifest.xml de votre application.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

Paramètres spécifiques au réseau

L'adaptateur InMobi accepte des paramètres de requête supplémentaires qui peuvent lui être transmis sous forme de bundle Android. L'adaptateur recherche les clés suivantes dans le bundle :

Voici un exemple de code montrant comment définir ces paramètres de demande d'annonce :

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44)
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE)
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44);
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE);
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter.class, extras)
   .build();

• Remplacez AD_UNIT_ID par l'ID de votre bloc d'annonces.

• Remplacez AREA_CODE_VALUE par l'indicatif régional.

Utiliser des annonces natives

Affichage des annonces

L'adaptateur InMobi renvoie ses annonces natives sous forme d'objets NativeAd. Il renseigne les descriptions des champs des annonces natives pour un NativeAd.

¹ L'adaptateur InMobi 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.

Suivi des impressions et des clics

GMA Next-Gen SDK utilise les rappels du SDK InMobi pour le suivi des impressions et des clics. Les rapports des deux tableaux de bord devraient donc correspondre, avec peu ou pas de différences.

Codes d'erreur

Si l'adaptateur ne reçoit pas d'annonce d'InMobi, les éditeurs peuvent vérifier l'erreur sous-jacente dans la réponse d'annonce à l'aide de ResponseInfo.getAdSourceResponses() dans les classes suivantes :

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

Voici les codes et les messages associés que génère l'adaptateur InMobi lorsque le chargement d'une annonce échoue :