برداشتن همه اعضای مخاطب

این راهنما توضیح می‌دهد که چگونه با ارسال RemoveAllAudienceMembersRequest، همه اعضای مخاطب «مطابقت مشتری» را بردارید.

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

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

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

جایگزین کردن همه اعضا

برای جایگزین کردن همه اعضای مخاطب «انطباق مشتری» و درعین‌حال جلوگیری از فهرست کاربر خالی، این مراحل را دنبال کنید:

1. زمان فعلی را به‌عنوان T ضبط کنید.
2. با ارسال IngestAudienceMembersRequest، بارگذاری اعضای جدید را شروع کنید. درصورت نیاز می‌توانید چندین درخواست انتقال داده ایجاد کنید.

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

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

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

ساختن درخواست

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

destinations

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

removeAsOfTime

‫

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

validateOnly

‫

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

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

در اینجا یک درخواست نمونه آورده شده است که همه اعضا را از فهرست «تطابق مشتری» برمی‌دارد.

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

آگهی‌دهنده

باز کردن در 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
}

شریک داده

باز کردن در 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
}

ارسال درخواست

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

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

{
  "requestId": "REQUEST_ID"
}

اگر درخواست ناموفق بود، خطاها را بازرسی کنید تا علت ناموفق بودن را تعیین کنید.