حذف همه اعضا از یک مخاطب

این راهنما نحوه حذف همه اعضا از مخاطبان Customer Match را با ارسال درخواست RemoveAllAudienceMembersRequest توضیح می‌دهد.

این روش در صورتی مفید است که نیاز به پاک کردن لیست کاربران با یک درخواست واحد یا جایگزینی تمام اعضای مخاطب یک لیست داشته باشید.

مخاطب را پاک کنید

برای حذف همه اعضا از یک مخاطب، یک RemoveAllAudienceMembersRequest ارسال کنید و فیلد removeAsOfTime را حذف کنید. این کار زمان حذف را به صورت پیش‌فرض روی زمان فعلی قرار می‌دهد و همه اعضای فعلی را از لیست پاک می‌کند.

جایگزینی همه اعضا

برای جایگزینی همه اعضا در مخاطبان Customer Match و در عین حال جلوگیری از خالی شدن لیست کاربران، این مراحل را دنبال کنید:

1. زمان فعلی را به عنوان T ثبت کنید.
2. با ارسال یک IngestAudienceMembersRequest ، آپلود اعضای جدید را آغاز کنید. در صورت نیاز می‌توانید چندین درخواست ingest ارسال کنید.

3. صبر کنید تا پردازش تمام درخواست‌های مصرف تمام شود. می‌توانید وضعیت درخواست‌های خود را با استفاده از Diagnostics بررسی کنید.

   توجه: اگر خالی بودن موقت لیست کاربران نگران‌کننده نیست، می‌توانید از این مرحله صرف‌نظر کنید و به مرحله ۴ بروید. ما همچنان توصیه می‌کنیم وضعیت درخواست‌های مصرف خود را بررسی کنید تا از پردازش موفقیت‌آمیز آنها اطمینان حاصل کنید.

4. یک RemoveAllAudienceMembersRequest با تنظیم removeAsOfTime روی برچسب زمانی T که در مرحله ۱ ثبت شده است، ارسال کنید. این کار فقط اعضایی را که قبل از شروع آپلود اعضای جدید اضافه شده‌اند، حذف می‌کند و فقط اعضای تازه اضافه شده را باقی می‌گذارد.

ساخت درخواست

فیلدهای زیر را در بدنه‌ی RemoveAllAudienceMembersRequest تنظیم کنید:

destinations

الزامی . فهرست مقصدها. فیلد productDestinationId در هر مقصد، مخاطبی را که می‌خواهید اعضا را از آن حذف کنید، مشخص می‌کند. برای اطلاعات بیشتر به پیکربندی مقصدها مراجعه کنید.

removeAsOfTime

اختیاری. فقط اعضایی که قبل از این زمان اضافه شده‌اند حذف می‌شوند. برای جزئیات قالب‌بندی، به قالب مهر زمان مراجعه کنید. اگر تنظیم نشده باشد، این مقدار به طور پیش‌فرض زمان فعلی را در نظر می‌گیرد.

validateOnly

اختیاری. برای اعتبارسنجی درخواست بدون اعمال تغییرات، آن را روی true تنظیم کنید. وقتی آماده اعمال تغییرات شدید، آن را روی false تنظیم کنید.

نمونه درخواست‌ها

در اینجا یک نمونه درخواست وجود دارد که همه اعضا را از لیست Customer Match حذف می‌کند.

1. برای باز کردن API Explorer در یک تب یا پنجره جدید، روی Open in API Explorer کلیک کنید.
2. در بدنه درخواست در API Explorer، هر رشته‌ای که با REPLACE_WITH شروع می‌شود، مانند REPLACE_WITH_OPERATING_ACCOUNT_TYPE را با مقدار مربوطه جایگزین کنید.
3. روی Execute در پایین صفحه API Explorer کلیک کنید و مراحل احراز هویت را برای ارسال درخواست تکمیل کنید.
4. برای اعتبارسنجی درخواست بدون اعمال تغییرات، validateOnly را روی true تنظیم کنید. وقتی آماده اعمال تغییرات شدید، validateOnly را روی false تنظیم کنید.

تبلیغ کننده

باز کردن در کاوشگر API

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

شریک داده

باز کردن در کاوشگر API

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

درخواست را ارسال کنید

درخواست را به نقطه پایانی removeAll ارسال کنید.

اگر درخواست با موفقیت انجام شود، پاسخ شامل یک requestId است که می‌توانید از آن برای پیگیری وضعیت عملیات استفاده کنید.

{
  "requestId": "REQUEST_ID"
}

اگر درخواست با شکست مواجه شد، خطاها را بررسی کنید تا علت شکست را مشخص کنید.