Affiliate-tracking Guide

Lär dig hur du spårar affiliate-klick och använder API:t för att visa genuint populära produkter.

Vad får du?

  • "Populära produkter" baserat på faktiska klick, inte admin-val
  • "Trending just nu" - produkter som ökar i popularitet
  • Filtrering per kategori, varumärke eller partner
  • Confidence-nivåer för att veta när du har tillräckligt med data

Steg 1: Konfigurera Event Properties

Innan du börjar spåra affiliate-klick måste du registrera vilka properties du vill samla in.

  1. 1. Gå till Inställningar → Event Properties
  2. 2. Välj din sajt
  3. 3. Klicka "Lägg till alla" för att lägga till alla rekommenderade properties
PropertyBeskrivningKrävs för
product_idUnikt produkt-IDPopular Products
product_slugURL-vänligt namn för länkarValfritt
category_slugProduktkategoriPopular Categories
brand_slugVarumärkeFiltrering
partner_slugAffiliate-partner/butikPopular Partners
pricePris vid klickAnalys
positionPosition i listaAnalys

Steg 2: Installera tracking-scriptet

Lägg till tracking-scriptet i din HTML:

<script defer data-site-id="DIN-SAJT-ID" src="https://besokskollen.se/script.js"></script>

Steg 3: Skicka affiliate_click events

När en användare klickar på en affiliate-länk, skicka ett event med relevanta properties:

// Exempel: Produktsida med flera erbjudanden
document.querySelectorAll('.affiliate-link').forEach(link => {
  link.addEventListener('click', () => {
    va('event', 'affiliate_click', {
      product_id: link.dataset.productId,
      product_slug: link.dataset.productSlug,
      category_slug: link.dataset.category,
      brand_slug: link.dataset.brand,
      partner_slug: link.dataset.partner,
      price: parseInt(link.dataset.price),
      position: parseInt(link.dataset.position)
    });
  });
});
<!-- Exempel: HTML för affiliate-länk -->
<a href="https://partner.com/product?ref=xxx"
   class="affiliate-link"
   data-product-id="iphone-15-skal-123"
   data-product-slug="iphone-15-skal"
   data-category="mobilskal"
   data-brand="apple"
   data-partner="teknikdelar"
   data-price="199"
   data-position="1">
  Köp nu hos Teknikdelar - 199 kr
</a>

Steg 4: Skapa en API-nyckel

För att hämta data via API:t behöver du en API-nyckel.

  1. 1. Gå till Inställningar → API-nycklar
  2. 2. Klicka "Skapa API-nyckel"
  3. 3. Välj sajt och ge nyckeln ett namn (t.ex. "Production")
  4. 4. Kopiera nyckeln direkt - den visas endast en gång!

Viktigt: Säkerhet

Exponera aldrig din API-nyckel i frontend-kod. Gör alltid API-anrop från din server (t.ex. i Next.js Server Components eller API routes).

Steg 5: Hämta populära produkter

Nu kan du hämta data via API:t. Här är ett exempel i Next.js:

// app/components/PopularProducts.tsx (Server Component)
async function getPopularProducts() {
  const res = await fetch(
    'https://besokskollen.se/api/v1/popular/products?site_id=din-sajt&days=7&limit=10',
    {
      headers: {
        'Authorization': `Bearer ${process.env.BESOKSKOLLEN_API_KEY}`
      },
      next: { revalidate: 1800 } // ISR: 30 minuter
    }
  );
  return res.json();
}

export default async function PopularProducts() {
  const { data, meta } = await getPopularProducts();

  // Fallback om för lite data
  if (meta.confidence === 'low') {
    return <FallbackProducts />;
  }

  return (
    <section>
      <h2>Populära produkter</h2>
      {meta.confidence === 'medium' && (
        <p className="text-sm text-gray-500">Baserat på begränsad data</p>
      )}
      <div className="grid grid-cols-3 gap-4">
        {data.map(product => (
          <ProductCard
            key={product.product_id}
            slug={product.product_slug}
            clicks={product.clicks}
          />
        ))}
      </div>
    </section>
  );
}

Bonus: Visa trending-produkter

Utöver de mest populära kan du också visa produkter som ökar i popularitet:

// Hämta produkter som trendar just nu
const trending = await fetch(
  'https://besokskollen.se/api/v1/trending/products?site_id=din-sajt&min_growth=50',
  {
    headers: { 'Authorization': `Bearer ${process.env.BESOKSKOLLEN_API_KEY}` },
    next: { revalidate: 900 } // 15 minuter för trending
  }
);

// Response innehåller growth_percent
// { product_id: "airpods-pro", growth_percent: 369, clicks_recent: 15 }

Optimering: Batch-anrop

Om du behöver flera typer av data samtidigt, använd batch-endpointen för att minska latens:

const response = await fetch('https://besokskollen.se/api/v1/batch', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.BESOKSKOLLEN_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    site_id: 'din-sajt',
    requests: [
      { endpoint: 'popular/products', params: { limit: 10, days: 7 } },
      { endpoint: 'popular/categories', params: { limit: 6, days: 30 } },
      { endpoint: 'trending/products', params: { min_growth: 50 } }
    ]
  }),
  next: { revalidate: 1800 }
});

const { results } = await response.json();
// results[0] = popular/products
// results[1] = popular/categories
// results[2] = trending/products

GDPR och integritet

Besökskollen är designat för att vara GDPR-vänligt:

  • Inga cookies - Cookieless tracking
  • Inga IP-adresser - IP hashas omedelbart
  • Inga personuppgifter - Endast aggregerad produktdata
  • Whitelist-system - Endast registrerade properties sparas

Förslag på text för er sajt:
"Vi använder Besökskollen för anonym statistik. Inga personuppgifter samlas in och inga cookies används. Läs mer på besokskollen.se/integritet"

Prompta din AI

Kopiera prompten nedan och klistra in i din favorit-AI (ChatGPT, Claude, etc.) för att få hjälp med att implementera affiliate-tracking för din sajt.

AI-prompt för affiliate-tracking

Jag använder Besökskollen (besokskollen.se) för webbanalys och vill sätta upp affiliate-tracking för att spåra produktklick och visa "populära produkter" baserat på faktiska klick. Besökskollen har ett event-system där jag kan: 1. Skicka events med va('event', 'affiliate_click', { properties }) 2. Registrera whitelistade properties (product_id, category_slug, brand_slug, partner_slug, price, position) 3. Hämta populära produkter via API: GET /api/v1/popular/products Min sajt är: [BESKRIV DIN SAJT - t.ex. "en prisjämförelsesajt för elektronik" eller "en affiliatesajt inom hälsa"] Min tekniska stack är: [BESKRIV DIN STACK - t.ex. "Next.js med TypeScript" eller "WordPress med PHP"] Mina affiliate-länkar ser ut så här: [BESKRIV STRUKTUREN - t.ex. "data-attribut på länkar" eller "dynamiskt genererade i React"] Hjälp mig implementera: 1. JavaScript-kod för att spåra affiliate_click events med rätt properties 2. Vilka properties bör jag använda för min typ av sajt? 3. Server-side kod för att hämta populära produkter från API:t 4. Hur ska jag hantera "confidence"-nivåer (low/medium/high)? 5. Fallback-strategi när jag inte har tillräckligt med data

Nästa steg

← Public APIEvent Properties →