# برنامه‌های متصل

برنامه‌هایی مثل Claude، ChatGPT یا یک اسکریپت را با حساب ادپیکس خود وصل کنید تا با همان دسترسی شما داده‌ها را بخوانند؛ خودتان انتخاب می‌کنید کدام وب‌سایت‌ها و کدام مجوزها، و هر زمان می‌توانید قطعش کنید.

## نمای کلی

با **برنامه‌های متصل** می‌توانید یک برنامه — دستیار هوش مصنوعی مثل Claude یا ChatGPT، ابزاری مثل Cursor، یا اسکریپت خودتان — را به ادپیکس وصل کنید تا از طریق API یا MCP و **به‌جای شما** داده‌ها را بخواند. اتصال با استاندارد OAuth انجام می‌شود: برنامه هرگز گذرواژه شما را نمی‌بیند.

## وصل کردن یک برنامه

1. در برنامه، اتصال به ادپیکس را شروع کنید. به صفحه ورود ادپیکس می‌روید (اگر وارد نشده باشید) و سپس به صفحه **اتصال**.
2. در بخش **مجوزها**، فقط چیزهایی را که برنامه لازم دارد علامت بزنید. برنامه هرگز بیش از آنچه خواسته بود نمی‌گیرد.
3. در بخش **وب‌سایت‌ها**، **همه وب‌سایت‌های من** (شامل مواردی که بعداً اضافه می‌شوند) یا **انتخاب وب‌سایت‌ها** را برگزینید و یک یا چند وب‌سایت را علامت بزنید — گروه‌بندی‌شده بر اساس سازمان و حساب، با جستجو و انتخاب همه.
4. **اجازه بده** را بزنید. به برنامه برمی‌گردید و اتصال برقرار است.

> **نقش شما سقف است**
>
> مجوزهای تغییر (مثل افزودن یادداشت یا مدیریت مسدودسازی تقلب) فقط روی وب‌سایت‌هایی کار می‌کنند که در آن‌ها حداقل نقش ویرایشگر دارید. شناسه‌های بازدیدکننده فقط جایی دیده می‌شوند که نقش و مجوز شناسه‌های شما هم‌اکنون اجازه می‌دهد. صفحه اتصال این موارد را کنار هر وب‌سایت نشان می‌دهد.

## مدیریت برنامه‌های متصل

از منوی حساب (آواتار بالای صفحه) **API و MCP** را باز کنید و زبانه **برنامه‌های متصل شما** را انتخاب کنید. برای هر برنامه، مجوزها، وب‌سایت‌ها، زمان اتصال و آخرین استفاده را می‌بینید. با **لغو**، دسترسی برنامه فوراً قطع می‌شود. اتصالی که با **همه وب‌سایت‌های من** ساخته شده دنبال دسترسی شما می‌رود: وب‌سایت‌هایی که بعداً به آن‌ها دسترسی پیدا می‌کنید بدون اتصال دوباره شامل می‌شوند.

مدیر حساب در **API و MCP ← توکن‌های سرویس** فهرست برنامه‌هایی را می‌بیند که به وب‌سایت‌های حساب وصل شده‌اند و می‌تواند هر برنامه را برای کل حساب **مسدود** کند.

## مجوزها

| مجوز | چه می‌دهد |
| --- | --- |
| خواندن گزارش‌ها | ترافیک، تعامل، تبدیل‌ها و گزارش‌های استاندارد |
| خواندن تنظیمات وب‌سایت | جریان داده ها، رویدادها، تعاریف سفارشی |
| دیدن وب‌سایت‌ها و سهمیه | فهرست وب‌سایت‌های متصل و مصرف امروز |
| خواندن محافظت از تقلب | کلیک‌های نامعتبر، منابع، شبکه‌ها |
| خواندن بازاریابی | هزینه، ROAS، آمیخته بازاریابی، lift |
| خواندن بلادرنگ | بازدیدکنندگان همین لحظه |
| دیدن شناسه‌های بازدیدکننده | فقط جایی که نقش شما آن را نشان می‌دهد |
| تغییر تنظیمات وب‌سایت | یادداشت‌ها، رویدادهای کلیدی، تعاریف، بخش‌ها (ویرایشگر به بالا) |
| مدیریت مسدودسازی تقلب | مسدود و آزاد کردن، فهرست مجاز، آستانه‌ها — هرگز حالت مسدودسازی را روشن نمی‌کند |

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

### آیا برنامه می‌تواند بیشتر از من ببیند؟

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

### چرا یک وب‌سایت در فهرست اتصال نیست؟

فقط وب‌سایت‌هایی که همین حالا به آن‌ها دسترسی دارید نشان داده می‌شوند. اگر مدیر حساب این برنامه را برای حسابش مسدود کرده باشد، وب‌سایت‌های آن حساب هم نمایش داده نمی‌شوند.

### پیام «این درخواست اتصال منقضی شده» یعنی چه؟

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

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

- [API و MCP](https://docs.adpix.io/fa/analytics/admin/api-access/)
- [مرجع API عمومی](https://docs.adpix.io/fa/developers/analytics/developers/public-api/)
- [نقش‌ها و اختیارات](https://docs.adpix.io/fa/analytics/admin/roles-and-capabilities/)

---

[مستندات](https://docs.adpix.io/fa/analytics/admin/connected-apps/) · AdPix