Tracking Script

Tracking Script

Het Blitz Rocket tracking script is een lichtgewicht JavaScript-fragment dat je aan je website toevoegt om automatisch verwijzingsbezoeken, aanmeldingen en aankopen te volgen.

Installatie

Voeg het volgende script toe aan je website. Vervang YOUR_CAMPAIGN_ID door je daadwerkelijke campagne-/wedstrijd-ID uit het Blitz Rocket dashboard:

<script
  src="https://blitzrocket.com/referral-tracker.js?campaignId=YOUR_CAMPAIGN_ID&autoInject=stripe"
  async
></script>

De parameter autoInject=stripe legt automatisch Stripe checkout aankopen vast. Verwijder deze als je geen Stripe gebruikt of aankopen liever handmatig volgt.

Aanmeldingen volgen

Roep RocketTracker.trackSignup() aan wanneer een gebruiker zich registreert op je site:

// Nadat gebruiker succesvol registreert
if (window.RocketTracker) {
  window.RocketTracker.trackSignup("newuser@example.com");
}

function SignupForm() {
  const handleSubmit = async (formData) => {
    const result = await registerUser(formData);

    if (result.success && window.RocketTracker) {
      window.RocketTracker.trackSignup(formData.email);
    }
  };

  return <form onSubmit={handleSubmit}>...</form>;
}

<script setup>
async function handleSignup(formData) {
  const result = await registerUser(formData);

  if (result.success && window.RocketTracker) {
    window.RocketTracker.trackSignup(formData.email);
  }
}
</script>

Aankopen volgen

Roep RocketTracker.trackPurchase() aan wanneer een gebruiker een aankoop voltooit:

// Nadat aankoop is bevestigd
if (window.RocketTracker) {
  window.RocketTracker.trackPurchase(
    "order-12345",  // orderId
    49.99,          // bedrag
    "USD",          // valuta
    "buyer@example.com" // e-mail (optioneel)
  );
}

function CheckoutSuccess({ order }) {
  useEffect(() => {
    if (window.RocketTracker) {
      window.RocketTracker.trackPurchase(
        order.id,
        order.total,
        order.currency,
        order.email
      );
    }
  }, [order]);

  return <div>Bedankt voor je aankoop!</div>;
}

Verwijzingscode ophalen

Haal de huidige verwijzingscode op die is opgeslagen van een bezoek via een verwijzingslink:

if (window.RocketTracker) {
  const code = window.RocketTracker.getReferralCode();
  if (code) {
    console.log("Actieve verwijzingscode:", code);
  }
}

Detectie van verwijzings- & affiliatecodes

Het tracking script detecteert automatisch codes uit URL-parameters en maakt onderscheid tussen verwijzings- en affiliateprogramma's op basis van welke parameter wordt gebruikt:

• Verwijzingsprogramma: ?code=ABC123 of ?ref=ABC123
• Affiliateprogramma: ?aff=XYZ789 of ?fpr=XYZ789 (FirstPromoter-stijl)

Elk programma wordt opgeslagen in een eigen cookie-namespace zodat een enkele site zowel een verwijzingsprogramma en een affiliateprogramma tegelijk kan draaien:

• Verwijzingscode → blitzrocket_referral_code cookie
• Affiliatecode → blitzrocket_affiliate_code cookie

Omdat codes alleen uniek zijn binnen een campagne, bepaalt het script via de server bij het eerste bezoek van een bezoeker aan welke campagne een code behoort. De gedetecteerde code wordt vervolgens opgenomen in volgende tracking-aanroepen.

Een domein kan maximaal één actief verwijzingsprogramma en één actief affiliateprogramma tegelijk hebben. Om van programma te wisselen, deactiveer eerst het bestaande.

Gericht op een specifiek programma

Bij server-side tracking lees je de bijbehorende cookie. Bij gebruik van de JS-hulpmiddelen op een site die beide programma's draait, geef je het programma expliciet mee:

// Specifiek een affiliate-aanmelding volgen
window.RocketTracker.trackSignup("newuser@example.com", { type: "affiliate" });

// Specifiek een affiliate-aankoop volgen
window.RocketTracker.trackPurchase("order-12345", 49.99, "USD", "buyer@example.com", { type: "affiliate" });

Framework Integratie

Nuxt 3

Blitz Rocket biedt een ingebouwde Nuxt plugin. Stel de omgevingsvariabele NUXT_PUBLIC_BLITZROCKET_CAMPAIGN_ID in en het script wordt automatisch geladen.

Je kunt ook de meegeleverde $blitzrocket helper gebruiken:

<script setup>
const { $blitzrocket } = useNuxtApp();

async function handleSignup(email) {
  await $blitzrocket.trackSignup(email);
}

async function handlePurchase(order) {
  await $blitzrocket.trackPurchase(
    order.id,
    order.total,
    order.currency,
    order.email
  );
}

const referralCode = $blitzrocket.getReferralCode();
</script>

Next.js

// app/layout.js
import Script from "next/script";

export default function RootLayout({ children }) {
  const campaignId = process.env.NEXT_PUBLIC_BLITZROCKET_CAMPAIGN_ID;

  return (
    <html>
      <head>
        <Script
          id="blitzrocket-tracker"
          src={`https://blitzrocket.com/referral-tracker.js?campaignId=${campaignId}&autoInject=stripe`}
          strategy="afterInteractive"
        />
      </head>
      <body>{children}</body>
    </html>
  );
}

Gewone HTML

<!DOCTYPE html>
<html>
  <head>
    <script
      src="https://blitzrocket.com/referral-tracker.js?campaignId=YOUR_CAMPAIGN_ID&autoInject=stripe"
      async
    ></script>
  </head>
  <body>
    <!-- De inhoud van je pagina -->
  </body>
</html>

Google Tag Manager

1. Ga naar GTM → Tags → Nieuwe Tag
2. Kies Aangepaste HTML
3. Plak:

<script
  src="https://blitzrocket.com/referral-tracker.js?campaignId=YOUR_CAMPAIGN_ID&autoInject=stripe"
  async
></script>

4. Stel de trigger in op Alle Pagina's
5. Publiceer je wijzigingen