# راه‌اندازی بنر رضایت

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

## چه چیزی را راه می‌اندازید

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

سه چیز را در این صفحه تنظیم می‌کنید و هر سه در همان دارایی ذخیره می‌شوند:

- **پیکربندی رضایت** — دسته‌ها، حالت پیش‌فرض، عدد بازنگری، مدت اعتبار انتخاب.
- **ظاهر و متن بنر** — چیدمان، تم، عنوان و توضیح و برچسب دکمه‌ها.
- **کنترل بازگشایی** — دکمه‌ای که بازدیدکننده بعدا با آن نظرش را عوض می‌کند.

تنظیمات روی **دارایی** می‌نشیند، نه روی جریان داده. اگر یک دارایی چند جریان دارد، همه یک بنر و یک پیکربندی مشترک می‌گیرند.

## ماژول را روشن کنید

صفحه در فهرست کناری، زیر گروه «پیکربندی»، با نام «رضایت کوکی» است و سه زبانه دارد: «طراحی بنر»، «گزارش رضایت» و «اظهارنامه کوکی». همه کار راه‌اندازی در زبانه اول است.

1. «رضایت کوکی» را باز کنید و مطمئن شوید دارایی درست در انتخابگر بالای صفحه انتخاب شده است.
2. در «دسته‌ها» تصمیم بگیرید هر دسته در پنل ترجیحات پیش‌فرض روشن باشد یا خاموش. «ضروری» قفل است.
3. در «تنظیمات رضایت»، «حالت پیش‌فرض» و «انقضای رضایت (روز)» را بگذارید.
4. در «محتوا و زبان»، «زبان محلی» و متن بنر را بنویسید؛ در «تم» و «چیدمان و رفتار» ظاهرش را بسازید و در «پیش نمایش زنده» نتیجه را ببینید.
5. سوییچ «ماژول» بالای صفحه را روشن کنید و «انتشار» را بزنید.

تا وقتی «انتشار» را نزده‌اید هیچ‌چیز ذخیره نشده و بنر روی سایت شما بالا نمی‌آید — حتی سوییچ «ماژول». بعد از ذخیره، کنار دکمه «ذخیره شد ✓» می‌بینید.

> سازنده بنر رضایت با پیش‌نمایش زنده و انتخاب قالب. — [analytics.adpix.io/fa/cookie-consent](https://analytics.adpix.io/fa/cookie-consent)

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

## دسته‌ها

بنر چهار دسته دارد: «ضروری»، «ترجیحات»، «آماری» و «مارکتینگ». اینکه هر کدام دقیقا چه رفتاری از تراکر را باز می‌کند، در [دسته‌های رضایت](concepts/governance/consent-categories) آمده و پیش از انتخاب حالت، خواندنش می‌ارزد.

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

دکمه «پذیرش همه» مستقل از این سوییچ‌هاست و همه دسته‌های تعریف‌شده را می‌پذیرد؛ «رد همه» فقط «ضروری» را نگه می‌دارد.

> دسته‌های رضایت: ضروری، آماری و بازاریابی. — [analytics.adpix.io/fa/cookie-consent](https://analytics.adpix.io/fa/cookie-consent)

نام و توضیح هر دسته از سازنده قابل ویرایش نیست؛ همان متنی که اینجا می‌بینید، همان است که در پنل ترجیحات به بازدیدکننده نشان داده می‌شود.

## حالت پیش‌فرض: پذیرش یا انصراف

مهم‌ترین انتخاب این صفحه، «حالت پیش‌فرض» در کارت «تنظیمات رضایت» است. دو مقدار دارد:

| مقدار | یعنی | برای کجا |
| --- | --- | --- |
| «پذیرش — اتحادیه اروپا/EEA» | تا وقتی بازدیدکننده انتخاب نکرده، هیچ چیز غیرضروری اجرا نمی‌شود | اتحادیه اروپا و منطقه اقتصادی اروپا |
| «انصراف — سایر نقاط جهان» | تا وقتی بازدیدکننده رد نکرده، همه چیز اجرا می‌شود | بقیه جهان |

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

> **در حالت پذیرش، بخشی از ترافیک شما دیگر شمرده نمی‌شود**
>
> بازدیدکننده‌ای که بدون انتخاب صفحه را می‌بندد، هیچ‌جا ثبت نمی‌شود. این افت واقعی است و در گزارش‌ها دیده می‌شود. پیش از روشن کردن روی سایت پرترافیک، انتظار عددها را با تیم خود تنظیم کنید و روز تغییر را یادداشت کنید تا بعدا افت را با یک خرابی اشتباه نگیرید.

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

## بازنگری — وقتی باید دوباره بپرسید

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

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

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

«انقضای رضایت (روز)» عمر همین انتخاب است و پیش‌فرضش ۱۸۲ روز. بعد از آن کوکی انتخاب منقضی می‌شود و بنر خودبه‌خود دوباره بالا می‌آید.

## ظاهر، متن و زبان

بقیه کارت‌های ستون چپ فقط ظاهر بنر را می‌سازند و همه‌شان بلافاصله در «پیش نمایش زنده» سمت راست دیده می‌شوند. پیش‌نمایش با همان کدی رندر می‌شود که بنر واقعی با آن رندر می‌شود، پس چیزی که اینجا می‌بینید همان چیزی است که بازدیدکننده می‌بیند.

| کارت | چه چیزی را تعیین می‌کند |
| --- | --- |
| «چیدمان و رفتار» | «چیدمان بنر رضایت» (جعبه، ابر، نوار)، «موقعیت» روی صفحه، «وزن دهی دکمه» |
| «تعامل» | «وارونه کردن ترتیب دکمه ها»، «تیره کردن پس زمینه»، «نمایش «Powered by AdPix»» |
| «تم» | «قالب آماده»، «رنگ تاکید برند»، «شعاع گوشه»، «خانواده فونت» |
| «محتوا و زبان» | «زبان محلی» و متن‌ها: «عنوان»، «توضیحات»، «برچسب پذیرش»، «برچسب رد»، «برچسب سفارشی سازی» |

سه نکته که در پیش‌نمایش پیدا نیستند:

- **بنر یک زبان دارد.** «زبان محلی» زبان بنر را انتخاب می‌کند و متن‌هایی که خودتان می‌نویسید برای همه بازدیدکنندگان همان می‌ماند؛ بنر بر اساس زبان مرورگر بین چند نسخه سوییچ نمی‌کند.
- **بنر داخل Shadow DOM بالا می‌آید.** استایل سایت شما به بنر نشت نمی‌کند و برعکس. برای همین اگر با CSS سایتتان سراغ بنر بروید، اثری نمی‌بینید — از فیلد «CSS سفارشی (پیشرفته)» استفاده کنید که همان‌جا تزریق می‌شود و قبل از تزریق پاک‌سازی می‌شود.
- **نشان «Powered by AdPix» قابل خاموش کردن است** با سوییچ «نمایش «Powered by AdPix»» در کارت «تعامل».

## کنترل بازگشایی

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

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

```js
window.__apxConsent.open();   // پنل ترجیحات را باز می‌کند
window.__apxConsent.get();    // انتخاب فعلی و عدد بازنگری آن
```

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

«انتشار» سه چیز را با هم ذخیره می‌کند: وضعیت روشن/خاموش ماژول، حالت و عدد بازنگری، و کل پیکربندی بنر. کنار آن‌ها یک اثرانگشت از همان پیکربندی هم ذخیره می‌شود؛ همین اثرانگشت است که بعدا روی هر سند رضایت می‌نشیند و ثابت می‌کند بازدیدکننده **دقیقا کدام نسخه بنر** را دیده بود.

هر دو پاسخی که بنر و تراکر می‌خوانند با کش ۶۰ ثانیه‌ای سرو می‌شوند. یعنی بعد از انتشار، بازدیدکننده بعدی حداکثر حدود یک دقیقه بعد نسخه تازه را می‌گیرد. لازم نیست چیزی را پاک کنید یا منتظر یک کار شبانه بمانید.

> **اول روی یک دارایی آزمایشی**
>
> بنر را روی یک دارایی یا سایت آزمایشی روشن کنید، در حالت ناشناس مرورگر یک بار «پذیرش همه» و یک بار «رد همه» را بزنید، بعد در زبانه «گزارش رضایت» ببینید دو سند با همان دسته‌ها ثبت شده‌اند. اگر ثبت شدند، مسیر کامل کار می‌کند.

## پیش از روشن کردن روی سایت زنده

- **ماژول خاموش یعنی هیچ تغییری.** تا وقتی روشنش نکرده‌اید، تراکر دقیقا مثل قبل رفتار می‌کند و هیچ دسته‌ای هم روی رویدادها مهر نمی‌شود. این حالت پیش‌فرض هر دارایی تازه است.
- **متن بنر را با تیم حقوقی‌تان تطبیق دهید.** ادپیکس ابزار نشان دادن، گرفتن، اعمال و اثبات رضایت را می‌دهد؛ اینکه کدام دسته برای کدام بازدیدکننده باید پذیرش صریح داشته باشد، تصمیم شماست.
- **اظهارنامه کوکی را چک کنید.** زبانه «اظهارنامه کوکی» فهرست کوکی‌های دارایی را می‌سازد و کوکی‌های خود ادپیکس در آن خودتوصیف‌اند؛ همان را در سیاست حریم خصوصی خود بگذارید.
- **بعد از روشن کردن، افت را با گزارش رضایت بخوانید،** نه با حدس. نرخ پذیرش و رد در [گزارش رضایت و خروجی سوابق](analytics/privacy/consent-log-and-export) آمده است.

جزئیات اینکه هر دسته دقیقا چه چیزی از تراکر را می‌بندد و چه چیزی روی هر رویداد مهر می‌شود، در [اعمال رضایت در تراکر](analytics/privacy/consent-categories-and-gating) است.

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

### برای بنر باید اسکریپت جداگانه‌ای نصب کنم؟

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

### بعد از انتشار، چقدر طول می‌کشد تا تغییر روی سایت دیده شود؟

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

### خاموش کردن سوییچ یک دسته در سازنده، آن دسته را از بنر حذف می‌کند؟

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

### چطور از همه دوباره رضایت بگیرم؟

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

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

- [دسته‌های رضایت](https://docs.adpix.io/fa/concepts/governance/consent-categories/)
- [اعمال رضایت در تراکر](https://docs.adpix.io/fa/analytics/privacy/consent-categories-and-gating/)
- [گزارش رضایت و خروجی سوابق](https://docs.adpix.io/fa/analytics/privacy/consent-log-and-export/)
- [اظهارنامه کوکی](https://docs.adpix.io/fa/analytics/privacy/cookie-declaration/)

---

[مستندات](https://docs.adpix.io/fa/analytics/privacy/consent-cmp-setup/) · AdPix