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 dari daftar.

Menghapus audiens

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

Mengganti semua anggota

Untuk mengganti semua anggota dalam audiens Customer Match sekaligus menghindari daftar pengguna 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 yang 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 anggota yang baru ditambahkan yang tersisa.

Membuat permintaan

Tetapkan kolom berikut di isi RemoveAllAudienceMembersRequest:

destinations
Wajib. Daftar tujuan. Kolom productDestinationId di setiap tujuan menentukan audiens yang anggotanya ingin Anda hapus. 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 ke waktu saat ini secara default.
validateOnly
Opsional. Tetapkan ke true untuk memvalidasi permintaan tanpa menerapkan perubahan. Jika Anda 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. Di isi permintaan di API Explorer, ganti setiap string yang dimulai 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 siap 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
}

Mengirim permintaan

Kirim permintaan ke removeAll endpoint.

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