นำสมาชิกทั้งหมดออกจากกลุ่มเป้าหมาย

คู่มือนี้อธิบายวิธีนำสมาชิกทั้งหมดออกจากกลุ่มเป้าหมายการจับคู่ข้อมูลลูกค้า โดยการส่ง RemoveAllAudienceMembersRequest

วิธีนี้มีประโยชน์หากคุณต้องการล้างรายการผู้ใช้ด้วยคำขอเดียวหรือ แทนที่สมาชิกกลุ่มเป้าหมายทั้งหมดในรายการ

ล้างกลุ่มเป้าหมาย

หากต้องการนำสมาชิกทั้งหมดออกจากกลุ่มเป้าหมาย ให้ส่ง RemoveAllAudienceMembersRequest และละเว้นฟิลด์ removeAsOfTime การดำเนินการนี้จะตั้งเวลาการนำออกเป็นเวลาปัจจุบัน และนำสมาชิกปัจจุบันทั้งหมดออกจากรายการ

แทนที่สมาชิกทั้งหมด

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

1. บันทึกเวลาปัจจุบันเป็น T
2. เริ่มอัปโหลดสมาชิกใหม่โดย ส่ง IngestAudienceMembersRequest คุณส่งคำขอส่งผ่านข้อมูลหลายรายการได้หากจำเป็น

3. รอจนกว่าคำขอส่งผ่านข้อมูลทั้งหมดจะประมวลผลเสร็จสิ้น คุณตรวจสอบสถานะคำขอได้โดยใช้การวินิจฉัย

4. ส่ง RemoveAllAudienceMembersRequest โดยตั้งค่า removeAsOfTime เป็นการประทับเวลา T ที่บันทึกไว้ในขั้นตอนที่ 1 การดำเนินการนี้จะนำเฉพาะสมาชิกที่เพิ่มก่อนที่คุณเริ่ม อัปโหลดสมาชิกใหม่เท่านั้น โดยจะเหลือไว้เฉพาะสมาชิกที่เพิ่มใหม่

สร้างคำขอ

ตั้งค่าช่องต่อไปนี้ในส่วนเนื้อหาของ RemoveAllAudienceMembersRequest

destinations

ต้องระบุ รายการปลายทาง productDestinationIdฟิลด์ ในแต่ละปลายทางจะระบุกลุ่มเป้าหมายที่คุณต้องการนำสมาชิก ออกจาก ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่าปลายทาง

removeAsOfTime

ไม่บังคับ ระบบจะนำเฉพาะสมาชิกที่เพิ่มก่อนเวลานี้ออก ดูรายละเอียดการจัดรูปแบบได้ที่รูปแบบการประทับเวลา หากไม่ได้ตั้งค่า ค่านี้จะ เป็นเวลาปัจจุบันโดยค่าเริ่มต้น

validateOnly

ไม่บังคับ ตั้งค่าเป็น true เพื่อตรวจสอบคำขอโดยไม่ใช้การเปลี่ยนแปลง เมื่อพร้อมที่จะใช้การเปลี่ยนแปลงแล้ว ให้ตั้งค่าเป็น false

ตัวอย่างคำขอ

นี่คือคำขอตัวอย่างที่นำสมาชิกทั้งหมดออกจากกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้า

1. คลิกเปิดในโปรแกรมสำรวจ API เพื่อเปิดโปรแกรมสำรวจ API ในแท็บหรือหน้าต่างใหม่
2. ในเนื้อหาคำขอใน API Explorer ให้แทนที่สตริงแต่ละรายการที่ขึ้นต้นด้วย REPLACE_WITH เช่น REPLACE_WITH_OPERATING_ACCOUNT_TYPE ด้วยค่าที่ เกี่ยวข้อง
3. คลิกดำเนินการที่ด้านล่างของหน้าโปรแกรมสำรวจ API และทำตามข้อความแจ้งการให้สิทธิ์เพื่อส่งคำขอ
4. ตั้งค่า validateOnly เป็น true เพื่อตรวจสอบคำขอโดยไม่ใช้การเปลี่ยนแปลง เมื่อพร้อมที่จะใช้การเปลี่ยนแปลงแล้ว ให้ตั้งค่า validateOnly เป็น false

{
    "destinations": [
        {
            "operatingAccount": {
                "accountType": "OPERATING_ACCOUNT_TYPE",
                "accountId": "OPERATING_ACCOUNT_ID"
            },
            "loginAccount": {
                "accountType": "LOGIN_ACCOUNT_TYPE",
                "accountId": "LOGIN_ACCOUNT_ID"
            },
            "productDestinationId": "AUDIENCE_ID"
        }
    ],
    "removeAsOfTime": "2026-07-20T15:01:23Z",
    "validateOnly": true
}

{
    "destinations": [
        {
            "operatingAccount": {
                "accountType": "OPERATING_ACCOUNT_TYPE",
                "accountId": "OPERATING_ACCOUNT_ID"
            },
            "loginAccount": {
                "accountType": "DATA_PARTNER",
                "accountId": "DATA_PARTNER_ACCOUNT_ID"
            },
            "linkedAccount": {
                "accountType": "LINKED_ACCOUNT_TYPE",
                "accountId": "LINKED_ACCOUNT_ID"
            },
            "productDestinationId": "AUDIENCE_ID"
        }
    ],
    "removeAsOfTime": "2026-07-20T15:01:23Z",
    "validateOnly": true
}

ส่งคำขอ

ส่งคำขอไปยังปลายทาง removeAll

หากคำขอสำเร็จ การตอบกลับจะมี requestId ซึ่งคุณใช้ติดตามสถานะของการดำเนินการได้

{
  "requestId": "REQUEST_ID"
}

หากคำขอไม่สำเร็จ ให้ตรวจสอบข้อผิดพลาดเพื่อหาสาเหตุที่ทำให้คำขอไม่สำเร็จ