REST Resource: firstAndThirdPartyAudiences

{
  "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.
}

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.

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.

string

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

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.

enum (FirstAndThirdPartyAudienceType)

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

enum (AudienceType)

Loại đối tượng.

enum (AudienceSource)

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

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

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.

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.

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.

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.

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.

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.

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.

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

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

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

{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ],
  "consent": {
    object (Consent)
  }
}

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.

object (Consent)

Chỉ nhập. Chế độ cài đặt về sự đồng ý cho người dùng trong contactInfos.

Nếu bạn không đặt trường này, thì tức là bạn chưa chỉ định trạng thái đồng ý.

Nếu bạn đặt các trường adUserData hoặc adPersonalization thành CONSENT_STATUS_DENIED, thì yêu cầu sẽ trả về lỗi.

{
  "hashedEmails": [
    string
  ],
  "hashedPhoneNumbers": [
    string
  ],
  "zipCodes": [
    string
  ],
  "hashedFirstName": string,
  "hashedLastName": string,
  "countryCode": string
}

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.

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.

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:

• countryCode
• hashedFirstName
• hashedLastName

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:

• countryCode
• hashedLastName
• zipCodes

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
• hashedFirstName
• zipCodes

string

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

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

• hashedFirstName
• hashedLastName
• zipCodes

{
  "adUserData": enum (ConsentStatus),
  "adPersonalization": enum (ConsentStatus)
}

enum (ConsentStatus)

Biểu thị sự đồng ý cho dữ liệu người dùng quảng cáo.

enum (ConsentStatus)

Thể hiện sự đồng ý đối với hoạt động cá nhân hoá quảng cáo.

{
  "mobileDeviceIds": [
    string
  ],
  "consent": {
    object (Consent)
  }
}

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.

object (Consent)

Chỉ nhập. Chế độ cài đặt về sự đồng ý cho người dùng trong mobileDeviceIds.

Nếu bạn không đặt trường này, thì tức là bạn chưa chỉ định trạng thái đồng ý.

Nếu bạn đặt các trường adUserData hoặc adPersonalization thành CONSENT_STATUS_DENIED, thì yêu cầu sẽ trả về lỗi.