Envoyer des notifications anticipées de coupure publicitaire

L'insertion dynamique d'annonce de Google est compatible avec les diffusions en direct à un niveau de simultanéité élevé. Les notifications anticipées de coupure publicitaire (EABN, Early Ad Break Notification) sont des requêtes permettant à Google DAI de planifier une prochaine coupure publicitaire ou de commencer immédiatement à prendre des décisions concernant les annonces, en optimisant à la fois le taux de remplissage des annonces et le temps de chargement.

Pour commencer à envoyer des notifications anticipées de coupure publicitaire pour le service complet, la diffusion de séries ou l'insertion d'annonces guidée par le serveur, utilisez la ressource AdBreaks. Cette ressource peut créer et gérer des coupures publicitaires pour toutes les diffusions en direct que vous créez via l'interface utilisateur de Google Ad Manager ou l'API SOAP Google Ad Manager LiveStreamEventService.

Cette page explique comment planifier une coupure publicitaire en tant que notification anticipée de coupure publicitaire.

Remarque :Si vous utilisez la version antérieure de l'API Notification de coupure publicitaire anticipée, passez à la ressource AdBreaks pour obtenir la parité et des fonctionnalités avancées, telles que la planification d'une coupure publicitaire et l'interrogation des états des coupures publicitaires.

Prérequis

Pour créer ou gérer les coupures publicitaires, vous avez besoin d'une clé d'élément ou d'une clé d'élément personnalisée générée par le système pour la diffusion en direct. Vous trouverez également ces clés sur la page d'informations détaillées du direct. Consultez Configurer une diffusion en direct pour l'insertion dynamique d'annonces à l'aide de l'interface utilisateur de Google Ad Manager.

Planifier une coupure publicitaire

Vous pouvez programmer une coupure publicitaire lorsque le nombre de spectateurs de votre diffusion augmente. Pour chaque événement de streaming en direct, planifiez une coupure publicitaire individuelle jusqu'à six heures à l'avance à l'aide de la méthode de service Create. Indiquez l'heure de début prévue et l'ID de la coupure publicitaire. La prise de décision publicitaire en temps réel commence à l'approche de l'heure prévue. Pour les décisions de coupure publicitaire immédiates, omettez l'heure de début prévue de la coupure publicitaire.

Pour que Google DAI commence immédiatement à prendre des décisions concernant les annonces, vous pouvez omettre l'heure de début prévue de la coupure publicitaire lorsque vous appelez Create.

L'exemple suivant planifie une coupure publicitaire pour un événement de diffusion en direct de type Linear qui doit commencer le 6 mars 2025 à 16h en temps universel coordonné (UTC) :

cURL Node.js

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{"adBreakId":"mid-roll-1","assetKey":"ASSET_KEY","duration":"30s","expectedStartTime":"2025-03-06T16:00:00Z"}'

fetch("https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks", {
    "headers": {
      "authorization":
        "Bearer ACCESS_TOKEN",
        "Content-Type": "application/json",
    },
  "body": JSON.stringify({
    "adBreakId": "mid-roll-1",
    "duration": "30s",
    "expectedStartTime": "2025-03-06T16:00:00Z"
  }),
  "method": "POST"
});

Si l'opération réussit, la réponse JSON suivante s'affiche:

{
  "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
  "adBreakId": "mid-roll-1",
  "assetKey": "...",
  "expectedStartTime": "2025-03-06T16:00:00Z",
  "duration": "30s",
  "breakState": "SCHEDULED"
}

Conseil :Vérifiez la propriété DynamicAdInsertionType de l'événement diffusé en direct. S'il s'agit de POD_SERVING_REDIRECT ou de POD_SERVING_MANIFEST, nous vous recommandons de transmettre un ID de coupure publicitaire personnalisé fourni par votre manipulateur de fichier manifeste de flux. Sinon, l'API génère une chaîne UUID pour l'ID de coupure publicitaire.

Pour interroger les coupures publicitaires, utilisez la méthode List. Pour inspecter les détails d'une coupure publicitaire, utilisez la méthode Get.

L'exemple suivant liste toutes les coupures publicitaires d'un événement en direct:

cURL Node.js

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN'

fetch(
  "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks",
  {
    "headers": {
      "authorization": "Bearer ACCESS_TOKEN",
    },
    "method": "GET"
  }
);

Si l'opération réussit, la réponse JSON suivante s'affiche:

{
  "adBreaks": [
    {
      "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
      "adBreakId": "mid-roll-1",
      "assetKey": "...",
      "expectedStartTime": "2025-03-06T16:00:00Z",
      "duration": "30s",
      "breakState": "DECISIONED",
      "breakSequence": "1"
    }
  ]
}

Si vous souhaitez avancer la coupure publicitaire actuelle, utilisez la méthode Patch pour modifier l'heure de début prévue. Si vous souhaitez annuler la coupure publicitaire en cours, utilisez la méthode Delete avant que son état ne soit COMPLETED.

Pour créer une autre coupure publicitaire, attendez que l'état de la coupure publicitaire actuelle soit COMPLETED.