REST Resource: firstPartyAndPartnerAudiences

Tài nguyên: FirstPartyAndPartnerAudience

Mô tả danh sách đối tượng của bên thứ nhất hoặc đối tác được dùng để nhắm mục tiêu. Đối tượng của bên thứ nhất được tạo thông qua việc sử dụng dữ liệu khách hàng. Đối tượng đối tác do Nhà cung cấp dữ liệu bên thứ ba cung cấp và chỉ có thể được cấp phép cho khách hàng.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của đối tượng bên thứ nhất và đối tượng đối tác.
firstPartyAndPartnerAudienceId

string (int64 format)

Giá trị nhận dạng. Mã nhận dạng duy nhất của đối tượng bên thứ nhất và đối tượng của đối tác. Do hệ thống chỉ định.
displayName

string

Không bắt buộc. Tên hiển thị của đối tượng bên thứ nhất và đối tượng đối tác.
description

string

Không bắt buộc. Nội dung mô tả về đối tượng do người dùng cung cấp.

Chỉ áp dụng cho đối tượng bên thứ nhất.
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

Chỉ có đầu ra. Liệu đối tượng có phải là đối tượng bên thứ nhất và đối tượng đối tác hay không.
audienceType

enum (AudienceType)

Không thể thay đổi. Loại đối tượng.
audienceSource

enum (AudienceSource)

Chỉ có đầu ra. Nguồn của đối tượng.
membershipDurationDays

string (int64 format)

Không bắt buộc. Số ngày mà một mục nhập vẫn nằm trong đối tượng sau sự kiện đủ điều kiện. Giá trị đã đặt phải lớn hơn 0 và nhỏ hơn hoặc bằng 540.

Chỉ áp dụng cho đối tượng bên thứ nhất.

Trường này là bắt buộc nếu bạn sử dụng một trong các audienceType sau:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

Chỉ có đầu ra. Quy mô đối tượng ước tính cho Mạng Hiển thị.

Nếu quy mô nhỏ hơn 1.000, thì số lượng sẽ bị ẩn và hệ thống sẽ trả về giá trị 0 vì lý do liên quan đến quyền riêng tư. Nếu không, số này sẽ được làm tròn thành hai chữ số có nghĩa.

Chỉ được trả về trong yêu cầu GET.
activeDisplayAudienceSize

string (int64 format)

Chỉ có đầu ra. Quy mô đối tượng ước tính cho Mạng Hiển thị trong tháng qua.

Nếu quy mô nhỏ hơn 1.000, thì số lượng sẽ bị ẩn và hệ thống sẽ trả về giá trị 0 vì lý do liên quan đến quyền riêng tư. Nếu không, số này sẽ được làm tròn thành hai chữ số có nghĩa.

Chỉ được trả về trong yêu cầu GET.
youtubeAudienceSize

string (int64 format)

Chỉ có đầu ra. Quy mô đối tượng ước tính cho mạng YouTube.

Nếu quy mô nhỏ hơn 1.000, thì số lượng sẽ bị ẩn và hệ thống sẽ trả về giá trị 0 vì lý do liên quan đến quyền riêng tư. Nếu không, số này sẽ được làm tròn thành hai chữ số có nghĩa.

Chỉ áp dụng cho đối tượng bên thứ nhất.

Chỉ được trả về trong yêu cầu GET.
gmailAudienceSize

string (int64 format)

Chỉ có đầu ra. Quy mô đối tượng ước tính cho mạng Gmail.

Nếu quy mô nhỏ hơn 1.000, thì số lượng sẽ bị ẩn và hệ thống sẽ trả về giá trị 0 vì lý do liên quan đến quyền riêng tư. Nếu không, số này sẽ được làm tròn thành hai chữ số có nghĩa.

Chỉ áp dụng cho đối tượng bên thứ nhất.

Chỉ được trả về trong yêu cầu GET.
displayMobileAppAudienceSize

string (int64 format)

Chỉ có đầu ra. Quy mô đối tượng ước tính trên ứng dụng di động trong Mạng Hiển thị.

Nếu quy mô nhỏ hơn 1.000, thì số lượng sẽ bị ẩn và hệ thống sẽ trả về giá trị 0 vì lý do liên quan đến quyền riêng tư. Nếu không, số này sẽ được làm tròn thành hai chữ số có nghĩa.

Chỉ áp dụng cho đối tượng bên thứ nhất.

Chỉ được trả về trong yêu cầu GET.
displayMobileWebAudienceSize

string (int64 format)

Chỉ có đầu ra. Quy mô đối tượng ước tính trên web dành cho thiết bị di động trong Mạng Hiển thị.

Nếu quy mô nhỏ hơn 1.000, thì số lượng sẽ bị ẩn và hệ thống sẽ trả về giá trị 0 vì lý do liên quan đến quyền riêng tư. Nếu không, số này sẽ được làm tròn thành hai chữ số có nghĩa.

Chỉ áp dụng cho đối tượng bên thứ nhất.

Chỉ được trả về trong yêu cầu GET.
displayDesktopAudienceSize

string (int64 format)

Chỉ có đầu ra. Quy mô đối tượng ước tính trên máy tính trong Mạng Hiển thị.

Nếu quy mô nhỏ hơn 1.000, thì số lượng sẽ bị ẩn và hệ thống sẽ trả về giá trị 0 vì lý do liên quan đến quyền riêng tư. Nếu không, số này sẽ được làm tròn thành hai chữ số có nghĩa.

Chỉ áp dụng cho đối tượng bên thứ nhất.

Chỉ được trả về trong yêu cầu GET.
appId

string

Không bắt buộc. appId khớp với loại mobileDeviceIds đang được tải lên.

Chỉ áp dụng cho audienceType CUSTOMER_MATCH_DEVICE_ID

FirstPartyAndPartnerAudienceType

Các loại tài nguyên đối tượng bên thứ nhất và đối tượng đối tác có thể có.

Enum
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED Giá trị mặc định khi loại không được chỉ định hoặc không xác định.
TYPE_FIRST_PARTY Đối tượng được tạo thông qua việc sử dụng dữ liệu khách hàng.
TYPE_PARTNER Đối tượng do nhà cung cấp dữ liệu của bên thứ ba cung cấp.

AudienceType

Các loại đối tượng có thể có.

Enum
AUDIENCE_TYPE_UNSPECIFIED Giá trị mặc định khi loại không được chỉ định hoặc không xác định.
CUSTOMER_MATCH_CONTACT_INFO Đối tượng được tạo bằng cách so khớp khách hàng với thông tin liên hệ đã biết.
CUSTOMER_MATCH_DEVICE_ID Đối tượng được tạo thông qua việc so khớp khách hàng với Mã thiết bị di động đã biết.
CUSTOMER_MATCH_USER_ID Đối tượng được tạo thông qua việc so khớp khách hàng với Mã nhận dạng người dùng đã biết.
ACTIVITY_BASED

Không dùng nữa: Đối tượng được tạo dựa trên hoạt động của chiến dịch.
FREQUENCY_CAP

Không dùng nữa: Đối tượng được tạo dựa trên việc loại trừ số lượt hiển thị mà họ đã được phân phát.
TAG_BASED Đối tượng được tạo dựa trên các biến tuỳ chỉnh được đính kèm vào pixel.
YOUTUBE_USERS Đối tượng được tạo dựa trên các lượt tương tác trước đây với video, quảng cáo trên YouTube hoặc kênh YouTube.
THIRD_PARTY Đối tượng đã được cấp phép sử dụng từ một bên thứ ba.
COMMERCE Đối tượng do đối tác thương mại cung cấp (có tính phí).
LINEAR Đối tượng cho nội dung truyền hình truyền thống.
AGENCY Đối tượng do một công ty quảng cáo cung cấp.

AudienceSource

Các nguồn đối tượng có thể có.

Enum
AUDIENCE_SOURCE_UNSPECIFIED Giá trị mặc định khi nguồn đối tượng không được chỉ định hoặc không xác định.
DISPLAY_VIDEO_360 Bắt nguồn từ Display & Video 360.
CAMPAIGN_MANAGER Bắt nguồn từ Campaign Manager 360.
AD_MANAGER Bắt nguồn từ Google Ad Manager.
SEARCH_ADS_360 Bắt nguồn từ Search Ads 360.
YOUTUBE Bắt nguồn từ YouTube.
ADS_DATA_HUB Bắt nguồn từ Ads Data Hub.

Phương thức

get

 Lấy đối tượng của bên thứ nhất hoặc đối tác.

list

 Liệt kê đối tượng bên thứ nhất và đối tượng của đối tác.