Ce guide explique comment utiliser l'API DAI pour demander un flux VOD avec des annonces à ignorer, afficher le bouton "Ignorer" conformément aux exigences Google Ads et envoyer les événements de suivi associés.
Prérequis
- Application implémentant des appels d'API DAI pour les flux VOD Pour en savoir plus, consultez la section Demander des flux VOD DAI.
Envoyer une demande d'annonces désactivables
Pour demander un flux VOD avec des annonces sautables, vous devez transmettre le paramètre dai-sas dans votre demande de flux.
Point de terminaison de l'API
POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded
Paramètres de chemin d'accès
{CMS_ID} |
ID du CMS du flux. |
{VIDEO_ID} |
ID vidéo du flux. |
Paramètres du corps
dai-sas |
Définissez dai-sas=1 pour activer les annonces désactivables.
|
Exemple de requête (cURL)
Pour les requêtes de flux HLS:
curl -X POST \
-d 'dai-sas=1' \
-H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Remplacez 'dash' dans l'URL des flux DASH:
https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Utilisez le format suivant pour inclure plusieurs paramètres de flux dans le corps de votre requête:
-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \
Gérer l'ignorer des annonces
Pour gérer le saut des annonces, utilisez les informations de la structure Ad ou de la structure AdBreak, selon que vous sautez l'annonce en cours ou toute la coupure publicitaire.
Prenez la valeur start et ajoutez la valeur duration, puis recherchez ce point dans le flux. Le sous-message SkipMetadata inclut également la valeur offset, qui correspond au délai en secondes avant que l'annonce puisse être ignorée. Le sous-message SkipMetadata n'est inclus que dans les annonces désactivables.
ad_breaks |
Liste des coupures publicitaires.
|
Exemple de réponse
{
...
"ad_breaks":[
{
...
"start":0,
"duration":10,
"ads":[
{
...
"start":0,
"duration":10,
"skip_metadata":{
"offset": 5,
"tracking_url": "https://example_skip_url.com"
}
}
}
}
Une fois l'annonce ignorée, envoyez un ping à l'URL de l'événement de saut incluse dans la réponse du flux.
Il est inclus dans le sous-message SkipMetadata.
Exigences liées au bouton "Ignorer"
Pour les annonces pouvant être ignorées, affichez le bouton d'ignorer en respectant les exigences de conception suivantes. Le non-respect de ces exigences peut entraîner des restrictions sur la diffusion d'annonces Google sur votre site ou dans votre application.
Retardateur
L'annonce ne doit pas être désactivable avant l'heure skipoffset spécifiée dans le VAST.
Pendant cette période non désactivable, vous devez afficher une notification informant l'utilisateur qu'il peut ignorer l'annonce dans X secondes. L'avis doit être traduit dans la langue de l'utilisateur.
Position du bouton "Ignorer"
Pour une langue de gauche à droite, placez le bouton de saut en bas à droite du lecteur vidéo. Pour une langue de droite à gauche, placez le bouton de saut en bas à gauche du lecteur vidéo.
Taille du bouton "Ignorer"
Le bouton et le texte doivent être suffisamment grands pour être clairement lisibles dans une expérience de visionnage de type "lean-back".
Texte et icône
Le bouton de saut doit comporter du texte et une icône. Vous pouvez utiliser l'icône Material "Ignorer le prochain" comme iconographie.
Accessibilité
L'utilisateur doit pouvoir accéder au bouton de saut à l'aide d'un clavier ou d'une télécommande. L'application doit sélectionner le bouton "Ignorer" une fois le compte à rebours terminé.
Internationalisation
Nous vous recommandons de traduire le texte de la fenêtre de désactivation dans la langue de l'utilisateur.
Séries d'annonces
Le bouton "Ignorer" permet d'ignorer l'annonce en cours de diffusion dans la série d'annonces ou l'ensemble de la série.
Traductions de "Ignorer l'annonce"
Utilisez le fichier skipAdTranslations.json pour traduire le texte "Ignorer l'annonce" en fonction des paramètres régionaux de l'utilisateur.