DataFirefly Affiliate Program: affiliateprogramma voor PrestaShop

Installatie

Installeer de module via Modules > Modulebeheer > Een module uploaden door het ZIP-bestand te sturen, of kopieer de map dfaffiliate naar de map /modules/ van uw winkel en klik op Installeren.

Bij de installatie maakt de module haar tabellen aan, slaat de standaardinstellingen op en voegt onder Verkopen een menu Affiliation toe met vijf items: Affiliates, Commissies, Overzichten en uitbetalingen, Commissieregels en Instellingen. De knop Configureren in Modulebeheer opent de instellingenpagina, die begint met een overzicht van het programma.

Om van versie 1.0.0 naar 1.1.0 te gaan, uploadt u gewoon de nieuwe ZIP: het updatescript voegt de nieuwe instellingen en hooks toe zonder bestaande affiliates, commissies of overzichten te wijzigen.

Eerste instellingen

Controleer minstens deze punten voordat u de eerste affiliates uitnodigt:

• Standaard commissiewaarde: 10 % van de producten excl. btw na installatie, of een vast bedrag per bestelling.
• Levensduur van de cookie: standaard 30 dagen, de termijn tussen klik en bestelling.
• Commissie goedkeuren bij en Commissie afwijzen bij: de bestelstatussen die de betaling bevestigen, en die welke annuleren (geannuleerd, terugbetaald, betalingsfout).
• Wachttijd: standaard 30 dagen. Een goedgekeurde commissie komt pas na deze termijn op een overzicht, om retouren op te vangen.
• Minimale uitbetaling: daaronder wordt het saldo naar de volgende maand doorgeschoven.
• Bedrijfsnaam, IBAN en BIC: nodig om het SEPA-overschrijvingsbestand te maken.

Tracking en toewijzing

Trackinglinks

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

• de trackingparameter, toe te voegen aan elk adres van de winkel: ?aff=CODE. De naam van de parameter wijzigt u in de instellingen, bijvoorbeeld in ref;
• korte links die de affiliate in zijn omgeving maakt op basis van het adres van een product, een categorie of een willekeurige pagina. Ze sturen door naar de gekozen pagina en tellen klikken en bestellingen per link.

Bij de klik legt een ondertekende cookie (dfaff_ref) de affiliate vast. De handtekening voorkomt dat een bezoeker hem wijzigt. Zoekmachinebots, geautomatiseerde browsers en eigen klikken van de affiliate tellen niet mee, en dezelfde bezoeker telt maar één keer per 30 minuten. Er wordt geen IP-adres in leesbare vorm opgeslagen.

Volgorde van toewijzing van een bestelling

1. De persoonlijke kortingscode van een affiliate die in de bestelling is gebruikt, ook zonder klik.
2. De link of cookie: de winkelwagen wordt tijdens het bezoek aan de affiliate gekoppeld, wat ook betalingen dekt die de bank later bevestigt.
3. Een eerder aangebrachte klant van deze affiliate, als de instelling Commissies op terugkerende klanten hoger is dan 0 dagen.

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

Beveiligingen

• Een affiliate verdient geen commissie op eigen bestellingen, herkend via klantaccount en e-mailadres.
• Alleen nieuwe klanten: alleen de eerste bestelling van een klant levert commissie op.
• Minimaal bestelbedrag: producten excl. btw na kortingen, 0 voor geen minimum.

Commissies

Berekening

De basis is het productbedrag excl. btw. Met Kortingen aftrekken worden de kortingsbonnen van de bestelling van de basis afgetrokken; een bon voor gratis verzending verandert niets. Verzendkosten tellen nooit mee. Het bedrag wordt omgerekend naar de standaardvaluta van de winkel.

Het toegepaste percentage is, in deze volgorde: de specifieke commissie van de affiliate als die bestaat, anders het programmapercentage. Bij percentages vervangen product- en daarna categorieregels het percentage regel per regel. Bij een vast bedrag ontstaat één commissie per bestelling, en maar één wanneer PrestaShop een winkelwagen voor meerdere vervoerders in meerdere bestellingen splitst.

Regels per categorie en per product

Het tabblad Commissieregels legt een percentage vast voor een categorie of een product, bijvoorbeeld 3 % op elektronica en 15 % op accessoires. Een productregel gaat voor op een categorieregel. Bij categorieën kijkt de module eerst naar de standaardcategorie van het product, daarna naar de beste van zijn andere categorieën. Een percentage van 0 sluit de producten uit van commissie. Regels gelden alleen voor commissies in procenten.

Levenscyclus

• Bij de bestelling wordt de commissie aangemaakt als In afwachting.
• Bereikt de bestelling een goedkeuringsstatus, dan wordt ze Goedgekeurd en start de goedkeuringsdatum de wachttijd.
• Gaat de bestelling naar een annuleringsstatus, dan wordt ze Afgewezen.
• Een gedeeltelijke creditnota verlaagt de commissie naar verhouding van het terugbetaalde productbedrag.
• Staat de commissie al op een overzicht of is ze betaald, dan wijzigt de module haar niet meer: er komt een negatieve correctie die zonder wachttijd van het volgende overzicht wordt afgetrokken. Een tweede annuleringsstatus op dezelfde bestelling leidt niet tot een nieuwe aftrek.

Handmatige commissies

Op het tabblad Commissies crediteert of debiteert Handmatige commissie toevoegen een affiliate (negatief bedrag voor een aftrek), met een notitie die in zijn omgeving zichtbaar is. Deze regels volgen dezelfde overzichtscyclus als bestelcommissies.

Affiliates

Aanmeldingen

De openbare programmapagina toont uw voorwaarden (percentage, cookieduur, minimale uitbetaling), drie stappen en een FAQ die uit uw instellingen wordt opgebouwd. De presentatietekst bewerkt u in de instellingen, per taal. Kiest u een CMS-pagina met de programmavoorwaarden, dan moet de kandidaat die accepteren.

De kandidaat moet ingelogd zijn met een klantaccount. Hij geeft aan waar hij publiceert, beschrijft zijn publiek en optioneel zijn bedrijf. Standaard wacht elke aanmelding op uw goedkeuring en ontvangt het notificatie-e-mailadres een bericht. Met Aanmeldingen automatisch goedkeuren is het account meteen actief.

Affiliatefiche

De fiche begint met een samenvatting (klikken, bestellingen, openstaande, verschuldigde en betaalde commissies) en de trackinglink om te kopiëren, gevolgd door drie blokken:

• Identiteit en kanaal: naam, e-mail, website, publiek, status en interne notitie. De status op Goedgekeurd zetten stuurt de e-mail „Uw affiliate-account is actief”.
• Tracking en commissie: affiliatecode, specifieke commissie, eigen cookieduur, persoonlijke kortingscode. Bestaat de code nog niet en geeft u een kortingspercentage op, dan wordt de winkelwagenregel automatisch aangemaakt, beperkt tot één gebruik per klant.
• Betaalgegevens: SEPA-overschrijving of PayPal, rekeninghouder, IBAN, BIC, PayPal-e-mail.

U kunt een affiliate zonder klantaccount aanmaken: hij krijgt zijn overzichten per e-mail maar heeft geen online omgeving. Gebruikt een klantaccount hetzelfde e-mailadres, dan wordt het automatisch gekoppeld.

Een affiliate met openstaande commissies of een onbetaald overzicht kan niet worden verwijderd: schort hem op of vereffen eerst het saldo.

Wat de affiliate ziet

• Mijn account: een tegel „Affiliate-omgeving”, of „Word affiliate” voor een klant die het nog niet is.
• Overzicht: linkgenerator, cijferbalk (klikken, bestellingen, conversie, in afwachting, goedgekeurd, betaald), grafiek van de laatste 30 dagen, voorwaarden en recente links.
• Mijn links: alle korte links met klikken, bestellingen, kopiëren en verwijderen.
• Commissies: datum, gemaskeerde bestelreferentie, bron, basis, commissie, status, filter op status en verwachte uitbetaalmaand. Er worden geen klantgegevens getoond.
• Overzichten: één overzicht per maand, te bekijken en af te drukken als pdf.
• Betaalgegevens: keuze tussen overschrijving en PayPal, IBAN gecontroleerd op controlecijfers en gemaskeerd getoond. Een stip en een melding wijzen op ontbrekende gegevens.
• Productpagina: een kader „Uw affiliatelink”, alleen zichtbaar voor de ingelogde affiliate, toont de productlink en het percentage dat hij erop verdient.

Overzichten en uitbetalingen

Overzichten aanmaken

Een overzicht bundelt voor één affiliate en één maand de goedgekeurde commissies die vóór het einde van de maand zijn ontstaan en waarvan de wachttijd voorbij is, plus negatieve correcties. Ligt het totaal onder de minimale uitbetaling, dan wordt niets aangemaakt en wordt het saldo doorgeschoven.

Twee manieren om overzichten aan te maken:

• Overzichten en uitbetalingen > Maandoverzichten aanmaken: kies de maand, bekijk de bedragen per affiliate in het voorbeeld, maak dan de overzichten aan en verstuur de e-mails.
• De cron-URL in het overzicht van de instellingen. Roep hem één keer per dag aan: tussen de 1e en de 5e van de maand maakt hij de overzichten van de vorige maand aan. Voeg &period=JJJJ-MM toe om een bepaalde maand te forceren. Hij is beveiligd met een token.

Affiliates uitbetalen

Selecteer in de lijst de te betalen overzichten en gebruik de gewenste bulkactie:

• SEPA-overschrijvingsbestand exporteren (XML): bestand pain.001.001.03 om in uw bank te importeren, voor affiliates die per overschrijving worden betaald. Vereist EUR als standaardvaluta en het IBAN van het bedrijf.
• PayPal Payouts-bestand exporteren (CSV): voor PayPal-bulkbetalingen aan affiliates die via PayPal worden betaald.
• Exporteren voor de boekhouding (CSV): alle geselecteerde overzichten, gescheiden door puntkomma’s.

Betalingsexports worden geweigerd, met een melding die het betrokken overzicht noemt, als een geselecteerd overzicht al betaald is of als een IBAN ontbreekt of ongeldig is: een onvolledig bestand zou een affiliate onbetaald laten, en een betaald overzicht zou twee keer betaald kunnen worden.

Na de overschrijving markeert u de overzichten als betaald, in bulk of vanuit het detail van een overzicht met betalingsreferentie en datum. De betrokken commissies gaan naar Betaald.

E-mails

De module verstuurt vier e-mails, vertaald in 8 talen en verzonden in de taal van de ontvanger, bedragen inbegrepen:

• Nieuwe affiliate-aanmelding, naar het notificatieadres.
• Uw affiliate-account is actief, met de link naar de affiliate-omgeving.
• Nieuwe verkoop, met commissie, basis en percentage, nooit met klantgegevens. Uit te schakelen in de instellingen en door elke affiliate in zijn betaalgegevens.
• Overzicht beschikbaar, met het bedrag en de link naar het overzicht.

De sjablonen staan in de map mails/ van de module en zijn aan te passen zoals elke PrestaShop-e-mail.

Back-office

• Overzicht (instellingenpagina): actieve affiliates, te beoordelen aanmeldingen, klikken, bestellingen en omzet over 30 dagen, openstaande, verschuldigde en betaalde commissies, beste affiliates.
• Bestelpagina: een kader toont de affiliate, de commissie, haar status en haar bron.
• CSV-export van de lijsten met affiliates en commissies, met ruwe bedragen voor een spreadsheet.

AVG en verwijdering van accounts

De module meldt zich aan bij de officiële AVG-module van PrestaShop. De gegevensexport van een klant bevat zijn affiliateprofiel en commissies. Verwijdering anonimiseert de affiliate (naam, e-mail, IBAN, website en publiek gewist, links en klikken verwijderd) en bewaart commissies en overzichten voor de boekhouding.

Verwijdert een medewerker een klantaccount, dan blijft de gekoppelde affiliate bestaan zonder online account en blijven zijn betaalgegevens staan.

Probleemoplossing

Er worden geen klikken geteld

Test in een privévenster, zonder ingelogd te zijn met het account van de affiliate: zijn eigen klikken worden genegeerd. Geautomatiseerde browsers worden als bots gefilterd. Gebruikt uw winkel een full-page cache, dan voert een pagina uit de cache geen PHP uit en wordt de parameter ?aff= niet gezien: gebruik korte links, die altijd via PrestaShop lopen, of sluit de parameter uit van de cache.

Een commissie blijft in afwachting

Controleer of de huidige bestelstatus is aangevinkt bij Commissie goedkeuren bij. Heeft een medewerker zonder het recht Bekijken op de module (Geavanceerde parameters > Team > Machtigingen) de status gewijzigd, dan heeft PrestaShop de module niet uitgevoerd: zet de bestelling opnieuw op die status met een beheerdersaccount.

De linkgenerator weigert een adres

De generator accepteert alleen adressen van uw winkel. Plak het volledige adres zoals het in de browser staat, op het domein van de winkel.

De SEPA-export wordt geweigerd

Lees de melding: die noemt het al betaalde overzicht of de affiliate zonder IBAN. Deselecteer het of vul de gegevens aan. Controleer ook of bedrijfsnaam en IBAN van het bedrijf zijn ingevuld.

Compatibiliteit

• PrestaShop 8.0 tot 9.x, hetzelfde ZIP-bestand voor beide versies.
• Meertalig en met meerdere valuta, commissies berekend in de standaardvaluta.
• Architectuur ModuleAdminController, zonder Composer-afhankelijkheid.
• Module en e-mails vertaald in het Engels, Frans, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.