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

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

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

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

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

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

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

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

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

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

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

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

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

destinations

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

removeAsOfTime

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

validateOnly

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

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

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

1. روی باز کردن در API Explorer کلیک کنید تا API Explorer در برگه یا پنجره جدیدی باز شود.
2. در بدنه درخواست در API Explorer، هر رشته‌ای را که با 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"
}

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