track.js

track.js er Affilyflows sporingsscript til webshops og websites. Det gemmer klikket, når en kunde lander fra et affiliate-link, og melder salget, når kunden når kvitteringen. Hvordan det hele hænger sammen, står i Sådan virker sporingen.

Indsæt scriptet

Indsæt linjen i <head> på alle sider – også kvitteringssiden.

<script src="https://app.affilyflow.com/track.js" data-store="DIN_BUTIK" async></script>

DIN_BUTIK er butikkens id. Den rigtige linje med jeres id står under Opsætning i butikkens dashboard – kopier den derfra.

Brug async: scriptet må aldrig holde siden tilbage. Undtagelsen er den kodefri lead-trigger (data-lead-url), hvor linjen skal være uden async – se Lead uden kode.

Attributter

Hvad scriptet gemmer

Når en kunde lander med ?afid= i adressen, gemmer scriptet klik-id'et både som cookie og i localStorage, så det overlever, at den ene af dem ryddes.

• Levetid: højst 90 dage fra klikket. Cookiens max-age er altid den resterende tid af de 90 dage.
• Genbesøg forlænger aldrig vinduet. Ved hvert besøg skrives cookie og localStorage igen med den resterende tid, så en slettet cookie genskabes fra localStorage – men tidspunktet er altid klikkets.
• localStorage gemmer værdien som { v, t } – værdien og tidspunktet for klikket. En værdi over 90 dage gammel slettes ved læsning.
• Cookien sættes med path=/ og SameSite=Lax, og med Secure på https.
• Domænet: cookien lægges på det bredeste domæne, browseren tillader (shop.dk frem for www.shop.dk), så klikket følger med til en kvittering på et andet subdomæne. Scriptet finder det med en kortvarig testcookie (_af_d), der slettes med det samme. På en IP-adresse eller localhost bruges den præcise host.
• Hukommelsen: klik-id'et fra adressen ligger også i sidens hukommelse, så et salg på samme side virker, selvom lageret er blokeret (fx et privat vindue).

Kun Affilyflows klik-id'er

Kun et afid, der ligner vores (c_ efterfulgt af 4–64 tegn: bogstaver, tal, _ og -), gemmes. Bruger butikken også et andet netværk med en parameter, der hedder afid, kan den fremmede værdi derfor aldrig overskrive et Affilyflow-klik.

affilyflow.conversion()

Meld et salg fra JavaScript. Kaldet virker kun, når track.js er indlæst på siden.

affilyflow.conversion({ order: '1008', total: 499, currency: 'DKK' });

Sådan opfører kaldet sig:

• Uden et affiliateklik i browseren sendes intet – og der skrives ingen fejl. Et almindeligt køb uden affiliate er ikke en fejl.
• Salget sendes med navigator.sendBeacon, så det kommer frem, selvom siden skifter med det samme bagefter. Uden sendBeacon bruges en usynlig billed-anmodning.
• Med data-consent="required" venter kaldet, til samtykket er afklaret, og sendes først derefter.
• Til et lead-program: affilyflow.conversion({ order: 'lead_' + Date.now() }) – intet beløb.

<script>
  (function () {
    var tries = 0;
    (function send() {
      if (!window.affilyflow) { if (tries++ < 50) setTimeout(send, 200); return; }
      affilyflow.conversion({ order: '1008', total: 499, currency: 'DKK' });
    })();
  })();
</script>

Beløb som tekst

Et tal bruges, som det er. Tekst, der er et gyldigt maskintal, bruges også, som den er. Anden tekst renses: alt andet end cifre, punktum, komma og minus fjernes, og den sidste separator er decimaltegnet. Står der kun en separator med præcis tre cifre efter, er den tusindtal.

Pladsholdere, der afvises

Står skabelonens pladsholder stadig i order, sendes salget uden ordrenummer – en pladsholder må aldrig optage et ordrenummer, så alle senere salg blev afvist som dubletter. Disse værdier regnes som pladsholdere (store og små bogstaver er ligegyldige):

• DIN_ORDRE_ID, DIT_ORDRE_ID, ORDRE_ID, ORDER_ID, YOUR_ORDER_ID, ORDERID
• XX, XXX osv. (to eller flere X)
• Alt i {{ … }}, [ … ], < … > eller % … % – en skabelonvariabel, der ikke blev udfyldt

Serveren bruger samme regel.

Dubletværn i browseren

Serveren tæller aldrig samme ordrenummer to gange i samme program. Browseren husker desuden, hvad den har sendt, så en genindlæst kvittering ikke sender igen:

• Med ordrenummer: gemt i localStorage (af_sent) i 30 dage.
• Uden ordrenummer: gemt i sessionStorage (af_sent_s) som side og beløb – samme kvittering med samme beløb sendes en gang pr. fane.

affilyflow.consent()

Butikkens egen samtykkeløsning kan styre scriptet direkte. Det er kun relevant med data-consent="required".

affilyflow.consent(true);  // gem klikket fra adressen, og send ventende salg
affilyflow.consent(false); // slet af_click, af_store, af_aff og af_sent

Siger den besøgende ja igen på samme side, gemmes klikket fra adressen igen.

Samtykke

Med data-consent="required" gemmer scriptet intet i browseren – ingen cookie, intet localStorage eller sessionStorage, ingen testcookie – før der er givet samtykke til marketing. Indtil da ligger klikket kun i sidens hukommelse og bruges ikke. Uden attributten opfører scriptet sig som før.

<script src="https://app.affilyflow.com/track.js" data-store="DIN_BUTIK" data-consent="required" async></script>

Scriptet læser selv samtykket fra:

• Et ja virker, uanset om banneret svarer før eller efter scriptet. Cookie Informations, Cookiebots og Shoporamas hændelser lyttes på hele tiden. window.affilyflowConsent tjekkes ved indlæsning og de første 10 sekunder, og TCF bruges, når dens API findes inden for de 10 sekunder.
• Et nej sletter kun ved en aktiv handling (Cookie Informations og Cookiebots hændelser, TCF's useractioncomplete eller affilyflow.consent(false)) – aldrig fordi banneret endnu ikke har læst sin egen cookie.
• Sætter I window.affilyflowConsent senere end 10 sekunder efter indlæsning, så kald affilyflow.consent(true) i stedet.

Se Samtykke og cookies for opsætningen.

Lead uden kode

Til lead-programmer kan scriptet selv melde et lead, når kunden når tak-siden. Sæt adressen i data-lead-url, og fjern async, så leadet sendes, før tak-siden eventuelt viderestiller.

<script src="https://app.affilyflow.com/track.js" data-store="DIN_BUTIK" data-lead-url="/tak"></script>

• /tak rammer /tak og /tak/…, men ikke /takeaway.
• En fuld adresse (https://shop.dk/tak) læses som stien.
• Står der parametre (/tak?type=lead), skal de alle findes i sidens adresse.
• Forsiden alene (/) matcher kun, når der også står parametre.
• Leadet meldes en gang pr. session og kun med et affiliateklik i browseren.

Fejl i konsollen

track.js skriver kun i browserens konsol, når et salg ikke kunne meldes fra salgslinjen eller Google Analytics:

Se Test og fejlfinding for at teste hele vejen med testlinket.

Safari og iPhone

Safari (ITP) sletter cookies og localStorage, der er sat fra JavaScript, efter cirka 7 dage uden besøg på siden. track.js genskriver lageret ved hvert besøg, men kan og skal ikke omgå grænserne. Kun en cookie sat af butikkens egen server – fx WooCommerce-pluginnet – lever længere. Det gælder alle netværk, ikke kun Affilyflow.

Ældre direkte links

Links med ?aff= (eller ?aff_id=) og ?store= i stedet for ?afid= virker stadig. Scriptet tæller klikket og gemmer af_aff og af_store. data-store vinder altid over ?store= i adressen, så en butik, der selv bruger ?store=, ikke får sine salg afvist.