- Tài nguyên: FirstAndSecondPartyAudience
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- Sự đồng ý
- ConsentStatus
- MobileDeviceIdList
- Phương thức
Tài nguyên: FirstAndSecondPartyAudience
Mô tả danh sách đối tượng của bên thứ nhất hoặc 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 bằng cách sử dụng dữ liệu của khách hàng. Đối tượng của bên thứ ba do Nhà cung cấp dữ liệu của 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 ( |
Trường | |
---|---|
name |
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 |
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 |
Tên hiển thị của đối tượng bên thứ nhất và đối tượng bên thứ ba. |
description |
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 |
Đối tượng là đối tượng thứ nhất hay đối tượng bên thứ ba. |
audienceType |
Kiểu đối tượng. |
audienceSource |
Chỉ có đầu ra. Nguồn đối tượng. |
membershipDurationDays |
Khoảng thời gian tính bằng ngày mà một bài viết lưu lại trong đối tượng sau sự kiện đủ điều kiện. 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 10000. 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
|
displayAudienceSize |
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 1000, số này sẽ bị ẩn và 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 |
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 quy mô nhỏ hơn 1000, số này sẽ bị ẩn và 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 |
Chỉ có đầu ra. Quy mô đối tượng ước tính cho mạng YouTube. Nếu quy mô nhỏ hơn 1000, số này sẽ bị ẩn và 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 |
Chỉ có đầu ra. Quy mô đối tượng ước tính cho mạng Gmail. Nếu quy mô nhỏ hơn 1000, số này sẽ bị ẩn và 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 |
Chỉ có đầu ra. Quy mô đối tượng ước tính của ứng dụng dành cho thiết bị di động trong Mạng Hiển thị. Nếu quy mô nhỏ hơn 1000, số này sẽ bị ẩn và 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 |
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 1000, số này sẽ bị ẩn và 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 |
Chỉ có đầu ra. Quy mô đối tượng trên máy tính ước tính trong Mạng Hiển thị. Nếu quy mô nhỏ hơn 1000, số này sẽ bị ẩn và 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 |
Mã ứng dụng khớp với loại mã thiết bị di động đang được tải lên. Chỉ áp dụng cho |
Trường hợp members . Các thành viên đầu tiên 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: |
|
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 |
mobileDeviceIdList |
Chỉ nhập. Danh sách mã thiết bị di động để xác định các thành viên đối tượng ban đầu. Chỉ áp dụng cho |
FirstAndThirdPartyAudienceType
Các loại tài nguyên có thể có của tài nguyên đối tượng bên thứ nhất và bên thứ ba.
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 kiểu đố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 các Mã thiết bị di động đã biết. |
CUSTOMER_MATCH_USER_ID |
Đối tượng được tạo bằng cách so khớp khách hàng với các 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 đi kèm với pixel. |
YOUTUBE_USERS |
Đối tượng được tạo dựa trên những hoạt động 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ừ 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 |
Có nguồn gốc từ YouTube. |
ADS_DATA_HUB |
Bắt nguồn từ Ads Data Hub. |
ContactInfoList
Thông báo bao bọc cho một danh sách thông tin liên hệ 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 |
---|
{ "contactInfos": [ { object ( |
Trường | |
---|---|
contactInfos[] |
Danh sách các đối tượng ContactInfo xác định thành viên thuộc đối tượng So khớp khách hàng. Kích thước của các thành viên sau khi chia tách ContactInfos không được lớn hơn 500.000. |
consent |
Chỉ nhập. Chế độ cài đặt về sự đồng ý cho người dùng trong Nếu bạn không đặt trường này, thì điều đó có nghĩa là chế độ đồng ý chưa được chỉ định. Nếu bạn đặt trường |
ContactInfo
Thông tin liên hệ xác định thành viên đố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[] |
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á mọi khoảng trắng và đảm bảo chuỗi đều là chữ thường. |
hashedPhoneNumbers[] |
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 cả mã gọi quốc gia. |
zipCodes[] |
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 |
Tên đã băm của thành viên bằng thuật toán SHA256. Trước khi băm, hãy xoá mọi khoảng trắng và đảm bảo chuỗi đều là chữ thường. Bạn cũng phải đặt các trường sau: |
hashedLastName |
Họ đã băm bằng thuật toán SHA256 của thành viên. Trước khi băm, hãy xoá mọi khoảng trắng và đảm bảo chuỗi đều là chữ thường. Bạn cũng phải đặt các trường sau: |
countryCode |
Mã quốc gia của thành viên. Bạn cũng phải đặt các trường sau: |
Sự đồng ý
Trạng thái đồng ý của người dùng.
Biểu diễn dưới dạng JSON |
---|
{ "adUserData": enum ( |
Trường | |
---|---|
adUserData |
Thể hiện sự đồng ý đối với dữ liệu người dùng quảng cáo. |
adPersonalization |
Thể hiện sự đồng ý đối với hoạt động cá nhân hoá quảng cáo. |
ConsentStatus
Trạng thái đồng ý.
Enum | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
Giá trị loại không được chỉ định hoặc không xác định trong phiên bản này. |
CONSENT_STATUS_GRANTED |
Đã đồng ý. |
CONSENT_STATUS_DENIED |
Người dùng không đồng ý. |
MobileDeviceIdList
Thông báo gói cho danh sách các mã thiết bị di động xác định thành viên đối tượng So khớp khách hàng.
Biểu diễn dưới dạng JSON |
---|
{
"mobileDeviceIds": [
string
],
"consent": {
object ( |
Trường | |
---|---|
mobileDeviceIds[] |
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. Kích thước của mobileDeviceIds không được lớn hơn 500.000. |
consent |
Chỉ nhập. Chế độ cài đặt về sự đồng ý cho người dùng trong Nếu bạn không đặt trường này, thì điều đó có nghĩa là chế độ đồng ý chưa được chỉ định. Nếu bạn đặt trường |
Phương thức |
|
---|---|
|
Tạo một đối tượng thứ nhất và bên thứ ba. |
|
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. |
|
Có được đối tượng bên thứ nhất và bên thứ ba. |
|
Liệt kê các đối tượng bên thứ nhất và bên thứ ba. |
|
Cập nhật một đối tượng FirstAndSecondPartyAudience hiện có. |