Intégrer i-mobile à la médiation

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

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

L'interface du tableau de bord i-mobile utilise du texte en japonais pour les libellés, les boutons et les descriptions. Les captures d'écran de ce guide n'ont pas été traduites. Toutefois, dans les descriptions et les instructions de ce guide, les libellés et les boutons sont traduits avec leur équivalent en anglais entre parenthèses.

Intégrations et formats d'annonces pris en charge

L'adaptateur de médiation pour i-mobile offre les fonctionnalités suivantes :

Conditions requises

• Niveau d'API Android 24 ou supérieur

• Dernière versionGMA Next-Gen SDK

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

Étape 1 : Configurer les paramètres dans l'UI i-mobile

Inscrivez-vous ou connectez vous à votre compte i-mobile.

Ajoutez votre application au tableau de bord i-mobile en cliquant sur l'onglet サイト／アプリ管理 (Site/Application Management) , puis sur le bouton correspondant à la plate-forme de votre application.

Remplissez le formulaire, puis cliquez sur le bouton 新規登録 (Sign up).

Pour créer un espace publicitaire, sélectionnez votre application dans l'onglet サイト／アプリ管理 (Site/Application Management).

Accédez à l'onglet 広告スポット管理 (Ad Spot Management) , puis cliquez sur le bouton 新規広告スポット (New Ad Spot).

Remplissez ensuite le formulaire en indiquant le 広告スポット名 (nom de l'espace publicitaire), 広告スポットサイズ (taille de l'espace publicitaire) et d'autres informations. Cliquez ensuite sur le bouton 新規登録 (Sign up).

Votre nouvel espace publicitaire est prêt. Pour afficher ses informations d'intégration, cliquez sur le bouton アプリ設定取得 (Get App settings).

Notez le パブリッシャーID (ID éditeur), le メディアID (ID élément multimédia), et le スポットID (ID espace). Vous aurez besoin de ces paramètres ultérieurement pour configurer i-mobile pour la médiation dans l'UI AdMob.

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 i-mobile, consultez leurs questions fréquentes.

Étape 2 : Configurer la demande i-mobile dans l'UI AdMob

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

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

Tout d'abord, connectez-vous à votre compte AdMob. Accédez ensuite à l'onglet Médiation. Si vous souhaitez modifier un groupe de médiation existant, cliquez sur son nom pour le modifier, puis passez à Ajouter i-mobile comme source d'annonces.

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

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

Attribuez un nom à votre groupe de médiation, puis sélectionnez les zones géographiques à cibler. Définissez ensuite 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 des blocs d'annonces doit maintenant être remplie avec les blocs d'annonces que vous avez sélectionnés :

Ajouter i-mobile comme source d'annonces

Étape 3 : Importer le SDK et l'adaptateur i-mobile

Intégration à 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://imobile.github.io/adnw-sdk-android")
    }
  }
}

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.25.0-beta01")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

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.25.0-beta01'
    implementation 'com.google.ads.mediation:imobile:2.3.2.1'
}

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 la dernière version du SDK i-mobile, extrayez le fichier android-ad-sdk.aar dans le dossier sdk, puis ajoutez-le à votre projet.

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

Étape 4 : Ajouter le code requis

Charger une annonce avec le contexte d'activité

Transmettez le contexte Activity lors du chargement des formats d'annonces bannière, interstitielle, avec récompense et native.Sans contexte d'activité, le chargement de l'annonce échouera.

Étape 5 : Tester votre implémentation

Activer les annonces test

Assurez-vous d' enregistrer votre appareil de test pour AdMob. i-mobile fournit des ID espace, des ID élément multimédia, et des ID éditeur de test que vous pouvez trouver ici.

Vérifier la réception des annonces test

Pour vérifier que vous recevez des annonces test d'i-mobile, activez le test d'une seule source d'annonces dans l'inspecteur d'annonces en utilisant la ou les sources d'annonces i-mobile (cascade).

Étapes facultatives

Utiliser des annonces natives

Rendu des annonces

L'adaptateur i-mobile remplit les descriptions de champs avancés suivantes pour les annonces natives pour un NativeAd.

¹ Pour les annonces natives, le SDK i-mobile ne fournit pas d'actif d'icône d'application. L'adaptateur i-mobile remplit plutôt l'icône de l'application avec une image transparente.

Codes d'erreur

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

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