REST Resource: advertisers

資源:Advertiser

Display & Video 360 (DV360) 中的單一廣告客戶。

JSON 表示法
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean
}
欄位
name

string

僅供輸出。廣告客戶的資源名稱。

advertiserId

string (int64 format)

僅供輸出。廣告客戶的專屬 ID。由系統指派。

partnerId

string (int64 format)

必要欄位。無法變更。廣告客戶所屬的合作夥伴專屬 ID。

displayName

string

必要欄位。廣告客戶的顯示名稱。

必須採用 UTF-8 編碼,且大小不得超過 240 個位元組。

entityStatus

enum (EntityStatus)

必要欄位。控制廣告主的廣告訂單和委刊項能否支出預算及對廣告空間出價。

  • 可接受的值為 ENTITY_STATUS_ACTIVEENTITY_STATUS_PAUSEDENTITY_STATUS_SCHEDULED_FOR_DELETION
  • 如果設為 ENTITY_STATUS_SCHEDULED_FOR_DELETION,系統就會在第一次安排刪除的 30 天後刪除廣告主。
updateTime

string (Timestamp format)

僅供輸出。廣告客戶上次更新時的時間戳記。由系統指派。

RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

generalConfig

object (AdvertiserGeneralConfig)

必要欄位。廣告客戶的一般設定。

adServerConfig

object (AdvertiserAdServerConfig)

必要欄位。無法變更。廣告主的廣告伺服器相關設定。

creativeConfig

object (AdvertiserCreativeConfig)

必要欄位。廣告主的廣告素材相關設定。

dataAccessConfig

object (AdvertiserDataAccessConfig)

控管廣告主資料存取權的設定。

integrationDetails

object (IntegrationDetails)

廣告客戶的整合詳細資料。廣告主目前僅適用於 integrationCode。系統不支援 IntegrationDetails 的其他欄位,因此系統會忽略這些欄位 (如有提供)。

servingConfig

object (AdvertiserTargetingConfig)

與廣告主廣告放送相關的指定目標設定。

prismaEnabled

boolean

是否啟用與 Mediaocean (Prisma) 整合。選擇啟用即表示你同意以下內容:

本人謹代表本公司授權 Mediaocean (Prisma) 將預算區隔企劃書傳送給 Google,並授權 Google 透過 DV360 將相應的報表和月結單傳送給 Mediaocean,以便這個廣告主規劃預算、計費及對帳。

AdvertiserGeneralConfig

廣告客戶的一般設定。

JSON 表示法
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
欄位
domainUrl

string

必要欄位。廣告主主要網站的網域網址。如果發布商需要用網站網址將廣告活動與廣告主建立關聯,系統就會將此資訊傳送給他們。

請提供不含路徑或查詢字串的網址,開頭應為 http:https:。例如:http://www.example.com

timeZone

string

僅供輸出。廣告客戶時區的標準 TZ 資料庫名稱。例如 America/New_York

詳情請參閱 https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

CM360 混合型廣告客戶的時區與關聯 CM360 帳戶的時區相同;如果是第三方廣告客戶,時區會與上層夥伴的時區相同。

currencyCode

string

必要欄位。無法變更。採用 ISO 4217 格式的廣告客戶貨幣。

接受的代碼及其代表的貨幣如下:

幣別代碼:貨幣名稱

  • ARS:阿根廷披索
  • AUD:澳幣
  • BRL:巴西雷亞爾
  • CAD:加幣
  • CHF:瑞士法郎
  • CLP:智利披索
  • CNY:人民幣
  • COP:哥倫比亞披索
  • CZK:捷克克朗
  • DKK:丹麥克朗
  • EGP:埃及鎊
  • EUR:歐元
  • GBP:英鎊
  • HKD:港幣
  • HUF:匈牙利福林
  • IDR:印尼盧比
  • ILS:以色列謝克爾
  • INR:印度盧比
  • JPY:日圓
  • KRW:韓元
  • MXN:墨西哥披索
  • MYR:馬來西亞林吉特
  • NGN:奈及利亞奈拉
  • NOK:挪威克羅納
  • NZD:紐西蘭幣
  • PEN:祕魯新索爾
  • PLN:波蘭茲羅提
  • RON:新羅馬尼亞列伊
  • RUB:俄羅斯盧布
  • SEK:瑞典克朗
  • TRY:土耳其里拉
  • TWD:新臺幣
  • USD:美元
  • ZAR:南非蘭特

AdvertiserAdServerConfig

廣告客戶的廣告伺服器相關設定。

JSON 表示法
{

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
欄位
聯集欄位 ad_server_config_scheme。必要欄位。ad_server_config_scheme 只能是下列其中一項:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

僅適用於使用第三方廣告伺服器的廣告主設定。

cmHybridConfig

object (CmHybridConfig)

同時使用 Campaign Manager 360 (CM360) 和第三方廣告伺服器的廣告客戶的設定。

ThirdPartyOnlyConfig

僅使用第三方廣告伺服器的廣告客戶適用的設定。

JSON 表示法
{
  "pixelOrderIdReportingEnabled": boolean
}
欄位
pixelOrderIdReportingEnabled

boolean

是否已啟用像素的訂單 ID 報表。這個值一旦設為 true,就無法變更。

CmHybridConfig

同時使用 Campaign Manager 360 (CM360) 和第三方廣告伺服器的廣告客戶的設定。

JSON 表示法
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
欄位
cmAccountId

string (int64 format)

必要欄位。無法變更。與 DV360 廣告主建立連結的 CM360 Floodlight 設定帳戶 ID。

cmFloodlightConfigId

string (int64 format)

必要欄位。無法變更。與 DV360 廣告主連結的 CM360 Floodlight 設定 ID。

cmSyncableSiteIds[]

string (int64 format)

系統會將刊登位置同步至 DV360 的 CM360 網站清單。

如果 advertisers.create 方法中沒有或空白,系統會自動建立 CM360 網站。

從這份清單中移除網站,可能會導致從 CM360 同步的 DV360 廣告素材遭到刪除。必須至少指定一個網站。

dv360ToCmDataSharingEnabled

boolean

是否將 DV360 資料納入 CM360 資料移轉報表中。

dv360ToCmCostReportingEnabled

boolean

選擇是否要向 CM360 回報 DV360 費用。

cmFloodlightLinkingAuthorized

boolean

必要欄位。無法變更。將這個欄位設為「true」即表示您代表貴公司授權將特定 Floodlight 設定的相關資訊分享給這個 Display & Video 360 廣告主。

AdvertiserCreativeConfig

廣告客戶的廣告素材相關設定。

JSON 表示法
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
欄位
iasClientId

string (int64 format)

用於設定 Integral Ad Service (IAS) 廣告活動監控功能的 ID。DV360 系統會在廣告素材代碼中附加一個內含這個 ID 的 IAS「廣告活動監控器」代碼。

obaComplianceDisabled

boolean

是否遵循 DV360 的「線上行為廣告」(OBA) 規定。

警告:變更 OBA 設定可能會導致部分廣告交易平台重設廣告素材的稽核狀態,導致廣告素材在重新獲準前無法放送。

dynamicCreativeEnabled

boolean

表示廣告主是否已啟用動態廣告素材。

videoCreativeDataSharingAuthorized

boolean

將此這個欄位設為「true」,即表示您代表貴公司授權 Google 使用與這個 Display & Video 360 廣告主相關的影片廣告素材,以提供該廣告主電視廣告活動相關的報表和功能。

僅適用於具備 CM360 hybrid 廣告伺服器設定的廣告客戶。

AdvertiserDataAccessConfig

控管廣告主相關資料存取方式的設定。

JSON 表示法
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
欄位
sdfConfig

object (AdvertiserSdfConfig)

廣告客戶的結構化資料檔案 (SDF) 設定。

如未指定,系統會使用上層合作夥伴的 SDF 設定。

AdvertiserSdfConfig

廣告客戶的結構化資料檔案 (SDF) 設定。

JSON 表示法
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
欄位
overridePartnerSdfConfig

boolean

這個廣告主是否要覆寫上層夥伴的 SDF 設定。

根據預設,廣告客戶會沿用上層夥伴的 SDF 設定。如要覆寫合作夥伴設定,請將這個欄位設為 true,並在 sdfConfig 中提供新設定。

sdfConfig

object (SdfConfig)

廣告客戶的 SDF 設定。

AdvertiserTargetingConfig

與廣告客戶廣告放送相關的指定目標設定。

JSON 表示法
{
  "exemptTvFromViewabilityTargeting": boolean
}
欄位
exemptTvFromViewabilityTargeting

boolean

連網電視裝置是否免除該廣告客戶所有影片委刊項的可視度指定目標。

方法

audit

稽核廣告客戶。

bulkEditAdvertiserAssignedTargetingOptions

在單一廣告客戶中大量編輯指定目標選項。

bulkListAdvertiserAssignedTargetingOptions

根據不同的指定類型,列出廣告主的指派指定目標選項。

create

建立新的廣告客戶。

delete

刪除廣告客戶。

get

取得廣告客戶。

list

列出目前使用者可存取的廣告主。

patch

更新現有的廣告客戶。