AudienceMember

สมาชิกในกลุ่มเป้าหมายที่จะดำเนินการ

การแสดง 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)
  },
  "googleUserIdData": {
    object (GoogleUserIdData)
  },
  "partnerProvidedIdData": {
    object (PartnerProvidedIdData)
  }
  // End of list of possible types for union field data.
}
ฟิลด์
destinationReferences[]

string

ไม่บังคับ กำหนดว่าควรส่งสมาชิกในกลุ่มเป้าหมายไปยัง Destination ใด
consent

object (Consent)

ไม่บังคับ การตั้งค่าความยินยอมสำหรับผู้ใช้
ฟิลด์ Union data ประเภทของข้อมูลระบุตัวตนที่จะดำเนินการ data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
userData

object (UserData)

ข้อมูลที่ได้จากผู้ใช้ซึ่งระบุตัวผู้ใช้
pairData

object (PairData)

รหัส Publisher Advertiser Identity Reconciliation (PAIR)

ฟีเจอร์นี้ใช้ได้เฉพาะกับพาร์ทเนอร์ด้านข้อมูลเท่านั้น
mobileData

object (MobileData)

ข้อมูลที่ระบุอุปกรณ์เคลื่อนที่ของผู้ใช้
userIdData

object (UserIdData)

ข้อมูลที่เกี่ยวข้องกับตัวระบุที่ไม่ซ้ำกันสำหรับผู้ใช้ตามที่ผู้ลงโฆษณากำหนด
ppidData

object (PpidData)

ข้อมูลที่เกี่ยวข้องกับตัวระบุที่ผู้เผยแพร่โฆษณามีให้

ฟีเจอร์นี้ใช้ได้เฉพาะกับพาร์ทเนอร์ด้านข้อมูลเท่านั้น
compositeData

object (CompositeData)

กลุ่มของตัวระบุหลายประเภท
googleUserIdData

object (GoogleUserIdData)

รหัสผู้ใช้ Google ที่เข้ารหัส
partnerProvidedIdData

object (PartnerProvidedIdData)

ตัวระบุที่พาร์ทเนอร์ระบุ

PairData

รหัส PAIR สำหรับกลุ่มเป้าหมาย ต้องระบุรหัสคู่ (PAIR ID) อย่างน้อย 1 รายการ

ฟีเจอร์นี้ใช้ได้เฉพาะกับพาร์ทเนอร์ด้านข้อมูลเท่านั้น

การแสดง JSON 
{
  "pairIds": [
    string
  ]
}
ช่อง
pairIds[]

string

ต้องระบุ ข้อมูล PII ที่ Clean Room จัดหาให้ ซึ่งแฮชด้วย SHA256 และเข้ารหัสด้วยการเข้ารหัสลับแบบสลับที่ใช้คีย์ของผู้เผยแพร่โฆษณาสำหรับรายชื่อผู้ใช้ PAIR ระบุ pairIds ได้สูงสุด 10 รายการใน AudienceMember เดียว

MobileData

รหัสอุปกรณ์เคลื่อนที่สำหรับกลุ่มเป้าหมาย ต้องระบุรหัสอุปกรณ์เคลื่อนที่อย่างน้อย 1 รายการ

การแสดง JSON 
{
  "mobileIds": [
    string
  ]
}
ช่อง
mobileIds[]

string

ต้องระบุ รายการรหัสอุปกรณ์เคลื่อนที่ (รหัสโฆษณา Android, IDFA ของ iOS สำหรับรายชื่อผู้ใช้ที่กำหนดเป้าหมายตามข้อมูลลูกค้า และรหัสโฆษณา Android, IDFA ของ iOS, รหัส Xbox หรือ Microsoft, รหัส Amazon Fire TV, รหัส Roku, รหัสอุปกรณ์ทั่วไปสำหรับรายชื่อผู้ใช้พื้นฐาน) ระบุ mobileIds ได้สูงสุด 10 รายการใน AudienceMember เดียว

UserIdData

ข้อมูลรหัสผู้ใช้ที่มีรหัสผู้ใช้

การแสดง JSON 
{
  "userId": string
}
ช่อง
userId

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันสำหรับผู้ใช้ตามที่ผู้ลงโฆษณากำหนด

PpidData

ข้อมูลตัวระบุที่ผู้เผยแพร่โฆษณามีให้ซึ่งมี PPID ต้องระบุ PPID อย่างน้อย 1 รายการ

ฟีเจอร์นี้ใช้ได้เฉพาะกับพาร์ทเนอร์ด้านข้อมูลเท่านั้น

การแสดง JSON 
{
  "ppids": [
    string
  ]
}
ช่อง
ppids[]

string

ต้องระบุ รายการตัวระบุที่ผู้เผยแพร่โฆษณามีให้สำหรับผู้ใช้

CompositeData

ข้อมูลแบบผสมที่มีตัวระบุและข้อมูลที่เชื่อมโยงสำหรับผู้ใช้ ต้องระบุ userData หรือ ipData อย่างน้อย 1 รายการ

การแสดง JSON 
{
  "userData": {
    object (UserData)
  },
  "ipData": [
    {
      object (IpData)
    }
  ]
}
ฟิลด์
userData

object (UserData)

ไม่บังคับ ข้อมูลที่ได้จากผู้ใช้ซึ่งระบุตัวผู้ใช้
ipData[]

object (IpData)

ไม่บังคับ ข้อมูลที่อยู่ IP ที่แสดงถึงการโต้ตอบของลูกค้าซึ่งใช้ในการสร้างกลุ่มเป้าหมาย

IpData

ข้อมูลที่อยู่ IP ของผู้ใช้ เราขอแนะนำให้รวม observeStartTime และ observeEndTime เพื่อช่วยปรับปรุงอัตราการจับคู่ของการจับคู่ข้อมูลลูกค้า

การแสดง JSON 
{
  "ipAddress": string,
  "observeStartTime": string,
  "observeEndTime": string
}
ช่อง
ipAddress

string

ต้องระบุ ที่อยู่ IP ที่บันทึกไว้ในขณะที่มีการโต้ตอบกับลูกค้า ยอมรับรูปแบบสตริงมาตรฐานสำหรับทั้ง IPv4 และ IPv6
observeStartTime

string (Timestamp format)

ไม่บังคับ เวลาของการโต้ตอบแรกที่บันทึกจากที่อยู่ IP นี้ในเซสชัน

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
observeEndTime

string (Timestamp format)

ไม่บังคับ เวลาโต้ตอบที่บันทึกล่าสุดจากที่อยู่ IP นี้ในเซสชัน

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

GoogleUserIdData

ข้อมูลรหัสผู้ใช้ Google ที่มีรหัสผู้ใช้ Google ที่เข้ารหัส ต้องระบุรหัสผู้ใช้ Google อย่างน้อย 1 รายการ

การแสดง JSON 
{
  "googleUserIds": [
    string
  ]
}
ช่อง
googleUserIds[]

string

ต้องระบุ รายการรหัสผู้ใช้ Google ที่เข้ารหัส

PartnerProvidedIdData

ข้อมูลที่พาร์ทเนอร์ระบุซึ่งมีตัวระบุที่พาร์ทเนอร์ระบุ ต้องระบุตัวระบุที่พาร์ทเนอร์ระบุอย่างน้อย 1 รายการ

การแสดง JSON 
{
  "partnerProvidedIds": [
    string
  ]
}
ช่อง
partnerProvidedIds[]

string

ต้องระบุ รายการตัวระบุที่พาร์ทเนอร์ระบุ