AudienceMember

Thành viên trong phân khúc đối tượng cần được thao tác.

Biểu diễn dưới dạng JSON 
{
  "destinationReferences": [
    string
  ],
  "consent": {
    object (Consent)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  },
  "googleUserIdData": {
    object (GoogleUserIdData)
  },
  "partnerProvidedIdData": {
    object (PartnerProvidedIdData)
  }
  // End of mutually exclusive fields.
}
Trường
destinationReferences[]

string

Không bắt buộc. Xác định Destination nào sẽ gửi thành viên trong phân khúc đối tượng đến.
consent

object (Consent)

Không bắt buộc. Chế độ cài đặt sự đồng ý của người dùng.
Loại dữ liệu nhận dạng cần được xử lý. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
userData

object (UserData)

Dữ liệu do người dùng cung cấp để xác định người dùng.
pairData

object (PairData)

Mã nhận dạng Điều chỉnh danh tính giữa nhà xuất bản và nhà quảng cáo (PAIR).

Tính năng này chỉ dành cho các đối tác dữ liệu.
mobileData

object (MobileData)

Dữ liệu xác định thiết bị di động của người dùng.
userIdData

object (UserIdData)

Dữ liệu liên quan đến giá trị nhận dạng riêng biệt cho một người dùng, do nhà quảng cáo xác định.
ppidData

object (PpidData)

Dữ liệu liên quan đến giá trị nhận dạng do nhà xuất bản cung cấp.

Tính năng này chỉ dành cho các đối tác dữ liệu.
compositeData

object (CompositeData)

Nhóm gồm nhiều loại giá trị nhận dạng.
googleUserIdData

object (GoogleUserIdData)

Mã nhận dạng người dùng Google đã mã hoá.
partnerProvidedIdData

object (PartnerProvidedIdData)

Giá trị nhận dạng do đối tác cung cấp.
Kết thúc các trường xung khắc.

PairData

Mã PAIR cho đối tượng. Bạn phải cung cấp ít nhất một mã PAIR.

Tính năng này chỉ dành cho các đối tác dữ liệu.

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

string

Bắt buộc. Dữ liệu PII do Cleanroom cung cấp, được băm bằng SHA256 và mã hoá bằng mật mã giao hoán EC bằng khoá của nhà xuất bản cho danh sách người dùng PAIR. Bạn có thể cung cấp tối đa 10 pairIds trong một AudienceMember.

UserIdData

Dữ liệu mã nhận dạng người dùng chứa mã nhận dạng người dùng.

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

string

Bắt buộc. Giá trị nhận dạng riêng biệt cho một người dùng, do nhà quảng cáo xác định.

PpidData

Dữ liệu giá trị nhận dạng do nhà xuất bản cung cấp chứa ppid. Bạn phải cung cấp ít nhất một ppid.

Tính năng này chỉ dành cho các đối tác dữ liệu.

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

string

Bắt buộc. Danh sách giá trị nhận dạng do nhà xuất bản cung cấp cho một người dùng.

CompositeData

Dữ liệu tổng hợp chứa mã nhận dạng và dữ liệu liên kết cho một người dùng. Bạn phải cung cấp ít nhất một trong hai thuộc tính userData hoặc ipData.

Biểu diễn dưới dạng JSON 
{
  "userData": {
    object (UserData)
  },
  "ipData": [
    {
      object (IpData)
    }
  ]
}
Trường
userData

object (UserData)

Không bắt buộc. Dữ liệu do người dùng cung cấp để xác định người dùng.
ipData[]

object (IpData)

Không bắt buộc. Dữ liệu địa chỉ IP thể hiện lượt tương tác của khách hàng được dùng để tạo đối tượng.

IpData

Thông tin địa chỉ IP của người dùng. Bạn nên thêm observeStartTime và observeEndTime để giúp cải thiện tỷ lệ khớp của tính năng So khớp khách hàng.

Biểu diễn dưới dạng JSON 
{
  "ipAddress": string,
  "observeStartTime": string,
  "observeEndTime": string
}
Trường
ipAddress

string

Bắt buộc. Địa chỉ IP được ghi lại tại thời điểm khách hàng tương tác. Chấp nhận các định dạng chuỗi tiêu chuẩn cho cả IPv4 và IPv6.
observeStartTime

string (Timestamp format)

Không bắt buộc. Thời gian tương tác đầu tiên được ghi lại từ địa chỉ IP này trong một phiên.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
observeEndTime

string (Timestamp format)

Không bắt buộc. Thời gian tương tác gần đây nhất được ghi lại từ địa chỉ IP này trong một phiên.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

GoogleUserIdData

Dữ liệu mã nhận dạng người dùng Google chứa mã nhận dạng người dùng Google đã mã hoá. Bạn phải cung cấp ít nhất một mã nhận dạng người dùng Google.

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

string

Bắt buộc. Danh sách mã nhận dạng người dùng Google đã mã hoá.

PartnerProvidedIdData

Dữ liệu do đối tác cung cấp chứa giá trị nhận dạng do đối tác cung cấp. Bạn phải cung cấp ít nhất một giá trị nhận dạng do đối tác cung cấp.

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

string

Bắt buộc. Danh sách giá trị nhận dạng do đối tác cung cấp.