Si vous utilisez un ad server tiers avec l'insertion d'annonces côté serveur (SSAI) Google Ad Manager, IMA permet de monétiser un inventaire supplémentaire via Google Ad Manager en envoyant un nonce chiffré à Ad Manager via l'ad server tiers. Ce guide explique comment envoyer ces signaux à l'aide du SDK IMA.
Ce guide utilise un exemple de tag d'emplacement publicitaire : https://youradserver.com.
Vous devez mettre à jour le tag d'emplacement publicitaire pour qu'il fonctionne avec vos véritables ad servers.
Prérequis
SDK IMA HTML5 version 3.523.0 ou ultérieure.
Suivez le guide de démarrage.
1. Configurer votre application pour envoyer un nonce aux serveurs d'insertion dynamique d'annonce de Google
Définissez enableNonce sur true pour que le SDK IMA DAI envoie un nonce chiffré aux serveurs d'insertion dynamique d'annonce.
const streamRequest = new LiveStreamRequest();
streamRequest.enableNonce = true;
2. Mettre à jour le tag d'annonce avec une macro pour renseigner le nonce
Ajoutez la macro [GOOGLE_INSTREAM_VIDEO_NONCE] à la balise de votre ad server dans l'interface utilisateur d'Ad Manager. Lorsque le serveur DAI renseigne les coupures publicitaires avec les URL de votre ad server tiers, Ad Manager renseigne dynamiquement la macro avec le nonce chiffré. Le résultat doit ressembler à l'exemple de tag d'emplacement publicitaire suivant, qui utilise une clé qui doit être configurée sur le serveur tiers:
https://youradserver.com?ad_manager_nonce=[GOOGLE_INSTREAM_VIDEO_NONCE]
Ce tag d'emplacement publicitaire utilise ad_manager_nonce comme exemple de clé, mais vous devrez vérifier auprès de votre ad server tiers comment il accepte la valeur nonce.
Pour modifier le tag de votre ad server dans Ad Manager, accédez à Vidéo > Diffusions en direct, puis sélectionnez une diffusion en direct active ou en créez une.
Ajoutez maintenant la macro au tag d'emplacement publicitaire configuré dans le flux sélectionné. Définissez la balise dans Paramètres des coupures publicitaires > Tag d'emplacement publicitaire maître.
3. Configurer la demande de l'ad server tiers pour Ad Manager
Configurez votre ad server tiers pour qu'il inclue le nonce dans la requête du serveur envoyée à Ad Manager. Voici un exemple de tag d'emplacement publicitaire configuré au sein de l'ad server tiers:
https://pubads.g.doubleclick.net/gampad/ads?givn=%%custom_key_for_google_nonce%%&iu=/21775744923/external/single_ad_samples&sz=640x480
Ad Manager recherche givn= pour identifier la valeur nonce. Le serveur publicitaire tiers doit prendre en charge une macro propre, telle que %%custom_key_for_google_nonce%%, et la remplacer par le paramètre de requête nonce que vous avez fourni à l'étape précédente. Pour en savoir plus, consultez la documentation de l'ad server tiers.
Et voilà ! Le paramètre nonce doit maintenant être propagé depuis le SDK DAI IMA via le serveur DAI, vers l'ad server tiers, puis vers Ad Manager. Cela permet de mieux monétiser votre application via Google Ad Manager.