Intégrer PubMatic OpenWrap (bêta) à la médiation AdMob

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

Intégrations et formats d'annonces pris en charge

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

¹ L'intégration en cascade est en version alpha.

² Tous les autres formats d'annonces compatibles , à l'exception des bannières, sont en version alpha.

Conditions requises

• Niveau d'API Android 24 ou supérieur

• Dernière version GMA Next-Gen SDK.

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

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

Inscrivez-vous ou connectez-vous à votre compte PubMatic, puis sélectionnez la carte OpenWrap SDK.

Ajouter une application

Accédez à l'onglet Apps (Applications), puis cliquez sur le bouton Add App (Ajouter une application).

Sélectionnez la Platform (Plate-forme), ainsi que l'App Store URL (URL de l'App Store) et l'App Name (Nom de l'application) pour votre application.

Sous Integration Path (Chemin d'intégration), sélectionnez Android (Java / Kotlin) , puis AdMob - SDK Bidding (AdMob – Enchères par SDK) comme Sub-integration Path (Sous-chemin d'intégration). Cliquez ensuite sur le bouton Add App (Ajouter une application).

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.

Avant que votre application ne soit finalisée, les entrées appropriées à ajouter à votre fichier app-ads.txt s'affichent.

Pour en savoir plus sur l'implémentation de app-ads.txt pour PubMatic, consultez Implémenter un fichier app-ads.txt.

ID du profil

Une fois votre application créée, accédez à l'onglet Apps (Applications) et notez l'ID du profil de l'application que vous venez de créer.

Créer un bloc d'annonces

Dans l'onglet Ad Units (Blocs d'annonces), sélectionnez l'application que vous avez créée dans la section précédente, puis cliquez sur le bouton Create Ad Unit (Créer un bloc d'annonces).

Remplissez le formulaire avec les informations de votre bloc d'annonces, puis cliquez sur Save (Enregistrer).

Notez l'ID du bloc d'annonces OpenWrap que vous venez de créer.

Obtenir votre référence éditeur

Accédez au tableau de bord Analytics. Passez la souris sur l'icône de profil et notez votre ID.

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

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

Vous devez ajouter le SDK PubMatic OpenWrap à la configuration de médiation de votre bloc d'annonces.

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

Pour créer un groupe de médiation, sélectionnez Create Mediation Group (Créer un groupe de médiation).

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

Attribuez un nom à votre groupe de médiation et sélectionnez les zones géographiques à cibler. Définissez ensuite l'état du groupe de médiation sur Enabled (Activé), puis cliquez sur Add Ad Units (Ajouter des blocs d'annonces).

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

La carte des blocs d'annonces doit maintenant être remplie avec les blocs d'annonces que vous avez sélectionnés :

Ajouter le SDK PubMatic OpenWrap comme source d'annonces

Enchères

Sous la carte Bidding (Enchères) de la section Ad Sources (Sources d'annonces), sélectionnez Add ad source (Ajouter une source d'annonces). Sélectionnez ensuite PubMatic OpenWrap SDK.

Cliquez sur Acknowledge &agree (Confirmer et accepter), puis sur Save (Enregistrer).



Si vous avez déjà une mise en correspondance pour le SDK PubMatic OpenWrap, vous pouvez la sélectionner. Sinon, cliquez sur Add mapping (Ajouter une mise en correspondance).



Saisissez ensuite l' ID du bloc d'annonces OpenWrap obtenu dans la section précédente. Cliquez ensuite sur Done (OK).

Cascade

Sous la carte Waterfall (Cascade) de la section Ad Sources (Sources d'annonces), sélectionnez Add Ad Source (Ajouter une source d'annonces).

Sélectionnez PubMatic OpenWrap SDK. Saisissez ensuite une valeur d'eCPM pour le SDK PubMatic OpenWrap, puis cliquez sur Continue (Continuer).



Si vous avez déjà une mise en correspondance pour le SDK PubMatic OpenWrap, vous pouvez la sélectionner. Sinon, cliquez sur Add mapping (Ajouter une mise en correspondance).

Saisissez ensuite l' ID du bloc d'annonces OpenWrap obtenu dans la section précédente. Cliquez ensuite sur Done (OK).

Ajouter PubMatic à 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 PubMatic à la liste des partenaires publicitaires concernés dans l'UI AdMob.

Étape 3 : Importer le SDK PubMatic OpenWrap et son adaptateur

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://repo.pubmatic.com/artifactory/public-repos")
    }
  }
}

Ensuite, dans le fichier build.gradle.kts au niveau de l'application, ajoutez les dépendances d'implémentation et les configurations suivantes. Utilisez les dernières versions du SDK PubMatic OpenWrap et de son adaptateur :

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:pubmatic:5.0.0.0")
}

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

Étape 4 : Implémenter les paramètres de confidentialité sur PubMatic

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.

PubMatic lit automatiquement le consentement RGPD défini par les plates-formes de gestion du consentement compatibles avec la spécification de consentement supplémentaire de Google, y compris le SDK UMP. Pour en savoir plus, consultez Transmettre le RGPD et le consentement RGPD.

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

PubMatic lit automatiquement le consentement GPP défini par les plates-formes de gestion du consentement compatibles avec la spécification de consentement supplémentaire de Google, y compris le SDK UMP. Pour en savoir plus, consultez Transmettre le consentement GPP.

Étape 5 : Ajouter le code requis

Aucun code supplémentaire n'est nécessaire pour l'intégration du SDK PubMatic OpenWrap.

Étape 6 : Tester votre implémentation

Activer les annonces test

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

Vérifier la réception des annonces test

Pour vérifier que vous recevez des annonces test du SDK PubMatic OpenWrap, activez le test d'une seule source d'annonces dans l'inspecteur d'annonces en utilisant la ou les sources d'annonces PubMatic OpenWrap.

Étapes facultatives

Annonces natives

Rendu des annonces

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

Codes d'erreur

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

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

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