- Tài nguyên: Nhà quảng cáo
- AdvertiserGeneralConfig
- AdvertiserAdServerConfig
- ThirdPartyOnlyConfig
- CmHybridConfig
- AdvertiserCreativeConfig
- AdvertiserDataAccessConfig
- AdvertiserSdfConfig
- AdvertiserTargetingConfig
- AdvertiserBillingConfig
- Phương thức
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 ( |
Trường | |
---|---|
name |
Chỉ có đầu ra. Tên tài nguyên của nhà quảng cáo. |
advertiserId |
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 |
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 |
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 |
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.
|
updateTime |
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ụ: |
generalConfig |
Bắt buộc. Cài đặt chung của nhà quảng cáo. |
adServerConfig |
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 |
Bắt buộc. Các chế độ cài đặt liên quan đến mẫu quảng cáo của nhà quảng cáo. |
dataAccessConfig |
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 |
Thông tin tích hợp của nhà quảng cáo. Hiện tại, chỉ có |
servingConfig |
Chế độ cài đặt tiêu chí 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. |
prismaEnabled |
Liệu tính năng tích hợp với Mediaocean (Prisma) có được bật hay không. Khi bật chế độ này, bạn đồng ý với những điều khoản sau đây: Thay mặt công ty, tôi cho phép Mediaocean (Prisma) gửi các 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. |
billingConfig |
Cài đặt liên quan đến thanh toán của nhà quảng cáo. |
AdvertiserGeneralConfig
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 |
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 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 |
timeZone |
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ụ: 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ờ 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ỉ bên thứ ba, múi giờ sẽ giống với múi giờ của đối tác mẹ. |
currencyCode |
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à các mã đó đại diện là: Mã đơn vị tiền tệ : Tên đơn vị tiền tệ
|
AdvertiserAdServerConfig
Chế độ cài đặt của một nhà quảng cáo có liên quan đến máy chủ quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường 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: |
|
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 |
Cấu hình này 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 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 |
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 |
CmHybridConfig
Chế độ cài đặt cho 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 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 |
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 |
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[] |
Chỉ có đầu ra. Nhóm Mã nhận dạng nhà quảng cáo CM360 dùng chung cấu hình Floodlight CM360. |
cmSyncableSiteIds[] |
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 Nếu bạn xoá các trang web khỏi danh sách này, 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 |
Có đưa dữ liệu DV360 vào báo cáo chuyển dữ liệu CM360 hay không. |
dv360ToCmCostReportingEnabled |
Liệu có báo cáo chi phí DV360 cho CM360 hay không. |
cmFloodlightLinkingAuthorized |
Bắt buộc. Không thể thay đổi. Khi đặt trường này thành |
AdvertiserCreativeConfig
Các 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 |
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 tích hợp (IAS) cung cấp. Hệ thống DV360 sẽ thêm một thẻ "Trình theo dõi chiến dịch" của IAS có chứa mã này vào thẻ mẫu quảng cáo. |
obaComplianceDisabled |
Liệu có tắt tính năng Giới thiệu về quảng cáo này của Google. Tính năng này sẽ 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 phần Giới thiệu 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. Thông tin về quảng cáo này mang lại cho người dùng quyền kiểm soát tốt hơn đối với quảng cáo họ xem và giúp bạn giải thích lý do tại sao 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
|
dynamicCreativeEnabled |
Nhà quảng cáo có được bật mẫu quảng cáo động hay không. |
videoCreativeDataSharingAuthorized |
Khi đặt trường này thành Chỉ áp dụng khi nhà quảng cáo có cấu hình máy chủ quảng cáo |
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 ( |
Trường | |
---|---|
sdfConfig |
Chế độ cài đặt về 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 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 ( |
Trường | |
---|---|
overridePartnerSdfConfig |
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 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 |
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 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 } |
Trường | |
---|---|
exemptTvFromViewabilityTargeting |
Liệu thiết bị TV thông minh có được miễn nhắm mục tiêu theo khả năng xem cho tất cả các mục hàng video của nhà quảng cáo hay không. |
AdvertiserBillingConfig
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 |
Mã hồ sơ thanh toán được chỉ định cho nhà quảng cáo. Trường này sẽ được đặt mặc định thành 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 một giá trị. |
Phương thức |
|
---|---|
|
Kiểm tra một nhà quảng cáo. |
|
Tạo nhà quảng cáo mới. |
|
Xoá nhà quảng cáo. |
|
Chỉnh sửa các tuỳ chọn nhắm mục tiêu trong một nhà quảng cáo. |
|
Tìm nhà quảng cáo. |
|
Liệt kê những nhà quảng cáo mà người dùng hiện tại có thể truy cập. |
|
Liệt kê các lựa chọn nhắm mục tiêu được chỉ định của nhà quảng cáo trên các loại nhắm mục tiêu. |
|
Cập nhật nhà quảng cáo hiện tại. |