付録: クリエイティブ タイプ別に 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 フィールド名: integrationCode
|
|
|
注
|
|
|
監査ステータス
|
|
読み取り専用 |
|
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 フィールド名: integrationCode
|
|
|
注
|
|
|
監査ステータス
|
|
省略可
|
|
API フィールド名: reviewStatus
|
|
第三者ディスプレイ クリエイティブ
| クリエイティブ タイプ: CREATIVE_TYPE_STANDARD |
| ホスティング ソース: HOSTING_SOURCE_THIRD_PARTY |
|
名前
|
|
必須
|
|
API フィールド名: displayName
|
|
|
ステータス |
|
必須
|
|
API フィールド名: entityStatus
|
|
|
ディメンション
|
|
|
ランディング ページ URL
|
|
必須
|
|
API フィールド名: exitEvents[].url
|
|
終了イベントのタイプ: EXIT_EVENT_TYPE_DEFAULT
|
|
|
MRAID が必要。
|
|
省略可
|
|
API フィールド名: needMraid
|
|
|
HTML5 が必要
|
|
省略可
|
|
API フィールド名: needHTML5
|
|
|
第三者タグ
|
|
必須
|
|
API フィールド名: thirdPartyTag
|
|
|
アトリビューションに ping が必要
|
|
省略可
|
|
API フィールド名: needPingForAttribution
|
|
|
統合コード
|
|
省略可
|
|
API フィールド名: integrationCode
|
|
|
注
|
|
|
監査ステータス
|
|
読み取り専用 |
|
API フィールド名: reviewStatus
|
|
第三者のエキスパンド クリエイティブ
| クリエイティブ タイプ: CREATIVE_TYPE_EXPANDABLE |
| ホスティング ソース: HOSTING_SOURCE_THIRD_PARTY |
|
名前
|
|
必須
|
|
API フィールド名: displayName
|
|
|
ステータス |
|
必須
|
|
API フィールド名: entityStatus
|
|
|
ディメンション
|
|
|
ランディング ページ 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 フィールド名: reviewStatus
|
|
第三者の動画クリエイティブ
| クリエイティブ タイプ: CREATIVE_TYPE_VIDEO |
| ホスティング ソース: HOSTING_SOURCE_THIRD_PARTY |
|
名前
|
|
必須
|
|
API フィールド名: displayName
|
|
|
ステータス |
|
必須
|
|
API フィールド名: entityStatus
|
|
|
VAST タグ URL
|
|
必須
|
|
API フィールド名: vastTagUrl
|
|
|
VPAID
|
|
|
HTML5 動画
|
|
読み取り専用 |
|
API フィールド名: html5Video
|
|
|
アトリビューションに ping が必要
|
|
省略可
|
|
API フィールド名: needPingForAttribution
|
|
|
統合コード
|
|
省略可
|
|
API フィールド名: integrationCode
|
|
|
注
|
|
|
監査ステータス
|
|
読み取り専用 |
|
API フィールド名: reviewStatus
|
|
第三者オーディオ クリエイティブ
| クリエイティブ タイプ: CREATIVE_TYPE_AUDIO |
| ホスティング ソース: HOSTING_SOURCE_THIRD_PARTY |
|
名前
|
|
必須
|
|
API フィールド名: displayName
|
|
|
ステータス |
|
必須
|
|
API フィールド名: entityStatus
|
|
|
VAST タグ URL
|
|
必須
|
|
API フィールド名: vastTagUrl
|
|
|
アトリビューションに ping が必要
|
|
省略可
|
|
API フィールド名: needPingForAttribution
|
|
|
統合コード
|
|
省略可
|
|
API フィールド名: integrationCode
|
|
|
注
|
|
|
監査ステータス
|
|
読み取り専用 |
|
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 フィールド名:SkipOffset
|
|
|
課金までの再生時間
|
|
省略可
|
|
API フィールド名: progressOffset
|
|
|
ユニバーサル広告 ID
|
|
省略可
|
|
API フィールド名: universalAdId
|
|
|
OBA
|
|
|
コンパニオン クリエイティブ
|
|
省略可
|
|
API フィールド名:companionCreativeIds
|
|
|
配信ファイル
|
|
読み取り専用 |
|
API フィールド名: トランスコード
|
|
|
第三者 URL
|
|
省略可
|
|
API フィールド名: thirdPartyUrls
|
|
|
統合コード
|
|
省略可
|
|
API フィールド名: integrationCode
|
|
|
注
|
|
|
監査ステータス
|
|
読み取り専用 |
|
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 フィールド名: 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 フィールド名: 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 フィールド名: reviewStatus
|
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2023-12-01 UTC。
[null,null,["最終更新日 2023-12-01 UTC。"],[[["This document provides a comprehensive mapping of UI fields to their corresponding API fields for various creative types, including Standard Image, HTML5, Third-Party Display, Third-Party Expandable, Third-Party Video, Third-Party Audio, Video, Audio, Native Display, and Native Video."],["Each creative type has a specific set of required and optional fields, along with their API field names and any further specifications for asset roles or exit event types."],["Creative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names."],["Campaign Manager 360 tracking ad can optionally be included using the `cmTrackingAd` API field."],["This mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system."]]],[]]
