อัปโหลดสมาชิกไปยังกลุ่มเป้าหมาย

อัปโหลดสมาชิกไปยังกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้าโดยส่ง IngestAudienceMembersRequest

ทำตามขั้นตอนต่อไปนี้เพื่อกำหนดค่าและส่งคำขอ

1. ตั้งค่าฟิลด์ termsOfService เป็นข้อความ TermsOfService โดยตั้งค่า customerMatchTermsOfServiceStatus เป็น ACCEPTED เพื่อ ยืนยันว่า operatingAccount ยอมรับ ข้อกำหนดในการให้บริการของการจับคู่ข้อมูลลูกค้า

2. ใน AudienceMember แต่ละรายการในรายการ audienceMembers ให้ตั้งค่าฟิลด์ข้อมูลตามประเภทข้อมูลที่ การอัปโหลดมี

   • หากการอัปโหลดมีข้อมูลติดต่อ ข้อมูลที่อยู่ IP, หรือทั้ง 2 อย่าง ให้ตั้งค่าฟิลด์ compositeData เป็นออบเจ็กต์ CompositeData สำหรับ ข้อมูลติดต่อ ให้ตั้งค่าฟิลด์ userData เป็นออบเจ็กต์ UserData และเพิ่มรายการแยกต่างหากใน รายการ userIdentifiers สำหรับตัวระบุแต่ละรายการของสมาชิกในกลุ่มเป้าหมาย สำหรับข้อมูลที่อยู่ IP ให้เพิ่มรายการ IpData ในรายการ ipData สำหรับที่อยู่ IP แต่ละรายการของสมาชิกในกลุ่มเป้าหมาย

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

   • หากการอัปโหลดมี Mobile ID ให้ตั้งค่าฟิลด์ mobileData เป็นข้อความ MobileData เพิ่มรายการแยกต่างหากในรายการ mobileIds สำหรับ Mobile ID แต่ละรายการของสมาชิกในกลุ่มเป้าหมาย

   • หากการอัปโหลดมีรหัสผู้ใช้ ให้ตั้งค่าฟิลด์ userIdData เป็นข้อความ UserIdData และตั้งค่าฟิลด์ userId เป็นรหัสผู้ใช้ของสมาชิกในกลุ่มเป้าหมาย

3. ส่งข้อมูลการจับคู่ข้อมูลลูกค้าโดยใช้ขั้นตอนใน ส่งสมาชิกในกลุ่มเป้าหมาย

ตัวอย่างสมาชิกในกลุ่มเป้าหมาย

ตัวอย่างต่อไปนี้แสดงวิธีจัดโครงสร้างออบเจ็กต์ AudienceMember สำหรับข้อมูลสมาชิกแต่ละประเภท AudienceMember ทุกรายการในคำขอเดียวต้องมี ชุดข้อมูลรหัสประเภทเดียวกัน (compositeData, mobileData หรือ userIdData)

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    }
  }
}

{
  "compositeData": {
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    },
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

{
  "mobileData": {
    "mobileIds": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}

{
  "userIdData": {
    "userId": "user_987654321"
  }
}