ダイナミック広告挿入の連続配信広告のライブ API

Dynamic Ad Insertion API を使用すると、DAI ライブ ストリームのリクエストとトラッキングを行うことができます。

サービス: dai.google.com

すべての URI は https://dai.google.com を基準とします。

メソッド: stream

HTTP リクエスト

POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

パスパラメータ

リクエスト本文

リクエスト本文は application/x-www-form-urlencoded 型で、次の内容が含まれます。 次のパラメータがあります。

レスポンスの本文

成功した場合、レスポンスの本文には新しい Stream オブジェクトが含まれます。

Open Measurement

DAI API には、 Verifications フィールド。このフィールドには 1 つ以上の 実行に必要なリソースとメタデータをリストする Verification 要素 第三者測定コードを使用してクリエイティブの 再生を検証する必要があります単独 JavaScriptResource がサポートされています。詳細については、 IAB Tech Lab および VAST 4.1 仕様をご覧ください。

メソッド: 連続配信広告のセグメント

HTTP リクエスト

GET https://dai.google.com//linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/pod/{pod_id}/profile/{profile_name}/{segment_number}.{segment_format}

パスパラメータ

クエリ パラメータ

脚注

1. 初期化セグメントには sd は必要ありません。 ↩
2. 期間を指定しない広告を含むイベントでは pd は不要 休憩が有効になりました。 ↩

レスポンスの本文

成功した場合、レスポンスの本文は リクエストで指定された形式とパラメータ。

メソッド: DASH Pod Period テンプレート

HTTP リクエスト

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

パスパラメータ

クエリ パラメータ

レスポンスの本文

成功した場合、レスポンスの本文には新しい PodTemplateResponse オブジェクト。

方法: メディアによるオーナー確認

再生中に広告メディア ID を見つけたら、すぐに stream から取得した media_verification_url を使用したリクエスト 示しています。サーバーサイド ビーコン処理では、これらのリクエストは不要 サーバーがメディア検証を開始します。

media verification エンドポイントへのリクエストはべき等です。

HTTP リクエスト

GET https://{media-verification-url}/{ad-media-id}

レスポンスの本文

media verification 次のレスポンスが返されます。

• メディアの検証が成功し、すべての ping が成功した場合、HTTP/1.1 204 No Content 送信しました。
• HTTP/1.1 404 Not Found: 次の理由でメディアを検証できない場合 URL の形式や有効期限が正しくない。
• HTTP/1.1 404 Not Found: この ID の以前の確認リクエスト 成功したことを示します。
• HTTP/1.1 409 Conflict: 別のリクエストがすでに ping を送信している場合 あります。

広告メディア ID

広告メディア ID は、別のメタデータ トラック（時間指定）でエンコードされます。 HLS トランスポート ストリームでは emsg を、mp4 ファイルでは emsg を表現できます。広告メディア識別子 常に文字列 google_ で始まります。

メタデータ エントリのテキスト コンテンツ全体を広告に追加する 確認用の URL を入力する必要があります。

メソッド: metadata

metadata_url のメタデータ エンドポイントが、広告の作成に使用される情報を返す UI です。サーバーサイド ビーコン送信ストリームではメタデータ エンドポイントを使用できません。 この場合、サーバーが広告メディアの確認を開始します。

HTTP リクエスト

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

レスポンスの本文

成功すると、レスポンスで次の内容のインスタンスが返されます。 PodMetadata。

メタデータの解析

メタデータには、tags、ads、広告 breaks の 3 つのセクションがあります。エントリ tags セクションにあります。その後、タグを繰り返し解析します。 名前がキーの接頭辞である最初のエントリを見つけます。 広告メディア ID。たとえば、 この場合、広告メディア ID は次のようになります。

google_1234567890

次に、google_12345 という名前のタグ オブジェクトを見つけます。この場合は 広告メディア ID。正しい広告メディア接頭辞オブジェクトが見つかったら、 広告 ID、広告ブレーク ID、イベントタイプが含まれます。広告 ID を使用して、Google 広告が ads オブジェクトと広告ブレーク ID は、breaks オブジェクトをインデックス登録するために使用されます。

Response data

ストリーム

{
  "stream_id": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "heartbeat_url": string,
  "polling_frequency": number,
  "pod_manifest_url": string,
  "manifest_format": string,
}

PodMetadata

{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}

TagSegment

{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}

AdBreak

{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}

広告

{
  "ad_break_id": string,
  "position": number,
  "duration": number,
  "title": string,
  "description": string,
  "advertiser": string,
  "ad_system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
  "clickthrough_url": string,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}

PodTemplateResponse

{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}

アイコン

{
  "click_data": object(ClickData),
  "creative_type": string,
  "click_fallback_images": [object(FallbackImage)],
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "x_position": string,
  "y_position": string,
  "program": string,
  "alt_text": string,
}

ClickData

{
  "url": string,
}

FallbackImage

{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}

ラッパー

{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}

確認

{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}

JavaScriptResource

{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}

TrackingEvent

{
  "event": string,
  "uri": string,
}

UniversalAdID

{
  "id_value": string,
  "id_registry": string,
}

コンパニオン

{
  "click_data": object(ClickData),
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}

InteractiveFile

{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}