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 display 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 :

Intégration
Enchères
Cascade	^1
Formats
Annonce à l'ouverture
Bannière
Interstitiel
Accordé
Interstitiel avec récompense
Natif

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

Prérequis

Avant de continuer, vérifiez les points suivants :

• Niveau d'API Android 24 ou version ultérieure.

• Dernière version de GMA Next-Gen SDK.

• Configurez la médiation AdMob.

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

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

Ajouter une application

Accédez à l'onglet Applications, puis cliquez sur le bouton Ajouter une application.

Sélectionnez la plate-forme, ainsi que l'URL du magasin d'applications et le nom de l'application.

Sous Chemin d'intégration, sélectionnez Android (Java/Kotlin), puis AdMob – Enchères par SDK comme Chemin d'intégration secondaire. Cliquez ensuite sur le bouton 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 de finaliser votre application, vous verrez les entrées appropriées à ajouter à votre app-ads.txt.

Pour en savoir plus sur l'implémentation de app-ads.txt pour PubMatic, consultez How to Implement app-ads.txt (en anglais).

ID du profil

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

Créer un bloc d'annonces

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

Remplissez le formulaire en indiquant les détails de votre bloc d'annonces, puis cliquez sur 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. Pointez 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 de votre bloc d'annonces

Vous devez ajouter le SDK PubMatic OpenWrap à la configuration de la médiation pour 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 à l'étape Ajouter le SDK PubMatic OpenWrap en tant que 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. 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 contenir les blocs d'annonces que vous avez sélectionnés :

Ajouter le SDK PubMatic OpenWrap en tant que source d'annonce

Enchères

Dans la section Sources d'annonces, recherchez la fiche Enchères, puis sélectionnez Ajouter une source d'annonces. Sélectionnez ensuite SDK PubMatic OpenWrap.

Cliquez sur Confirmer et accepter, puis sur Enregistrer.



Si vous disposez déjà d'une mise en correspondance pour le SDK PubMatic OpenWrap, vous pouvez la sélectionner. Sinon, cliquez sur Ajouter une mise en correspondance.



Ensuite, saisissez l'ID du bloc d'annonces OpenWrap obtenu dans la section précédente. Cliquez ensuite sur OK.

Important : La référence éditeur OpenWrap et l'ID de profil OpenWrap doivent être associés à l'application cible, comme dans l'UI du SDK PubMatic OpenWrap.

Cascade

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

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

Remarque : Vous ne devez configurer l'optimisation des sources d'annonces qu'une seule fois par réseau.

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



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

Important : La référence éditeur OpenWrap et l'ID de profil OpenWrap doivent être associés à l'application cible, comme dans l'UI du SDK PubMatic OpenWrap.

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

Important : Vérifiez que vous disposez de l'autorisation Gestion du compte pour configurer le consentement pour l'UE et le RGPD, les réglementations des États américains et la plate-forme User Messaging Platform. Pour en savoir plus, consultez Gérer l'accès des utilisateurs à votre compte.

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 et l'adaptateur PubMatic OpenWrap

Remarque : Si les versions des SDK PubMatic OpenWrap et Google Mobile Ads ne sont pas compatibles, vous risquez de rencontrer des problèmes de compilation.

Intégration d'Android Studio (recommandé)

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 et configurations d'implémentation suivantes. Utilisez les dernières versions du SDK et de l'adaptateur PubMatic OpenWrap :

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:pubmatic:5.4.1.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émentez les paramètres de confidentialité sur PubMatic

Pour respecter les règles de Google relatives au consentement de l'utilisateur dans l'UE, vous devez communiquer certaines informations à vos utilisateurs dans l'Espace économique européen (EEE), au Royaume-Uni et en Suisse. Vous devez également obtenir leur consentement pour l'utilisation de cookies ou d'autres types 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.

La version 4.7.0.0 et les versions ultérieures de l'adaptateur Android du SDK PubMatic OpenWrap permettent de transmettre les signaux de consentement RGPD des plates-formes de gestion du consentement qui s'intègrent au Transparency and Consent Framework (TCF) de l'IAB au SDK PubMatic OpenWrap. 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 : Testez votre implémentation

Activer les annonces test

Enregistrez votre appareil de test pour AdMob.

Important : Désactivez le mode test pour AdMob et le SDK PubMatic OpenWrap avant de publier votre application.

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.

Champ	Composants toujours inclus par l'adaptateur PubMatic
Titre
Image
Body
Icône
Incitation à l'action
Note
Magasin
Prix
Annonceur

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 :

Code d'erreur	Domaine	Motif
101	com.google.ads.mediation.pubmatic	La configuration du serveur ne comporte pas de référence éditeur requise.
102	com.google.ads.mediation.pubmatic	Le format d'annonce n'est pas compatible avec PubMatic ou est manquant dans les données de signal RTB.
103	com.google.ads.mediation.pubmatic	Échec de la présentation d'une annonce, car elle n'était pas prête.
104	com.google.ads.mediation.pubmatic	ID de profil manquant ou non valide.
105	com.google.ads.mediation.pubmatic	ID de bloc d'annonces manquant ou vide.
106	com.google.ads.mediation.pubmatic	L'annonce avec récompense renvoyée est nulle.
107	com.google.ads.mediation.pubmatic	Taille de bannière non valide.
1001-5002	Envoyé par le SDK PubMatic	Le SDK PubMatic a renvoyé une erreur. Pour en savoir plus, consultez la documentation de PubMatic.

Journal des modifications de l'adaptateur de médiation Android PubMatic

Version suivante

• Mise à jour de l'adaptateur pour utiliser l'API InitializationCompleteCallback.onInitializationFailed(AdError).

Version 5.4.1.0

• Le niveau d'API Android minimal requis est désormais 24.
• Compatibilité vérifiée avec le SDK Pubmatic 5.4.1.

Conçue et testée avec :

• SDK Google Mobile Ads version 25.5.0.
• SDK Google Mobile Ads Next-Gen version 1.5.0.
• SDK Pubmatic version 5.4.1

Version 5.4.0.0

• Compatibilité vérifiée avec le SDK Pubmatic 5.4.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 25.4.0.
• SDK Google Mobile Ads Next-Gen version 1.4.0.
• SDK Pubmatic version 5.4.0

Version 5.3.0.1

• Épinglez la dépendance Kotlin de l'adaptateur à la version 1.9.0 (version minimale de Kotlin compatible avec le SDK GMA NextGen).

Conçue et testée avec :

• SDK Google Mobile Ads version 25.4.0.
• SDK Google Mobile Ads Next-Gen version 1.4.0.
• SDK Pubmatic version 5.3.0

Version 5.3.0.0

• Compatibilité vérifiée avec le SDK Pubmatic 5.3.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 25.4.0.
• SDK Google Mobile Ads Next-Gen version 1.4.0.
• SDK Pubmatic version 5.3.0

Version 5.2.0.0

• Compatibilité vérifiée avec le SDK Pubmatic 5.2.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 25.4.0.
• SDK Google Mobile Ads Next-Gen version 1.3.0.
• SDK Pubmatic version 5.2.0

Version 5.1.2.2

• Mappe AgeRestrictedTreatment à l'API COPPA de PubMatic.

Conçue et testée avec :

• SDK Google Mobile Ads version 25.4.0.
• SDK Google Mobile Ads Next-Gen version 1.2.1.
• SDK Pubmatic version 5.1.2

Version 5.1.2.1

• Ajout de la compatibilité avec les annonces natives vidéo(VAST) à l'aide de l'API MediaView du SDK OpenWrap de PubMatic.

Conçue et testée avec :

• SDK Google Mobile Ads 25.2.0.
• SDK Google Mobile Ads Next-Gen version 1.2.1.
• SDK Pubmatic version 5.1.2

Version 5.1.2.0

• Compatibilité vérifiée avec le SDK Pubmatic 5.1.2.

Conçue et testée avec :

• SDK Google Mobile Ads 25.2.0.
• SDK Google Mobile Ads Next-Gen version 1.1.0.
• SDK Pubmatic version 5.1.2

Version 5.1.1.0

• Compatibilité vérifiée avec le SDK Pubmatic 5.1.1.

Conçue et testée avec :

• SDK Google Mobile Ads 25.2.0.
• SDK Google Mobile Ads Next-Gen version 1.0.1.
• SDK Pubmatic version 5.1.1

Version 5.1.0.0

• Compatibilité vérifiée avec le SDK Pubmatic 5.1.0.

Conçue et testée avec :

• SDK Google Mobile Ads 25.2.0.
• SDK Pubmatic version 5.1.0

Version 5.0.0.1

• Ajout d'une propriété pour compiler l'adaptateur avec la dépendance du SDK GMA Next-Gen.
• Correction d'un bug qui empêchait l'initialisation de l'objet mediationUtils.

Conçue et testée avec :

• SDK Google Mobile Ads version 25.1.0.
• SDK Pubmatic version 5.0.0

Version 5.0.0.0

• Compatibilité vérifiée avec le SDK Pubmatic 5.0.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 25.0.0.
• SDK Pubmatic version 5.0.0

Version 4.12.0.0

• Compatibilité vérifiée avec le SDK Pubmatic 4.12.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 24.9.0.
• SDK Pubmatic version 4.12.0

Version 4.11.0.1

• Ajout de la compatibilité avec le transfert du paramètre tagForUnderAgeOfConsent du SDK Google Mobile Ads au SDK PubMatic.

Conçue et testée avec :

• SDK Google Mobile Ads version 24.9.0.
• SDK Pubmatic version 4.11.0

Version 4.11.0.0

• Compatibilité vérifiée avec le SDK Pubmatic 4.11.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 24.9.0.
• SDK Pubmatic version 4.11.0

Version 4.10.0.1

• Ajout d'une liste de composants pour le format d'annonce native en cascade.

Conçue et testée avec :

• SDK Google Mobile Ads version 24.7.0.
• SDK Pubmatic version 4.10.0

Version 4.10.0.0

• Compatibilité vérifiée avec le SDK Pubmatic 4.10.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 24.7.0.
• SDK Pubmatic version 4.10.0

Version 4.9.1.0

• Compatibilité vérifiée avec le SDK Pubmatic 4.9.1.

Conçue et testée avec :

• SDK Google Mobile Ads version 24.6.0.
• SDK Pubmatic version 4.9.1

Version 4.8.0.1

• Ajout de la compatibilité avec les annonces interstitielles en cascade.
• Ajout de la compatibilité avec les annonces avec récompense en cascade.
• Ajout de la compatibilité avec les bannières en cascade.
• Ajout de la compatibilité avec les annonces natives en cascade.
• Compatibilité vérifiée avec le SDK Pubmatic 4.8.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 24.6.0.
• SDK Pubmatic version 4.8.0

Version 4.8.0.0

• Compatibilité vérifiée avec le SDK Pubmatic 4.8.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 24.4.0.
• SDK Pubmatic version 4.8.0.

Version 4.7.1.1

• Taille fixe de l'icône Choisir sa pub

Conçue et testée avec :

• SDK Google Mobile Ads version 24.4.0.
• SDK Pubmatic version 4.7.1

Version 4.7.1.0

• Compatibilité vérifiée avec le SDK Pubmatic 4.7.1.

Conçue et testée avec :

• SDK Google Mobile Ads version 24.4.0.
• SDK Pubmatic version 4.7.1

Version 4.7.0.1

• Correction des dépendances internes.

Conçue et testée avec :

• SDK Google Mobile Ads version 24.4.0.
• SDK Pubmatic version 4.7.0.

Version 4.7.0.0

• Version initiale.
• Ajout de la compatibilité des enchères pour les formats d'annonces bannières, interstitielles, avec récompense et natives.
• Compatibilité vérifiée avec le SDK Pubmatic 4.7.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 24.4.0.
• SDK Pubmatic version 4.7.0.