# رویدادهای کلیدی

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

## علامت‌گذاری چه چیزی را عوض می‌کند

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

فهرست در «مدیریت» ← «تنظیمات دارایی» ← «رویدادهای کلیدی» نگه‌داری می‌شود.

> علامت‌گذاری رویدادها به‌عنوان رویداد کلیدی و انتخاب روش شمارش. — [analytics.adpix.io/fa/admin?sel=key-events](https://analytics.adpix.io/fa/admin?sel=key-events)

1. «مدیریت» را باز کنید و در ستون «دارایی»، «رویدادهای کلیدی» را انتخاب کنید.
2. نام رویداد را دقیقا همان‌طور که در گزارش رویدادها دیده می‌شود بنویسید.
3. روش شمارش و در صورت نیاز ارز را انتخاب کنید.
4. «علامت‌گذاری رویداد کلیدی» را بزنید.

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

## این کار گذشته‌نگر است

این مهم‌ترین تفاوتش با قواعد رویداد است و اغلب غافلگیرکننده.

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

برداشتن علامت هم به همان سرعت برگشت‌پذیر است: رویدادها سر جایشان می‌مانند، فقط دیگر تبدیل شمرده نمی‌شوند.

## کجا اثرش را می‌بینید

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

یک اثر کمتر آشکار هم دارد: **تعریف نشست متعامل**. نشستی متعامل شمرده می‌شود که دست‌کم ۱۰ ثانیه تعامل داشته باشد، یا دو بازدید صفحه، **یا یک رویداد کلیدی**. پس هر رویداد کلیدی تازه، نرخ تعامل را هم کمی بالا می‌برد.

## درآمد از کجا می‌آید

ستون درآمد رویدادهای کلیدی، پارامتر `value` را از روی خود رویدادهای کلیدی جمع می‌زند. رویدادی که `value` ندارد صفر می‌آورد.

پس اگر می‌خواهید تبدیلی درآمد نشان دهد، مقدار را با خود رویداد بفرستید:

```js
ap('track', 'lead_qualified', { value: 1200000, currency: 'IRR' });
```

برای خرید، فرمان `ecommerce` همین کار را می‌کند و علاوه بر آن ریز اقلام را هم می‌فرستد — [رویدادهای تجارت الکترونیک](analytics/collect/ecommerce-events).

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

## نام باید دقیقا بخواند

شمارش با تطبیق دقیق نام انجام می‌شود. `Purchase` و `purchase` دو چیز جدا هستند و رویداد کلیدی‌ای که نامش با هیچ رویدادی نمی‌خواند، بی‌سروصدا صفر می‌ماند — پیامی نمی‌گیرید.

نامی را ثبت کنید که در گزارش رویدادها با چشم خودتان دیده‌اید. یک استثنا هم هست: بازدید صفحه نام رویدادش خالی است و نامش را در نوع رویداد حمل می‌کند، پس ثبت `page_view` به عنوان رویداد کلیدی چیزی نمی‌شمارد. اگر بارگذاری یک صفحه خاص تبدیل شماست، اول با یک قاعده «ساخت رویداد» روی آدرس همان صفحه رویدادی با نام خودتان بسازید و بعد آن را کلیدی کنید — روشش در [قواعد ایجاد و اصلاح رویداد](analytics/collect/event-rules) آمده است.

## سپر ماژول تقلب

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

ماژول حفاظت از تقلب پیش از هر چیز روی **دقت** تنظیم شده: منبعی که واقعا تبدیل می‌سازد آدم واقعی دارد و نباید علامت‌دار شود. برای تشخیص «تبدیل‌ساز بودن»، ماژول فهرست رویدادهای کلیدی همان دارایی را می‌خواند — به‌علاوه رویداد `purchase` که همیشه حساب می‌شود.

نتیجه‌اش دو طرفه است:

- اگر تبدیل‌های شما نام سفارشی دارند و **در فهرست رویدادهای کلیدی ثبت نشده‌اند**، ماژول آن‌ها را نمی‌بیند و ترافیک کاملا سالمی که فقط الگوی غیرعادی دارد می‌تواند به اشتباه علامت بخورد.
- اگر ثبت شده باشند، منبعی که در همان حد تبدیل می‌سازد از علامت‌گذاری خودکار بر پایه نظر مدل معاف می‌شود.

با این حال تبدیل، ایمنی مطلق نمی‌آورد: سیگنال‌های ساختاری سخت — مثل حلقه اثرانگشت یا ترافیک شناخته‌شده ربات — روی موجودیت تبدیل‌ساز هم اعمال می‌شوند و آن را به صف بازبینی انسانی می‌فرستند، نه به فهرست پاک. دلیلش روشن است: رویداد کلیدی از سمت مرورگر می‌آید و ربات هم می‌تواند آن را شلیک کند. منطق کامل در [چرا این علامت خورد](analytics/fraud/why-was-this-flagged) توضیح داده شده است.

## چند تا رویداد کلیدی

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

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

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

### علامت‌گذاری یک رویداد کلیدی، گذشته را هم شامل می‌شود؟

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

### می‌توانم `page_view` را رویداد کلیدی کنم؟

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

### درآمد رویداد کلیدی از کجا می‌آید؟

از پارامتر `value` روی خود رویداد، در همان بازه انتخاب‌شده. مقدار پیش‌فرضی که هنگام ساخت رویداد کلیدی وارد می‌کنید جای آن را نمی‌گیرد؛ رویدادی که `value` ندارد صفر می‌آورد.

### چند رویداد کلیدی داشته باشم؟

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

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

- [قواعد ایجاد و اصلاح رویداد](https://docs.adpix.io/fa/analytics/collect/event-rules/)
- [قیف تبدیل](https://docs.adpix.io/fa/analytics/reports/funnel/)
- [رویدادهای تجارت الکترونیک](https://docs.adpix.io/fa/analytics/collect/ecommerce-events/)
- [چرا این ترافیک علامت خورد](https://docs.adpix.io/fa/analytics/fraud/why-was-this-flagged/)

---

[مستندات](https://docs.adpix.io/fa/analytics/collect/key-events/) · AdPix