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 les annonces désactivables s'affichent, le bouton "Ignorer" s'affiche Exigences Google Ads et envoyer les événements de suivi associés.

Prérequis

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 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 champ corps:

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

Gérer les annonces ignorées

Pour gérer les annonces ignorées, utilisez les informations des Ad struct 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. La SkipMetadata inclut également la valeur offset, qui est une valeur dans secondes avant que l'annonce puisse être ignorée. Le sous-message SkipMetadata ne seront inclus 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ù commence l'annonce, dans secondes.
duration (number) Durée de l'annonce, en secondes.
skip_metadata (object(SkipMetadata)) Métadonnées facultatives pour les annonces désactivables annonces. Si cette règle est définie, elle 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 (nombre) Décalage indique la durée en après le début de l'annonce, le lecteur doit attendre "Ignorer". Omis s'ils ne sont pas fournis dans le fichier VAST.
tracking_url (chaîne) URL à laquelle un ping doit être envoyé lorsque l'utilisateur ignore le contenu. .

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, le bouton "Ignorer" s'affiche comme suit : exigences. Le non-respect de ces exigences peut entraîner des restrictions dans les 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 de sorte qu'elle puisse être ignorée dans X secondes. L'avis doit être traduit en la langue de l'utilisateur.

Position du bouton "Ignorer"

Pour une langue s'écrivant de gauche à droite, placez le bouton "Ignorer" en bas à droite le lecteur vidéo. Pour une langue s'écrivant de droite à gauche, placez le bouton "Ignorer" sur la en bas à gauche du lecteur vidéo.

Taille du bouton "Ignorer"

Le bouton et le texte doivent être assez grands pour être clairement lisibles dans un dossier incliné. expérience.

Texte et icône

Le bouton "Ignorer" doit contenir à la fois du texte et une iconographie. Vous pouvez utiliser ignorer l'icône Material suivante comme iconographie.

Accessibilité

L'utilisateur doit pouvoir accéder au bouton "Ignorer" à l'aide d'un clavier ou la 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 l'ensemble de la série d'annonces.

"Ignorer l'annonce" traductions

Utilisez Le fichier skipAdTranslations.json pour traduire le texte "Ignorer l'annonce" en fonction des paramètres régionaux de l'utilisateur.