لیدآرا

اتصال به لیدآرا

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

لیدآرا با دریافت رویدادها (این‌که کاربران چه می‌کنند) و هویت‌ها (این‌که چه کسانی هستند) کار می‌کند. وقتی رویدادها وارد شوند، تیم بازاریابی روی همان‌ها تحلیل، بخش‌بندی، مسیر و کمپین می‌سازد — کار شما فقط ارسال رویدادهای خوب است.

برای ابزار هوش مصنوعی شما

این فایل را به Cursor، Claude، Copilot یا هر دستیار کدنویسی هوش مصنوعی بدهید تا لیدآرا را برایتان وصل کند — شامل روش پیشنهادی نصب، SDK، افزونه و کل API است. فایل به انگلیسی است.

دانلود .md

کدام مسیر را انتخاب کنم؟

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

  • سایت وردپرسی ← افزونهٔ لیدآرا را نصب کنید و شناسهٔ فضای کاری و کلید نوشتن را وارد کنید. بدون کدنویسی.
  • وب‌سایت یا وب‌اپ (با هر فریم‌ورکی) ← اسنیپت جاوااسکریپت را اضافه کنید. مسیر پیشنهادی برای هر چیزی در مرورگر؛ بازدید صفحه‌ها را خودکار ثبت می‌کند.
  • موبایل، بک‌اند یا سمت سرور ← مستقیم API را صدا بزنید.

می‌توانید ترکیب کنید — مثلاً اسنیپت روی سایت و API از سمت سرور.

دریافت اطلاعات حساب

برای همهٔ موارد زیر به دو مقدار از داشبورد، در یکپارچه‌سازی‌ها → منابع (یا صفحهٔ نصب)، نیاز دارید:

  • شناسهٔ فضای کاری — یک UUID مثل 1c4f1e2a-….
  • کلید نوشتن — در اسنیپت و در هدر x-write-key استفاده می‌شود. این کلید قابل‌انتشار است (در کد سمت کلاینت امن است) و فقط اجازهٔ نوشتن رویداد را می‌دهد.

اسنیپت وب‌سایت

این را در <head> اضافه کنید و دو جای‌گزین را عوض کنید:

<script
  async
  src="https://api.leadara.ir/sdk/WORKSPACE_ID/sdk.js"
  data-write-key="WRITE_KEY"
></script>

به‌صورت خودکار ثبت بازدید صفحه‌ها را شروع می‌کند. بعد هرجا که خواستید این‌ها را صدا بزنید:

window.leadara.identify("user-123", { email: "sam@example.com", plan: "pro" });
window.leadara.track("checkout_started", { cartValue: 149000, currency: "IRR" });
window.leadara.page("Pricing");
window.leadara.group("acct-42", { companyName: "Acme Co." });

ویژگی‌های اختیاری اسکریپت

ویژگیکاربرد
data-session-replay="true"ضبط بازپخش جلسه با ماسک فیلدها (در سیاست حریم خصوصی ذکر کنید). آپلود از طریق HTTP — جدا از ارسال لحظه‌ای.
data-replay-sample-rate="0.5"ضبط بخشی از جلسات (۰ تا ۱) وقتی بازپخش روشن است.
data-realtime="false"قطع اتصال زنده در پس‌زمینه. ردیابی و بازپخش کار می‌کنند؛ پاپ‌آپ فوری و چت زنده نه.
data-debug="true"لاگ عیب‌یابی نصب در کنسول مرورگر.

نکته‌های یکپارچه‌سازی

  • اسکریپت را یک‌بار لود کنید — یک تگ async در <head>. روی هر مسیر دوباره تزریق نکنید.
  • window.leadara.init() را صدا نزنید وقتی تگ اسکریپت روی صفحه است — SDK خودکار بالا می‌آید. init() دستی ممکن است اتصال زندهٔ تکراری باز کند.
  • فقط به identify، track، group و page نیاز دارید — اتصال زنده یا هندلر ناوبری سمت خودتان لازم نیست.
  • فقط تحلیل می‌خواهید؟ data-realtime="false" بگذارید اگر پاپ‌آپ لحظه‌ای یا چت زنده ندارید ولی رویدادها (و در صورت نیاز بازپخش) را می‌خواهید.

API

کلید نوشتن را در هر درخواست به https://api.leadara.ir در هدر x-write-key بفرستید.

curl -X POST 'https://api.leadara.ir/track' \
  -H 'x-write-key: WRITE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"userId":"user-123","name":"purchase_completed","properties":{"total":249000}}'

مسیرها: POST /track، /page، /screen، /identify، /group، /alias و /batch (تا ۱۰۰ رویداد یک‌جا). هر رویداد به userId و/یا anonymousId نیاز دارد. پاسخ‌ها به شکل { "success": true, "data": … } هستند — پیش از خواندن data روی success شرط بگذارید.

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

نکته‌ها

  • قبل از logged_in در همان بارگذاری صفحه identify را صدا بزنید و email و/یا phone را بفرستید تا مسیرهای ایمیلی/پیامکی بتوانند برسند. track ویژگی نمی‌آورد — مسیر از پروفایل می‌خواند، نه از رویداد ورود.
  • در بالا آمدن اپ، اگر نشست از قبل وجود دارد، identify را با ویژگی‌های پایگاه کاربران خودتان صدا بزنید (نه فقط هنگام ورود تازه). کاربران برگشتی اغلب صفحهٔ ورود را نمی‌بینند.
  • نام‌های پایدار و snake_case برای رویدادها (signed_up، purchase_completed) و جزئیات در properties. اتوماسیون‌ها نام را دقیق (حساس به حروف بزرگ/کوچک) مطابقت می‌دهند.
  • روی تبدیل کلیدی یک مقدار عددی بفرستید (مثل total) تا تحلیل درآمد به‌صورت آماده کار کند.
  • در وب، اسنیپت را ترجیح بدهید — بازدیدکنندهٔ ناشناس، نشست‌ها و تلاش مجدد را برایتان مدیریت می‌کند.

راهنمای قابل‌دانلود هوش مصنوعی را برای نمونه‌های کامل ورود، بازیابی نشست و پیش‌نیازهای پیامک/ایمیل ببینید.

در این صفحه

کدام مسیر را انتخاب کنم؟
دریافت اطلاعات حساب
اسنیپت وب‌سایت
ویژگی‌های اختیاری اسکریپت
نکته‌های یکپارچه‌سازی
API
نکته‌ها