Bir kitlenin tüm üyelerini kaldırma

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

Bu yöntem, tek bir istekle 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 listedeki tüm mevcut üyeleri temizler.

Tüm üyeleri değiştirme

Boş bir kullanıcı listesi oluşturmadan Müşteri Eşleştirme kitlesindeki tüm üyeleri değiştirmek için aşağıdaki adımları uygulayın:

  1. Mevcut saati T olarak kaydedin.
  2. IngestAudienceMembersRequest göndererek yeni üyeleri yüklemeye başlayın. Gerekirse birden fazla alım isteği gönderebilirsiniz.

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

  4. removeAsOfTime parametresi, 1. adımda kaydedilen T zaman damgasına ayarlanmış 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 üyeler kalı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 saatten önce eklenen üyeler kaldırılır. Biçimlendirme ayrıntıları için Zaman damgası biçimi başlıklı makaleyi inceleyin. Ayarlanmazsa bu değer varsayılan olarak geçerli saat olur.
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 İş 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önderin

İ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