آلفانا — پلتفرم تحلیل رفتار کاربران
راهنمای نصب React

نصب آلفانا روی React

برای SPAهای React و Vite، UserTrackerProvider را در entry point قرار می‌دهی و روی routeهای اصلی از usePageView استفاده می‌کنی. رویدادها batch ارسال می‌شوند تا روی bundle و runtime تأثیر کمتری بگذارند.

نکات این مسیر نصب

Provider و هوک‌های آماده برای React 17+
سازگار با Vite، CRA و ساختارهای SPA
شناسایی کاربر با tracker.identify
ارسال رویداد سفارشی از همان SDK
ساخت اپ و دریافت کلیدمستندات کامل

چهار قدم تا اولین رویداد

  1. 1

    اپ جدید در داشبورد آلفانا بساز و کلیدها را کپی کن.

  2. 2

    alphana-sdk را نصب کن و UserTrackerProvider را در ریشه اپ قرار بده.

  3. 3

    روی routeهای اصلی از usePageView استفاده کن.

  4. 4

    چند بازدید تست بزن و رویدادها را در داشبورد بررسی کن.

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

نمونه کد

React
import { UserTrackerProvider, usePageView } from "alphana-sdk/react";

function App() {
  return (
    <UserTrackerProvider config={{ appId: "…", secretKey: "…" }}>
      <Routes />
    </UserTrackerProvider>
  );
}

App ID و Secret Key را از داشبورد کپی کن — در production هرگز Secret Key را در client عمومی قرار نده.

اتصال را چطور تأیید کنی؟

بعد از نصب، این سه مرحله را انجام بده. اگر رویدادها در داشبورد ثبت شدند، اتصال درست برقرار شده است.

بازدید تست

چند صفحه از سایت خودت را باز کن

بررسی داشبورد

در پنل اپ، لیست رویدادها را باز کن

تأیید ثبت

رویداد جدید با URL و زمان بازدیدت باید دیده شود

کلیدها را داری؟ نصب را ادامه بده

App ID و Secret Key را از داشبورد بگیر، مراحل بالا را دنبال کن و اتصال را تست کن. برای جزئیات بیشتر به مستندات مراجعه کن.

ساخت اپ و دریافت کلیدمستندات کامل

استک دیگری داری؟