ردیابی UTM را یکپارچه کنید و قیف‌ها را از استک خود تعریف کنید.

جریان یکپارچه‌سازی خود را انتخاب کنید

همان بخش‌های پایین، چیده‌شده بر اساس چیزی که واقعاً یکپارچه می‌کنید — نزدیک‌ترین مورد به وضعیت خودتان را انتخاب کنید.

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

<!-- Plain HTML: drop the file in /public and include it -->
<script>window.UTM_TRACKER_ENDPOINT = "https://api.didsar.ir/api/events";</script>
<script src="/utm-tracker.js" defer></script>

<!-- or configure on the tag itself -->
<script src="/utm-tracker.js" data-endpoint="https://api.didsar.ir/api/events" defer></script>
  1. برای دریافت لینک کوتاه، یک کمپین بسازید — پنل (Campaigns → New) یا اسکریپتش کنید.
  2. نصب کنید اسکریپت ردیاب — یک تگ <script> در بخش <head>.
  3. اضافه کنید data-utm-action به دکمه‌هایی که می‌خواهید ردیابی شوند — ببینید ردیابی اعلانی کلیک.
  4. یک رویداد آزمایشی بفرستید و از رسیدنش مطمئن شوید — دکمه در بخش ردیاب پایین است.

مرجع و راه‌اندازی کامل

افزودن اسکریپت ردیاب در Next.js / React

کپی utm-tracker.js را داخل پوشه /public برنامه خود قرار دهید (یا مستقیماً به نسخه همین سرور لینک دهید)، سپس آن را بارگذاری کنید. آدرس را روی /api/events بک‌اند UTM خود تنظیم کنید.

Next.js (اپ روتر)

// app/layout.tsx — load the tracker on every page
import Script from "next/script";

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        {/* point it at your UTM backend's /events endpoint */}
        <Script id="utm-endpoint" strategy="beforeInteractive">
          {`window.UTM_TRACKER_ENDPOINT = "https://api.didsar.ir/api/events";`}
        </Script>
        <Script src="/utm-tracker.js" strategy="afterInteractive" />
        {children}
      </body>
    </html>
  );
}

React SPA ساده (Vite، CRA، …)

بدون next/script خارج از Next.js — کافیست خودتان تگ را اضافه کنید.

// A tiny hook for a plain React SPA (Vite, CRA, etc. — no next/script)
import { useEffect } from "react";

export function useUtmTracker(endpoint) {
  useEffect(() => {
    window.UTM_TRACKER_ENDPOINT = endpoint;
    const s = document.createElement("script");
    s.src = "/utm-tracker.js";
    s.defer = true;
    document.body.appendChild(s);
    return () => s.remove();
  }, [endpoint]);
}

// In your root component:
useUtmTracker("https://api.didsar.ir/api/events");

این اسکریپت به‌طور خودکار utm_* پارامترهای را از آدرس ورودی می‌گیرد، ذخیره می‌کند و یک page_view را به‌طور خودکار ارسال می‌کند.

← بازگشت به کمپین‌ها

مستندات یکپارچه‌سازی — ردیابی UTM و تعریف قیف از هر استک · Didsar