AMP et publicité

Dans cette rubrique, vous apprendrez à afficher de la publicité avec un lecteur Brightcove qui utilise AMP. Vous apprendrez également à utiliser le consentement côté client avec la configuration du lecteur/AMP de Brightcove.

Introduction

La publicité, y compris les prerolls, fonctionne dans les lecteurs utilisés dans AMP. Le plugin publicitaire et sa configuration doivent simplement être inclus dans la configuration du lecteur. Pour une configuration de base utilisant une balise publicitaire statique, suivez les étapes de la section Configuration de base avec une balise publicitaire statique de ce document.

Souvent, vous voudrez utiliser des macros pour ajouter des informations dynamiques aux appels publicitaires. Pour plus d'informations sur l'utilisation de cette technique, voir la section Utilisation des macros dans les appels publicitaires de ce document.

Dans AMP, vous pouvez utiliser le consentement côté client, offrant aux utilisateurs un contrôle supplémentaire sur leur expérience en ligne. Pour plus d'informations, voir la section AMP-consentement et publicité de ce document.

Notez qu'AMP est très strict sur ce qui peut être ajouté à une page AMP valide, comme détaillé dans le document AMP Using a Video Cloud Video . Par exemple, vous NE POUVEZ PAS utiliser la pratique standard d'ajout d'un id au amp-brightcove tag puis utilisez un script block pour configurer, par exemple, le plugin IMA3. La publicité doit donc être mise en œuvre dans la configuration du lecteur, soit à l'aide de Studio, soit à l'aide de l'API de gestion des lecteurs.

Configuration de base avec une balise publicitaire statique

Pour configurer un lecteur avec une balise publicitaire statique, vous devez procéder comme suit :

Créer le joueur.
Configurez la publicité à l'aide d'une balise publicitaire statique, comme indiqué dans les étapes 1 à 15 de la section Pas à pas : Mise en œuvre de la publicité document.
Configurez votre lecteur pour utiliser AMP comme indiqué dans la première moitié du document AMP Using a Video Cloud Video .

Une fois que vous avez placé votre code de lecteur AMP sur une page, la ou les publicités sont lues en même temps que votre vidéo.

Utilisation de macros dans les appels publicitaires

Si vous devez inclure des valeurs spécifiques à un article dans vos appels au serveur publicitaire, vous pouvez transmettre des données personnalisées à un plugin de lecteur. Les macros pour les métadonnées vidéo telles que {mediainfo.tags} peuvent être utilisées normalement. (Pour la liste complète des macros de métadonnées vidéo, voir le document Ad macros and the serverUrl of the Advertising with the IMA3 Plugin ) Cependant, pour utiliser les macros {pageVariable.*} , quelques étapes supplémentaires sont nécessaires pour AMP, puisque le lecteur AMP se trouve dans une iframe.

Commencez par configurer le lecteur pour qu'il analyse les paramètres de la requête, à l'aide de la fonction query_string_to_window du lecteur Brightcove. Pour ajouter tous les paramètres de chaîne de requête à l'espace de noms global, ajoutez ce qui suit à la configuration de votre lecteur:

    "query_string_to_window": {
      "target": "qsParams"
    }

Notez que le nom qsParams correspond à l'objet dans lequel les paramètres sont stockés. Vous pouvez modifier le nom à votre guise, auquel cas vous modifierez ultérieurement le nom utilisé dans les macros.

Ensuite, pour transmettre des données, ajoutez autant de paramètres data-param-* que nécessaire au code d'intégration <amp-brightcove> . Par exemple :

data-param-ad-id="prerollonly"
data-param-site-section="celebrity"
data-param-post-id="A12345"

Désormais, dans l'iframe du lecteur, ces données supplémentaires sont disponibles sous forme de propriétés de l'objet cible :

window.qsParams.adId
window.qsParams.siteSection
window.qsParams.postId

Elles peuvent être utilisées dans les macros {pageVariable.*} de la configuration de l'annonce (les retours à la ligne ont été ajoutés pour des raisons de lisibilité) :

https://ads.example.com/ad?ad={pageVariable.qsParams.adId}
    &video={mediainfo.id}&article={pageVariable.qsParams.postId}
    &section={pageVariable.qsParams.siteSection}

Pour obtenir des instructions spécifiques sur l'utilisation de l'API de gestion des lecteurs pour mettre à jour une configuration de lecteur, voir Configurations de lecteur - Mise à jour d'une configuration de lecteur.

AMP-consentement et publicité

Dans AMP, vous pouvez utiliser le consentement côté client, offrant aux utilisateurs un contrôle supplémentaire sur leur expérience en ligne. Si votre page AMP gère le consentement de l'utilisateur avec le consentement AMP et que vous utilisez de la publicité dans le lecteur, vous pouvez alors souhaiter adapter la demande d'annonce du lecteur en fonction de ce consentement. Faites-le en ajoutant un

data-block-on-consent = "_ till_responded"

attribut à l'élément amp-brightcove. Le chargement du lecteur est alors retardé jusqu'à ce que l'utilisateur ait accepté ou rejeté le consentement. Sur les pages suivantes où le consentement est connu, le lecteur se charge normalement sans délai.

Configurations publicitaires

Le scénario le plus simple pour mettre en œuvre la publicité et l'AMP consiste à utiliser l'intégration de publicité IMA standard de Brightcove Player avec Google Ad Manager, ce qui npa=1 à ajouter à la demande d'annonce si le consentement est inconnu ou non donné. Pour ce faire, ajoutez

"imaAddNpa": vrai

dans les options du plugin de support AMP du lecteur, ce qui est automatiquement ajouté à l'URL du serveur publicitaire, comme indiqué ici :

Pour les autres modifications de l'URL du serveur publicitaire, l'état de consentement est défini dans l'iframe du lecteur à l'aide de trois paramètres de requête :

ampInitialConsentState: Si le consentement est accepté, rejeté, inconnu
ampConsentSharedData: Une chaîne de données JSON du fournisseur de consentement
ampInitialConsentValue: La chaîne de consentement du fournisseur de consentement

L'état de consentement est un entier tel que défini dans AMP:

SUFFISANT: 1
INSUFFISANT: 2
INCONNU_NOT_REQUIRED: 3
INCONNU: 4

Pour mettre à jour la configuration du lecteur afin de rendre les paramètres de requête du lecteur iFrame disponibles sous forme de simples variables Javascript, ajoutez ce qui suit à la configuration du lecteur dans l'éditeur JSON:

« query_string_to_window » : {"target » : « QueryStringParams"}

Pour obtenir de l'aide, voici une capture d'écran de l'interface utilisateur:

Vous pouvez ensuite utiliser les paramètres de requête de consentement dans la demande du serveur publicitaire, soit à l'aide de macros, soit en configurant la severURL comme une fonction.

Exemple de macro

« URL du serveur d'annonces » : « https://ads.example.com/ad?consent={pageVariable.queryStringParams.ampInitialConsentState}&consentString={pageVariable.queryStringParams.ampInitialConsentValue} »

Exemple de fonction

Configurez le lecteur sans URL de serveur publicitaire en utilisant les éléments suivants:

videojs.registerPlugin ('setAdUrl', function () {
  this.ima3.settings.serverUrl = fonction (rappel) {
    if (window.queryStringParams.ampInitialConsentState === '1') {
      // Consentement suffisant
      callback ('https://ads.example.com/adwithconsent?string= {pageVariable.queryStringParams.ampInitialConsentValue}');
    } else {
      // Utiliser une autre annonce
      rappel ('https://ads.example.com/basicad');
    }
}) ;