Ce guide explique comment utiliser l'API d'insertion dynamique d'annonce pour demander un flux de vidéo à la demande avec des annonces désactivables, afficher le bouton "Ignorer" conformément aux exigences de Google Ads et envoyer les événements de suivi associés.
Conditions préalables
- Application implémentant les appels d'API d'insertion dynamique d'annonces pour les flux de vidéo à la demande. Pour en savoir plus, consultez le guide sur le flux de vidéo à la demande de l'API d'insertion dynamique d'annonce.
Envoyer une demande d'annonces désactivables
Pour demander un flux de vidéo à la demande avec des annonces désactivables, 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 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 demandes 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 par les 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 les annonces ignorées
Pour gérer l'omission des annonces, utilisez les informations de la structure Ad
ou AdBreak
selon que vous ignorez l'annonce actuelle ou l'intégralité de 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 est une valeur exprimée en secondes avant que l'annonce puisse être ignorée. Le sous-message SkipMetadata
ne s'affichera 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, pinguez l'URL de l'événement "Ignorer" incluse dans la réponse du flux.
Il est inclus dans le sous-message SkipMetadata
.
Conditions requises pour le bouton "Ignorer"
Pour les annonces désactivables, affichez le bouton "Ignorer" en respectant les exigences de conception suivantes. Si ces exigences ne sont pas respectées, des restrictions peuvent être appliquées aux annonces Google diffusées sur votre site ou dans votre application.
Retardateur
L'annonce ne doit pas être désactivable avant la date de fin (skipoffset
) spécifiée dans le code VAST.
Pendant cette période, vous devez afficher une notification à l'attention de l'utilisateur pour l'informer que l'annonce peut être ignorée dans X secondes. La notification doit être traduite
dans la langue de l'utilisateur.
Position du bouton "Ignorer"
Pour une langue s'écrivant de gauche à droite, placez le bouton "Ignorer" en bas à droite du lecteur vidéo. Pour une langue s'écrivant de droite à gauche, placez le bouton "Ignorer" 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 lecture simple.
Texte et icône
Le bouton "Ignorer" doit contenir à la fois du texte et une iconographie. Vous pouvez utiliser l'icône Material Next Next comme iconographie.
Accessibilité
L'utilisateur doit pouvoir accéder au bouton "Ignorer" à 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 du bouton "Ignorer" dans la langue de l'utilisateur.
Séries d'annonces
Le bouton "Ignorer" permet d'ignorer l'annonce actuelle dans la série d'annonces ou d'ignorer la série d'annonces dans son intégralité.
Traductions "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.