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

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

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

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

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

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

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

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

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

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

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

สร้างคำขอ

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

destinations

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

removeAsOfTime

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

validateOnly

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

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

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

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

ผู้ลงโฆษณา

เปิดในโปรแกรมสำรวจ API

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

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

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