REST Resource: advertisers

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

Một nhà quảng cáo duy nhất trong Mạng Hiển thị và 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)
  }
}
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. Bất biến. 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 được mã hoá 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 bạn đặt thành ENTITY_STATUS_SCHEDULED_FOR_DELETION, nhà quảng cáo này sẽ bị xoá sau 30 ngày kể từ lần đầu được 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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 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. Chế độ cài đặt chung của nhà quảng cáo.
adServerConfig

object (AdvertiserAdServerConfig)

Bắt buộc. Bất biến. 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)

Các 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ề quy trình tích hợp của nhà quảng cáo. Hiện chỉ có integrationCode áp dụng cho nhà quảng cáo. 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 có liên quan đến việc phân phát quảng cáo của nhà quảng cáo.
prismaEnabled

boolean

Xem có bật tính năng tích hợp với Mediaocean (Prisma) 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, tôi uỷ quyền cho 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 nhằm mục đích 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.
billingConfig

object (AdvertiserBillingConfig)

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

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 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 có URL của trang web liên kết chiến dịch với nhà quảng cáo.

Hãy 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 những nhà quảng cáo CM360 kết hợp, 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 bên thứ ba (chỉ các nhà quảng cáo 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. Bất biến. Đơ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 : Peso Argentina
  • AUD : Đô la Úc
  • BRL : Rin Brazil
  • CAD : Đô la Canada
  • CHF : Đồng franc Thuỵ Sĩ
  • CLP : Peso Chile
  • CNY : Nhân dân tệ Trung Quốc
  • COP : Peso Colombia
  • CZK : Cuaron Séc
  • DKK : Krone Đan Mạch
  • EGP : Bảng Ai Cập
  • EUR : Đồng Euro
  • GBP : Bảng Anh
  • HKD : Đô la Hong Kong
  • HUF : Forint Hungary
  • IDR : Rupee Indonesia
  • ILS : Shekel Israel
  • INR : Rupee Ấn Độ
  • JPY : Yên Nhật
  • KRW : Won Hàn Quốc
  • MXN : Peso Mexico
  • MYR : Rinhgit Malaysia
  • NGN : Naira Nigeria
  • NOK : Krone Na Uy
  • NZD : Đô la New Zealand
  • PEN : Sol Peru
  • PLN : Zloty Ba Lan
  • RON : Đồng Leu mới của Romania
  • RUB : Đồng Rúp Nga
  • SEK : Đồng krona Thuỵ Điển
  • TRY : Lia Thổ Nhĩ Kỳ
  • TWD : Đô la Đài Loan mới
  • USD : Đô la Mỹ
  • ZAR : Rand Nam Phi

AdvertiserAdServerConfig

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 
{

  // 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.
}
Trường
Trường kết hợp 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ững 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 của Campaign Manager 360 (CM360) và máy chủ quảng cáo của 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
}
Trường
pixelOrderIdReportingEnabled

boolean

Liệu tính năng 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 của 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. Bất biến. 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. Bất biến. Mã 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 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 trên 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

Liệu 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. Bất biến. Bằng việc đặt trường này thành true, bạn thay mặt cho công ty của mình cho phép việc chia sẻ thông tin từ cấu hình Floodlight đã cung cấp cho chiến dịch Hiển thị và Nhà quảng cáo video 360.

AdvertiserCreativeConfig

Chế độ cài đặt liên quan đến mẫu quảng cáo của 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 "Trình giám sát chiến dịch" IAS thẻ chứa ID này vào thẻ quảng cáo.
obaComplianceDisabled

boolean

Liệu có tắt tính năng Thông tin về quảng cáo này của Google để thêm huy hiệu (để xác định nội dung là quảng cáo) và thông tin về tính minh bạch (khi tương tác với Thông tin về quảng cáo này) vào quảng cáo cho Quảng cáo dựa trên hành vi trực tuyến (OBA) và các yêu cầu theo quy định hay không. Phần Thông tin về quảng cáo này cấp cho người dùng nhiều quyền kiểm soát hơn đối với những quảng cáo mà họ thấy và giúp bạn giải thích lý do họ 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, xin lưu ý rằng quảng cáo được phân phát thông qua Mạng Hiển thị và 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 giải pháp báo cáo, tính minh bạch và huy hiệu quảng cáo thay thế, bạn phải đảm bảo giải pháp đó có thông tin minh bạch và cơ chế gắn cờ nội dung bất hợp pháp bắt buộc, đồng thời thông báo cho Google về mọi báo cáo nội dung bất hợp pháp bằng biểu mẫu thích hợp.
dynamicCreativeEnabled

boolean

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

boolean

Bằng cách đặt trường này thành true, bạn thay mặt công ty cho phép Google sử dụng mẫu quảng cáo dạng video được liên kết với chiến dịch Hiển thị và Nhà quảng cáo 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 có 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 không được chỉ định, chế độ cài đặt SDF của đối tác là cấp độ gốc 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)
  }
}
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, nhà quảng cáo 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 tiêu chí nhắm mục tiêu có liên quan đến việc 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
}
Trường
exemptTvFromViewabilityTargeting

boolean

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

AdvertiserBillingConfig

Chế độ cài đặt liên quan đến 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)

Mã của hồ sơ thanh toán được chỉ định cho nhà quảng cáo.

Theo mặc định, trường này sẽ có mã hồ sơ thanh toán mặc định của đối tác mẹ của nhà quảng cáo nếu bạn không cung cấp giá trị.

Phương thức

audit

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

create

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

delete

 Xoá nhà quảng cáo.

editAssignedTargetingOptions

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

get

 Lấy nhà quảng cáo.

list

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

listAssignedTargetingOptions

 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 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ó.