# گزارش رضایت و خروجی سوابق

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

## سند رضایت، همان مدرک است

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

هر سند این‌ها را نگه می‌دارد:

| چه چیزی | برای چه |
| --- | --- |
| زمان و شناسه رضایت | کی، و کدام تصمیم |
| اقدام | «اولین رضایت»، «به روزرسانی» یا «پس گرفتن» |
| دسته‌های پذیرفته و رد شده | خودِ تصمیم، هر دو سمتش |
| حالت | کدام پیش‌فرض در آن لحظه حاکم بوده — پذیرش یا انصراف |
| بازنگری و اثرانگشت پیکربندی | اثبات اینکه دقیقا **کدام نسخه بنر** را دیده بود |
| زبان محلی | متن بنری که به او نشان داده شد |
| شناسه ناشناس | برای وصل کردن سند به رفتار همان مرورگر |
| هش آدرس IP و عامل کاربر مرورگر | زمینه فنی، بدون نگه‌داری خود آدرس |

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

## کی یک سند ساخته می‌شود

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

نوع اقدام از خود تصمیم استنتاج می‌شود:

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

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

> **ثبت روی شناسه رضایت idempotent است**
>
> اگر مرورگر همان درخواست را دوباره بفرستد — شبکه ضعیف، تلاش دوباره — ردیف تکراری ساخته نمی‌شود؛ ثبت دوم بی‌اثر است. و اگر نوشتن سند اصلا شکست بخورد، باز هم چیزی به صفحه سایت برنمی‌گردد: انتخاب بازدیدکننده روی مرورگر خودش نوشته شده و از همان لحظه معتبر است.

## IP هرگز خام ذخیره نمی‌شود

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

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

## زبانه «گزارش رضایت»

زبانه دوم صفحه سه بخش دارد و هر سه از بازه تاریخ بالای صفحه پیروی می‌کنند.

**چهار سنجه بالا.** این‌ها روی سوابق حساب می‌شوند، نه روی بازدیدها — و همین را باید موقع خواندنشان در ذهن داشته باشید:

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

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

**فهرست سوابق.** ستون‌هایش «زمان»، «اقدام»، «دسته‌های پذیرفته شده»، «حالت»، «نسخه»، «زبان» و «شناسه رضایت» است. سه فیلتر بالای فهرست دارید — «همه اقدامات»، «همه حالت‌ها» و «جستجوی شناسه رضایت / شناسه ناشناس» — و فهرست ۲۵تایی ورق می‌خورد. ورق زدن با نشانگر انجام می‌شود نه با شماره صفحه، پس روی دارایی‌ای با میلیون‌ها سند هم صفحه آخر به‌اندازه صفحه اول سریع است. در عوض، پرش مستقیم به صفحه دلخواه ندارید؛ فقط «← قبلی» و «بعدی →».

## خروجی CSV و JSON

پایین همان کارت، دو دکمه هست: «خروجی CSV» و «خروجی JSON». هر دو یک مجموعه ردیف را می‌دهند، فقط قالبشان فرق می‌کند.

ستون‌های CSV دقیقا این نه‌تاست و به همین ترتیب:

| ستون | مقدار |
| --- | --- |
| `consent_id` | شناسه رضایت |
| `consent_at` | زمان تصمیم، قالب RFC3339 |
| `action` | `first_consent` یا `update` یا `withdraw` |
| `accepted` | دسته‌های پذیرفته‌شده، جدا شده با فاصله |
| `rejected` | دسته‌های رد شده، جدا شده با فاصله |
| `mode` | `opt_in` یا `opt_out` |
| `revision` | عدد بازنگری لحظه تصمیم |
| `config_version` | اثرانگشت پیکربندی‌ای که بازدیدکننده دید |
| `locale` | زبان بنر |

سه چیز را پیش از تکیه کردن به این فایل بدانید:

- **خروجی از بازه تاریخ و فیلترهای صفحه پیروی نمی‌کند.** همیشه تازه‌ترین ۵۰٬۰۰۰ سند همان دارایی را می‌دهد، از جدید به قدیم. اگر دارایی شما بیشتر از این دارد، فایل بریده می‌شود بدون اینکه هشداری بدهد.
- **هش IP، عامل کاربر و شناسه ناشناس در خروجی نیستند.** آن‌ها ذخیره می‌مانند ولی از این مسیر بیرون نمی‌آیند.
- **خروجی برای هر دارایی جداست.** برای چند دارایی، چند بار بگیرید.

> **یک نسخه دوره‌ای بگیرید**
>
> سندها با ترتیب زمانی می‌آیند و سقف ۵۰٬۰۰۰تایی دارند، پس روی دارایی پرترافیک، خروجی امروز شامل سندهای سال گذشته نیست. اگر نگه‌داری بلندمدت مدرک برایتان مهم است، در فاصله‌های منظم — مثلا ماهانه — خروجی بگیرید و همان‌جا که بقیه مدارک انطباق را نگه می‌دارید بایگانی کنید.

## چه کسی می‌بیند

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

## این گزارش چه چیزی نیست

سند رضایت اثبات یک تصمیم است، نه ابزار اجرای آن و نه سیاهه داده‌های کاربر.

- **پس گرفتن رضایت، داده قبلی را پاک نمی‌کند.** جمع‌آوری از همان لحظه می‌ایستد و کوکی‌های آن دسته پاک می‌شوند؛ رویدادهای پیشین سر جایشان می‌مانند. حذف داده مسیر خودش را دارد، در [نگهداری و حذف داده](concepts/governance/data-retention-and-deletion).
- **این گزارش نمی‌گوید یک رویداد با چه رضایتی جمع شده.** آن اطلاعات روی خود ردیف رویداد مهر می‌شود؛ در [اعمال رضایت در تراکر](analytics/privacy/consent-categories-and-gating) توضیح داده شده.
- **فهرست کوکی‌هایی که سایتتان می‌گذارد** جای دیگری است: زبانه «اظهارنامه کوکی»، در [اظهارنامه کوکی](analytics/privacy/cookie-declaration).

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

### آدرس IP بازدیدکننده ذخیره می‌شود؟

نه به‌صورت خام. فقط هش آن نگه داشته می‌شود، یعنی می‌توانید ثابت کنید سندی از یک آدرس مشخص آمده ولی از روی سند نمی‌شود به خود آدرس رسید. همین هش هم در خروجی CSV و JSON نمی‌آید.

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

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

### خروجی، بازه تاریخ انتخاب‌شده را رعایت می‌کند؟

خیر. فهرست و نمودارهای صفحه از بازه بالا پیروی می‌کنند، ولی خروجی همیشه تازه‌ترین ۵۰٬۰۰۰ سند همان دارایی را می‌دهد، بدون توجه به بازه و فیلترهای صفحه.

### بازدیدکننده رضایتش را پس گرفت. داده‌های قبلی‌اش پاک می‌شوند؟

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

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

- [راه‌اندازی بنر رضایت](https://docs.adpix.io/fa/analytics/privacy/consent-cmp-setup/)
- [اعمال رضایت در تراکر](https://docs.adpix.io/fa/analytics/privacy/consent-categories-and-gating/)
- [اظهارنامه کوکی](https://docs.adpix.io/fa/analytics/privacy/cookie-declaration/)
- [نگه داشت و حذف داده](https://docs.adpix.io/fa/concepts/governance/data-retention-and-deletion/)

---

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