# مسدودسازی‌ها و ارسال فهرست استثنا

زبانه «مسدودسازی‌ها» فهرست آدرس‌ها و دستگاه‌هایی است که ادپیکس از کمپین‌های پولی شما کنار می‌گذارد، هر کدام با تاریخ انقضای خودش. از همین‌جا دستی مسدود می‌کنید، مسدودسازی را برمی‌دارید و فهرست را به یک وب‌هوک یا به Google Ads می‌فرستید.

مسدودسازی در پلن «پرو» و «ادپیکس ۳۶۰» در دسترس است. در پلن «استارتر» این زبانه صفحه ارتقای پلن را نشان می‌دهد و تشخیص بدون مسدودسازی ادامه دارد.

## مسدودسازی در ادپیکس یعنی چه

هر مسدودسازی یک **مقدار** است — یک آدرس، یک بازه، یک بازه IPv6 یا یک دستگاه — همراه شدت، دلیل‌ها و تاریخ انقضا. در «محافظت در برابر تقلب» (`/integrity`)، زبانه «مسدودسازی‌ها» همه این‌ها را نشان می‌دهد.

مسدودسازی به سایت شما دست نمی‌زند و جلوی هیچ بازدیدی را نمی‌گیرد. سطری است در فهرست استثنایی که ادپیکس برای پلتفرم‌های تبلیغاتی نگه می‌دارد؛ اثرش وقتی شروع می‌شود که این فهرست از راه یک مقصد ارسال یا یک فایل خروجی به پلتفرم برسد.

بالای جدول یک خط هست: «… مسدودسازی فعال · گوگل برای هر کمپین ۵۰۰ مورد را می‌پذیرد». این تعداد فقط مسدودسازی‌های از نوع آدرس را می‌شمارد؛ مسدودسازی دستگاه هیچ‌وقت به گوگل نمی‌رود، چون گوگل فقط آدرس IP استثنا می‌کند.

## چرخه عمر

فیلتر بالای جدول چهار وضعیت دارد:

| وضعیت | یعنی |
| --- | --- |
| «فعال» | اجرا می‌شود و در هر ارسال می‌آید. هر حکم «تاییدشده» تازه روی همان مقدار، انقضا را جلوتر می‌برد |
| «منقضی» | عمرش تمام شده. اگر وب‌سایت روی حالت «مسدودسازی» باشد و همان مقدار دوباره حکم «تاییدشده» بگیرد، دوباره فعال می‌شود |
| «برداشته‌شده» | یک نفر برش داشته. حکم‌های خودکار دیگر آن را برنمی‌گردانند؛ فقط مسدودسازی دستی دوباره فعالش می‌کند |
| «مجاز» | مثل «برداشته‌شده»، تصمیم یک انسان است و حکم‌های خودکار دوباره فعالش نمی‌کنند |

ادپیکس هر ساعت مسدودسازی‌هایی را که تاریخشان گذشته به «منقضی» می‌برد. عمر هر مسدودسازی تازه از «انقضای مسدودسازی (روز)» در [تنظیمات محافظت](analytics/fraud/protection-settings) می‌آید.

## ستون‌های جدول

| ستون | چه چیزی نشان می‌دهد |
| --- | --- |
| «مقدار» | خود آدرس، بازه یا شناسه دستگاه |
| «نوع» | یکی از چهار نوع بخش بعد |
| «شدت» | رده حکمی که مسدودسازی را ساخت |
| «دلایل» | حداکثر دو برچسب دلیل؛ مسدودسازی دستی دلیل تشخیص ندارد |
| «دفعات» | چند بار حکم‌های خودکار به این مقدار خورده‌اند. تقریبی است: هر مقدار حداکثر دقیقه‌ای یک بار شمرده می‌شود |
| «آخرین مشاهده» | آخرین روزی که حکمی به این مقدار خورد |
| «انقضا» | برای مسدودسازی فعال «… روز مانده»، برای بقیه تاریخ |
| «ایجادکننده» | «بلادرنگ»، «شبانه» یا «دستی» |

دکمه «برداشتن» فقط روی سطرهای «فعال» است.

## چه کسی مسدودسازی می‌سازد

| «ایجادکننده» | کِی |
| --- | --- |
| «بلادرنگ» | حکم «تاییدشده» در لحظه ورود، یا به‌روزرسانی از سیگنال‌های مرورگر — فقط در حالت «مسدودسازی» |
| «شبانه» | حکم «تاییدشده» در تحلیل شبانه — فقط در حالت «مسدودسازی» |
| «دستی» | شما، از فرم همین زبانه یا دکمه «مسدود کردن این آدرس» در کشوی شواهد کلیک |

و چهار نوع مقدار:

| «نوع» | چه چیزی را کنار می‌گذارد |
| --- | --- |
| «آدرس IP» | یک آدرس |
| «بازه IP (a.b.c.*)» | یک بازه `/24`، یعنی ۲۵۶ آدرس. این نوع را فقط خودتان می‌سازید |
| «IPv6 /64» | بازه IPv6 یک مشترک؛ آدرس‌های حریم خصوصی IPv6 داخل همین بازه عوض می‌شوند |
| «دستگاه» | اثرانگشت یک دستگاه. به گوگل نمی‌رود؛ فقط به وب‌هوک |

مسدودسازی‌های خودکار آدرس IPv4 را به‌صورت «آدرس IP» و آدرس IPv6 را به‌صورت «IPv6 /64» می‌سازند، و دستگاه را فقط وقتی حکم درباره خود دستگاه است. آدرس‌های اشتراکی موبایل و اپراتور هیچ‌وقت خودکار مسدود نمی‌شوند.

## مسدودسازی دستی

کارت «مسدود کردن آدرس یا دستگاه» سه فیلد دارد:

1. «نوع» را انتخاب کنید.
2. «مقدار» را وارد کنید: یک آدرس مثل `203.0.113.9`، یک بازه مثل `203.0.113.*`، یک پیشوند IPv6 مثل `2001:db8:1:2::`، یا شناسه دستگاه.
3. در «دلیل» بنویسید چرا، و «افزودن مسدودسازی» را بزنید.

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

> **فرم، آدرس‌های اپراتوری را نمی‌شناسد**
>
> دکمه «مسدود کردن این آدرس» در کشوی شواهد کلیک، برای آدرس‌های اپراتور موبایل و اشتراکی اصلا نمایش داده نمی‌شود. فرم دستی این محافظت را ندارد و هر آدرس معتبری را می‌پذیرد. پیش از مسدود کردن دستی یک آدرس یا یک بازه `/24`، در کشوی شواهد یکی از کلیک‌هایش نوع شبکه را ببینید؛ پشت یک آدرس اپراتور، مشتری‌های واقعی زیادی هستند.

## برداشتن مسدودسازی

«برداشتن» مسدودسازی را به «برداشته‌شده» می‌برد. از آن لحظه:

- در هیچ ارسال بعدی نمی‌آید، و ارسال بعدی آن را در فهرست `remove` می‌گذارد تا مقصد Google Ads استثنای مربوط را پاک کند؛
- حکم‌های خودکار دیگر آن را برنمی‌گردانند، حتی اگر همان آدرس دوباره حکم «تاییدشده» بگیرد؛
- تنها راه برگرداندنش یک مسدودسازی دستی است.

اگر مسدودسازی را برمی‌دارید چون حکم غلط بود، همان آدرس یا دستگاه را به فهرست مجاز هم اضافه کنید تا کلیک‌های بعدی‌اش هم «پاک» ثبت شوند.

## سقف ۵۰۰ گوگل و ترتیب فهرست

Google Ads برای هر کمپین حداکثر ۵۰۰ استثنای IP می‌پذیرد. ادپیکس فهرست را این‌طور مرتب می‌کند: اول شدیدترین، بعد تازه‌ترین «آخرین مشاهده»، بعد بیشترین «دفعات». وقتی آدرس‌ها از ۵۰۰ بیشتر شوند، خطی مثل «… مورد بیش از سقف گوگل: خروجی‌ها شدیدترین و تازه‌ترین‌ها را نگه می‌دارند.» ظاهر می‌شود. اضافه‌ها بی‌صدا حذف نمی‌شوند؛ تعدادشان گزارش می‌شود.

فهرستی که ارسال می‌شود از سه منبع ساخته می‌شود:

- مسدودسازی‌های «فعال» همین جدول؛
- آدرس کلیک‌های پولی «تاییدشده» در ۳۰ روز گذشته — هرگز آدرس اپراتوری؛
- بازه‌های `/24` که ترافیک شبکه‌های «تاییدشده» از آن‌ها آمده، فقط وقتی شبکه دیتاسنتر، VPN، پراکسی یا Tor است یا در فهرست متقلب‌های شناخته‌شده — هرگز شبکه خانگی یا موبایل.

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

وب‌هوک سقف ندارد و همه آدرس‌ها را می‌گیرد. در Google Ads، استثناهایی که خودتان دستی گذاشته‌اید هم از ۵۰۰ جای هر کمپین سهم می‌برند؛ وقتی کمپین پر باشد، آدرس‌های رده پایین‌تر تا خالی شدن جا منتظر می‌مانند.

## مقصدهای ارسال

کارت «مقصدهای ارسال» جایی است که «ارسال اکنون» و ارسال خودکار فهرست را می‌فرستند. بالای کارت، جدول مقصدهای فعلی با ستون‌های «نام» و «نوع» و دکمه «حذف» است؛ زیرش فرم افزودن.

### وب‌هوک

برای n8n، یک فایروال یا هر نقطه HTTP دیگر:

1. «نوع» را روی «وب‌هوک (n8n، فایروال، هر نقطه HTTP)» بگذارید.
2. «نام» و «آدرس وب‌هوک» را وارد کنید و «افزودن مقصد» را بزنید.
3. متنی که بعد از «کلید مشترک، فقط یک بار نمایش داده می‌شود؛ گیرنده آن را در هدر X-Sovereign-Secret بررسی می‌کند:» می‌آید را همان لحظه کپی کنید.

هر ارسال یک درخواست `POST` با بدنه JSON است و این کلید در سرآیند `X-Sovereign-Secret` همراهش می‌رود. گیرنده باید مقدار سرآیند را با کلید مقایسه کند و هر درخواست دیگری را رد کند. کلید دوباره نمایش داده نمی‌شود؛ اگر گمش کردید، مقصد را حذف کنید و دوباره بسازید تا کلید تازه‌ای بگیرید.

بدنه درخواست این شکل را دارد:

```json
{
  "op": "sync_ip_exclusions",
  "add": ["203.0.113.9", "198.51.100.*", "2001:db8:1:2::/64"],
  "remove": ["192.0.2.44"],
  "property_id": "…",
  "blocks": [
    {
      "block_id": "…",
      "identifier_type": "ip",
      "value": "203.0.113.9",
      "severity": "confirmed",
      "reason_codes": ["ip_velocity_10m", "ip_datacenter"],
      "hits": 14,
      "first_seen": "…",
      "last_seen": "…",
      "expires_at": "…",
      "source": "realtime",
      "status": "active"
    }
  ]
}
```

| فیلد | یعنی |
| --- | --- |
| `add` | همه آدرس‌های فهرست، به ترتیب اولویت و بدون سقف ۵۰۰. بازه `/24` به شکل `a.b.c.*` و بازه IPv6 با پسوند `/64` |
| `remove` | مقدارهایی که آخرین بار به همین مقصد فرستاده شدند و دیگر در فهرست نیستند — منقضی، برداشته یا مجازشده |
| `blocks` | سطرهای کامل، همراه مسدودسازی‌های دستگاه و کد دلیل‌ها؛ `source` برای سطرهایی که از کلیک‌ها یا شبکه‌ها آمده‌اند `ledger` یا `network` است |

کدهای `reason_codes` همان کدهای پایداری‌اند که برچسب‌های «دلایل» از آن‌ها ساخته می‌شوند.

### حذف IP در Google Ads

«نوع» را روی «حذف IP در Google Ads» بگذارید و این فیلدها را پر کنید:

| فیلد | چه چیزی |
| --- | --- |
| «شناسه مشتری Google Ads» | شناسه حساب تبلیغاتی، مثل `123-456-7890` |
| «شناسه حساب مدیر (اختیاری)» | وقتی دسترسی از راه یک حساب مدیر (MCC) است |
| «توکن بازآوری OAuth» | توکنی که صاحب حساب برای دسترسی داده |
| «شناسه کمپین‌ها (با ویرگول جدا کنید)» | کمپین‌هایی که ادپیکس استثناهای IP آن‌ها را نگه می‌دارد |

برای هر کمپینی که نام برده‌اید، ادپیکس آدرس‌های تازه فهرست را اضافه می‌کند و **فقط** استثناهایی را برمی‌دارد که خودش پیش‌تر اضافه کرده و دیگر در فهرست نیستند. استثناهایی که خودتان دستی گذاشته‌اید هیچ‌وقت دست نمی‌خورند. فقط آدرس‌ها به گوگل می‌روند؛ دستگاه‌ها نه.

کمپین‌های Search، Display، Shopping و Demand Gen استثنای IP می‌پذیرند. کمپین‌های Performance Max، ویدیو و اپ، و هر نوع دیگری که استثنای IP نمی‌پذیرد، بدون خطا رد می‌شوند و بقیه کمپین‌های همان مقصد مثل همیشه به‌روز می‌شوند.

> **پیش از اولین ارسال به گوگل**
>
> ارسال به Google Ads به دسترسی Google Ads API نیاز دارد که باید روی پلتفرم ادپیکس فعال شده باشد. تا وقتی فعال نشده، ارسال به این مقصد به نتیجه نمی‌رسد و دلیلش در ستون «آخرین خطا» می‌آید. در این فاصله فایل «حذف IP در Google Ads» را از زبانه «شواهد» بردارید و دستی وارد کنید — [مسدود کردن شبکه‌ها و مدارک بازپرداخت](analytics/fraud/blocklist-and-refund-evidence).
>
> این مقصد برای وب‌سایت‌های ایرانی در دسترس نیست: اگر ارز وب‌سایت ریال یا تومان باشد یا منطقه زمانی‌اش تهران، ادپیکس آن را نمی‌پذیرد، چون گوگل به تبلیغ‌دهنده‌های ایرانی سرویس نمی‌دهد. این وب‌سایت‌ها از وب‌هوک و فایل‌های زبانه «شواهد» استفاده می‌کنند.

## «ارسال اکنون» و جدول «ارسال‌ها»

دکمه «ارسال اکنون» روی کارت «ارسال‌ها» فهرست فعلی را برای ارسال به همه مقصدهای فعال وب‌سایت در صف می‌گذارد و پیام «ارسال در صف قرار گرفت.» را نشان می‌دهد. اگر وب‌سایت هیچ مقصد ارسالی نداشته باشد، به‌جای آن خطایی می‌گیرید که همین را می‌گوید. ارسال خودکار، شرط‌هایش و اینکه فقط در حالت «مسدودسازی» کار می‌کند در [تنظیمات محافظت](analytics/fraud/protection-settings) آمده.

جدول زیر دکمه ۵۰ ارسال آخر را نشان می‌دهد، با ستون‌های «زمان»، «پلتفرم»، «آدرس‌های ارسال‌شده»، «وضعیت» و «آخرین خطا». وضعیت، زنده از صف تحویل خوانده می‌شود:

| «وضعیت» | یعنی |
| --- | --- |
| «در صف» / «در انتظار» | ثبت شده و منتظر نوبت ارسال است |
| «در حال ارسال» | همین حالا در حال تحویل است |
| «تحویل شد» | مقصد آن را پذیرفت |
| «ناموفق» | آخرین تلاش شکست خورد و دوباره تلاش می‌شود؛ دلیلش در «آخرین خطا» است |
| «متوقف شد» | تلاش‌ها تمام شد و این ارسال دیگر فرستاده نمی‌شود. خطا را برطرف کنید و دوباره «ارسال اکنون» بزنید |

## پرسش‌های پرتکرار

### چرا تعداد «آدرس‌های ارسال‌شده» با تعداد مسدودسازی‌های جدول فرق دارد؟

چون فهرست ارسالی فقط سطرهای جدول نیست. آدرس کلیک‌های پولی «تاییدشده» در ۳۰ روز گذشته و بازه‌های `/24` شبکه‌های «تاییدشده» از نوع دیتاسنتر، VPN، پراکسی، Tor یا متقلب شناخته‌شده هم به آن اضافه می‌شوند. از طرف دیگر مسدودسازی‌های دستگاه هیچ‌وقت به گوگل نمی‌روند و گوگل حداکثر ۵۰۰ آدرس می‌گیرد.

### اگر مسدودسازی را بردارم، از Google Ads هم حذف می‌شود؟

بله، در ارسال بعدی. آن مقدار در فهرست `remove` می‌رود و مقصد Google Ads استثنایی را که خود ادپیکس اضافه کرده بود پاک می‌کند. حکم‌های خودکار هم دیگر آن را برنمی‌گردانند.

### آیا ادپیکس استثناهایی را که خودم در Google Ads گذاشته‌ام پاک می‌کند؟

نه. فقط مواردی را برمی‌دارد که خودش اضافه کرده. ولی استثناهای دستی شما هم از سقف ۵۰۰ مورد هر کمپین سهم می‌برند؛ وقتی کمپین پر باشد، آدرس‌های رده پایین‌تر منتظر جای خالی می‌مانند.

### چرا نمی‌توانم مقصد Google Ads اضافه کنم؟

اگر ارز وب‌سایت ریال یا تومان است یا منطقه زمانی‌اش تهران، ادپیکس این مقصد را نمی‌پذیرد، چون گوگل به تبلیغ‌دهنده‌های ایرانی سرویس نمی‌دهد. برای این وب‌سایت‌ها از وب‌هوک و فایل‌های زبانه «شواهد» استفاده کنید.

## مطالب مرتبط

- [تنظیمات محافظت: حالت، الگوی صنعت و آستانه‌ها](https://docs.adpix.io/fa/analytics/fraud/protection-settings/)
- [کلیک‌های پولی و شواهد هر کلیک](https://docs.adpix.io/fa/analytics/fraud/paid-click-log/)
- [شواهد، فهرست‌های حذف و مدارک بازپرداخت](https://docs.adpix.io/fa/analytics/fraud/blocklist-and-refund-evidence/)
- [بودجه تبلیغاتی هدررفته — این عدد دقیقا چیست](https://docs.adpix.io/fa/analytics/fraud/money-wasted/)

---

[مستندات](https://docs.adpix.io/fa/analytics/fraud/blocks-and-exclusions/) · AdPix