Annonces désactivables de flux à la demande

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

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.
start (number) Position dans le flux où la coupure publicitaire commence, en secondes.
duration (number) Durée de la coupure publicitaire, en secondes.
ads (object(Ad)) : liste des annonces présentes dans le flux.
start (number) Position dans le flux où l'annonce démarre, en secondes.
duration (number) Durée de l'annonce, en secondes.
skip_metadata (object(SkipMetadata)) Métadonnées facultatives pour les annonces désactivables. Si cet indicateur est défini, il indique que l'annonce est désactivable, et inclut des instructions sur la gestion de l'interface utilisateur "Ignorer" et de l'événement de suivi.
offset (number) La valeur "Offset" indique la durée (en secondes) pendant laquelle le lecteur doit attendre avant que le bouton "Ignorer" s'affiche. Omis s'ils ne sont pas fournis dans le fichier VAST.
tracking_url (string) URL à laquelle un ping doit être envoyé en cas d'événement "Ignorer".

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.