REST Resource: advertisers

Tài nguyên: Nhà quảng cáo

Một nhà quảng cáo trong Display & Video 360 (DV360).

Biểu diễn dưới dạng 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
}
Các trường
name

string

Chỉ có đầu ra. Tên tài nguyên của nhà quảng cáo.
advertiserId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của nhà quảng cáo. Do hệ thống chỉ định.
partnerId

string (int64 format)

Bắt buộc. Không thể thay đổi. Mã nhận dạng duy nhất của đối tác chứa nhà quảng cáo.
displayName

string

Bắt buộc. Tên hiển thị của nhà quảng cáo.

Phải là mã UTF-8 với kích thước tối đa là 240 byte.
entityStatus

enum (EntityStatus)

Bắt buộc. Kiểm soát việc các đơn đặt hàng quảng cáo và mục hàng của nhà quảng cáo có thể chi tiêu ngân sách và đặt giá thầu trên khoảng không quảng cáo hay không.

  • Giá trị được chấp nhận là ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED và ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Nếu bạn đặt thành ENTITY_STATUS_SCHEDULED_FOR_DELETION, nhà quảng cáo sẽ bị xoá sau 30 ngày kể từ lần đầu tiên lên lịch xoá.
updateTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian khi nhà quảng cáo được cập nhật lần gần đây nhất. Do hệ thống chỉ định.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
generalConfig

object (AdvertiserGeneralConfig)

Bắt buộc. Cài đặt chung của nhà quảng cáo.
adServerConfig

object (AdvertiserAdServerConfig)

Bắt buộc. Không thể thay đổi. Các chế độ cài đặt liên quan đến máy chủ quảng cáo của nhà quảng cáo.
creativeConfig

object (AdvertiserCreativeConfig)

Bắt buộc. Chế độ cài đặt liên quan đến mẫu quảng cáo của nhà quảng cáo.
dataAccessConfig

object (AdvertiserDataAccessConfig)

Chế độ cài đặt kiểm soát cách truy cập vào dữ liệu của nhà quảng cáo.
integrationDetails

object (IntegrationDetails)

Thông tin tích hợp của nhà quảng cáo. Hiện tại, nhà quảng cáo chỉ có thể sử dụng integrationCode. Các trường khác của IntegrationDetails không được hỗ trợ và sẽ bị bỏ qua nếu được cung cấp.
servingConfig

object (AdvertiserTargetingConfig)

Chế độ cài đặt nhắm mục tiêu liên quan đến việc phân phát quảng cáo của nhà quảng cáo.
prismaEnabled

boolean

Liệu tính năng tích hợp với Mediaocean (Prisma) có được bật hay không. Khi bật tính năng này, bạn đồng ý với những điều sau:

Thay mặt công ty của tôi, tôi cho phép Mediaocean (Prisma) gửi kế hoạch phân khúc ngân sách cho Google, đồng thời cho phép Google gửi báo cáo và hoá đơn tương ứng từ DV360 đến Mediaocean để lập kế hoạch ngân sách, thanh toán và điều chỉnh cho nhà quảng cáo này.

AdvertiserGeneralConfig

Cài đặt chung của một nhà quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
Các trường
domainUrl

string

Bắt buộc. URL miền của trang web chính của nhà quảng cáo. Hệ thống sẽ gửi thông tin này đến những nhà xuất bản yêu cầu URL của trang web để liên kết chiến dịch với nhà quảng cáo.

Cung cấp một URL không có đường dẫn hoặc chuỗi truy vấn, bắt đầu bằng http: hoặc https:. Ví dụ: http://www.example.com
timeZone

string

Chỉ có đầu ra. Tên cơ sở dữ liệu TZ chuẩn theo múi giờ của nhà quảng cáo. Ví dụ: America/New_York.

Xem thêm tại: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Đối với các nhà quảng cáo kết hợp CM360, múi giờ của tài khoản CM360 được liên kết sẽ giống với múi giờ của tài khoản CM360 được liên kết. Đối với các nhà quảng cáo chỉ bên thứ ba, múi giờ sẽ giống với múi giờ của đối tác mẹ.
currencyCode

string

Bắt buộc. Không thể thay đổi. Đơn vị tiền tệ của nhà quảng cáo theo định dạng ISO 4217.

Các mã được chấp nhận và đơn vị tiền tệ mà chúng đại diện là:

Mã đơn vị tiền tệ : Tên đơn vị tiền tệ

  • ARS : Đồng Peso Argentina
  • AUD : Đô la Úc
  • BRL : Đồng Real Brazil
  • CAD : Đô la Canada
  • CHF : Đồng Franc Thuỵ Sĩ
  • CLP : Đồng Peso Chile
  • CNY : Đồng Nhân dân tệ của Trung Quốc
  • COP : Đồng Peso Colombia
  • CZK : Koruna Séc
  • DKK : Đồng Krone của Đan Mạch
  • EGP : Đồng Bảng Ai Cập
  • EUR : Đồng Euro
  • GBP : Bảng Anh
  • HKD : Đô la Hong Kong
  • HUF : Forint Hungary
  • IDR : Đồng Rupiah của Indonesia
  • ILS : Shekel Israel
  • INR : Đồng Rupee của Ấn Độ
  • JPY : Đồng Yên của Nhật Bản
  • KRW : Đồng Won Hàn Quốc
  • MXN : Đồng Peso Mexico
  • MYR : Đồng Ringgit Malaysia
  • NGN : Đồng Naira của Nigeria
  • NOK : Đồng Krone của Na Uy
  • NZD : Đô la New Zealand
  • PEN : Đồng Nuevo Sol của Peru
  • PLN : Zloty Ba Lan
  • RON : Đồng Leu mới của Romania
  • RUB : Rúp Nga
  • SEK : Đồng Krona của Thuỵ Điển
  • TRY : Lira Thổ Nhĩ Kỳ
  • TWD : Tân Đài tệ
  • USD : Đô la Mỹ
  • ZAR : Đồng Rand Nam Phi

AdvertiserAdServerConfig

Các chế độ cài đặt liên quan đến máy chủ quảng cáo của một nhà quảng cáo.

Biểu diễn dưới dạng 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.
}
Các trường
Trường nhóm ad_server_config_scheme. Bắt buộc. ad_server_config_scheme chỉ có thể là một trong những trạng thái sau đây:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

Cấu hình dành cho nhà quảng cáo chỉ sử dụng máy chủ quảng cáo của bên thứ ba.
cmHybridConfig

object (CmHybridConfig)

Cấu hình dành cho những nhà quảng cáo sử dụng cả máy chủ quảng cáo Campaign Manager 360 (CM360) và máy chủ quảng cáo bên thứ ba.

ThirdPartyOnlyConfig

Chế độ cài đặt dành cho nhà quảng cáo chỉ sử dụng máy chủ quảng cáo của bên thứ ba.

Biểu diễn dưới dạng JSON 
{
  "pixelOrderIdReportingEnabled": boolean
}
Các trường
pixelOrderIdReportingEnabled

boolean

Liệu báo cáo mã đơn hàng cho pixel có được bật hay không. Bạn không thể thay đổi giá trị này sau khi đặt thành true.

CmHybridConfig

Chế độ cài đặt cho những nhà quảng cáo sử dụng cả máy chủ quảng cáo Campaign Manager 360 (CM360) và máy chủ quảng cáo bên thứ ba.

Biểu diễn dưới dạng JSON 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Các trường
cmAccountId

string (int64 format)

Bắt buộc. Không thể thay đổi. Mã tài khoản của cấu hình Floodlight CM360 được liên kết với nhà quảng cáo DV360.
cmFloodlightConfigId

string (int64 format)

Bắt buộc. Không thể thay đổi. Mã cấu hình Floodlight CM360 được liên kết với nhà quảng cáo DV360.
cmSyncableSiteIds[]

string (int64 format)

Danh sách các trang web CM360 có vị trí sẽ được đồng bộ hoá với DV360 dưới dạng mẫu quảng cáo.

Nếu không có hoặc trống trong phương thức advertisers.create, hệ thống sẽ tự động tạo một trang web CM360.

Nếu bạn xoá các trang web khỏi danh sách này, những mẫu quảng cáo DV360 được đồng bộ hoá từ CM360 có thể bị xoá. Bạn phải chỉ định ít nhất một trang web.
dv360ToCmDataSharingEnabled

boolean

Có đưa dữ liệu DV360 vào báo cáo chuyển dữ liệu CM360 hay không.
dv360ToCmCostReportingEnabled

boolean

Liệu có báo cáo chi phí DV360 cho CM360 hay không.
cmFloodlightLinkingAuthorized

boolean

Bắt buộc. Không thể thay đổi. Khi đặt trường này thành true, bạn (thay mặt công ty của mình) cho phép chia sẻ thông tin từ cấu hình Floodlight đã cho với nhà quảng cáo Display & Video 360 này.

AdvertiserCreativeConfig

Chế độ cài đặt liên quan đến mẫu quảng cáo của một nhà quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
Các trường
iasClientId

string (int64 format)

Mã nhận dạng để định cấu hình tính năng giám sát chiến dịch do Dịch vụ quảng cáo Integral (IAS) cung cấp. Hệ thống DV360 sẽ thêm một thẻ "Trình theo dõi chiến dịch" IAS có chứa mã này vào thẻ mẫu quảng cáo.
obaComplianceDisabled

boolean

Liệu có sử dụng tính năng tuân thủ Quảng cáo dựa trên hành vi trực tuyến (OBA) của DV360 hay không.

Cảnh báo: Việc thay đổi chế độ cài đặt OBA có thể khiến một số nền tảng trao đổi quảng cáo đặt lại trạng thái kiểm tra của các mẫu quảng cáo. Điều này khiến các nền tảng trao đổi quảng cáo đó không đủ điều kiện để phân phát cho đến khi được phê duyệt lại.
dynamicCreativeEnabled

boolean

Nhà quảng cáo có được bật mẫu quảng cáo động hay không.
videoCreativeDataSharingAuthorized

boolean

Khi đặt trường này thành true, bạn thay mặt cho công ty của mình cho phép Google sử dụng mẫu quảng cáo dạng video liên kết với nhà quảng cáo Display & Video 360 này để cung cấp báo cáo và các tính năng có liên quan đến các chiến dịch truyền hình của nhà quảng cáo này.

Chỉ áp dụng khi nhà quảng cáo có cấu hình máy chủ quảng cáo CM360 hybrid.

AdvertiserDataAccessConfig

Chế độ cài đặt kiểm soát cách truy cập vào dữ liệu liên quan đến nhà quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
Các trường
sdfConfig

object (AdvertiserSdfConfig)

Chế độ cài đặt Tệp dữ liệu có cấu trúc (SDF) cho nhà quảng cáo.

Nếu bạn không chỉ định, thì chế độ cài đặt SDF của đối tác mẹ sẽ được sử dụng.

AdvertiserSdfConfig

Chế độ cài đặt Tệp dữ liệu có cấu trúc (SDF) của một nhà quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
Các trường
overridePartnerSdfConfig

boolean

Liệu nhà quảng cáo này có ghi đè cấu hình SDF của đối tác mẹ hay không.

Theo mặc định, một nhà quảng cáo sẽ kế thừa cấu hình SDF từ đối tác mẹ. Để ghi đè cấu hình đối tác, hãy đặt trường này thành true và cung cấp cấu hình mới trong sdfConfig.
sdfConfig

object (SdfConfig)

Cấu hình SDF cho nhà quảng cáo.

AdvertiserTargetingConfig

Chế độ cài đặt nhắm mục tiêu liên quan đến hoạt động phân phát quảng cáo của nhà quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "exemptTvFromViewabilityTargeting": boolean
}
Các trường
exemptTvFromViewabilityTargeting

boolean

Thiết bị TV có kết nối được miễn khỏi tiêu chí nhắm mục tiêu khả năng xem đối với tất cả các mục hàng video theo nhà quảng cáo hay không.

Phương thức

audit

 Kiểm tra một nhà quảng cáo.

bulkEditAdvertiserAssignedTargetingOptions

 Chỉnh sửa hàng loạt các tuỳ chọn nhắm mục tiêu trong một nhà quảng cáo.

bulkListAdvertiserAssignedTargetingOptions

 Liệt kê các lựa chọn nhắm mục tiêu được chỉ định của một nhà quảng cáo trên nhiều loại nhắm mục tiêu.

create

 Tạo nhà quảng cáo mới.

delete

 Xoá nhà quảng cáo.

get

 Nhận một nhà quảng cáo.

list

 Liệt kê những nhà quảng cáo mà người dùng hiện tại có thể truy cập.

patch

 Cập nhật nhà quảng cáo hiện tại.