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

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

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

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

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

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

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

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

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

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

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

สร้างคำขอ

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

destinations

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

removeAsOfTime

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

validateOnly

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

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

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

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

ผู้ลงโฆษณา

เปิดใน API Explorer

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

พาร์ทเนอร์ด้านข้อมูล

เปิดใน API Explorer

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

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