- 資源:Advertiser
- AdvertiserGeneralConfig
- AdvertiserAdServerConfig
- ThirdPartyOnlyConfig
- CmHybridConfig
- AdvertiserCreativeConfig
- AdvertiserDataAccessConfig
- AdvertiserSdfConfig
- AdvertiserTargetingConfig
- 方法
資源:Advertiser
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」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
generalConfig |
必要欄位。廣告客戶的一般設定。 |
adServerConfig |
必要欄位。無法變更。廣告主的廣告伺服器相關設定。 |
creativeConfig |
必要欄位。廣告主的廣告素材相關設定。 |
dataAccessConfig |
控管廣告主資料存取權的設定。 |
integrationDetails |
廣告客戶的整合詳細資料。廣告主目前僅適用於 |
servingConfig |
與廣告主廣告放送相關的指定目標設定。 |
prismaEnabled |
是否啟用與 Mediaocean (Prisma) 整合。選擇啟用即表示你同意以下內容: 本人謹代表本公司授權 Mediaocean (Prisma) 將預算區隔企劃書傳送給 Google,並授權 Google 透過 DV360 將相應的報表和月結單傳送給 Mediaocean,以便這個廣告主規劃預算、計費及對帳。 |
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, "cmSyncableSiteIds": [ string ], "dv360ToCmDataSharingEnabled": boolean, "dv360ToCmCostReportingEnabled": boolean, "cmFloodlightLinkingAuthorized": boolean } |
欄位 | |
---|---|
cmAccountId |
必要欄位。無法變更。與 DV360 廣告主建立連結的 CM360 Floodlight 設定帳戶 ID。 |
cmFloodlightConfigId |
必要欄位。無法變更。與 DV360 廣告主連結的 CM360 Floodlight 設定 ID。 |
cmSyncableSiteIds[] |
系統會將刊登位置同步至 DV360 的 CM360 網站清單。 如果 從這份清單中移除網站,可能會導致從 CM360 同步的 DV360 廣告素材遭到刪除。必須至少指定一個網站。 |
dv360ToCmDataSharingEnabled |
是否將 DV360 資料納入 CM360 資料移轉報表中。 |
dv360ToCmCostReportingEnabled |
選擇是否要向 CM360 回報 DV360 費用。 |
cmFloodlightLinkingAuthorized |
必要欄位。無法變更。將這個欄位設為「 |
AdvertiserCreativeConfig
廣告客戶的廣告素材相關設定。
JSON 表示法 |
---|
{ "iasClientId": string, "obaComplianceDisabled": boolean, "dynamicCreativeEnabled": boolean, "videoCreativeDataSharingAuthorized": boolean } |
欄位 | |
---|---|
iasClientId |
用於設定 Integral Ad Service (IAS) 廣告活動監控功能的 ID。DV360 系統會在廣告素材代碼中附加一個內含這個 ID 的 IAS「廣告活動監控器」代碼。 |
obaComplianceDisabled |
是否遵循 DV360 的「線上行為廣告」(OBA) 規定。 警告:變更 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 |
連網電視裝置是否免除該廣告客戶所有影片委刊項的可視度指定目標。 |
方法 |
|
---|---|
|
稽核廣告客戶。 |
|
在單一廣告客戶中大量編輯指定目標選項。 |
|
根據不同的指定類型,列出廣告主的指派指定目標選項。 |
|
建立新的廣告客戶。 |
|
刪除廣告客戶。 |
|
取得廣告客戶。 |
|
列出目前使用者可存取的廣告主。 |
|
更新現有的廣告客戶。 |