راهنمای نصب JavaScript

نصب آلفانا با JavaScript

برای سایت‌های HTML، Laravel Blade یا هر بک‌اندی که React ندارد، کلاس UserTracker یا بیلد global روی window.AlphanaSDK را استفاده می‌کنی. می‌توانی از npm import کنی یا اسکریپت را مستقیم در صفحه بگذاری.

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

بدون وابستگی به npm در صورت استفاده از CDN
مناسب HTML استاتیک و پروژه‌های legacy
رویداد سفارشی و identify از همان API
ارسال batch برای کاهش درخواست شبکه

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

  1. 1

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

  2. 2

    اسکریپت global را قبل از </body> اضافه کن یا از npm import کن.

  3. 3

    tracker.init() را بعد از ساخت نمونه صدا بزن.

  4. 4

    برای SPAهای سبک، pageview دستی بعد از تغییر hash یا route بفرست.

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

نمونه کد

JavaScript
import { UserTracker } from "alphana-sdk";

const tracker = new UserTracker({
  appId: "YOUR_APP_ID",
  secretKey: "YOUR_SECRET_KEY",
});

tracker.init();

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

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

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

بازدید تست

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

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

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

تأیید ثبت

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

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

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

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