راهنمای نصب Next.js

نصب آلفانا روی Next.js

این راهنما مسیر نصب آلفانا روی پروژه Next.js را مرحله‌به‌مرحله توضیح می‌دهد — از دریافت App ID و Secret Key تا wrap کردن layout با Provider. با App Router و مسیریابی سمت کلاینت سازگار است.

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

سازگار با App Router و Pages Router
نصب یک‌بار در layout.tsx برای کل اپ
ثبت pageview بعد از navigate سمت کلاینت
همان alphana-sdk/react که در React استفاده می‌شود

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

  1. 1

    در داشبورد آلفانا یک اپ بساز و App ID و Secret Key را کپی کن.

  2. 2

    بسته alphana-sdk را نصب کن: npm install alphana-sdk

  3. 3

    در layout.tsx، UserTrackerProvider را با config اپ wrap کن.

  4. 4

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

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

نمونه کد

Next.js
import { UserTrackerProvider } from "alphana-sdk/react";

export default function RootLayout({ children }) {
  return (
    <UserTrackerProvider
      config={{
        appId: "YOUR_APP_ID",
        secretKey: "YOUR_SECRET_KEY",
      }}
    >
      {children}
    </UserTrackerProvider>
  );
}

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

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

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

بازدید تست

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

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

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

تأیید ثبت

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

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

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

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