付録: クリエイティブ タイプ別に UI フィールドを API フィールドにマッピングする

次の表に、UI フィールドと対応する API フィールドを示します。クリエイティブ タイプごとに分類されています。一部の API フィールドでは、指定されたリソースのロールまたはタイプを指定する必要があります。

標準の画像クリエイティブ

クリエイティブ タイプ: CREATIVE_TYPE_STANDARD
ホスティング ソース: HOSTING_SOURCE_HOSTED
名前
必須
API フィールド名: displayName
クリエイティブ アセット
必須
API フィールド名: assets
アセットロール: ASSET_ROLE_MAIN
ランディング ページ URL
必須
API フィールド名: exitEvents[].url
終了イベントの種類: EXIT_EVENT_TYPE_DEFAULT
ステータス
必須
API フィールド名: entityStatus
追加された HTML トラッキング タグ
省略可
API フィールド名: appendedTag
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名:
監査ステータス
読み取り専用
API フィールド名: reviewStatus

HTML5 クリエイティブ

クリエイティブ タイプ: CREATIVE_TYPE_STANDARD
ホスティング ソース: HOSTING_SOURCE_HOSTED
名前
必須
API フィールド名: displayName
クリエイティブ アセット
必須
API フィールド名: assets
アセットロール: ASSET_ROLE_MAIN
ステータス
必須
API フィールド名: entityStatus
代替画像
省略可
API フィールド名: assets
アセットロール: ASSET_ROLE_BACKUP
代替のランディング ページ URL
省略可
API フィールド名: exitEvents[].url
終了イベントの種類: EXIT_EVENT_TYPE_BACKUP
代替画像の exit レポートラベル
省略可
API フィールド名: exitEvents[].reportingName
終了イベントの種類: EXIT_EVENT_TYPE_BACKUP
ポライトロード画像
省略可
API フィールド名: assets
アセットロール: ASSET_ROLE_POLITE_LOAD
離脱
必須
API フィールド名: exitEvents[]
終了イベントの種類: EXIT_EVENT_TYPE_DEFAULT
カウンタ
省略可
API フィールド名: counterEvents[]
タイマー
省略可
API フィールド名: timerEvents[]
追加された HTML トラッキング タグ
省略可
API フィールド名: appendedTag
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名:
監査ステータス
省略可
API フィールド名: reviewStatus

サードパーティ ディスプレイ クリエイティブ

クリエイティブ タイプ: CREATIVE_TYPE_STANDARD
ホスティング ソース: HOSTING_SOURCE_THIRD_PARTY
名前
必須
API フィールド名: displayName
ステータス
必須
API フィールド名: entityStatus
ディメンション
必須
API フィールド名: ディメンション
ランディング ページ URL
必須
API フィールド名: exitEvents[].url
終了イベントの種類: EXIT_EVENT_TYPE_DEFAULT
MRAID が必要
省略可
API フィールド名: requireMraid
HTML5 が必要
省略可
API フィールド名: requireHtml5
サードパーティ タグ
必須
API フィールド名: thirdPartyTag
アトリビューションに ping が必要
省略可
API フィールド名: requirePingForAttribution
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名:
監査ステータス
読み取り専用
API フィールド名: reviewStatus

サードパーティのエキスパンド クリエイティブ

クリエイティブ タイプ: CREATIVE_TYPE_EXPANDABLE
ホスティング ソース: HOSTING_SOURCE_THIRD_PARTY
名前
必須
API フィールド名: displayName
ステータス
必須
API フィールド名: entityStatus
ディメンション
必須
API フィールド名: ディメンション
ランディング ページ URL
必須
API フィールド名: exitEvents[].url
終了イベントの種類: EXIT_EVENT_TYPE_DEFAULT
MRAID が必要
省略可
API フィールド名: requireMraid
HTML5 が必要
省略可
API フィールド名: requireHtml5
エキスパンド方向
必須
API フィールド名: expandingDirection
カーソルを合わせて展開
省略可
API フィールド名: expandOnHover
サードパーティ
必須
API フィールド名: thirdPartyTag
アトリビューションに ping が必要
省略可
API フィールド名: requirePingForAttribution
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名:
監査ステータス
読み取り専用
API フィールド名: reviewStatus

サードパーティ動画クリエイティブ

クリエイティブ タイプ: CREATIVE_TYPE_VIDEO
ホスティング ソース: HOSTING_SOURCE_THIRD_PARTY
名前
必須
API フィールド名: displayName
ステータス
必須
API フィールド名: entityStatus
VAST タグ URL
必須
API フィールド名: vastTagUrl
VPAID
読み取り専用
API フィールド名: vpaid
HTML5 動画
読み取り専用
API フィールド名: html5Video
アトリビューションに ping が必要
省略可
API フィールド名: requirePingForAttribution
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名:
監査ステータス
読み取り専用
API フィールド名: reviewStatus

第三者オーディオ クリエイティブ

クリエイティブ タイプ: CREATIVE_TYPE_AUDIO
ホスティング ソース: HOSTING_SOURCE_THIRD_PARTY
名前
必須
API フィールド名: displayName
ステータス
必須
API フィールド名: entityStatus
VAST タグ URL
必須
API フィールド名: vastTagUrl
アトリビューションに ping が必要
省略可
API フィールド名: requirePingForAttribution
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名:
監査ステータス
読み取り専用
API フィールド名: reviewStatus

動画クリエイティブ

クリエイティブ タイプ: CREATIVE_TYPE_VIDEO
ホスティング ソース: HOSTING_SOURCE_HOSTED
名前
必須
API フィールド名: displayName
ステータス
必須
API フィールド名: entityStatus
ソースファイル
必須
API フィールド名: assets
アセットロール: ASSET_ROLE_MAIN
ランディング ページ URL
必須
API フィールド名: exitEvents[].url
終了イベントの種類: EXIT_EVENT_TYPE_DEFAULT
スキップボタンを含める
省略可
API フィールド名: skippable
スキップまでの再生時間
省略可
API フィールド名: skipOffset
課金までの再生時間
省略可
API フィールド名: progressOffset
ユニバーサル広告 ID
省略可
API フィールド名: universalAdId
OBA
省略可
API フィールド名: obaIcon
コンパニオン クリエイティブ
省略可
API フィールド名: companionCreativeIds
配信ファイル
読み取り専用
API フィールド名: transcodes
第三者 URL
省略可
API フィールド名: thirdPartyUrls
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名:
監査ステータス
読み取り専用
API フィールド名: reviewStatus

オーディオ クリエイティブ

クリエイティブ タイプ: CREATIVE_TYPE_AUDIO
ホスティング ソース: HOSTING_SOURCE_HOSTED
名前
必須
API フィールド名: displayName
ステータス
必須
API フィールド名: entityStatus
ソースファイル
必須
API フィールド名: assets
アセットロール: ASSET_ROLE_MAIN
ランディング ページ URL
必須
API フィールド名: exitEvents[].url
終了イベントの種類: EXIT_EVENT_TYPE_DEFAULT
コンパニオン アセット(アップロードまたは割り当て)
必須
API フィールド名: companionCreativeIds
配信ファイル名
読み取り専用
API フィールド名: transcodes[].name
配信ファイル形式
読み取り専用
API フィールド名: transcodes[].mimeType
配信ファイルのオーディオ ビット レート
読み取り専用
API フィールド名: transcodes[].audioBitRateKbps
サービング ファイルの音声サンプルレート
読み取り専用
API フィールド名: transcodes[].audioSampleRateHz
第三者 URL
省略可
API フィールド名: thirdPartyUrls
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名:
監査ステータス
読み取り専用
API フィールド名: reviewStatus

ネイティブ ディスプレイ クリエイティブ

クリエイティブ タイプ: CREATIVE_TYPE_NATIVE、CREATIVE_TYPE_NATIVE_SITE_SQUARE
ホスティング ソース: HOSTING_SOURCE_HOSTED
名前
必須
API フィールド名: displayName
status
必須
API フィールド名: entityStatus
ロゴ
必須
API フィールド名: assets
アセットのロール: ASSET_ROLE_ICON
画像 / スクエア画像
必須
API フィールド名: assets
アセットロール: ASSET_ROLE_MAIN
見出し
必須
API フィールド名: assets
アセットのロール: ASSET_ROLE_HEADLINE
長い広告見出し
省略可
API フィールド名: assets
アセットのロール: ASSET_ROLE_LONG_HEADLINE
本文
必須
API フィールド名: assets
アセットロール: ASSET_ROLE_BODY
長い本文
省略可
API フィールド名: assets
アセットのロール: ASSET_ROLE_LONG_BODY
ランディング ページ URL
必須
API フィールド名: exitEvents[].url
終了イベントの種類: EXIT_EVENT_TYPE_DEFAULT
キャプション URL
必須
API フィールド名: assets
アセットのロール: ASSET_ROLE_CAPTION_URL
行動を促すフレーズ
必須
API フィールド名: assets
アセットのロール: ASSET_ROLE_CALL_TO_ACTION
キャンペーン マネージャー 360 のトラッキング広告
省略可
API フィールド名: cmTrackingAd
インプレッション トラッキング URL 1
省略可
API フィールド名: trackingUrls[]
インプレッション トラッキング URL 2
省略可
API フィールド名: trackingUrls[]
JavaScript トラッキング URL
省略可
API フィールド名: jsTrackerUrl
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名:
監査ステータス
読み取り専用
API フィールド名: reviewStatus

ネイティブ動画クリエイティブ

クリエイティブ タイプ: CREATIVE_TYPE_NATIVE_VIDEO
ホスティング ソース: HOSTING_SOURCE_HOSTED
名前
必須
API フィールド名: displayName
ステータス
必須
API フィールド名: entityStatus
ロゴ
必須
API フィールド名: assets
アセットのロール: ASSET_ROLE_ICON
動画
必須
API フィールド名: assets
アセットロール: ASSET_ROLE_MAIN
カバー画像
必須
API フィールド名: assets
アセットロール: ASSET_ROLE_COVER_IMAGE
広告主名
必須
API フィールド名: assets
アセットのロール: ASSET_ROLE_ADVERTISER_NAME
見出し
必須
API フィールド名: assets
アセットのロール: ASSET_ROLE_HEADLINE
長い広告見出し
省略可
API フィールド名: assets
アセットのロール: ASSET_ROLE_LONG_HEADLINE
本文
必須
API フィールド名: assets
アセットロール: ASSET_ROLE_BODY
長い本文
省略可
API フィールド名: assets
アセットのロール: ASSET_ROLE_LONG_BODY
ランディング ページ URL
必須
API フィールド名: exitEvents[].url
終了イベントの種類: EXIT_EVENT_TYPE_DEFAULT
キャプション URL
必須
API フィールド名: assets
アセットのロール: ASSET_ROLE_CAPTION_URL
行動を促すフレーズ
必須
API フィールド名: assets
アセットのロール: ASSET_ROLE_CALL_TO_ACTION
インプレッション トラッキング URL 1
省略可
API フィールド名: trackingUrls[]
インプレッション トラッキング URL 2
省略可
API フィールド名: trackingUrls[]
JavaScript トラッキング URL
省略可
API フィールド名: jsTrackerUrl
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名:
監査ステータス
読み取り専用
API フィールド名: reviewStatus