نصب آلفانا روی Next.js
این راهنما مسیر نصب آلفانا روی پروژه Next.js را مرحلهبهمرحله توضیح میدهد — از دریافت App ID و Secret Key تا wrap کردن layout با Provider. با App Router و مسیریابی سمت کلاینت سازگار است.
نکات این مسیر نصب
چهار قدم تا اولین رویداد
- 1
در داشبورد آلفانا یک اپ بساز و App ID و Secret Key را کپی کن.
- 2
بسته alphana-sdk را نصب کن: npm install alphana-sdk
- 3
در layout.tsx، UserTrackerProvider را با config اپ wrap کن.
- 4
چند بازدید تست بزن و رویدادها را در داشبورد بررسی کن.
اگر در هر مرحلهای به مشکل خوردی، از صفحه تماس یا بخش تیکتهای داشبورد با تیم پشتیبانی در تماس باش.
نمونه کد
Next.jsimport { 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 را از داشبورد بگیر، مراحل بالا را دنبال کن و اتصال را تست کن. برای جزئیات بیشتر به مستندات مراجعه کن.