Bir kitlenin tüm üyelerini kaldırma

Bu kılavuzda, RemoveAllAudienceMembersRequest göndererek Müşteri Eşleştirme kitlesindeki tüm üyelerin nasıl kaldırılacağı açıklanmaktadır.

Bu yöntem, tek bir istekle bir kullanıcı listesini temizlemeniz veya bir listenin tüm kitle üyelerini değiştirmeniz gerektiğinde kullanışlıdır.

Kitleyi temizleme

Bir kitledeki tüm üyeleri kaldırmak için RemoveAllAudienceMembersRequest gönderin ve removeAsOfTime alanını atlayın. Bu işlem, kaldırma zamanını varsayılan olarak geçerli zamana ayarlar ve mevcut tüm üyeleri listeden kaldırır.

Tüm üyeleri değiştirme

Kullanıcı listesinin boş kalmasını önleyerek bir Müşteri Eşleştirme kitlesindeki tüm üyeleri değiştirmek için aşağıdaki adımları uygulayın:

  1. Geçerli zamanı T olarak kaydedin.
  2. IngestAudienceMembersRequest göndererek yeni üyeleri yüklemeye başlayın. Gerekirse birden fazla besleme isteği gönderebilirsiniz.

  3. Tüm besleme isteklerinin işlenmesi tamamlanana kadar bekleyin. Teşhis'i kullanarak isteklerinizin durumunu kontrol edebilirsiniz.

  4. removeAsOfTime, 1. adımda kaydedilen T zaman damgasına ayarlanmış şekilde bir RemoveAllAudienceMembersRequest gönderin. Bu işlem, yalnızca yeni üyeleri yüklemeye başlamadan önce eklenen üyeleri kaldırır ve yalnızca yeni eklenen üyeleri bırakır.

İsteği oluşturma

RemoveAllAudienceMembersRequest gövdesinde aşağıdaki alanları ayarlayın:

destinations
Zorunlu. Hedeflerin listesi. Her hedefteki productDestinationId alanı, üyelerini kaldırmak istediğiniz kitleyi belirtir. Daha fazla bilgi için Hedefleri yapılandırma başlıklı makaleyi inceleyin.
removeAsOfTime
İsteğe bağlı. Yalnızca bu süreden önce eklenen üyeler kaldırılır. Biçimlendirme ayrıntıları için Zaman damgası biçimi bölümüne bakın. Ayarlanmazsa bu değer varsayılan olarak geçerli saate ayarlanır.
validateOnly
İsteğe bağlı. Değişiklikleri uygulamadan isteği doğrulamak için true olarak ayarlayın. Değişiklikleri uygulamaya hazır olduğunuzda false olarak ayarlayın.

Örnek istekler

Aşağıda, tüm üyeleri bir Müşteri Eşleştirme listesinden kaldıran örnek bir istek verilmiştir.

  1. API Gezgini'ni yeni bir sekmede veya pencerede açmak için API Gezgini'nde aç'ı tıklayın.
  2. API Gezgini'ndeki istek gövdesinde, REPLACE_WITH ile başlayan her dizeyi (ör. REPLACE_WITH_OPERATING_ACCOUNT_TYPE) ilgili değerle değiştirin.
  3. API Gezgini sayfasının alt kısmındaki Execute'u (Yürüt) tıklayın ve isteği göndermek için yetkilendirme istemlerini tamamlayın.
  4. Değişiklikleri uygulamadan isteği doğrulamak için validateOnly değerini true olarak ayarlayın. Değişiklikleri uygulamaya hazır olduğunuzda validateOnly değerini false olarak ayarlayın.

Reklamveren

API Gezgini'nde aç 
{
    "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
}

Veri iş ortağı

API Gezgini'nde aç 
{
    "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
}

İsteği gönder

İsteği removeAll uç noktasına gönderin.

İstek başarılı olursa yanıt, işlemin durumunu izlemek için kullanabileceğiniz bir requestId içerir.

{
  "requestId": "REQUEST_ID"
}

İstek başarısız olursa hatanın nedenini belirlemek için hataları inceleyin.

Önceki
Yükleme sonuçlarını kontrol etme