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

Dynamic Ad Insertion API を使用すると、ダイナミック広告挿入のライブ配信をリクエストしてトラッキングできます。

サービス: dai.google.com

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

メソッド: ストリーム

メソッド
stream POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

DAI DAI Pod Serving ライブ配信セッションを登録します。

HTTP リクエスト

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

パスパラメータ

パラメータ
network_code string

パブリッシャーの Google アド マネージャー ネットワーク コード。

custom_asset_key string

Google アド マネージャーでこのイベントに関連付けられているカスタム ID。

リクエストの本文

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

パラメータ
DFP ターゲティング パラメータ 省略可 追加のターゲティング パラメータ。
ストリーム パラメータをオーバーライドする 省略可 ストリーム作成パラメータのデフォルト値をオーバーライドします。
HMAC 認証 省略可 HMAC ベースのトークンを使用して認証します。

レスポンスの本文

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

Open Measurement

DAI API の Verifications フィールドには、Open Measurement の確認に関する情報が含まれています。このフィールドには、クリエイティブの再生を確認するためにサードパーティ測定コードを実行するために必要なリソースとメタデータを一覧表示する 1 つ以上の Verification 要素が含まれます。JavaScriptResource のみがサポートされています。詳しくは、IAB Tech Lab と VAST 4.1 の仕様をご覧ください。

メソッド: Pod セグメント

メソッド
pod segment GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

指定されたイベント ID の DAI ストリームを作成します。

HTTP リクエスト

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

パスパラメータ

パラメータ
network_code string

パブリッシャーの Google アド マネージャー ネットワーク コード。

custom_asset_key string

Google アド マネージャーでこのイベントに関連付けられているカスタム ID。

pod_identifier

次の形式がサポートされています。

pod/{integer}

現在のミッドロール挿入点の数値 ID。広告連続配信 ID は、広告ブレーク イベントごとに 1 から順に割り当てられます。

ad_break_id/{string}

現在のミッドロール挿入点の文字列 ID。
profile_name string

リクエストされた Google アド マネージャー DAI エンコード プロファイルの名前。エンコード プロファイルは、選択したイベント用に構成されたエンコード プロファイルのいずれかである必要があります。
segment_number integer

現在の広告連続配信内のリクエストされたセグメントのインデックス（0 から始まる）。
segment_format string

リクエストされたセグメント形式に関連付けられたファイル拡張子。使用できる拡張子は、ts、mp4、vtt、aac、ac3、eac3 です。

クエリ パラメータ

パラメータ
stream_id 必須 string

現在のユーザーのセッションのストリーム ID。この値は、stream エンドポイントへの成功したリクエストによって返されます。
sd required1 integer

リクエストされたセグメントの長さ（ミリ秒単位）。
so 省略可

連続配信広告内のリクエストされたセグメントのオフセット（ミリ秒単位）。so パラメータを省略すると、セグメントの長さ × セグメント番号で計算されます。
pd 必須2 integer

連続配信広告の再生時間（ミリ秒単位）。
auth-token 必須 string

現在の広告連続配信の署名付き URL エンコード HMAC トークン。
last 省略可 boolean

広告ブレーク内の最後のセグメントを示します。他のすべてのセグメントでは、このパラメータを省略します。
scte35 省略可 string

このミッドロール挿入点の Base64 エンコードされた SCTE-35 信号。
cust_params 省略可 string

アド マネージャー キャンペーンのターゲティングに使用される Key-Value ペアのセット。これらのペアは、URL エンコードされたクエリ文字列として表す必要があります。

例:
パラメータ
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

脚注

  1. 初期化セグメントには sd は必要ありません。↩
  2. 長さのないミッドロール挿入点が有効になっているイベントでは、pd は必要ありません。↩

例

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/ad_break_id/adbreak-2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

レスポンスの本文

成功すると、レスポンスの本文は、リクエストで指定された形式とパラメータに一致する再生可能なストリーム セグメントになります。

方法: HLS Pod マニフェスト

クライアントの動画プレーヤーが読み込んで再生する準備ができているライブ配信の HLS 連続配信広告マニフェストを取得します。

メソッド
GET GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/{pod_identifier}.m3u8;

広告連続配信の HLS マルチバリエーション再生リストを取得する API。

HTTP リクエスト

GET https://dai.google.com/linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}.m3u8?stream_id={stream_id}&pd={pod_duration}

パスパラメータ

パラメータ
network_code string

パブリッシャーの Google アド マネージャー ネットワーク コード。
custom_asset_key string

Google アド マネージャーでこのイベントに関連付けられているカスタム識別子
pod_identifier

次の形式がサポートされています。

pod/{integer}

現在のミッドロール挿入点の数値 ID。広告連続配信 ID は、広告ブレーク イベントごとに 1 から順に割り当てられます。

ad_break_id/{string}

現在のミッドロール挿入点の文字列 ID。

クエリ パラメータ

パラメータ
stream_id 必須 string

現在のユーザーのセッションのストリーム ID。この値は、stream エンドポイントへのリクエストが成功すると返されます。
pd 必須 integer

連続配信広告の再生時間（ミリ秒単位）。
scte35 省略可 string

このミッドロール挿入点の Base64 エンコードされた SCTE-35 信号。
cust_params 省略可 string

アド マネージャー キャンペーンのターゲティングに使用される Key-Value ペアのセット。これらのペアは、URL エンコードされたクエリ文字列として表す必要があります。

例:
パラメータ
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

レスポンスの本文

成功すると、レスポンスの本文は HLS マルチバリアント プレイリストになります。

方法: DASH Pod マニフェスト

クライアントの動画プレーヤーが読み込んで再生する準備ができているライブ配信の MPEG-DASH 連続配信広告マニフェストを取得します。

メソッド
GET GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/pod/{pod_id}/manifest.mpd

広告連続配信の MPEG-DASH mpd 再生リストを取得する API。

HTTP リクエスト

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/stream/{stream_id}/pod/{pod_id}/manifest.mpd?pd={pod_duration}

パスパラメータ

パラメータ
network_code string

パブリッシャーの Google アド マネージャー ネットワーク コード。
custom_asset_key string

Google アド マネージャーでこのイベントに関連付けられているカスタム識別子
stream_id string

現在のユーザーのセッションのストリーム ID。この値は、stream エンドポイントへのリクエストが成功すると返されます。
pod_id integer

現在のミッドロール挿入点の数値 ID。広告連続配信 ID は、広告ブレーク イベントごとに 1 から順に割り当てられます。

クエリ パラメータ

パラメータ
pd 必須 integer

連続配信広告の再生時間（ミリ秒単位）。
scte35 省略可 string

このミッドロール挿入点の Base64 エンコードされた SCTE-35 信号。
cust_params 省略可 string

アド マネージャー キャンペーンのターゲティングに使用される Key-Value ペアのセット。これらのペアは、URL エンコードされたクエリ文字列として表す必要があります。

例:
パラメータ
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

レスポンスの本文

成功した場合、レスポンスの本文は MPEG-DASH mpd プレイリストです。

方法: DASH Pod 期間テンプレート

メソッド
pods GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

Google アド マネージャーから DASH 期間テンプレートをリクエストします。このテンプレートには、ストリーム パラメータで入力する必要があるマクロが含まれています。これらのマクロが入力されると、テンプレートはミッドロール挿入点の期間になり、DASH マニフェストに縫い付けることができます。

HTTP リクエスト

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

パスパラメータ

パラメータ
network_code string

パブリッシャーの Google アド マネージャー ネットワーク コード。

custom_asset_key string

Google アド マネージャーでこのイベントに関連付けられているカスタム ID。

クエリ パラメータ

パラメータ
stream_id 必須 string

現在のユーザーのセッションのストリーム ID。この値は、stream エンドポイントへの成功したリクエストによって返されます。

レスポンスの本文

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

方法: メディアの確認

再生中に広告メディア ID が検出されたら、上記の stream エンドポイントから取得した media_verification_url を使用してすぐにリクエストを行います。これらのリクエストは、サーバーがメディアの検証を開始するサーバーサイド ビーコン ストリームでは必要ありません。

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

メソッド
media verification GET /{media_verification_url}/{ad_media_id}

メディアの検証イベントを API に通知します。

HTTP リクエスト

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

レスポンスの本文

media verification は次のレスポンスを返します。

  • HTTP/1.1 204 No Content: メディアの検証が成功し、すべての ping が送信された場合。
  • HTTP/1.1 404 Not Found: URL の形式が正しくないか、有効期限が切れているためにリクエストでメディアを検証できない場合。
  • HTTP/1.1 404 Not Found: この ID の前回の確認リクエストが成功した場合。
  • HTTP/1.1 409 Conflict: この時点で別のリクエストがすでに ping を送信している場合。

広告メディア ID

広告メディア ID は、個別のメタデータ トラック（HLS トランスポート ストリームの場合はタイミング付きメタデータ、MP4 ファイルの場合は emsg）にエンコードされます。広告メディア識別子は常に文字列 google_ で始まります。

各広告確認リクエストを行う前に、メタデータ エントリのテキスト コンテンツ全体を広告確認 URL に追加する必要があります。

メソッド: metadata

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

メソッド
metadata GET /{metadata_url}/{ad-media-id}

GET /{metadata_url}

広告メタデータ情報を取得します。

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 は ads オブジェクトのインデックス登録に使用され、ミッドロール挿入点 ID は breaks オブジェクトのインデックス登録に使用されます。

Response data

ストリーム

Stream は、新しく作成されたストリームのリソースのリストを JSON 形式でレンダリングするために使用されます。
JSON 表現
{
  "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,
}
フィールド
stream_id string

GAM ストリーム ID。
media_verification_url string

再生イベントのトラッキング用ベースエンドポイントとして使用されるメディア検証 URL。
metadata_url string

今後のストリーミング広告イベントに関する定期的な情報をポーリングするために使用されるメタデータ URL。
session_update_url string

このストリームのターゲティング パラメータを更新するために使用されるセッションの更新 URL。ターゲティング パラメータの元の値は、最初のストリーム作成リクエスト中に取得されます。
heartbeat_url string

サーバーサイド ビーコン ストリームを維持するために使用されるハートビート URL。{PollingFrequency} 秒ごとに ping する必要があります。サーバーサイド ビーコン処理ストリーム用に入力されます。
polling_frequency number

metadata_url または heartbeat_url をリクエストする際のポーリング頻度（秒単位）。
pod_manifest_url string

連続広告配信マニフェスト URL テンプレートは、HLS のマルチバリアント プレイリストの URL または DASH の MPD に対応する、ストリームの連続広告配信マニフェストを取得する URL の生成に使用されます。ダイナミック広告挿入タイプ POD_SERVING_MANIFEST のライブ配信イベントに入力されます。 https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType
manifest_format string

マニフェスト形式は、pod_manifest_url から取得したマニフェストの形式です（dash または hls）。

PodMetadata

PodMetadata には、広告、ミッドロール挿入点、メディア ID タグに関するメタデータ情報が含まれます。
JSON 表現
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}
フィールド
tags map[string, object(TagSegment)]

タグ接頭辞でインデックスに登録されたタグセグメントのマップ。
ads map[string, object(Ad)]

広告 ID でインデックスされた広告のマップ。
ad_breaks map[string, object(AdBreak)]

広告ブレーク ID でインデックスされた広告ブレークのマップ。

TagSegment

TagSegment には、広告、そのミッドロール挿入点、イベントタイプへの参照が含まれます。type="progress" の TagSegment は、広告メディアの検証エンドポイントに ping しないでください。
JSON 表現
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
フィールド
ad string

このタグの広告の ID。
ad_break_id string

このタグの広告ブレークの ID。
type string

このタグのイベントタイプ。

AdBreak

AdBreak は、ストリーム内の 1 つのミッドロール挿入点を表します。長さ、タイプ（ミッドロール/プレロール/ポストロール）、広告数を指定します。
JSON 表現
{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}
フィールド
type string

有効な休憩タイプは、pre、mid、post です。
duration number

このミッドロール挿入点の広告の合計時間（秒単位）。
expected_duration number

すべての広告とスレートを含む広告ブレークの予想される長さ（秒単位）。
ads number

広告ブレーク内の広告の数。
Ad は、ストリーム内の広告を表します。
JSON 表現
{
  "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),
}
フィールド
ad_break_id string

この広告のミッドロール挿入点の ID。
position number

広告ブレーク内のこの広告の位置（1 から始まる）。
duration number

広告の長さ（秒単位）。
title string

広告のタイトル（省略可）。
description string

広告の説明（省略可）。
advertiser string

広告主 ID（省略可）。
ad_system string

オプションの広告システム。
ad_id string

オプションの広告 ID。
creative_id string

クリエイティブ ID（省略可）。
creative_ad_id string

オプションのクリエイティブ広告 ID。
deal_id string

省略可能な取引 ID。
clickthrough_url string

リンク先 URL（省略可）。
click_tracking_urls string

クリック トラッキング URL（省略可）。
verifications [object(Verification)]

サードパーティの測定コードを実行してクリエイティブの再生を検証するために必要なリソースとメタデータを一覧表示する、Open Measurement の検証エントリ（省略可）。
slate boolean

現在のエントリがスレートであることを示すブール値（省略可）
icons [object(Icon)]

アイコンのリスト（空の場合は省略）。
wrappers [object(Wrapper)]

ラッパーのリスト（空の場合は省略）。
universal_ad_id object(UniversalAdID)

オプションのユニバーサル広告 ID。
extensions string

VAST 内のすべての <Extension> ノードのリスト（省略可）。
companions [object(Companion)]

この広告とともに表示されるコンパニオン（省略可）。
interactive_file object(InteractiveFile)

広告の再生中に表示するオプションのインタラクティブ クリエイティブ（SIMID）。

PodTemplateResponse

PodTemplateResponse は、Pod のステッチング用に VTP に返される JSON ペイロードを表します。
JSON 表現
{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}
フィールド
dash_period_template string

DashPeriodTemplate は、ステッチする前に適切なデータで入力する期間の XML テンプレートです。
segment_duration_ms int64

SegmentDurationMS は、期間セグメントの長さ（ミリ秒単位）です。

AdpodTimingMetadataResponse

AdpodTimingMetadataResponse には、広告連続配信と、そのセグメント URL を作成する方法に関する情報が含まれます。
JSON 表現
{
  "status": string,
  "ads": [object(AdRendering)],
  "slate": object(SlateRendering),
  "dash_representations": map[string, object(DASHRepresentation)],
  "dash_adaptation_sets": map[string, object(DASHAdaptationSet)],
}
フィールド
status string

連続配信広告の決定ステータス。
ads [object(AdRendering)]

広告セグメントの URL のレンダリング方法を記述する Ad オブジェクトの配列（インデックスは 0 から始まります）。
slate object(SlateRendering)

スレート セグメント URL のレンダリング方法を説明するスレート。
dash_representations map[string, object(DASHRepresentation)]

DASH マニフェストでレンダリングされる広告連続配信の DASH 表現のリスト。
dash_adaptation_sets map[string, object(DASHAdaptationSet)]

DASH マニフェストでレンダリングされる広告連続配信の DASH 適応セットのリスト。

AdRendering

AdRendering では、決定済みの広告のレンダリング方法について説明します。
JSON 表現
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
フィールド
duration_ms number

広告の長さ（ミリ秒単位）（int）。
variants map[string, object(VariantRendering)]

UI から設定された、パターン/プロファイル ID でインデックス付けされたパターン オブジェクト（下記を参照）の辞書。

SlateRendering

SlateRendering では、スレート コンテンツのレンダリング方法について説明します。
JSON 表現
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
フィールド
duration_ms number

スレートの時間（ミリ秒単位）（int）。
variants map[string, object(VariantRendering)]

パターン オブジェクトのディクショナリ。パターン ID またはプロファイル ID でインデックスが付けられています。 スレート時間は、必要なスレート長に達するまでループする必要があります。反復処理の間に HLS の不連続性を挿入するか、MPEG-DASH の新しい期間をループします。

VariantRendering

VariantRendering は、広告/スレート内の 1 つのバリエーション/プロファイルを表します。
JSON 表現
{
  "segment_extension": string,
  "segment_durations": object(SegmentDurations),
}
フィールド
segment_extension string

文字列（ts、mp4、aac、ac3、ec3、m4a、m4v のいずれか）。 セグメント URL のファイル名拡張子
segment_durations object(SegmentDurations)

SegmentDurations オブジェクト。各セグメントの長さは、セグメントの URL に変換できます。

SegmentDurations

SegmentDurations は、指定された時間単位で、一連のセグメントの長さを表します。
JSON 表現
{
  "timescale": number,
  "values": [],
}
フィールド
timescale number

タイムスケールは 1 秒あたりの単位数（int）です。次のように想定されます。HLS の場合は 1,000（ミリ秒）、DASH 動画の場合は 90,000（PTS）、DASH 音声の場合は音声サンプリング レート。
values number

タイムスケール単位の int セグメント時間の配列。

DASHRepresentation

DASHRepresentation は、DASH マニフェストでレンダリングされる Representation ノードを記述します。
JSON 表現
{
  "codecs": string,
  "bandwidth": number,
  "width": number,
  "height": number,
  "frame_rate": string,
  "audio_sampling_rate": number,
  "audio_channel_config": object(SchemeIDURIAndValue),
}
フィールド
codecs string

表現のコーデック。
bandwidth number

表現の帯域幅。
width number

表現の幅。
height number

表現の高さ。
frame_rate string

表現のフレームレート。
audio_sampling_rate number

表現の音声サンプリング レート。
audio_channel_config object(SchemeIDURIAndValue)

表現のオーディオ チャンネルの構成。

DASHAdaptationSet

DASHAdaptationSet は、DASH マニフェストでレンダリングされる AdaptationSet ノードを記述します。
JSON 表現
{
  "content_type": string,
  "mime_type": string,
  "role": object(SchemeIDURIAndValue),
  "inband_event_stream": object(SchemeIDURIAndValue),
  "min_frame_rate": string,
  "max_frame_rate": string,
  "scan_type": string,
  "start_with_sap": string,
  "segment_alignment": boolean,
  "representations": [],
}
フィールド
content_type string

適応セットのコンテンツ タイプ。
mime_type string

適応セットの MIME タイプ。
role object(SchemeIDURIAndValue)

適応セットの役割。
inband_event_stream object(SchemeIDURIAndValue)

適応セットのインバンド イベント ストリーム。
min_frame_rate string

適応セットの最小フレームレート。
max_frame_rate string

適応セットの最大フレームレート。
scan_type string

適応セットのスキャンタイプ。
start_with_sap string

まず、適応セットの SAP から始めます。
segment_alignment boolean

アダプテーション セットのセグメントの配置。
representations string

アダプテーション セットを表します。

SchemeIDURIAndValue

SchemeIDURIAndValue は、スキーム ID とその値のペアです。
JSON 表現
{
  "scheme_id_uri": string,
  "value": string,
}
フィールド
scheme_id_uri string

値のスキーマ ID URI。
value string

スキーム ID URI の値。

アイコン

Icon には、VAST アイコンに関する情報が含まれます。
JSON 表現
{
  "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,
}
フィールド
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

ClickData には、アイコンのクリックスルーに関する情報が含まれます。
JSON 表現
{
  "url": string,
}
フィールド
url string

FallbackImage

FallbackImage には、VAST 代替画像に関する情報が含まれます。
JSON 表現
{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}
フィールド
creative_type string

height int32

width int32

resource string

alt_text string

ラッパー

Wrapper には、ラッパー広告に関する情報が含まれます。取引 ID が存在しない場合、取引 ID は含まれません。
JSON 表現
{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}
フィールド
system string

広告システムの ID。
ad_id string

ラッパー広告に使用される広告 ID。
creative_id string

ラッパー広告に使用されるクリエイティブ ID。
creative_ad_id string

ラッパー広告に使用されるクリエイティブ広告 ID。
deal_id string

ラッパ―広告の取引 ID（省略可）。

確認

検証には、第三者の視認性と検証の測定を容易にする Open Measurement に関する情報が含まれています。現在、JavaScript リソースのみがサポートされています。https://iabtechlab.com/standards/open-measurement-sdk/ をご覧ください。
JSON 表現
{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}
フィールド
vendor string

検証ベンダー。
java_script_resources [object(JavaScriptResource)]

検証用の JavaScript リソースのリスト。
tracking_events [object(TrackingEvent)]

検証用のトラッキング イベントのリスト。
parameters string

ブートストラップ確認コードに渡される不透明な文字列。

JavaScriptResource

JavaScriptResource には、JavaScript による検証に関する情報が含まれます。
JSON 表現
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
フィールド
script_url string

JavaScript ペイロードの URI。
api_framework string

APIFramework は、検証コードを実行する動画フレームワークの名前です。
browser_optional boolean

このスクリプトをブラウザの外部で実行できるかどうか。

TrackingEvent

TrackingEvent には、特定の状況でクライアントが ping する必要がある URL が含まれています。
JSON 表現
{
  "event": string,
  "uri": string,
}
フィールド
event string

トラッキング イベントのタイプ。
uri string

ping を送信するトラッキング イベント。

UniversalAdID

UniversalAdID は、広告システム間で維持される一意のクリエイティブ ID を提供するために使用されます。
JSON 表現
{
  "id_value": string,
  "id_registry": string,
}
フィールド
id_value string

広告に選択したクリエイティブのユニバーサル広告 ID。
id_registry string

選択したクリエイティブのユニバーサル広告 ID がカタログ化されているレジストリ ウェブサイトの URL を識別するために使用される文字列。

コンパニオン モード

コンパニオンには、広告とともに表示されるコンパニオン広告に関する情報が含まれます。
JSON 表現
{
  "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)],
}
フィールド
click_data object(ClickData)

このコンパニオンのクリックデータ。
creative_type string

静的タイプのコンパニオンの場合は、VAST の <StaticResource> ノードにある CreativeType 属性。
height int32

このコンパニオンの高さ（ピクセル単位）。
width int32

このコンパニオンの幅（ピクセル単位）。
resource string

静的コンパニオンと iframe コンパニオンの場合、これは読み込まれて表示される URL です。HTML コンパニオンの場合は、コンパニオンとして表示する HTML スニペットになります。
type string

このコンパニオンのタイプ。静的、iframe、HTML のいずれかです。
ad_slot_id string

このコンパニオンのスロット ID。
api_framework string

このコンパニオンの API フレームワーク。
tracking_events [object(TrackingEvent)]

このコンパニオンのトラッキング イベントのリスト。

InteractiveFile

InteractiveFile には、広告の再生中に表示するインタラクティブ クリエイティブ（SIMID など）の情報が含まれます。
JSON 表現
{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}
フィールド
resource string

インタラクティブ クリエイティブの URL。
type string

リソースとして指定されたファイルの MIME タイプ。
variable_duration boolean

このクリエイティブで再生時間の延長をリクエストできるかどうか。
ad_parameters string

VAST の <AdParameters> ノードの値。