Ga naar hoofdinhoud

Snelstart

Stel uw affiliate-programma in minder dan 30 minuten in. Deze gids legt u uit hoe u het Selgeo-trackingsnippet aan uw website toevoegt, het verbindt met Stripe en uw eerste testconversie verifieert.

API-versie: v1

Vereisten​

  • Een Selgeo-verkopersaccount
  • Toegang tot de HTML van uw website (of een tagbeheerder)
  • Een Stripe-account verbonden met Selgeo (voor op Stripe gebaseerde conversietracking)

Stap 1: API-sleutels ophalen​

Log in op het Selgeo-verkopersdashboard en navigeer naar Instellingen > API-sleutels. U ziet twee sleutelparen:

SleuteltypeFormaatDoel
Publieke sleutel (test)pk_test_*JS-snippet op uw website (testmodus)
Publieke sleutel (live)pk_live_*JS-snippet op uw website (live-modus)
Geheime sleutel (test)sk_test_*Server-side API-aanroepen (testmodus)
Geheime sleutel (live)sk_live_*Server-side API-aanroepen (live-modus)

Publieke sleutels (pk_*) kunnen veilig worden ingesloten in frontend-code. Ze kunnen alleen klikken registreren.

Geheime sleutels (sk_*) mogen nooit worden blootgesteld aan de browser. Gebruik ze alleen op uw server.

Begin met testsleutels

Gebruik pk_test_* en sk_test_* tijdens de integratie. De testmodus volgt alles op dezelfde manier maar maakt geen echte commissies aan. Schakel over naar live sleutels wanneer u klaar bent om live te gaan.

Stap 2: Het trackingsnippet toevoegen​

Voeg de volgende <script>-tag toe aan elke pagina van uw website, vlak voor de sluitende </body>-tag:

<script
  async
  src="https://cdn.selgeo.com/v1/selgeo.js"
  data-merchant="pk_test_YOUR_KEY"
></script>

Vervang pk_test_YOUR_KEY door uw werkelijke publieke sleutel uit Stap 1.

Voor uw framework, zie de specifieke handleiding​

De <script>-tag hierboven werkt op elke HTML-pagina. Als u op een moderne frontend-stack bouwt, vindt u de equivalente integratie in een van de volgende handleidingen:

  • HTML / eenvoudig script — statische sites, tagbeheerders, aangepaste server-gerenderde pagina's.
  • Next.js — next/script voor App Router en Pages Router.
  • React (Vite) — plaatsing in index.html, met een useEffect-terugvaloptie.
  • WordPress — Site Editor, footer.php of een header-footer-plugin.

Wat het snippet doet:

  1. Wanneer een bezoeker aankomt via een partnerreferrallink (bijv. https://uw-site.com/?ref=abc123), registreert het snippet de klik bij Selgeo en slaat een click_id op in de sessionStorage van de browser.
  2. Als u Stripe Payment Links gebruikt, voegt het snippet automatisch de click_id toe aan die links als client_reference_id — geen backend-werk vereist.
  3. Het snippet is cookieloos. Het gebruikt alleen sessionStorage, dat wordt gewist wanneer het browsertabblad wordt gesloten.

Stap 3: Uw installatie verifiëren​

  1. Maak een trackinglink aan in het Selgeo-dashboard onder Programma's > Trackinglinks.
  2. Open een nieuw browsertabblad en bezoek uw site via de trackinglink.
  3. Open de Ontwikkelaarstools van uw browser (F12) en controleer het tabblad Console. Met data-debug toegevoegd ziet u: 
    [selgeo] ref detected UW_TRACKING_REF
    [selgeo] click_id stored xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  4. Verifieer de click_id door dit uit te voeren in de browserconsole: 
    __selgeo.getClickId()
  5. Controleer het Selgeo-dashboard — de klik zou binnen enkele seconden zichtbaar moeten zijn in Analytics.

Stap 4: Conversies bijhouden via Stripe​

Selgeo ondersteunt drie Stripe-integratiepaden. Kies het pad dat past bij uw configuratie:

Als u Stripe Payment Links (buy.stripe.com-URL's) gebruikt, verwerkt het snippet alles automatisch.

<!-- Uw bestaande Payment Link — het snippet herschrijft het automatisch -->
<a href="https://buy.stripe.com/test_abc123">Nu abonneren</a>

Optie B: Stripe Checkout (één regel frontend-code)​

Frontend — lees de klik-ID uit het snippet:

const clickId = __selgeo.getClickId();

fetch('/api/create-checkout', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ priceId: 'price_xxx', clickId: clickId }),
});

Backend — geef het door als client_reference_id:

const stripe = require('stripe')('sk_test_YOUR_STRIPE_KEY');

app.post('/api/create-checkout', async (req, res) => {
  const session = await stripe.checkout.sessions.create({
    mode: 'subscription',
    line_items: [{ price: req.body.priceId, quantity: 1 }],
    success_url: 'https://uw-site.com/success',
    cancel_url: 'https://uw-site.com/cancel',
    client_reference_id: req.body.clickId || undefined,
  });
  res.json({ url: session.url });
});

Optie C: Niet-Stripe-conversies (Conversie-API)​

curl -X POST https://api.selgeo.com/api/v1/conversions \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "click_id": "CLICK_ID_VAN_FRONTEND",
    "external_transaction_id": "signup_12345",
    "event_type": "signup",
    "amount_cents": 0
  }'

Volgende stappen​

  • Snippet-setup — geavanceerde snippetconfiguratie
  • Stripe Metadata — click_id doorgeven via metadata van de betaalsessie
  • Conversie-API — volledige API-referentie voor niet-Stripe-conversies
  • Testmodus — gedetailleerde gids voor het testen van uw integratie
  • Live-checklist — stappen om over te schakelen van testmodus naar live-modus