REST Resource: advertisers

資源：廣告主

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,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
欄位
name

string

僅供輸出。廣告主的資源名稱。
advertiserId

string (int64 format)

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

string (int64 format)

必要欄位。不可變更。廣告主所屬合作夥伴的專屬 ID。
displayName

string

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

必須採用 UTF-8 編碼，大小上限為 240 個位元組。
entityStatus

enum (EntityStatus)

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

  • 可接受的值為 ENTITY_STATUS_ACTIVE、ENTITY_STATUS_PAUSED 和 ENTITY_STATUS_SCHEDULED_FOR_DELETION。
  • 如果設為 ENTITY_STATUS_SCHEDULED_FOR_DELETION，系統會在首次排定刪除廣告主後的 30 天內刪除該廣告主。
updateTime

string (Timestamp format)

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

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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，以便這個廣告主規劃預算、計費及對帳。
billingConfig

object (AdvertiserBillingConfig)

必要欄位。廣告主的帳單相關設定。
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

(選用步驟) 這個廣告主是否含有放送歐盟政治廣告的委刊項。

如果此欄位設為 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING，則會發生下列情況：

  • 如果沒有另外指定，系統會為這個廣告主底下建立的所有新委刊項指派 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING。
  • 這個廣告主底下沒有設定值的現有委刊項，都會在一日內更新為 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING。

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,
  "cmAdvertiserIds": [
    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。
cmAdvertiserIds[]

string (int64 format)

僅供輸出。共用 CM360 Floodlight 設定的 CM360 廣告主 ID 集。
cmSyncableSiteIds[]

string (int64 format)

系統會將這些 CM360 網站的刊登位置同步到 DV360，做為廣告素材。

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

從這個清單中移除網站，可能會導致系統刪除從 CM360 同步處理的 DV360 廣告素材。請至少指定一個地點。
dv360ToCmDataSharingEnabled

boolean

是否要在 CM360 資料移轉報表中納入 DV360 資料。
dv360ToCmCostReportingEnabled

boolean

是否要將 DV360 費用匯報至 CM360。
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

是否要停用 Google 的「關於這則廣告」功能，為線上行為廣告 (OBA) 和法規要求，在廣告中新增標記 (旨在將內容標示為廣告) 和公開資訊 (與「關於這則廣告」互動)。「關於這則廣告」可讓使用者進一步控管自己看到的廣告，還可協助您向使用者說明他們看到您廣告的原因。瞭解詳情。

如果選擇將這個欄位設為 true，請注意，透過 Display & Video 360 放送的廣告必須遵守下列規定：

  • 根據您與 Google Marketing Platform 簽訂的合約，遵守「線上行為廣告」(OBA) 相關規範。
  • 在歐洲經濟區 (EEA)，廣告必須顯示公開資訊，並提供違法內容檢舉機制。如果使用替代廣告徽章、資訊公開和檢舉解決方案，請務必確保該解決方案包含必要的資訊公開資訊和非法內容標記機制，並使用適當的表單，通知 Google 使用者舉報的所有非法內容。
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

可連網電視裝置是否不必與廣告主所有影片委刊項的可視度指定目標相容。

AdvertiserBillingConfig

廣告主的帳單相關設定。

JSON 表示法 
{
  "billingProfileId": string
}
欄位
billingProfileId

string (int64 format)

必要欄位。指派給廣告主的帳單資料 ID。

方法

audit

 稽核廣告主。

create

 建立新的廣告主。

delete

 刪除廣告主。

editAssignedTargetingOptions

 編輯單一廣告主下的指定目標選項。

get

 取得廣告主。

list

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

listAssignedTargetingOptions

 列出廣告主在各指定類型中指派的指定目標選項。

patch

 更新現有廣告主。