付録: クリエイティブ タイプ別に 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 フィールド名:addedTag
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名: notes
監査ステータス
読み取り専用
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
exit
必須
API フィールド名: exitEvents[]
終了イベントのタイプ: EXIT_EVENT_TYPE_DEFAULT
カウンタ
省略可
API フィールド名:counterEvents[]
タイマー
省略可
API フィールド名:タイマー Events[]
追加の HTML トラッキング タグ
省略可
API フィールド名:addedTag
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名: notes
監査ステータス
省略可
API フィールド名: reviewStatus

第三者ディスプレイ クリエイティブ

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

第三者のエキスパンド クリエイティブ

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

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

クリエイティブ タイプ: CREATIVE_TYPE_AUDIO
ホスティング ソース: HOSTING_SOURCE_THIRD_PARTY
名前
必須
API フィールド名: displayName
ステータス
必須
API フィールド名: entityStatus
VAST タグ URL
必須
API フィールド名: vastTagUrl
アトリビューションに ping が必要
省略可
API フィールド名: needPingForAttribution
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名: notes
監査ステータス
読み取り専用
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 フィールド名: スキップ可能
スキップまでの再生時間
省略可
API フィールド名:SkipOffset
課金までの再生時間
省略可
API フィールド名: progressOffset
ユニバーサル広告 ID
省略可
API フィールド名: universalAdId
OBA
省略可
API フィールド名: obaIcon
コンパニオン クリエイティブ
省略可
API フィールド名:companionCreativeIds
配信ファイル
読み取り専用
API フィールド名: トランスコード
第三者 URL
省略可
API フィールド名: thirdPartyUrls
統合コード
省略可
API フィールド名: integrationCode
省略可
API フィールド名: notes
監査ステータス
読み取り専用
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 フィールド名: notes
監査ステータス
読み取り専用
API フィールド名: reviewStatus

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

クリエイティブ タイプ: CREATIVE_TYPE_NATIVE、CREATIVE_TYPE_NATIVE_SITE_SQUARE
ホスティング ソース: HOSTING_SOURCE_HOSTED
名前
必須
API フィールド名: displayName
ステータス
必須
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 フィールド名: notes
監査ステータス
読み取り専用
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 フィールド名: notes
監査ステータス
読み取り専用
API フィールド名: reviewStatus