PS PrestaShop Beginner

DataFirefly Affiliate Program: affiliateprogramma voor PrestaShop

Het affiliateprogramma installeren, instellen en beheren: dashboard, linktracking, commissies met validatieperiode, regels en simulator, SEPA- of PayPal-overzichten, affiliate-account en promotiemateriaal.

Bijgewerkt Moduleversie 2.0.0

Installatie en update

Installeer de module via Modules > Modulebeheer > Een module uploaden door het ZIP-bestand te uploaden. Hetzelfde ZIP-bestand werkt op PrestaShop 1.7.8, 8 en 9.

Bij de installatie maakt de module zijn tabellen en standaardinstellingen aan en voegt het menu Verkopen > Affiliate toe met zeven items: Dashboard, Affiliates, Commissies, Overzichten en uitbetalingen, Commissieregels, Promotiemateriaal en Instellingen. Met een gemeenschappelijk menu bovenaan elke pagina gaat u van de ene naar de andere pagina.

Om van versie 1.0.0 of 1.1.0 naar 2.0.0 te gaan, uploadt u gewoon het nieuwe ZIP-bestand. Het updatescript behoudt de affiliates, links, klikken, commissies, overzichten, regels en instellingen, en voegt de nieuwe functies toe:

  • al opgeslagen IBAN’s worden versleuteld;
  • commissies die nog binnen hun termijn vallen, gaan naar de stap “Validatieperiode”;
  • de nieuwe instellingen krijgen hun standaardwaarde.

Controleer voordat u het programma opent in Instellingen welke bestelstatus(sen) de betaling bevestigen, de validatieperiode en de minimale uitbetaling. Het Dashboard toont daarna een configuratiecontrole die aangeeft wat er ontbreekt.

Dashboard

Dashboard van het affiliateprogramma: kliks, toegewezen bestellingen, gegenereerde omzet, te betalen commissies en taken
Dashboard van het affiliateprogramma: kliks, toegewezen bestellingen, gegenereerde omzet, te betalen commissies en taken

Het dashboard vat de activiteit samen over 7 dagen, 30 dagen, 90 dagen of 12 maanden:

  • Kerncijfers: klikken en unieke bezoekers, toegewezen bestellingen en klikconversie, gegenereerde omzet (commissiebasis van de bestellingen, zonder verzendkosten), verdiende commissies en hun aandeel in de omzet, te betalen commissies, actieve affiliates, bestellingen die zijn geweigerd wegens eigen verwijzing of dubbele beloning.
  • Grafiek van klikken en omzet per dag, of per maand over 12 maanden.
  • Waar de commissies staan: wacht op betaling van de bestelling, in validatieperiode, uitbetaalbaar, op te betalen overzichten, betaald.
  • Te doen: te beoordelen aanmeldingen, wachtende commissies, aan te maken of te betalen overzichten, affiliates zonder betaalgegevens, elk met een knop die de juiste lijst opent.
  • Configuratiecontrole, beste affiliates, meest aangeklikte links en laatste commissies.

Tracking en attributie

Elke affiliate heeft een code. Twee soorten links bevatten die code:

  • de trackingparameter, toegevoegd aan elk willekeurig adres van de winkel: ?aff=CODE. De naam van de parameter wijzigt u in de instellingen;
  • de korte links /go/… die de affiliate in zijn account aanmaakt. Ze verwijzen door naar de gekozen pagina en tellen de klikken en bestellingen per link. Alleen adressen van de winkel worden geaccepteerd: een link kan nooit naar een andere website verwijzen.

De attributiecookie

Bij een klik slaat de cookie dfaff_ref de affiliate op. De cookie is ondertekend (een bezoeker kan hem niet wijzigen), HttpOnly en SameSite=Lax, en de looptijd stelt u in bij de instellingen of per affiliate. De attributie wordt ook op de winkelwagen opgeslagen, zodat betalingen die de bank later bevestigt ook worden meegeteld.

Nooit meegeteld worden:

  • robots en linkvoorbeelden van sociale netwerken en berichtenapps;
  • voorladen door de browser en HEAD-verzoeken;
  • klikken van de affiliate zelf;
  • herladen pagina’s en herhaalde klikken van dezelfde bezoeker op dezelfde link binnen het gekozen tijdvenster (standaard 30 minuten).
Trackinginstellingen: URL-parameter, cookieduur, laatste of eerste klik, herhaalde kliks en wachten op toestemming
Trackinginstellingen: URL-parameter, cookieduur, laatste of eerste klik, herhaalde kliks en wachten op toestemming

De instelling Attributiecookie en toestemming biedt twee mogelijkheden:

  • cookie bij elk gevolgd bezoek plaatsen;
  • wachten op toestemming: de cookie wordt alleen geplaatst als de cookie van uw cookiebanner aanwezig is en de opgegeven tekst bevat, bijvoorbeeld tarteaucitron en dfaffiliate=true. Zonder toestemming wordt de klik wel meegeteld in de statistieken, maar kan alleen een kortingscode van de affiliate de bestelling toewijzen.

Hoe deze cookie wettelijk moet worden behandeld, hangt af van uw land en uw gebruik: laat dit controleren door uw adviseur. De module garandeert geen enkele naleving van regelgeving.

Volgorde van attributie van een bestelling

  1. De persoonlijke kortingscode van een affiliate die in de bestelling is gebruikt, ook zonder klik.
  2. De link of de cookie.
  3. Een klant die al eerder door deze affiliate is aangebracht, als commissies op terugkerende klanten zijn ingeschakeld.

Het attributiemodel bepaalt wat er gebeurt als een bezoeker op de links van twee affiliates klikt: bij laatste klik (standaard) wint de laatst bezochte affiliate; bij eerste klik houdt de eerste affiliate de verkoop tot de cookie verloopt.

Commissies

Levenscyclus van een commissie

Commissies per fase: wacht op betaling, validatieperiode tot een datum, uitbetaalbaar, betaald of geweigerd
Commissies per fase: wacht op betaling, validatieperiode tot een datum, uitbetaalbaar, betaald of geweigerd
  1. Wacht op betaling van de bestelling: de bestelling is geplaatst. Een bestelling die per overschrijving of cheque wordt betaald, blijft in deze stap tot u de betaling bevestigt.
  2. Validatieperiode: de bestelling bereikt een status die de betaling bevestigt. De commissie wacht het gekozen aantal dagen (standaard 30) om de herroepingstermijn en retouren te dekken. De einddatum wordt getoond.
  3. Uitbetaalbaar: de periode is verstreken, de commissie komt op het volgende overzicht.
  4. Op een overzicht, daarna Betaald zodra u het overzicht als betaald markeert.

Validatieperiodes worden automatisch afgesloten: door de cron-taak als u die gebruikt, anders zodra de back-office van de module of het affiliate-account wordt geopend.

Bijzondere gevallen:

  • Bestelling geannuleerd of terugbetaald: de commissie wordt afgewezen zolang ze niet is uitbetaald. Als de bestelling daarna opnieuw wordt betaald, komt de commissie terug met een nieuwe validatieperiode.
  • Gedeeltelijke terugbetaling (creditnota): de commissie wordt verlaagd naar verhouding van de terugbetaalde producten.
  • Na uitbetaling: de module raakt de uitbetaalde commissie niet meer aan en maakt een negatieve correctie aan, die van het volgende overzicht wordt afgetrokken. Een tweede statuswijziging leidt niet tot een nieuwe inhouding.
  • Eén commissie per bestelling: de bevestigingspagina opnieuw laden, twee betalingsmeldingen ontvangen of meerdere keren dezelfde status doorlopen leidt nooit tot een dubbele commissie (vergrendeling en unieke sleutel in de database).

In de lijst met commissies beëindigt de bulkactie Nu goedkeuren de validatieperiode van de geselecteerde commissies. Bestellingen die nog niet zijn betaald, worden geweigerd en hun referentie wordt vermeld.

Berekening

  • Basis: producten exclusief of inclusief btw (naar keuze), nooit de verzendkosten.
  • Kortingsbonnen: naar verhouding per regel afgetrokken als de optie is ingeschakeld. Een bon voor gratis verzending wordt niet afgetrokken.
  • Valuta: bestellingen in een andere valuta worden omgerekend met de koers die bij de bestelling is opgeslagen.
  • Afronding: één keer per bestelling, op de cent.
  • Vast bedrag: één commissie per bestelling, en ook maar één wanneer PrestaShop een winkelwagen in meerdere bestellingen opsplitst.
  • Terugkerende klanten: gedurende het gekozen aantal dagen leveren volgende bestellingen van een aangebrachte klant een commissie op, tegen het percentage van de affiliate of een specifiek percentage.

Geen enkel bedrag komt uit de browser: alles wordt opnieuw berekend op basis van de bestelling die PrestaShop heeft opgeslagen.

Commissieregels en simulator

Regelsimulator: een bestelling regel voor regel nagerekend, toegepast tarief en de regel die geldt
Regelsimulator: een bestelling regel voor regel nagerekend, toegepast tarief en de regel die geldt

Een regel legt een percentage vast voor een categorie of een product, voor alle affiliates of voor één affiliate. Voor elke bestelregel geldt de volgende prioriteit:

  1. productregel;
  2. regel van de standaardcategorie van het product;
  3. beste regel van de andere categorieën;
  4. percentage van de affiliate of van het programma.

Een regel voor één affiliate gaat voor op dezelfde regel voor iedereen. Een regel kan het percentage vervangen (een regel op 0 % sluit de producten uit) of erbij optellen: een affiliate met 10 % en een regel “+2” krijgt 12 %, met een maximum van 100 %. Regels gelden niet voor vaste bedragen.

De regelsimulator, bovenaan de pagina met regels, beantwoordt de vraag “welk percentage geldt, en waarom?” voor een product en een affiliate, of speelt een bestaande bestelling regel voor regel opnieuw af, zonder iets aan te maken.

Handmatige commissies

Handmatige commissie toevoegen crediteert of debiteert een affiliate (negatief bedrag voor een aftrek), met een notitie die in zijn account zichtbaar is.

Fraude en dubbele beloningen

Fraude en uitbetalingen: adresvergelijking, samenwerking met het doorverwijsprogramma, minimale uitbetaling en SEPA-bestand
Fraude en uitbetalingen: adresvergelijking, samenwerking met het doorverwijsprogramma, minimale uitbetaling en SEPA-bestand
  • Een bestelling die is geplaatst met hetzelfde klantaccount, hetzelfde e-mailadres of, als de optie is ingeschakeld, die naar een adres van de affiliate wordt geleverd of gefactureerd, wordt opgeslagen als geweigerd, met een reden die de verkoper en de affiliate kunnen lezen.
  • Als de module DataFirefly Loyalty & Referral actief is, levert een bestelling die al een verwijzer beloont geen affiliatecommissie op (instelling aanpasbaar). De gegevens van de verwijzingsmodule worden alleen gelezen, nooit gewijzigd. De twee modules gebruiken verschillende URL-parameters en cookies.
  • Alleen nieuwe klanten en minimaal bestelbedrag vullen deze bescherming aan.

Affiliates

Aanmeldingen

Openbare pagina van het affiliateprogramma: presentatie, voorwaarden, stappen en antwoorden op vragen
Openbare pagina van het affiliateprogramma: presentatie, voorwaarden, stappen en antwoorden op vragen

De openbare pagina van het programma toont uw voorwaarden (percentage, looptijd van de cookie, validatieperiode, minimale uitbetaling), de stappen en veelgestelde vragen die op basis van uw instellingen worden gegenereerd. De presentatietekst bewerkt u per taal.

Aanvraagformulier: website of kanaal, publiek en aanvaarding van de voorwaarden, daarna beoordeeld door de handelaar
Aanvraagformulier: website of kanaal, publiek en aanvaarding van de voorwaarden, daarna beoordeeld door de handelaar

De kandidaat moet ingelogd zijn met een klantaccount. Hij geeft aan waar hij publiceert en beschrijft zijn publiek. Als er een CMS-pagina met voorwaarden is gekozen, moet hij die accepteren. Standaard wacht elke aanmelding op uw goedkeuring en ontvangt het meldingsadres een e-mail.

Lijst en affiliatepagina

Lijst van affiliates: code, kanaal, status, kliks, bestellingen en saldi, aanvragen in bulk goedkeuren
Lijst van affiliates: code, kanaal, status, kliks, bestellingen en saldi, aanvragen in bulk goedkeuren

De lijst toont de code, het kanaal, de status, de klikken, de bestellingen en de saldi. Met bulkacties keurt u meerdere aanmeldingen tegelijk goed, wijst u ze af of schort u ze op. De CSV-export neutraliseert cellen die een spreadsheetprogramma als formule zou kunnen lezen.

Volledige affiliatepagina: kerncijfers, saldo per fase, voorwaarden, gemaskeerde IBAN, links, commissies, overzichten en persoonsgegevens
Volledige affiliatepagina: kerncijfers, saldo per fase, voorwaarden, gemaskeerde IBAN, links, commissies, overzichten en persoonsgegevens

De affiliatepagina brengt op één pagina samen:

  • het profiel, met de knoppen Goedkeuren, Afwijzen, Opschorten en Bewerken;
  • de kerncijfers en het saldo per stap;
  • de voorwaarden (percentage, eigen regels, cookie, kortingscode) en de trackinglink;
  • de betaalgegevens, met gemaskeerd IBAN;
  • de aanmelding;
  • de links van de laatste 30 dagen, de laatste commissies en de overzichten.

Het blok Persoonsgegevens exporteert in JSON wat de module over de affiliate bewaart. U kunt de affiliate er ook mee anonimiseren: naam, e-mail, website, betaalgegevens, links en klikken worden gewist, en de commissies en overzichten blijven bewaard voor uw boekhouding.

In het bewerkingsformulier wordt het IBAN nooit opnieuw leesbaar getoond: laat het veld leeg om het opgeslagen IBAN te behouden, of vul een nieuw IBAN in.

Wat de affiliate ziet

Affiliate-omgeving: saldi in validatie, uitbetaalbaar en betaald, trackinglink, statistieken van de laatste 30 dagen en voorwaarden
Affiliate-omgeving: saldi in validatie, uitbetaalbaar en betaald, trackinglink, statistieken van de laatste 30 dagen en voorwaarden

Het affiliate-account opent met een kop die de code, het percentage en de saldi (in validatie, uitbetaalbaar, betaald) toont, gevolgd door zes tabbladen. Het werkt met de thema’s Classic en Hummingbird.

  • Overzicht: linkgenerator, kerncijfers, grafiek van de laatste 30 dagen, voorwaarden en recente links.
  • Linkgenerator: aanmaken van een korte link naar elke pagina van de winkel, lijst van links met klikken, bestellingen, kopiëren en verwijderen.
  • Statistieken: klikken, bestellingen, conversie, verkopen en commissies over 7 dagen tot 12 maanden, herkomst van de klikken en prestaties per link.
  • Commissies: stap van elke commissie, verwachte uitbetalingsdatum, gemaskeerde bestelreferentie. Er worden geen klantgegevens getoond.
  • Betalingen: maandoverzichten die kunnen worden bekeken en afgedrukt, keuze tussen SEPA-overschrijving en PayPal, IBAN gecontroleerd op de controlecijfers, versleuteld en gemaskeerd getoond, e-mails bij verkopen.
  • Promotiemateriaal: kant-en-klare banners en teksten, met de trackinglink van de affiliate er al in verwerkt.
Linkgenerator: korte link naar elke pagina van de winkel, kliks en bestellingen per link
Linkgenerator: korte link naar elke pagina van de winkel, kliks en bestellingen per link
Statistieken van de affiliate: kliks, bestellingen, conversie, gegenereerde verkopen per periode, bron en link
Statistieken van de affiliate: kliks, bestellingen, conversie, gegenereerde verkopen per periode, bron en link
Commissiegeschiedenis: fases van betaling tot uitbetaling, gemaskeerd bestelnummer, geen klantgegevens
Commissiegeschiedenis: fases van betaling tot uitbetaling, gemaskeerd bestelnummer, geen klantgegevens
Betalingen van de affiliate: maandoverzichten, SEPA-overschrijving of PayPal, IBAN versleuteld en gemaskeerd getoond
Betalingen van de affiliate: maandoverzichten, SEPA-overschrijving of PayPal, IBAN versleuteld en gemaskeerd getoond

Een affiliate ziet alleen zijn eigen gegevens: zijn links, commissies en overzichten worden bij elke weergave gecontroleerd, en de formulieren zijn beveiligd met een token.

Promotiemateriaal

Promotiemateriaal: banners en teksten voor affiliates, met voorbeeld, formaat en landingspagina
Promotiemateriaal: banners en teksten voor affiliates, met voorbeeld, formaat en landingspagina

Voeg in Promotiemateriaal banners (JPG, PNG, GIF of WebP, maximaal 2 MB) en kant-en-klare teksten toe, met een naam en een alternatieve tekst in elke taal, en de pagina van de winkel waarnaar ze verwijzen. De volgorde stelt u in met slepen en neerzetten.

Promotiemateriaal voor affiliates: banners en tekst met de trackinglink er al in, met één klik gekopieerd
Promotiemateriaal voor affiliates: banners en tekst met de trackinglink er al in, met één klik gekopieerd

Elke affiliate kopieert de HTML-code van de banner, de tekst en de link, met zijn trackinglink er al in. Het tabblad verschijnt alleen in het affiliate-account als er minstens één actief item is.

Overzichten en uitbetalingen

Overzichten en uitbetalingen: maandoverzichten, SEPA- of PayPal-export, betaling slechts één keer gemarkeerd
Overzichten en uitbetalingen: maandoverzichten, SEPA- of PayPal-export, betaling slechts één keer gemarkeerd

De uitbetaling verloopt in vier stappen, die bovenaan de pagina worden herhaald:

  1. Overzichten aanmaken: kies de maand, bekijk vooraf de bedragen per affiliate en maak daarna de overzichten aan. Een overzicht bundelt de uitbetaalbare commissies die vóór het einde van de maand zijn aangemaakt en de negatieve correcties. Onder de minimale uitbetaling wordt het saldo doorgeschoven.
  2. Betalingsbestand exporteren: selecteer de overzichten en daarna de bulkactie SEPA-overschrijvingsbestand exporteren (XML) (pain.001.001.03) of PayPal Payouts-bestand exporteren (CSV). De boekhoudexport in CSV toont het IBAN gemaskeerd.
  3. Betalen via uw bank of PayPal: de module verstuurt nooit zelf geld.
  4. Als betaald markeren, met de referentie en de datum van de overschrijving.
Overzicht van een affiliate: commissieregels, verschuldigd bedrag, gemaskeerde bankgegevens en referentie van de overschrijving
Overzicht van een affiliate: commissieregels, verschuldigd bedrag, gemaskeerde bankgegevens en referentie van de overschrijving

Een betaald overzicht kan niet meer worden geëxporteerd of een tweede keer worden betaald. Een betalingsexport wordt volledig geweigerd als een geselecteerd overzicht al is betaald of als er gegevens ontbreken: de melding noemt de betrokken affiliate en zegt waar u de gegevens kunt aanvullen.

Cron-taak (optioneel)

De cron-URL staat in de instellingen. Hij sluit de validatieperiodes af en maakt, als de optie is ingeschakeld, tussen de 1e en de 5e van de maand de overzichten van de vorige maand aan. Hij is beveiligd met een token, wordt nooit twee keer tegelijk uitgevoerd en betaalt nooit iets uit.

E-mails

De module verstuurt vier e-mails, vertaald in 8 talen en verzonden in de taal van de ontvanger, inclusief onderwerp en bedragen: nieuwe aanmelding (aan de verkoper), affiliate-account geactiveerd, nieuwe verkoop en overzicht beschikbaar.

E-mail „nieuwe verkoop” aan de affiliate: commissie, bestelbedrag en tarief, zonder klantgegevens
E-mail „nieuwe verkoop” aan de affiliate: commissie, bestelbedrag en tarief, zonder klantgegevens
E-mail met het maandoverzicht: periode, bedrag, aantal commissies en link naar het overzicht in de affiliate-omgeving
E-mail met het maandoverzicht: periode, bedrag, aantal commissies en link naar het overzicht in de affiliate-omgeving

De e-mail bij een nieuwe verkoop vermeldt de commissie, het bestelbedrag en het percentage, nooit de gegevens van de klant. Elke affiliate kan deze e-mail uitschakelen. De sjablonen staan in de map mails/ van de module.

Instellingen

De pagina met instellingen is ingedeeld in vijf blokken:

  • Tracking en attributie: URL-parameter, looptijd van de cookie, attributiemodel, tijdvenster tegen dubbele klikken, toestemming, terugkerende klanten.
  • Commissies: standaardtype en -percentage, basis exclusief of inclusief btw, aftrek van kortingsbonnen, alleen nieuwe klanten, minimaal bestelbedrag, statussen die de betaling bevestigen of de commissie afwijzen, validatieperiode.
  • Fraude en dubbele beloningen.
  • Overzichten en uitbetalingen: minimale uitbetaling, overzichten via cron, SEPA-gegevens van het bedrijf.
  • Aanmeldingen en programmapagina: automatische goedkeuring, e-mails, presentatietekst, voorwaardenpagina, accentkleur.

Foutmeldingen geven aan wat u moet corrigeren, bijvoorbeeld “IBAN van het bedrijf: de controlecijfers kloppen niet”.

AVG

De module meldt zich aan bij de officiële AVG-module van PrestaShop. De export van de gegevens van een klant bevat zijn affiliateprofiel en zijn commissies, met gemaskeerd IBAN. Bij verwijdering wordt de affiliate geanonimiseerd, terwijl de commissies en overzichten bewaard blijven. Dezelfde acties zijn beschikbaar via de affiliatepagina. Deze hulpmiddelen helpen u verzoeken te verwerken, maar vormen geen garantie van naleving.

Problemen oplossen

Er worden geen klikken geteld

Test in een privévenster, zonder ingelogd te zijn met het account van de affiliate. Geautomatiseerde browsers worden als robots gefilterd. Met de optie “wachten op toestemming” accepteert u eerst de dienst in uw cookiebanner. Als uw winkel een volledige paginacache gebruikt, gebruik dan de korte links /go/, die altijd via PrestaShop lopen.

Een commissie blijft op “Wacht op betaling van de bestelling” staan

Controleer of de huidige status van de bestelling is aangevinkt bij Bestelling betaald bij. Een bestelling per overschrijving of cheque blijft wachten zolang u de betaling niet hebt bevestigd.

De SEPA-export wordt geweigerd

Lees de getoonde melding: die noemt het al betaalde overzicht of de affiliate van wie het IBAN ontbreekt. Controleer ook de bedrijfsnaam en het IBAN van het bedrijf, en of de euro de standaardvaluta is.

Compatibiliteit

  • PrestaShop 1.7.8, 8 en 9: hetzelfde ZIP-bestand dekt de drie versies, met de thema’s Classic en Hummingbird.
  • Multistore: affiliates, commissies en statistieken gefilterd per winkel. Meerdere valuta’s: omrekening tegen de koers van de bestelling.
  • Module en e-mails in het Engels, Frans, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.
Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support