AudienceMember

Thành viên khán giả cần được thao tác.

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

  // Union field data can be only one of the following:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  }
  // End of list of possible types for union field data.
}
Trường
destinationReferences[]

string

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

object (Consent)

Không bắt buộc. Chế độ cài đặt sự đồng ý cho người dùng.
Trường nhóm data. Loại dữ liệu nhận dạng cần được xử lý. data chỉ có thể là một trong những trạng thái sau:
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.

PairData

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

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 Clean Room 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.

MobileData

Mã nhận dạng thiết bị di động cho đối tượng. Bạn phải có ít nhất một mã nhận dạng thiết bị di động.

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

string

Bắt buộc. Danh sách mã thiết bị di động (mã nhận dạng cho quảng cáo/IDFA). Bạn có thể cung cấp tối đa 10 mobileIds trong một AudienceMember.

UserIdData

Dữ liệu mã nhận dạng người dùng lưu giữ 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 lưu giữ các ppid. Bạn phải có í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 giá trị nhận dạng và dữ liệu được 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 được ghi lại gần đây nhất 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".