REST Resource: customers.adsDataLinks

• Tài nguyên: AdsDataLink
  • Biểu diễn dưới dạng JSON
• Pháp nhân
  • Biểu diễn dưới dạng JSON
• EntityType
• Nền tảng
• Chỉ số
• GmpExportScope
• Phương thức

Tài nguyên: AdsDataLink

Biểu thị một đường liên kết dữ liệu quảng cáo.

Biểu diễn dưới dạng JSON
{ "name": string, "linkedEntity": { object (Entity) }, "parentEntity": { object (Entity) }, "childEntities": [ { object (Entity) } ], "platform": enum (Platform), "customerLink": { object (CustomerLink) }, "status": enum (LinkStatus), "createTime": string, "updateTime": string, "vendorClientId": string, "metrics": [ enum (Metric) ], "gmpExportScopes": [ enum (GmpExportScope) ] }

Các trường
name	string Tên xác định duy nhất một tài nguyên AdsDataLink. Thông tin đó có dạng khách hàng/[customerId]/adsDataLinks/[resource_id]. Mã tài nguyên do máy chủ tạo.
linkedEntity	object (Entity) Thực thể được liên kết thông qua AdsDataLink này.
parentEntity	object (Entity) Pháp nhân mẹ có liên quan, nếu có. Nếu pháp nhân được liên kết là chiến dịch trên Google Ads thì trường này sẽ chứa một khách hàng Google Ads tương ứng chứa chiến dịch đó.
childEntities[]	object (Entity) Thực thể con liên quan, nếu có. Nếu pháp nhân được liên kết là khách hàng của Google Ads tương ứng với mối liên kết với người quản lý khách hàng, thì các thực thể con sẽ bao gồm một tập hợp đầy đủ các khách hàng Google Ads có dữ liệu được nhập vào Ads Data Hub thông qua đường liên kết này.
platform	enum (Platform) Nền tảng quảng cáo liên kết với pháp nhân được liên kết.
customerLink	object (CustomerLink) Đường liên kết với khách hàng mà qua đó dữ liệu được liên kết có thể truy cập được. Chỉ có tên, mã khách hàng và displayName đang điền.
status	enum (LinkStatus) Trạng thái của đường liên kết dữ liệu.
createTime	string (Timestamp format) Thời gian tạo đường liên kết. Dấu thời gian ở định dạng RFC3339 UTC "Zulu" với độ phân giải nano giây và tối đa chín chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
updateTime	string (Timestamp format) Lần gần nhất trạng thái đường liên kết được cập nhật. Dấu thời gian ở định dạng RFC3339 UTC "Zulu" với độ phân giải nano giây và tối đa chín chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
vendorClientId	string Mã khách hàng của nhà cung cấp, nếu có.
metrics[]	enum (Metric) Bạn có thể xem các chỉ số thông qua đường liên kết dữ liệu này. Nếu trống, hệ thống sẽ không áp dụng quy định hạn chế nào về chỉ số. Trường này hiện chỉ được đọc và chỉ được hỗ trợ khi loại thực thể liên kết là GOOGLE_ADS_CAMPAIGN hoặc YT_RESERVE_LINE_ITEM.
gmpExportScopes[]	enum (GmpExportScope) Các loại dữ liệu sẽ được xuất cho các đường liên kết Display & Video 360. Chỉ được điền sẵn khi nền tảng là GOOGLE_MARKETING_PLATFORM. Nếu trống thì bạn chưa chỉ định và có thể kết hợp những kiểu này với nhau.

Thực thể

Đại diện cho một pháp nhân quảng cáo có thể liên kết với khách hàng Ads Data Hub.

Biểu diễn dưới dạng JSON
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

Các trường
entityId	string (int64 format) Mã nhận dạng thực thể. Giá trị liệt kê ở đây phụ thuộc vào loại thực thể.
displayName	string Tên hiển thị của thực thể.
type	enum (EntityType) Loại pháp nhân được liên kết.

Loại thực thể

Pháp nhân quảng cáo được hỗ trợ.

Enum
ENTITY_TYPE_UNSPECIFIED	Loại thực thể không xác định.
GOOGLE_ADS_CUSTOMER	Một khách hàng Google Ads. entityId tương ứng với Customer.id trong API Google Ads.
GOOGLE_ADS_CAMPAIGN	Một chiến dịch trên Google Ads. entityId tương ứng với Campaign.id trong API Google Ads.
GMP_CM_ACCOUNT	Có tài khoản Campaign Manager 360. entityId tương ứng với Accounts.id trong API Campaign Manager 360.
GMP_CM_FLOODLIGHT	Một tài khoản Floodlight trong Campaign Manager 360. entityId tương ứng với FloodlightConfigurations.accountId trong API Campaign Manager 360.
GMP_DV360_PARTNER	Mã đối tác Display & Video 360. entityId là mã đối tác Display & Video 360.
GMP_DV360_ADVERTISER	Mã nhà quảng cáo Display & Video 360. entityId là mã nhà quảng cáo Display & Video 360.
GMP_DV360_ORDER	Mã đơn hàng Display & Video 360. entityId là mã đơn hàng Display & Video 360.
GMP_DV360_LINE_ITEM	Mã mục hàng Display & Video 360. entityId là mã mục hàng Display & Video 360.
YT_RESERVE_ORDER	Mã đơn đặt hàng Dành riêng trên YouTube. entityId tương ứng với Order.id trong API Google Ad Manager.
YT_RESERVE_LINE_ITEM	Một mục hàng Dành riêng trên YouTube. entityId tương ứng với LineItem.id trong API Google Ad Manager.
VENDOR_CLIENT_ID_REGISTRATION	Mã khách hàng của nhà cung cấp được nhà cung cấp công nghệ quảng cáo bên thứ ba đăng ký theo cách thủ công để cung cấp dịch vụ đo lường của bên thứ ba.
GOOGLE_AD_MANAGER_ORDER	Mã đơn đặt hàng Google Ad Manager. entityId tương ứng với Order.id trong API Google Ad Manager.
GOOGLE_AD_MANAGER_LINE_ITEM	Mục hàng Google Ad Manager. entityId tương ứng với LineItem.id trong API Google Ad Manager.

Nền tảng

Nền tảng quảng cáo được hỗ trợ.

Enum
PLATFORM_UNSPECIFIED	Nền tảng chưa được chỉ định.
GOOGLE_ADS	Thực thể này được liên kết với Google Ads.
GOOGLE_MARKETING_PLATFORM	Pháp nhân liên kết với Google Marketing Platform.
YOUTUBE_RESERVE	Pháp nhân đó được liên kết với Dành riêng trên YouTube.
GOOGLE_AD_MANAGER	Thực thể liên kết với Google Ad Manager.
FREEWHEEL	Thực thể này được liên kết với FreeWheel.

Chỉ số

Chỉ số có thể được hiển thị thông qua các đường liên kết dữ liệu quảng cáo.

Enum
METRIC_UNSPECIFIED	Chỉ số không xác định.
BRAND_LIFT	Chỉ số tương ứng với Mức tăng thương hiệu.
BRAND_SAFETY	Chỉ số tương ứng với Mức an toàn thương hiệu.
REACH	Chỉ số tương ứng với Phạm vi tiếp cận, trong đó khách hàng là nhà quảng cáo.
VIEWABILITY	Chỉ số tương ứng với Khả năng xem, trong đó khách hàng là nhà quảng cáo.
PUBLISHER_REACH	Chỉ số tương ứng với Phạm vi tiếp cận, trong đó khách hàng là nhà xuất bản/nhà cung cấp nội dung.
PUBLISHER_VIEWABILITY	Chỉ số tương ứng với Khả năng xem, trong đó khách hàng là nhà xuất bản/nhà cung cấp nội dung.

Xuất GmpExport

Các loại dữ liệu khác nhau có thể xuất cho các đường liên kết GMP.

Enum
GMP_EXPORT_SCOPE_UNSPECIFIED	Phạm vi không xác định.
GMP_EXPORT_SCOPE_YT_TRUEVIEW	Nên xuất dữ liệu Display & Video trên YouTube 360.
GMP_EXPORT_SCOPE_DT	Nên xuất dữ liệu Chuyển dữ liệu.

Phương pháp
batchApprove	Phê duyệt danh sách các đường liên kết dữ liệu quảng cáo đang chờ xử lý.
batchReject	Từ chối danh sách đường liên kết dữ liệu quảng cáo đang chờ xử lý.
list	Liệt kê các mối liên kết giữa khách hàng được chỉ định và các pháp nhân quảng cáo khác của Google.