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.

Hapus audiens

Untuk menghapus semua anggota dari audiens, kirim RemoveAllAudienceMembersRequest dan hilangkan kolom removeAsOfTime. Tindakan ini akan menetapkan waktu penghapusan ke waktu saat ini, 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. Merekam waktu saat ini sebagai T.
  2. Mulai mengupload anggota baru dengan mengirim 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 yang ditetapkan ke stempel waktu T yang dicatat di Langkah #1. Tindakan ini hanya menghapus anggota yang ditambahkan sebelum Anda mulai mengupload anggota baru, sehingga hanya menyisakan anggota yang baru ditambahkan.

Buat permintaan

Tetapkan kolom berikut di 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 secara default adalah waktu saat ini.
validateOnly
Opsional. Setel ke true untuk memvalidasi permintaan tanpa menerapkan perubahan. Jika Anda sudah siap untuk 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. Di 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.

Pengiklan

Buka di 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
}

Partner Data

Buka di 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
}

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.

Sebelumnya
Periksa hasil upload