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

Ce guide explique comment utiliser Google Mobile Ads 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 iOS.

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.

Prérequis

Avant de continuer, vérifiez les points suivants :

• Cible de déploiement iOS 13.0 ou version ultérieure

• Dernière version de Google Mobile Ads 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 OpenWrap SDK.

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 pour votre application.

Sous Integration Path (Chemin d'intégration), sélectionnez iOS (Objective-C / Swift), puis AdMob - SDK Bidding (AdMob – Enchères par SDK) comme Sub-integration Path (Chemin de sous-intégration). 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 fichier 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 Apps (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, 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.

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.




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.

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

Recommandé : Utiliser Swift Package Manager

Avant de continuer, vous devez disposer de la version minimale compatible de l'adaptateur, à savoir la version 4.10.0.0.

Pour ajouter une dépendance de package à votre projet, procédez comme suit :

1. Dans Xcode, accédez à File > Add Package Dependencies... (Fichier > Ajouter des dépendances de package...).

2. Dans l'invite qui s'affiche, recherchez l'URL de package suivante :

   https://github.com/googleads/googleads-mobile-ios-mediation-pubmatic.git
   

3. Dans Règle de dépendance, sélectionnez Branche.

4. Dans le champ de texte, saisissez main.

Intégration manuelle

1. Téléchargez la dernière version du SDK PubMatic OpenWrap pour iOS et associez tous les fichiers et bundles .xcframework dans votre projet.

2. Téléchargez la dernière version de l'adaptateur PubMatic (lien de téléchargement disponible dans le journal des modifications), puis associez PubMaticAdapter.xcframework à votre projet.

Utiliser CocoaPods

• Ajoutez la ligne suivante au fichier Podfile de votre projet :

  pod 'GoogleMobileAdsMediationPubMatic'
  

• Depuis la ligne de commande, exécutez la commande suivante :

  pod install --repo-update

Étape 4 : Implémenter 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 fournir certaines informations aux utilisateurs de l'Espace économique européen (EEE), du Royaume-Uni et de la 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 iOS 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

Implémenter SKAdNetwork

Suivez la documentation de PubMatic pour ajouter les identifiants SKAdNetwork au fichier Info.plist de votre projet.

Étape 6 : Testez votre implémentation

Activer les annonces test

Enregistrez 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 GADNativeAd. Il renseigne les champs suivants pour un GADNativeAd.

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 GADResponseInfo.adNetworkInfoArray dans les classes suivantes :

GADMediationAdapterPubMatic

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

PubMatic iOS Mediation Adapter Changelog

Version 5.5.0.0

• Compatibilité vérifiée avec la version 5.5.0 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.12.0.
• SDK PubMatic OpenWrap version 5.5.0.

Version 5.4.1.0

• Compatibilité vérifiée avec la version 5.4.1 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.10.0.
• SDK PubMatic OpenWrap version 5.4.1.

Version 5.4.0.0

• Compatibilité vérifiée avec la version 5.4.0 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.9.0.
• SDK PubMatic OpenWrap version 5.4.0.

Version 5.3.0.0

• Compatibilité vérifiée avec la version 5.3.0 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.8.0.
• SDK PubMatic OpenWrap version 5.3.0.

Version 5.2.0.0

• Compatibilité vérifiée avec la version 5.2.0 du SDK PubMatic OpenWrap.
• Nécessite désormais le SDK Google Mobile Ads version 13.6 ou ultérieure.
• Ajout de la compatibilité avec les composants vidéo dans les annonces natives à l'aide de l'API mediaView.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.7.0.
• SDK PubMatic OpenWrap version 5.2.0.

Version 5.1.1.0

• Compatibilité vérifiée avec la version 5.1.1 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.4.0.
• SDK PubMatic OpenWrap version 5.1.1.

Version 5.1.0.1

• L'adaptateur transmet désormais l'indicateur ageRestrictedTreatment du SDK Google Mobile Ads à l'API COPPA du SDK PutMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.3.0.
• SDK PubMatic OpenWrap version 5.1.0.

Version 5.1.0.0

• Compatibilité vérifiée avec la version 5.1.0 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.3.0.
• SDK PubMatic OpenWrap version 5.1.0.

Version 5.0.1.0

• Compatibilité vérifiée avec la version 5.0.1 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads 13.2.0.
• SDK PubMatic OpenWrap version 5.0.1.

Version 5.0.0.0

• Compatibilité vérifiée avec la version 5.0.0 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.1.0.
• SDK PubMatic OpenWrap version 5.0.0.

Version 4.12.0.0

• Compatibilité vérifiée avec la version 4.12.0 du SDK PubMatic OpenWrap.
• Mise à jour de la dépendance du SDK Google Mobile Ads vers la version 13.0.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.0.0.
• SDK PubMatic OpenWrap version 4.12.0.

Version 4.11.0.2

• Mise à jour de la version minimale d'iOS pour CocoaPods vers la version 13.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.0.0.
• SDK PubMatic OpenWrap version 4.11.0.

Version 4.11.0.1

• Ajout de la prise en charge du transfert des paramètres tagForChildDirectedTreatment et tagForUnderAgeOfConsent du SDK Google Mobile Ads vers le SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 12.14.0.
• SDK PubMatic OpenWrap version 4.11.0.

Version 4.11.0.0

• Compatibilité vérifiée avec la version 4.11.0 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 12.14.0.
• SDK PubMatic OpenWrap version 4.11.0.

Version 4.10.0.0

• Compatibilité vérifiée avec la version 4.10.0 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 12.12.0.
• SDK PubMatic OpenWrap version 4.10.0.

Version 4.9.0.0

• Ajout de la compatibilité avec la cascade d'annonces pour les formats d'annonces bannières, interstitielles, avec récompense et natives.
• Correction d'un bug qui empêchait de définir correctement les délégués d'annonces natives.
• Ajoutez une propriété de mode test dans la classe GADMediationAdapterPubMaticExtras.
• Compatibilité vérifiée avec la version 4.9.0 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 12.12.0.
• SDK PubMatic OpenWrap version 4.9.0.

Version 4.8.1.0

• Compatibilité vérifiée avec la version 4.8.1 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 12.9.0.
• SDK PubMatic OpenWrap version 4.8.1.

Version 4.8.0.0

• Compatibilité vérifiée avec la version 4.8.0 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads version 12.8.0.
• SDK PubMatic OpenWrap version 4.8.0.

Version 4.7.0.0

• Version initiale.
• Compatible avec les enchères pour les formats d'annonces bannières, interstitielles, avec récompense et natives.
• Compatibilité vérifiée avec la version 4.7.0 du SDK PubMatic OpenWrap.

Conçue et testée avec :

• SDK Google Mobile Ads 12.6.0.
• SDK PubMatic OpenWrap version 4.7.0.