早期広告ブレーク通知を送信する

Google ダイナミック広告挿入（DAI）は、高い同時実行レベルでライブ配信をサポートしています。早期広告ブレーク通知（EABN）は、Google DAI に次の広告ブレークのスケジュール設定を依頼したり、広告の決定を直ちに開始したりして、広告のフィラー率と読み込み時間の両方を最適化するためのリクエストです。

フルサービス、ポッド サービング、サーバー ガイド付き広告挿入の早期広告ブレーク通知を開始するには、AdBreaks リソースを使用します。このリソースを使用すると、Google アド マネージャー UI または Google アド マネージャー SOAP API の LiveStreamEventService で作成したすべてのライブ配信のミッドロール挿入点を作成、管理できます。

このページでは、早期広告ブレーク通知として広告ブレークをスケジュールする方法について説明します。

前提条件

ミッドロール挿入点の作成または管理には、ライブ配信システムによって生成されたアセットキーまたはカスタム アセットキーが必要です。これらのキーは、ライブ配信の詳細ページでも確認できます。Google アド マネージャーの UI を使用して、DAI のライブ配信を設定するをご覧ください。

ミッドロール挿入点をスケジュールする

ミッドロール挿入点は、視聴者数が増加している間にスケジュールできます。ライブ配信イベントごとに、Create サービス メソッドを使用して、最大 6 時間前に 1 つのミッドロール挿入点を個別にスケジュールします。開始予定時刻とミッドロール挿入点 ID を含めます。DAI は、スケジュールされた時間の近くで広告の決定を開始します。即時広告ブレークの決定の場合は、広告ブレークの開始予定時刻を省略します。

Google DAI で広告の決定をすぐに開始するには、Create を呼び出すときにミッドロール挿入点の開始予定時刻を省略します。

次の例では、Linear タイプのライブ配信イベントのミッドロール挿入点が 2025 年 3 月 6 日午後 4 時（協定世界時（UTC））に開始するようにスケジュールします。

cURL

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

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 メソッドを使用して、予定開始時間を変更します。現在のミッドロール挿入点をキャンセルするには、その状態が COMPLETED になる前に Delete メソッドを使用します。

別のミッドロール挿入点を作成する場合は、現在のミッドロール挿入点のステータスが COMPLETED になるまで待ちます。