- 資源:廣告主
- AdvertiserGeneralConfig
- AdvertiserAdServerConfig
- ThirdPartyOnlyConfig
- CmHybridConfig
- AdvertiserCreativeConfig
- AdvertiserDataAccessConfig
- AdvertiserSdfConfig
- AdvertiserTargetingConfig
- AdvertiserBillingConfig
- 方法
資源:廣告主
Display & Video 360 (DV360) 中的單一廣告客戶。
JSON 表示法 |
---|
{ "name": string, "advertiserId": string, "partnerId": string, "displayName": string, "entityStatus": enum ( |
欄位 | |
---|---|
name |
僅供輸出。廣告客戶的資源名稱。 |
advertiserId |
僅供輸出。廣告客戶的專屬 ID。由系統指派。 |
partnerId |
必要欄位。不可變動。廣告客戶所屬合作夥伴的專屬 ID。 |
displayName |
必要欄位。廣告客戶的顯示名稱。 必須使用 UTF-8 編碼,且大小上限為 240 個位元組。 |
entityStatus |
必要欄位。控管廣告客戶的廣告訂單和委刊項能否支出預算及對廣告空間出價。
|
updateTime |
僅供輸出。廣告客戶上次更新時的時間戳記。由系統指派。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
generalConfig |
必要欄位。廣告客戶的一般設定。 |
adServerConfig |
必要欄位。不可變動。廣告主的廣告伺服器相關設定。 |
creativeConfig |
必要欄位。廣告主的廣告素材相關設定。 |
dataAccessConfig |
控管廣告主資料存取方式的設定。 |
integrationDetails |
廣告客戶的整合詳細資料。目前只有 |
servingConfig |
與廣告主廣告放送相關的指定目標設定。 |
prismaEnabled |
是否已啟用 Mediaocean (Prisma) 整合功能。啟用這項功能即代表您同意下列條款: 本人謹代表本公司授權 Mediaocean (Prisma) 將預算區隔企劃書傳送給 Google,並授權 Google 透過 DV360 將相應的報表和月結單傳送給 Mediaocean,以便這個廣告主規劃預算、計費及對帳。 |
billingConfig |
廣告主的帳單相關設定。 |
AdvertiserGeneralConfig
廣告客戶的一般設定。
JSON 表示法 |
---|
{ "domainUrl": string, "timeZone": string, "currencyCode": string } |
欄位 | |
---|---|
domainUrl |
必要欄位。廣告客戶主要網站的網域網址。系統會將這項資訊傳送給發布商,表示發布商必須提供網站網址,才能將廣告活動與廣告客戶建立關聯。 請提供不含路徑或查詢字串的網址,開頭須為 |
timeZone |
僅供輸出。廣告客戶時區的標準 TZ 資料庫名稱,例如 詳情請參閱:https://en.wikipedia.org/wiki/List_of_tz_database_time_zones 如果是 CM360 混合型廣告客戶,時區會與相關聯的 CM360 帳戶相同;如果是僅限第三方的廣告客戶,時區會與上層合作夥伴的時區相同。 |
currencyCode |
必要欄位。不可變動。採用 ISO 4217 格式的廣告主貨幣。 接受的代碼及其代表的貨幣如下: 貨幣代碼:貨幣名稱
|
AdvertiserAdServerConfig
廣告客戶的廣告伺服器相關設定。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 ad_server_config_scheme 。必要欄位。ad_server_config_scheme 只能是下列其中一項: |
|
thirdPartyOnlyConfig |
僅限使用第三方廣告伺服器的廣告主設定。 |
cmHybridConfig |
適用於同時使用 Campaign Manager 360 (CM360) 和第三方廣告伺服器的廣告客戶設定。 |
ThirdPartyOnlyConfig
僅適用於使用第三方廣告伺服器的廣告客戶設定。
JSON 表示法 |
---|
{ "pixelOrderIdReportingEnabled": boolean } |
欄位 | |
---|---|
pixelOrderIdReportingEnabled |
是否已啟用像素的訂單 ID 報表功能。這個值設為 |
CmHybridConfig
適用於同時使用 Campaign Manager 360 (CM360) 和第三方廣告伺服器的廣告客戶設定。
JSON 表示法 |
---|
{ "cmAccountId": string, "cmFloodlightConfigId": string, "cmAdvertiserIds": [ string ], "cmSyncableSiteIds": [ string ], "dv360ToCmDataSharingEnabled": boolean, "dv360ToCmCostReportingEnabled": boolean, "cmFloodlightLinkingAuthorized": boolean } |
欄位 | |
---|---|
cmAccountId |
必要欄位。不可變動。與 DV360 廣告主連結的 CM360 Floodlight 設定帳戶 ID。 |
cmFloodlightConfigId |
必要欄位。不可變動。與 DV360 廣告主連結的 CM360 Floodlight 設定 ID。 |
cmAdvertiserIds[] |
僅供輸出。共用 CM360 Floodlight 設定的 CM360 廣告主 ID 組合。 |
cmSyncableSiteIds[] |
CM360 網站清單,這些網站的刊登位置將同步處理至 DV360 做為廣告素材。 如果 從這份清單中移除網站,可能會導致從 CM360 同步的 DV360 廣告素材遭到刪除。請至少指定一個網站。 |
dv360ToCmDataSharingEnabled |
是否在 CM360 資料移轉報表中納入 DV360 資料。 |
dv360ToCmCostReportingEnabled |
是否向 CM360 回報 DV360 費用。 |
cmFloodlightLinkingAuthorized |
必要欄位。不可變動。將這個欄位設為「 |
AdvertiserCreativeConfig
廣告主的廣告素材相關設定。
JSON 表示法 |
---|
{ "iasClientId": string, "obaComplianceDisabled": boolean, "dynamicCreativeEnabled": boolean, "videoCreativeDataSharingAuthorized": boolean } |
欄位 | |
---|---|
iasClientId |
用於設定 Integral Ad Service (IAS) 廣告活動監控功能的 ID。DV360 系統會將內含這個 ID 的 IAS「Campaign Monitor」代碼附加到廣告素材代碼中。 |
obaComplianceDisabled |
是否停用 Google 的「關於這則廣告」功能,會在廣告加入「線上行為廣告」(OBA) 和法規要求時加入徽章 (以識別廣告內容) 和透明度資訊 (與「關於這則廣告」互動)。關於這則廣告,使用者能進一步掌控自己看到的廣告,並解釋他們看見廣告的原因。瞭解詳情。 請注意,如果選擇將這個欄位設為
|
dynamicCreativeEnabled |
是否為廣告客戶啟用動態廣告素材。 |
videoCreativeDataSharingAuthorized |
將這個欄位設為「 只有在廣告主進行 |
AdvertiserDataAccessConfig
控管廣告主相關資料存取方式的設定。
JSON 表示法 |
---|
{
"sdfConfig": {
object ( |
欄位 | |
---|---|
sdfConfig |
廣告客戶的結構化資料檔案 (SDF) 設定。 如未指定,則會使用上層夥伴的 SDF 設定。 |
AdvertiserSdfConfig
廣告客戶的結構化資料檔案 (SDF) 設定。
JSON 表示法 |
---|
{
"overridePartnerSdfConfig": boolean,
"sdfConfig": {
object ( |
欄位 | |
---|---|
overridePartnerSdfConfig |
這個廣告主是否會覆寫上層夥伴的 SDF 設定。 根據預設,廣告客戶會沿用上層夥伴的 SDF 設定。如要覆寫合作夥伴設定,請將這個欄位設為 |
sdfConfig |
廣告客戶的 SDF 設定。
|
AdvertiserTargetingConfig
與廣告主廣告放送相關的指定目標設定。
JSON 表示法 |
---|
{ "exemptTvFromViewabilityTargeting": boolean } |
欄位 | |
---|---|
exemptTvFromViewabilityTargeting |
連網電視裝置是否不必針對廣告主的所有影片委刊項指定可視度。 |
AdvertiserBillingConfig
廣告客戶的帳單相關設定。
JSON 表示法 |
---|
{ "billingProfileId": string } |
欄位 | |
---|---|
billingProfileId |
指派給廣告客戶的帳單資料 ID。 如果未提供值,這個欄位將預設為廣告主上層夥伴的預設帳單資料 ID。 |
方法 |
|
---|---|
|
稽核廣告客戶。 |
|
建立新的廣告客戶。 |
|
刪除廣告客戶。 |
|
編輯單一廣告主的指定目標選項。 |
|
取得廣告主。 |
|
列出目前使用者可存取的廣告主。 |
|
列出廣告客戶在不同指定類型中的指派的指定目標選項。 |
|
更新現有的廣告客戶。 |