REST Resource: firstAndThirdPartyAudiences

Tài nguyên: FirstAndThirdPartyAudience

Mô tả danh sách đối tượng của bên thứ nhất hoặc của bên thứ ba 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 ứng dụng. Đối tượng bên thứ ba 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,
  "firstAndThirdPartyAudienceId": string,
  "displayName": string,
  "description": string,
  "firstAndThirdPartyAudienceType": enum (FirstAndThirdPartyAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string,

  // Union field members can be only one of the following:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field members.
}
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à bên thứ ba.
firstAndThirdPartyAudienceId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của đối tượng bên thứ nhất và bên thứ ba. Do hệ thống chỉ định.
displayName

string

Tên hiển thị của đối tượng bên thứ nhất và bên thứ ba.
description

string

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

enum (FirstAndThirdPartyAudienceType)

Đối tượng là đối tượng bên thứ nhất hay bên thứ ba.
audienceType

enum (AudienceType)

Loại đối tượng.
audienceSource

enum (AudienceSource)

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

string (int64 format)

Khoảng thời gian tính bằng ngày mà một bài dự thi vẫn còn trong đối tượng sau khi sự kiện đủ điều kiện kết thúc. Nếu đối tượng không có thời hạn, hãy đặt giá trị của trường này thành 10.000. Nếu không, 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.

Đây là trường 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 kích thước nhỏ hơn 1000, số sẽ bị ẩn và 0 sẽ được trả về vì lý do liên quan đến quyền riêng tư. Nếu không, số đó 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 trước.

Nếu kích thước nhỏ hơn 1000, số sẽ bị ẩn và 0 sẽ được trả về vì lý do liên quan đến quyền riêng tư. Nếu không, số đó 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 kích thước nhỏ hơn 1000, số sẽ bị ẩn và 0 sẽ được trả về vì lý do liên quan đến quyền riêng tư. Nếu không, số đó 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 kích thước nhỏ hơn 1000, số sẽ bị ẩn và 0 sẽ được trả về vì lý do liên quan đến quyền riêng tư. Nếu không, số đó 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 cho ứng dụng dành cho thiết bị di động trong Mạng Hiển thị.

Nếu kích thước nhỏ hơn 1000, số sẽ bị ẩn và 0 sẽ được trả về vì lý do liên quan đến quyền riêng tư. Nếu không, số đó 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 kích thước nhỏ hơn 1000, số sẽ bị ẩn và 0 sẽ được trả về vì lý do liên quan đến quyền riêng tư. Nếu không, số đó 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 kích thước nhỏ hơn 1000, số sẽ bị ẩn và 0 sẽ được trả về vì lý do liên quan đến quyền riêng tư. Nếu không, số đó 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

Mã appId khớp với loại mobileDeviceIds đang được tải lên.

Chỉ áp dụng cho audienceType CUSTOMER_MATCH_DEVICE_ID
Trường kết hợp members. Các thành viên ban đầu của đối tượng So khớp khách hàng. members chỉ có thể là một trong những trạng thái sau đây:
contactInfoList

object (ContactInfoList)

Chỉ nhập. Danh sách thông tin liên hệ để xác định các thành viên ban đầu của đối tượng.

Chỉ áp dụng cho audienceType CUSTOMER_MATCH_CONTACT_INFO
mobileDeviceIdList

object (MobileDeviceIdList)

Chỉ nhập. Danh sách mã thiết bị di động để xác định các thành viên ban đầu của đối tượng.

Chỉ áp dụng cho audienceType CUSTOMER_MATCH_DEVICE_ID

FirstAndThirdPartyAudienceType

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

Enum
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED Giá trị mặc định khi loại không được chỉ định hoặc không xác định.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY Đối tượng được tạo thông qua việc sử dụng dữ liệu khách hàng.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY Đố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 bằng cách 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 những Mã nhận dạng người dùng đã biết.
ACTIVITY_BASED

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

Đối tượng được tạo dựa trên việc loại trừ số lượt hiển thị mà đối tượng đã được phân phát.
TAG_BASED Đối tượng được tạo dựa trên các biến tùy chỉnh đính kèm với 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.
LICENSED Loại phụ của loại đối tượng bên thứ ba.

AudienceSource

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ừ Mạng Hiển thị và 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.

ContactInfoList

Thông báo bao bọc cho danh sách thông tin liên hệ để xác định các thành viên của đối tượng So khớp khách hàng.

Biểu diễn dưới dạng JSON 
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ]
}
Trường
contactInfos[]

object (ContactInfo)

Danh sách các đối tượng ContactInfo xác định các thành viên của đối tượng So khớp khách hàng. Quy mô của các thành viên sau khi phân tách contactInfo không được lớn hơn 500.000.

ContactInfo

Thông tin liên hệ để xác định một thành viên của đối tượng So khớp khách hàng.

Biểu diễn dưới dạng JSON 
{
  "hashedEmails": [
    string
  ],
  "hashedPhoneNumbers": [
    string
  ],
  "zipCodes": [
    string
  ],
  "hashedFirstName": string,
  "hashedLastName": string,
  "countryCode": string
}
Trường
hashedEmails[]

string

Danh sách email đã băm bằng thuật toán SHA256 của thành viên. Trước khi băm, hãy xoá tất cả khoảng trắng và đảm bảo toàn bộ chuỗi là chữ thường.
hashedPhoneNumbers[]

string

Danh sách số điện thoại đã băm bằng thuật toán SHA256 của thành viên. Trước khi băm, tất cả các số điện thoại phải được định dạng bằng định dạng E.164 và bao gồm mã gọi điện quốc gia.
zipCodes[]

string

Danh sách mã bưu chính của thành viên.

Bạn cũng phải đặt các trường sau:
hashedFirstName

string

Tên được băm bằng thuật toán SHA256 của thành viên. Trước khi băm, hãy xoá tất cả khoảng trắng và đảm bảo toàn bộ chuỗi là chữ thường.

Bạn cũng phải đặt các trường sau:
hashedLastName

string

Họ đã băm bằng thuật toán SHA256 của thành viên. Trước khi băm, hãy xoá tất cả khoảng trắng và đảm bảo toàn bộ chuỗi là chữ thường.

Bạn cũng phải đặt các trường sau:
countryCode

string

Mã quốc gia của thành viên.

Bạn cũng phải đặt các trường sau:

MobileDeviceIdList

Thông báo bao bọc cho danh sách mã thiết bị di động để xác định thành viên của đối tượng So khớp khách hàng.

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

string

Danh sách mã thiết bị di động xác định các thành viên của đối tượng So khớp khách hàng. Kích thước của mobileDeviceIds không được lớn hơn 500.000.

Phương thức

create

 Tạo một FirstAndThirdPartyAudience.

editCustomerMatchMembers

 Cập nhật danh sách thành viên của một đối tượng So khớp khách hàng.

get

 Thu hút đối tượng bên thứ nhất và bên thứ ba.

list

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

patch

 Cập nhật một FirstAndThirdPartyAudience hiện có.