REST Resource: advertisers

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

Một nhà quảng cáo duy nhất 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,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
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 riêng biệt của đối tác mà nhà quảng cáo thuộc về.
displayName

string

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

Phải được mã hoá theo 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 đơ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 cho khoảng không quảng cáo hay không.

  • Các giá trị được chấp nhận là ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED và ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Nếu được đặt thành ENTITY_STATUS_SCHEDULED_FOR_DELETION, nhà quảng cáo sẽ bị xoá sau 30 ngày kể từ khi được lên lịch xoá lần đầu.
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.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
generalConfig

object (AdvertiserGeneralConfig)

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

object (AdvertiserAdServerConfig)

Bắt buộc. Không thể thay đổi. 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 chi tiết về việc 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 bạn cung cấp.
servingConfig

object (AdvertiserTargetingConfig)

Chế độ cài đặt tiêu chí 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 bạn có bật tính năng tích hợp với Mediaocean (Prisma) hay không. Khi bật chế độ này, bạn đồng ý với những điều sau:

Thay mặt công ty của mình, tôi cho phép Mediaocean (Prisma) gửi kế hoạch phân đoạn ngân sách cho Google và tôi cho phép Google gửi báo cáo và hoá đơn tương ứng từ DV360 cho Mediaocean nhằm mục đích lập kế hoạch ngân sách, thanh toán và đối chiếu cho nhà quảng cáo này.
billingConfig

object (AdvertiserBillingConfig)

Bắt buộc. Chế độ cài đặt liên quan đến việc thanh toán của nhà quảng cáo.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Không bắt buộc. Nhà quảng cáo này có chứa các mục hàng phân phát quảng cáo chính trị ở Liên minh Châu Âu hay không.

Nếu bạn đặt trường này thành DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, thì những điều sau sẽ xảy ra:

  • Mọi mục hàng mới được tạo trong nhà quảng cáo này sẽ được chỉ định DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING nếu không được chỉ định khác.
  • Mọi mục hàng hiện có thuộc nhà quảng cáo này mà chưa có giá trị được đặt sẽ được cập nhật thành DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING trong vòng một ngày.
defaultBusinessName

string

Không bắt buộc. Tên doanh nghiệp mặc định của nhà quảng cáo.

Đây là giá trị mà quảng cáo trên YouTube và quảng cáo Tạo nhu cầu sử dụng trong trường hợp nhà quảng cáo này không cung cấp tên doanh nghiệp.
defaultLogoAssetId

string (int64 format)

Không bắt buộc. Mã tài sản của hình ảnh biểu trưng mặc định cho nhà quảng cáo.

Đây là mã tài sản mà YouTube và quảng cáo Dựa trên nhu cầu sẽ sử dụng cho nhà quảng cáo này nếu bạn không cung cấp thành phần biểu trưng.

Bạn phải sử dụng advertisers.adAssets.upload để tải thành phần này lên bằng API.

AdvertiserGeneralConfig

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

Biểu diễn dưới dạng JSON 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
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 cho những nhà xuất bản yêu cầu URL trang web để liên kết một chiến dịch với một 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 tiêu chuẩn của 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 nhà quảng cáo kết hợp CM360, múi giờ giống với múi giờ của tài khoản CM360 được liên kết; đối với nhà quảng cáo chỉ sử dụng bên thứ ba, múi giờ giống với múi giờ của đối tác chính.
currencyCode

string

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

Các mã được chấp nhận và đơn vị tiền tệ mà các mã đó đạ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 : Franc Thuỵ Sĩ
  • CLP : Đồng Peso của Chile
  • CNY : Nhân dân tệ
  • COP : Đồng Peso của Colombia
  • CZK : Đồng Koruna của Cộng hoà Séc
  • DKK : Krone Đan Mạch
  • EGP : Bảng Ai Cập
  • EUR : Euro
  • GBP : Bảng Anh
  • HKD : Đô la Hong Kong
  • HUF : Đồng Forint Hungary
  • IDR : Rupiah Indonesia
  • ILS : Đồng Shekel Israel
  • INR : Đồng Rupee Ấn Độ
  • JPY : Yên Nhật
  • KRW : Đồng Won của Hàn Quốc
  • MXN : Đồng Peso của Mexico
  • MYR : 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 Romania mới
  • RUB : Rúp Nga
  • SEK : Krona Thuỵ Điển
  • TRY : Lira Thổ Nhĩ Kỳ
  • TWD : Đô la Đài Loan mới
  • USD : Đô la Mỹ
  • ZAR : Đồng Rand của Nam Phi

AdvertiserAdServerConfig

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

Biểu diễn dưới dạng JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
Trường
Bắt buộc. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

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

object (CmHybridConfig)

Cấu hình cho những nhà quảng cáo sử dụng cả Campaign Manager 360 (CM360) và máy chủ quảng cáo của bên thứ ba.
Kết thúc các trường loại trừ lẫn nhau.

ThirdPartyOnlyConfig

Chỉ dành cho những nhà quảng cáo 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
}
Trường
pixelOrderIdReportingEnabled

boolean

Cho biết bạn có bật tính năng báo cáo mã đơn đặt hàng cho pixel 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ả Campaign Manager 360 (CM360) và máy chủ quảng cáo của bên thứ ba.

Biểu diễn dưới dạng JSON 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
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 trên DV360.
cmFloodlightConfigId

string (int64 format)

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

string (int64 format)

Chỉ có đầu ra. Tập hợp các mã nhận dạng nhà quảng cáo CM360 dùng chung cấu hình Floodlight CM360.
cmSyncableSiteIds[]

string (int64 format)

Danh sách các trang web trên 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.

Việc xoá các trang web khỏi danh sách này có thể khiến các mẫu quảng cáo DV360 được đồng bộ hoá từ CM360 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

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 cho 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 này trên Display & Video 360.

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
}
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 Integral Ad Service (IAS) cung cấp. Hệ thống DV360 sẽ thêm thẻ "Campaign Monitor" (Giám sát chiến dịch) của IAS có chứa mã nhận dạng này vào thẻ mẫu quảng cáo.
obaComplianceDisabled

boolean

Có nên tắt tính năng Thông tin về quảng cáo này của Google hay không. Tính năng này thêm huy hiệu (để xác định nội dung là quảng cáo) và thông tin minh bạch (khi người dùng tương tác với tính năng Thông tin về quảng cáo này) vào quảng cáo của bạn cho quảng cáo dựa trên hành vi trên mạng (OBA) và các yêu cầu theo quy định. Tính năng Thông tin về quảng cáo này giúp người dùng kiểm soát tốt hơn những quảng cáo mà họ nhìn thấy và giúp bạn giải thích lý do họ nhìn thấy quảng cáo của bạn. Tìm hiểu thêm.

Nếu bạn chọn đặt trường này thành true, hãy lưu ý rằng quảng cáo được phân phát thông qua Display & Video 360 phải tuân thủ những điều sau:

  • Tuân thủ Quảng cáo dựa trên hành vi trên mạng (OBA), theo hợp đồng của bạn với Google Marketing Platform.
  • Ở Khu vực kinh tế Châu Âu (EEA), hãy thêm thông tin minh bạch và cơ chế để người dùng báo cáo nội dung bất hợp pháp trong quảng cáo. Nếu sử dụng một giải pháp thay thế để gắn huy hiệu cho quảng cáo, cung cấp thông tin minh bạch và báo cáo, bạn phải đảm bảo rằng giải pháp đó có thông tin minh bạch bắt buộc và cơ chế gắn cờ nội dung bất hợp pháp, đồng thời bạn phải thông báo cho Google về mọi báo cáo liên quan đến nội dung bất hợp pháp bằng biểu mẫu thích hợp.
dynamicCreativeEnabled

boolean

Nhà quảng cáo có được bật cho 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 được liên kết với nhà quảng cáo này trên Display & Video 360 để cung cấp báo cáo và các tính năng liên quan đến chiến dịch truyền hình của nhà quảng cáo.

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

Các 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)
  }
}
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, hệ thống sẽ sử dụng chế độ cài đặt SDF của đối tác cấp trên.

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)
  }
}
Trường
overridePartnerSdfConfig

boolean

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

Theo mặc định, nhà quảng cáo sẽ kế thừa cấu hình SDF từ đối tác cấp trên. Để 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 tiêu chí nhắm mục tiêu liên quan đến việc phân phát quảng cáo của một nhà quảng cáo.

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

boolean

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

AdvertiserBillingConfig

Các chế độ cài đặt liên quan đến việc thanh toán của nhà quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "billingProfileId": string
}
Trường
billingProfileId

string (int64 format)

Bắt buộc. Mã nhận dạng của hồ sơ thanh toán được chỉ định cho nhà quảng cáo.

Phương thức

audit

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

create

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

delete

 Xoá một nhà quảng cáo.

editAssignedTargetingOptions

 Chỉnh sửa các lựa chọn nhắm mục tiêu trong một nhà quảng cáo.

get

 Lấy 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.

listAssignedTargetingOptions

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

patch

 Cập nhật một nhà quảng cáo hiện có.