Отправляйте ранние уведомления о рекламных паузах

Динамическая вставка объявлений Google (DAI) поддерживает прямые трансляции на высоком уровне параллелизма. Ранние уведомления о рекламной паузе (EABN) — это запросы к Google DAI, чтобы запланировать предстоящую рекламную паузу или немедленно начать принимать решения по рекламе, оптимизируя как скорость заполнения рекламы, так и время загрузки.

Чтобы начать получать ранние уведомления о рекламных паузах для полного обслуживания , показа модулей или вставки рекламы, управляемой сервером , используйте ресурс AdBreaks . Этот ресурс может создавать рекламные паузы и управлять ими для всех прямых трансляций, которые вы создаете с помощью пользовательского интерфейса Google Ad Manager или SOAP API Google Ad Manager LiveStreamEventService .

На этой странице описано, как запланировать рекламную паузу в качестве раннего уведомления о рекламной паузе.

Предварительные условия

Чтобы создавать рекламные паузы или управлять ими, вам понадобится ключ актива, созданный системой прямой трансляции, или пользовательский ключ актива . Вы также можете найти эти ключи на странице сведений о прямой трансляции. См. раздел Настройка прямой трансляции для DAI с помощью пользовательского интерфейса Google Ad Manager.

Запланируйте рекламную паузу

Вы можете запланировать рекламную паузу, пока количество просмотров вашей трансляции будет увеличиваться. Для каждого события прямой трансляции запланируйте одну рекламную паузу индивидуально не позднее, чем за шесть часов, используя метод Create сервис». Укажите ожидаемое время начала и идентификатор рекламной паузы. DAI начинает принимать решения по рекламе ближе к запланированному времени. Чтобы принять немедленное решение о рекламной паузе, опустите ожидаемое время начала рекламной паузы.

Чтобы DAI Google немедленно принял решение о запуске рекламы, вы можете опустить ожидаемое время начала рекламной паузы при вызове Create .

В следующем примере рекламная пауза для события прямой трансляции типа Linear начинается 6 марта 2025 года в 16:00 по всемирному координированному времени (UTC):

КУЛЬ 

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"}'

Node.js 

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"
});

В случае успеха вы увидите следующий ответ JSON:

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

Чтобы запросить рекламные паузы, используйте метод List . Чтобы просмотреть сведения о рекламной паузе, используйте метод Get .

В следующем примере перечислены все рекламные паузы для прямой трансляции:

КУЛЬ 

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

Node.js 

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

В случае успеха вы увидите следующий ответ JSON:

{
  "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"
    }
  ]
}

Если вы хотите перенести текущую рекламную паузу на более раннее время, используйте метод Patch , чтобы изменить ожидаемое время начала. Если вы хотите отменить текущую рекламную паузу, используйте метод Delete до того, как его состояние станет COMPLETED .

Чтобы создать еще одну рекламную паузу, подождите, пока текущая рекламная пауза не станет COMPLETED .