Menghapus semua anggota dari audiens

Panduan ini menjelaskan cara menghapus semua anggota dari audiens Customer Match dengan mengirimkan RemoveAllAudienceMembersRequest.

Metode ini berguna jika Anda perlu menghapus daftar pengguna dengan satu permintaan atau mengganti semua anggota audiens dalam daftar.

Menghapus audiens

Untuk menghapus semua anggota dari audiens, kirim RemoveAllAudienceMembersRequest dan hapus kolom removeAsOfTime. Tindakan ini akan menetapkan waktu penghapusan secara default ke waktu saat ini, sehingga menghapus semua anggota saat ini dari daftar.

Mengganti semua anggota

Untuk mengganti semua anggota di audiens Customer Match sekaligus menghindari daftar pengguna yang kosong, ikuti langkah-langkah berikut:

1. Catat waktu saat ini sebagai T.
2. Mulai upload anggota baru dengan mengirimkan IngestAudienceMembersRequest. Anda dapat membuat beberapa permintaan penyerapan jika diperlukan.

3. Tunggu hingga semua permintaan penyerapan selesai diproses. Anda dapat memeriksa status permintaan menggunakan Diagnostik.

4. Kirim RemoveAllAudienceMembersRequest dengan removeAsOfTime ditetapkan ke stempel waktu T yang dicatat di Langkah #1. Tindakan ini hanya akan menghapus anggota yang ditambahkan sebelum Anda mulai mengupload anggota baru, sehingga hanya menyisakan anggota yang baru ditambahkan.

Membuat permintaan

Tetapkan kolom berikut dalam isi RemoveAllAudienceMembersRequest:

destinations

Wajib. Daftar tujuan. Kolom productDestinationId di setiap tujuan menentukan audiens yang ingin Anda hapus anggotanya. Lihat Mengonfigurasi tujuan untuk mengetahui informasi selengkapnya.

removeAsOfTime

Opsional. Hanya anggota yang ditambahkan sebelum waktu ini yang akan dihapus. Untuk mengetahui detail pemformatan, lihat Format stempel waktu. Jika tidak ditetapkan, nilai ini akan ditetapkan secara default ke waktu saat ini.

validateOnly

Opsional. Tetapkan ke true untuk memvalidasi permintaan tanpa menerapkan perubahan. Jika Anda sudah siap menerapkan perubahan, tetapkan ke false.

Permintaan contoh

Berikut adalah contoh permintaan yang menghapus semua anggota dari daftar Customer Match.

1. Klik Open in API Explorer untuk membuka API Explorer di tab atau jendela baru.
2. Dalam isi permintaan di API Explorer, ganti setiap string yang diawali dengan REPLACE_WITH, seperti REPLACE_WITH_OPERATING_ACCOUNT_TYPE, dengan nilai yang relevan.
3. Klik Execute di bagian bawah halaman API Explorer dan selesaikan perintah otorisasi untuk mengirim permintaan.
4. Tetapkan validateOnly ke true untuk memvalidasi permintaan tanpa menerapkan perubahan. Jika Anda sudah siap untuk menerapkan perubahan, tetapkan validateOnly ke 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
}

Kirim permintaan

Kirim permintaan ke endpoint removeAll.

Jika permintaan berhasil, respons akan berisi requestId yang dapat Anda gunakan untuk melacak status operasi.

{
  "requestId": "REQUEST_ID"
}

Jika permintaan gagal, periksa error untuk menentukan penyebab kegagalan.