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

อัปโหลดสมาชิกไปยังกลุ่มเป้าหมายในการจับคู่ข้อมูลลูกค้าโดยส่ง 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"
        }
      ]
    }
  }
}

ข้อมูลที่อยู่ IP

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

ข้อมูลติดต่อและ IP

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

Mobile ID

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

รหัสผู้ใช้

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