Bir kitlenin tüm üyelerini kaldırma

Bu kılavuzda, RemoveAllAudienceMembersRequest göndererek Müşteri Eşleştirme kitlesinden tüm üyelerin 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. Geçerli saati T olarak kaydeder.
2. IngestAudienceMembersRequest göndererek yeni üyeleri yüklemeye başlayın. Gerekirse birden fazla alım isteğinde bulunabilirsiniz.

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

4. RemoveAllAudienceMembersRequest ile birlikte removeAsOfTime değerini 1. adımda kaydedilen zaman damgası T olarak ayarlayarak gönderin. Bu işlem, 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 zamandan ö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 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 Explorer'ı yeni bir sekmede veya pencerede açmak için Open in API Explorer'ı (API Explorer'da 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.

{
    "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
}

İ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 başarısızlığın nedenini belirlemek için hataları inceleyin.