Geavanceerde affiliatiemodule Affiliate voor Magento 2

Kowal_Affiliate is een uitgebreide module voor affiliateprogramma's voor Magento 2 waarmee u een volledig systeem voor verkooppartners kunt starten zonder een afzonderlijk extern platform te bouwen.
SKU
M2-AFFILIATE
€ 92,25
Email to a Friend

Vraag over dit product

Beschrijving / Geavanceerde affiliatiemodule Affiliate voor Magento 2

1. Wat is deze module

De module breidt Magento 2 uit met een compleet affiliatesysteem dat rechtstreeks binnen de webshop werkt. Dit betekent dat de winkeleigenaar partners, commissies, afrekeningen en promotiematerialen beheert vanuit het eigen beheerpaneel, terwijl partners gebruikmaken van hun eigen dashboard in het klantaccount.

In de praktijk maakt de module het mogelijk om meerdere samenwerkingsmodellen tegelijk te implementeren:

  • een klassiek affiliateprogramma op basis van trackinglinks,
  • een referralprogramma op basis van individuele partnercodes,
  • een hybride model: affiliatelink plus kortingscode,
  • een partnerprogramma voor klanten van de winkel, bureaus, implementatiepartners en creators.

2. Belangrijkste zakelijke waarde

De grootste waarde van de module is de combinatie van verkoop, attributie, afrekeningen en partnerbeheer op één plek. De webshop hoeft geen extern affiliatesysteem te onderhouden, bestellingen handmatig te exporteren of partners in spreadsheets af te rekenen.

De module biedt de winkeleigenaar:

  • een nieuw verkoopkanaal,
  • controle over de samenwerkingsregels,
  • transparante verwerking van commissies en uitbetalingen,
  • duidelijke rapporten over de effectiviteit van affiliates,
  • de mogelijkheid om het programma veilig te starten, ook in middelgrote en grote webshops.

De partner krijgt:

  • een eigen referralcode,
  • een eigen affiliatelink,
  • een kant-en-klaar paneel om activiteiten te monitoren,
  • inzicht in commissies en payouts,
  • de mogelijkheid om promotiematerialen en banners te gebruiken.

3. Voor wie is de module bedoeld

De module is geschikt voor webshops die een netwerk van verkooppartners willen opbouwen zonder externe affiliateplatforms te gebruiken, of die volledige controle over gegevens en het afrekenproces willen behouden.

De module werkt bijzonder goed in projecten waarin het affiliateprogramma wordt uitgevoerd door:

  • klanten die de webshop aanbevelen aan bekenden,
  • online creators,
  • bloggers en uitgevers,
  • specialisten en consultants,
  • implementatiepartners,
  • software houses en bureaus,
  • resellers en B2B-verkopers,
  • merkambassadeurs en communities.

4. Belangrijkste functies van de module

4.1. Registratie van een affiliate

De module stelt een aanmeldformulier voor het affiliateprogramma beschikbaar. De klant kan zich zelfstandig aanmelden voor deelname aan het programma door basiscontactgegevens, het adres van de website of het kanaal en korte informatie over de geplande promotie op te geven.

Na het verzenden van het formulier:

  • wordt een affiliateaccount aangemaakt,
  • wordt een unieke referral_code gegenereerd,
  • wordt de status van de aanmelding ingesteld op Pending,
  • kan de beheerder een melding ontvangen over een nieuwe aanmelding,
  • kan de klant een bevestiging ontvangen dat de aanmelding is ontvangen.

4.2. Partner goedkeuren

De beheerder kan een affiliate goedkeuren vanuit het Magento-paneel. Na acceptatie:

  • verandert de partnerstatus naar Active,
  • kan de partner volledig gebruikmaken van het programma,
  • kan de affiliatecoupon worden geactiveerd,
  • kan de klant een bericht ontvangen over de goedkeuring van deelname.

Elke affiliate krijgt een eigen affiliatelink op basis van referral_code. De link werkt via een trackingcontroller en slaat de attributie van het bezoek op. Na een klik kan het systeem:

  • de affiliatie in een cookie opslaan,
  • een bezoekrecord aanmaken,
  • een attributierecord aanmaken,
  • een latere bestelling koppelen aan een specifieke affiliate.

4.4. Affiliatecode en kortingscoupon

De module ondersteunt ook een model waarin referral_code kan werken als kortingscode in de winkelwagen.

De beheerder kan op het affiliateaccount het veld instellen:

  • Affiliate Coupon Discount (%)

Als de waarde groter is dan nul, doet het systeem het volgende:

  • synchroniseert de native Magento-regel Cart Price Rule,
  • stelt de couponcode gelijk aan referral_code,
  • berekent een procentuele korting in de winkelwagen,
  • behandelt het gebruik van deze code als bron van de affiliate-attributie van de bestelling.

Daardoor kan de affiliate promoten:

  • een gewone affiliatelink,
  • alleen de kortingscode,
  • een combinatie van beide mechanismen tegelijk.

Dit is een van de meest praktische verkoopfuncties van de module, omdat veel winkeleigenaren verwachten dat een partner niet alleen verkeer aanlevert, maar de klant ook een concreet prijsvoordeel biedt.

4.5. Bestellingsattributie

De module kan een bestelling toewijzen aan een affiliate op basis van:

  • een klik op een affiliatelink,
  • actieve attributie die is opgeslagen in de sessie of cookie,
  • het gebruik van een affiliatecode in de winkelwagen,
  • een ingelogde klant die is gekoppeld aan actieve attributie.

Op bestellingsniveau worden de volgende gegevens opgeslagen:

  • affiliate_id,
  • affiliate_attribution_id,
  • affiliate_referral_code,
  • is_affiliate_order,
  • affiliate_commission_amount,
  • affiliate_commission_status.

Dit maakt het mogelijk om de verkoopbron rechtstreeks op quote en sales_order te rapporteren.

4.6. Commissieberekening

De commissie wordt automatisch aangemaakt voor een affiliatebestelling. In het huidige model:

  • wordt de commissie procentueel berekend over het subtotaal van de bestelling,
  • komt het standaardtarief uit de configuratie van de module,
  • voorkomt het systeem dubbele commissies voor dezelfde bestelling en affiliate,
  • wordt het resultaat opgeslagen in de commissietabel en op de bestelling.

Ondersteunde commissiestatussen omvatten onder andere:

  • pending,
  • approved,
  • ready_for_payout,
  • paid,
  • rejected,
  • cancelled,
  • charged_back.

4.7. Hold period en automatische acceptatie

De module ondersteunt een wachttijd voor commissies. Dit betekent dat een commissie niet direct klaar hoeft te zijn voor uitbetaling. Zij kan gedurende een bepaalde periode de status in behandeling behouden en pas na afloop van de ingestelde periode automatisch door cron worden goedgekeurd.

Deze oplossing is vooral belangrijk bij:

  • risico op retouren,
  • handmatige verificatie van bestellingen,
  • verkoopmodellen met uitgestelde afronding,
  • de noodzaak om het programma te beschermen tegen misbruik.

4.8. Uitbetalingen voor affiliates

De partner kan een uitbetalingsverzoek indienen als de minimale drempel is gehaald en er voldoende goedgekeurd saldo beschikbaar is.

De payout-workflow omvat:

  • het indienen van een payout request,
  • het toewijzen van commissies aan de payout,
  • het wijzigen van de commissiestatus naar ready_for_payout,
  • het markeren van de uitbetaling als betaald,
  • het wijzigen van de commissiestatussen naar paid.

Daardoor kan de winkeleigenaar uitbetalingen op een geordende en auditeerbare manier uitvoeren.

4.9. Fraud prevention

De module heeft een basislaag voor antifraude die helpt de meest voor de hand liggende vormen van misbruik te elimineren.

Dit omvat onder andere:

  • het blokkeren van self-referral,
  • het markeren van commissies als afgewezen wanneer misbruik wordt gedetecteerd,
  • de verwerking van fraudecases,
  • een register van afwijzingsredenen,
  • een aparte weergave van fraud cases aan de beheerderszijde.

Daarnaast ondersteunt de module:

  • annuleringen van bestellingen,
  • chargebacks,
  • refunds via creditmemo,
  • wijziging van commissiestatussen na retouren.

4.10. Meldingen

De module heeft een eigen systeem voor het in de wachtrij plaatsen en verwerken van meldingen. Zij kan operationele gebeurtenissen opslaan en e-mailberichten verzenden.

Ondersteunde gevallen zijn onder andere:

  • nieuwe affiliateaanmelding,
  • bevestiging van ontvangst van de aanmelding,
  • acceptatie van de affiliate,
  • commissiegebeurtenissen,
  • payouts,
  • fraud alerts.

4.11. Affiliatepaneel

De partner gebruikt een uitgebreid dashboard in het Magento-klantaccount. Het dashboard is niet alleen een lijst met commissies, maar een volledig operationeel paneel.

In het affiliatepaneel zijn beschikbaar:

  • de deelnamestatus aan het programma,
  • de referralcode,
  • de volledige affiliatelink,
  • het standaard doelpad,
  • een commissieoverzicht,
  • de commissiegeschiedenis,
  • doorgang naar payouts,
  • inhoud met samenwerkingsregels,
  • kant-en-klare promotiesnippets,
  • bannerpreview,
  • AI-bannergenerator.

4.12. AI-bannergenerator

De module bevat een door AI ondersteunde functie waarmee de affiliate op basis van een briefing een kant-en-klare promotiebanner kan voorbereiden.

De gebruiker kan opgeven:

  • een tekstuele briefing,
  • een visuele richting,
  • kleuren,
  • stijl,
  • een optionele URL van een afbeelding,
  • een optionele target link.

Het systeem geeft aan de AI-laag door:

  • de briefing van de gebruiker,
  • referral link,
  • target path,
  • technische eisen voor het antwoordformaat.

De gegenereerde HTML van de banner kan worden opgeslagen op het affiliateaccount en door de partner worden gebruikt als kant-en-klaar promotiemateriaal.

4.13. Rapportage

De module ondersteunt rapporten en CSV-exports voor de belangrijkste onderdelen van het programma:

  • commissies,
  • payouts,
  • fraud cases,
  • AI-insights.

Dit vereenvoudigt zowel de dagelijkse werking van het programma als de analyse van de effectiviteit van partners.

5. Beheerpaneel

De module breidt het Magento-beheerpaneel uit met configuratie en beheer van het affiliateprogramma.

De beheerder heeft toegang tot:

  • globale programma-instellingen,
  • commissie-instellingen,
  • payout-instellingen,
  • instellingen van het affiliateportaal,
  • meldingsinstellingen,
  • fraude-instellingen,
  • AI-instellingen,
  • rapportage-instellingen.

Daarnaast zijn in het paneel operationele secties beschikbaar:

  • Affiliate Commissions,
  • Affiliate Payouts,
  • Affiliate Fraud Cases,
  • Affiliate Reports.

In de klantenlijst en bij het bewerken van een klant zijn affiliategegevens zichtbaar, zoals:

  • deelname aan het programma,
  • affiliatestatus,
  • affiliatesaldo,
  • referralcode,
  • kortingspercentage van de affiliatecoupon.

6. Hoe affiliatie in de praktijk werkt

6.1. Scenario met affiliatelink

  1. De partner ontvangt zijn link.
  2. De klant klikt op de link en komt in de webshop terecht.
  3. Het systeem slaat het bezoek en de attributie op.
  4. De klant plaatst een bestelling.
  5. De bestelling wordt toegewezen aan de affiliate.
  6. Er wordt een commissie aangemaakt.
  7. Na afloop van de hold period kan de commissie worden goedgekeurd.
  8. Na het voldoen aan de voorwaarden kan de partner een uitbetalingsverzoek indienen.

6.2. Scenario met affiliatecode in de winkelwagen

  1. De partner publiceert zijn affiliatecode.
  2. De klant voert de code in de winkelwagen in.
  3. Magento berekent de korting op basis van de winkelwagenregel.
  4. De module herkent de code als affiliatecode.
  5. De bestelling wordt toegewezen aan de affiliate.
  6. De commissie wordt aangemaakt volgens de programmaregels.

6.3. Hybride scenario

De klant kan eerst via een affiliatelink naar de webshop gaan en daarna de kortingscode van de affiliate gebruiken. Dit model maakt het mogelijk om klassieke tracking te combineren met voordelen voor de eindklant.

7. Veiligheidsgebieden

De module is voorbereid met productie-implementatie in gedachten en houdt daarom rekening met:

  • auditregistraties,
  • verwerking van retouren en annuleringen,
  • blokkering van self-referral,
  • meldingenwachtrij,
  • mechanismen die dubbele commissies beperken,
  • veilige opslag van AI-configuratie,
  • beperking van gegevens die naar de AI-laag worden verzonden,
  • mogelijkheid tot diagnose van integratiefouten.

8. Integratie met AI

De AI-laag in de module is optioneel en blokkeert de werking van het basisaffiliateprogramma niet. Deze kan worden gebruikt voor:

  • affiliateassistent,
  • het genereren van insights,
  • het genereren van banners,
  • retrieval van productkennis via vector_store_id.

De module hoeft geen eigen productdatabase voor AI te onderhouden als de webshop al gebruikmaakt van een externe module die productkennis en Vector Store beheert.

9. Verkooptoepassingen

De module kan worden verkocht als oplossing voor meerdere soorten projecten:

  • B2C-webshops met een referralprogramma,
  • premium webshops die een netwerk van merkambassadeurs willen opbouwen,
  • B2B-bedrijven met een programma voor handelspartners,
  • digitale en softwarewebshops,
  • bureau-implementaties waarbij de klant een volledig partnerprogramma nodig heeft zonder externe SaaS.

Bijzonder sterke verkoopargumenten zijn:

  • volledige controle over gegevens,
  • geen abonnement op een extern affiliateplatform,
  • integratie met Magento 2 zonder tussenpersonen,
  • ondersteuning voor affiliatelinks en affiliatecoupons,
  • kant-en-klaar partnerpaneel,
  • mogelijkheid tot verdere uitbreiding met AI.

10. Belangrijkste voordelen van de module

De belangrijkste voordelen van deze oplossing zijn:

  • werkt rechtstreeks in Magento 2,
  • ondersteunt zowel links als affiliatecodes,
  • verwerkt kortingscoupons die aan een affiliate zijn gekoppeld,
  • maakt partnerbeheer mogelijk vanuit het Magento-klantniveau,
  • heeft een echte workflow voor commissies en payouts,
  • bevat basisbeveiliging en audit,
  • heeft een modern affiliatiedashboard,
  • is klaar voor verdere ontwikkeling met extra enterprise-functies.

11. Systeemvereisten

De module is bedoeld voor:

  • Magento Open Source / Adobe Commerce 2.4.7+
  • PHP 8.2 / 8.3

Vereist compatibele Magento-modules gerelateerd aan:

  • Customer,
  • Quote,
  • Sales,
  • SalesRule,
  • Cms,
  • Email,
  • Backend,
  • Store.

12. Implementatiebereik

De module kan gefaseerd worden geïmplementeerd:

  • start met affiliatelinks en commissies,
  • uitbreiding met payouts,
  • uitbreiding met affiliatecoupons,
  • uitbreiding met AI en content voor affiliates,
  • verdere uitbreiding met geavanceerdere commissieregels en fraud scoring.

Dit betekent dat de module geschikt is voor zowel MVP-implementaties als voor langetermijnontwikkeling van het partnerprogramma.

13. Samenvatting

Kowal_Affiliate is een volwassen affiliatiemodule voor Magento 2 waarmee u binnen uw eigen webshop een compleet partnerprogramma kunt verkopen en starten. De module combineert klassieke affiliatelinks, referralcodes, kortingscoupons, commissies, payouts, basis fraud prevention, rapportage en een modern partnerpaneel.

Vanuit verkoopoogpunt is dit niet alleen een toevoeging voor referrallinks, maar een volledige partnerlaag voor Magento 2 die kan worden aangeboden als:

  • standalone module,
  • onderdeel van een webshopimplementatie,
  • deel van een growth- / performancepakket,
  • basis voor een geavanceerder partner- en merkambassadeursprogramma.

In de praktijk is dit een oplossing die inspeelt op echte behoeften van webshops die vragen naar:

  • een affiliateprogramma in Magento 2,
  • kortingscodes voor partners,
  • afrekening van commissies,
  • partnerpaneel,
  • gereedheid voor verkoop en productiegebruik.

More Information

Overeenstemming met sjabloon Luma / Blank, Smid

Installatiehandleiding voor de module

Kowal_Affiliate - installatie- en configuratiehandleiding

Dit document beschrijft hoe u de module Kowal_Affiliate voor Magento 2 installeert, activeert en voor het eerst configureert. De handleiding behandelt zowel de technische vereisten als de praktische stappen die nodig zijn om een affiliateprogramma in de webshop te starten.

1. Systeemvereisten

De module is bedoeld voor:

  • Magento Open Source / Adobe Commerce 2.4.7+
  • PHP 8.2 of 8.3

In het Magento-project moeten minimaal de volgende modules beschikbaar zijn:

  • Magento_Store
  • Magento_Cms
  • Magento_Customer
  • Magento_Email
  • Magento_Quote
  • Magento_Sales
  • Magento_SalesRule
  • Magento_Backend

2. Installatiemethoden

De module kan standaard als Composer-pakket worden geïmplementeerd.

2.1. Installatie via Composer

De module wordt gedistribueerd als Composer-pakket. Een voorbeeldproces ziet er als volgt uit:

De toegangsgegevens voor de Composer-repository, het e-mailadres van de klant en de licentietoken, ontvangt u na aankoop per e-mail. Ze zijn ook beschikbaar in het klantpaneel nadat u bent ingelogd op kowal.store. Vervang TWOJ_EMAIL_KLIENTA door het e-mailadres van uw account en TWOJ_TOKEN door de ontvangen token. Voer de commando’s uit in de hoofdmap van Magento.

composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/module-affiliatebin/magento module:enable Kowal_Affiliatebin/magento setup:upgradebin/magento setup:di:compilebin/magento cache:flush

2.3. Productiemodus

Als de webshop in production mode draait, is het na de installatie ook aan te raden om het volgende uit te voeren:

bin/magento setup:static-content:deploy

3. Wat de module tijdens de installatie aanmaakt

Tijdens de installatie doet de module het volgende:

  • maakt eigen databasetabellen aan die verband houden met affiliatefunctionaliteit,
  • breidt quote en sales_order uit met affiliatevelden,
  • voegt klantattributen toe die worden gebruikt voor het beheren van affiliates,
  • maakt een standaard CMS-pagina voor het partnerprogramma aan,
  • bereidt systeemconfiguratie en cronjobs voor,
  • registreert e-mailsjablonen en resources voor het beheerpaneel.

3.1. Standaard CMS-pagina

Na de installatie wordt een voorbeeldpagina voor het partnerprogramma aangemaakt:

identifier: affiliate-programtitle: Affiliate Partnership Program

De pagina is algemeen opgezet en kan na een kleine personalisatie van de inhoud in productie worden gebruikt.

De patch is idempotent:

  • als er al een pagina met deze identifier bestaat, zal de module deze niet overschrijven.

4. Waar u de moduleconfiguratie vindt

Het configuratiepaneel bevindt zich in:

Stores -> Configuration -> Affiliate Program

De belangrijkste secties:

  • General
  • Commission
  • Payouts
  • Affiliate Portal
  • Notifications
  • Fraud
  • AI
  • Reporting

5. Eerste configuratie na installatie

Na activering van de module wordt de volgende configuratievolgorde aanbevolen:

  1. schakel de module globaal in,
  2. stel de registratie van affiliates in,
  3. configureer de commissie en hold period,
  4. stel de minimale uitbetalingsdrempel in,
  5. vul de inhoud van het affiliateportaal aan,
  6. configureer beheerdersmeldingen,
  7. configureer optioneel AI,
  8. voer een test uit van registratie, affiliateklik en bestelling.

6. Gedetailleerde configuratie

6.1. General

Enable Module

Globale schakelaar van de module.

Als deze instelling is uitgeschakeld:

  • zou affiliate-tracking niet moeten werken,
  • zou het registratieformulier niet moeten werken,
  • worden commissies en payouts niet verwerkt.

Aanbeveling:

  • Yes op de productieomgeving na afronding van de tests,
  • No alleen wanneer het programma tijdelijk wordt uitgeschakeld.

Enable Affiliate Registration

Schakelt het aanmeldformulier voor het affiliateprogramma aan de voorkant van de webshop in.

Als de optie is uitgeschakeld:

  • kunnen nieuwe partners zich niet zelfstandig registreren,
  • kan de beheerder nog steeds handmatig een klant als affiliate markeren.

Bepaalt de levensduur van cookiegebaseerde attributie na een klik op een affiliatelink.

Voorbeelden:

  • 30 voor een standaard affiliateprogramma,
  • 7 voor korte campagnes,
  • 60 of 90 alleen als het programmareglement daarin voorziet.

Default Redirect Path

Reservepad dat wordt gebruikt wanneer de trackinglink geen correcte target bevat.

Voorbeelden:

  • /
  • promotions
  • catalog/category/view/id/12

6.2. Commission

Enable Commissions

Schakelt het berekenen van commissies voor affiliatebestellingen in.

Als het veld is uitgeschakeld:

  • kan de affiliatekoppeling worden opgeslagen,
  • maar wordt er geen record in de commissietabel aangemaakt.

Default Commission Rate (%)

Standaard percentage voor de commissie.

Voorbeeld:

  • 10 betekent een commissie van 10% over de actuele berekeningsgrondslag.

Commission Hold Period (days)

Het aantal dagen waarin de commissie de status in behandeling behoudt.

Na afloop van deze periode kan cron de commissie automatisch goedkeuren.

Aanbeveling:

  • 14 als veilige standaardwaarde,
  • 0 alleen bij een zeer eenvoudig programma zonder risico op retouren.

6.3. Payouts

Enable Payouts

Schakelt de workflow voor uitbetalingen aan affiliates in.

Als de optie is uitgeschakeld:

  • kan de partner geen payout-aanvraag indienen,
  • kan de beheerder nog steeds commissies analyseren, maar geen uitbetaling in de module verwerken.

Minimum Payout Amount

Minimaal saldo dat vereist is om een uitbetaling aan te vragen.

Voorbeelden:

  • 100
  • 250
  • 500

6.4. Affiliate Portal

Deze sectie beheert de inhoud die in het dashboard van de affiliate wordt weergegeven.

Dashboard Intro

Korte beschrijving bovenaan het dashboard van de affiliate.

Deze moet aan de partner uitleggen:

  • waar hij de affiliatelink vindt,
  • waar hij commissies kan bekijken,
  • hoe het paneel werkt.

Program Rules

Zichtbare samenwerkingsregels voor de affiliate.

Het beste is om in te voeren:

  • één regel per regel,
  • beknopte en eenduidige berichten.

Standaardtitel van het voorbeeldpromotiemateriaal.

Korte beschrijving onder de bannertitel.

Standaard targetpad voor affiliatelinks en banners.

Voorbeelden:

  • /
  • promotions/spring
  • catalog/category/view/id/24

6.5. Notifications

Enable Notifications

Schakelt het interne meldingssysteem en de notificatiewachtrij in.

Admin Notification Email

E-mailadres van de beheerder die de belangrijkste operationele berichten moet ontvangen.

Als het veld leeg blijft:

  • kan de module in geselecteerde flows het standaardadres general van Magento als fallback gebruiken.

Notification Log Retention (days)

Bepaalt hoelang records in het notificatielog moeten worden bewaard voordat cleanup plaatsvindt.

6.6. Fraud

Enable Fraud Checks

Schakelt basiscontroles tegen fraude in.

Block Self Referral

Blokkeert de commissie wanneer de klant die de bestelling plaatst tegelijkertijd de affiliate is die aan deze bestelling is gekoppeld.

6.7. AI

De AI-sectie is optioneel en is niet vereist voor de basiswerking van het affiliateprogramma.

Enable AI

Hoofdschakelaar voor AI-functies.

OpenAI API Key

API-sleutel voor communicatie met OpenAI.

Het veld wordt opgeslagen in versleutelde configuratie.

AI Model Name

Model dat voor AI-functies wordt gebruikt.

De lijst met modellen kan uit OpenAI worden opgehaald nadat de API-sleutel correct is opgeslagen.

OpenAI Request Timeout (seconds)

Maximale wachttijd voor een antwoord van OpenAI.

Praktische aanbeveling:

  • 60 seconden voor stabielere werking in productie.

Enable AI Diagnostic Logging

Schakelt diagnostische logging van AI-requests en -antwoorden in.

Nuttig bij:

  • integratie,
  • tests,
  • analyse van time-outs en antwoordfouten.

AI Diagnostic Max Chars

Maximale lengte van de gelogde payload-preview.

Enable Affiliate Assistant

Schakelt de affiliate-assistent in als de webshop deze functie wil gebruiken.

Enable Weekly AI Reports

Maakt het mogelijk periodieke AI-samenvattingen te genereren.

Enable Product Knowledge Retrieval

Maakt het mogelijk productkennis uit Vector Store te gebruiken.

Enable Program Knowledge Retrieval

Maakt het mogelijk kennis over het affiliateprogramma, FAQ en documentatie te gebruiken.

Product Vector Store Scope

Bepaalt hoe product_vector_store_id wordt opgelost.

Product Vector Store ID

Identifier van Vector Store als de webshop retrieval gebruikt.

Redact Personal Data

Verwijdert of maskeert persoonsgegevens voordat de prompt naar de AI-laag wordt verzonden.

6.8. Reporting

Enable Reporting

Schakelt het genereren van rapporten en CSV-exports in.

Export Directory

Pad naar de map waarin gegenereerde exports moeten worden opgeslagen.

Voorbeeld:

var/export/affiliate

7. Klant configureren als affiliate

Na installatie breidt de module de Magento-klantbewerking uit met affiliatevelden.

In de klantbewerking kunt u onder andere beheren:

  • Affiliate Participant
  • Affiliate Status
  • Affiliate Referral Code
  • Affiliate Website URL
  • Affiliate Notes
  • Affiliate Balance
  • Affiliate Coupon Discount (%)

7.1. Affiliate Participant

Geeft aan of de klant deelneemt aan het affiliateprogramma.

7.2. Affiliate Status

De belangrijkste statussen:

  • Pending
  • Active
  • Suspended
  • Rejected
  • Blocked

7.3. Affiliate Balance

Het saldo wordt automatisch berekend op basis van goedgekeurde commissies die klaar zijn voor uitbetaling.

Het veld:

  • is zichtbaar in de klantbewerking,
  • mag niet handmatig worden bewerkt,
  • wordt automatisch bijgewerkt na wijzigingen in commissies.

7.4. Affiliate Coupon Discount (%)

Met dit veld kunt u aan de affiliate een kortingspercentage toewijzen dat werkt op zijn referral_code.

Als u een waarde groter dan 0 invoert, zal de module:

  • een Magento-winkelwagenregel aanmaken of bijwerken,
  • de coupon instellen op de code van de affiliate,
  • klanten toestaan deze code als coupon in de winkelwagen te gebruiken,
  • de bestelling aan de affiliate toewijzen op basis van coupon_code.

Voorbeeld:

  • de affiliate heeft de code FMX1FBXXY3
  • de beheerder voert 5 in
  • de klant voert FMX1FBXXY3 in als kortingscoupon
  • Magento berekent 5% korting
  • de module wijst de bestelling toe aan de affiliate.

8. Cronjobs van de module

De module gebruikt crons in de groep default.

8.1. Auto approve commissions

job: kowal_affiliate_auto_approve_commissionsschedule: */15 * * * *

De taak:

  • controleert commissies met status pending,
  • wijzigt deze na afloop van de hold period naar approved.

8.2. Process notifications

job: kowal_affiliate_process_notificationsschedule: */10 * * * *

De taak:

  • verwerkt de meldingswachtrij,
  • markeert records als verzonden,
  • verstuurt transactionele berichten via het e-mailkanaal.

8.3. Cleanup notification log

job: kowal_affiliate_cleanup_notification_logschedule: 30 2 * * *

De taak:

  • verwijdert oude records uit het notificatielog volgens de retentie-instelling.

8.4. Weekly AI insights

job: kowal_affiliate_generate_weekly_ai_insightsschedule: 0 6 * * 1

De taak:

  • genereert wekelijkse AI-insights als de functie actief is.

9. CLI-commando’s

De module biedt servicecommando’s:

bin/magento kowal:affiliate:auto-approvebin/magento kowal:affiliate:process-notificationsbin/magento kowal:affiliate:cleanup-notificationsbin/magento kowal:affiliate:generate-ai-insightsbin/magento kowal:affiliate:export-report

Het meest nuttig bij de eerste ingebruikname zijn:

bin/magento kowal:affiliate:process-notificationsbin/magento kowal:affiliate:auto-approve

10. Eerste test na installatie

Na configuratie van de module wordt een eenvoudige end-to-endtest aanbevolen.

10.1. Test van affiliate-registratie

  1. Ga naar het registratieformulier voor affiliates.
  2. Verstuur de aanvraag.
  3. Controleer of het affiliateaccount is aangemaakt.
  4. Controleer of de klant de status Pending heeft.
  5. Controleer of er notificatierecords zijn aangemaakt.

10.2. Activeringstest

  1. Open de klantbewerking in het adminpaneel.
  2. Stel de affiliatestatus in op Active of gebruik de goedkeuringsactie.
  3. Controleer of de klant het affiliate-dashboard ziet.

10.3. Test van de affiliatelink

  1. Kopieer de affiliatelink uit het dashboard.
  2. Ga via deze link naar de webshop.
  3. Voeg een product toe aan de winkelwagen.
  4. Plaats een bestelling.
  5. Controleer of de bestelling het volgende heeft:
    • affiliate_id
    • affiliate_referral_code
    • is_affiliate_order = 1

10.4. Test van de affiliatecoupon

  1. Stel voor de affiliate Affiliate Coupon Discount (%) in, bijvoorbeeld 5.
  2. Sla de klant op.
  3. Zorg ervoor dat de affiliate de status Active heeft.
  4. Voer in de winkelwagen zijn Referral Code in als coupon.
  5. Plaats een bestelling.
  6. Controleer:
    • of de korting is berekend,
    • of de bestelling aan de affiliate is toegewezen,
    • of er een commissie is aangemaakt.

10.5. Test van payouts

  1. Keur de commissie goed of wacht op auto-approve.
  2. Controleer het saldo van de affiliate.
  3. Dien een uitbetalingsaanvraag in.
  4. Markeer de payout als betaald in het adminpaneel.

11. Meest voorkomende problemen na installatie

11.1. Geen commissie na bestelling

Controleer:

  • of de bestelling een affiliate_id heeft,
  • of commissies zijn ingeschakeld,
  • of de module werkt na de fix voor het aanmaken van commissies nadat affiliategegevens op de order zijn opgeslagen,
  • of er een record verschijnt in de tabel kowal_affiliate_commission.

11.2. Het klantengrid toont het actuele affiliatesaldo niet

Controleer:

  • of de index customer_grid is vernieuwd,
  • of reindexRow werkt na het opslaan,
  • of de waarde in de klantbewerking overeenkomt met de waarde in het grid.

Voer indien nodig uit:

bin/magento indexer:reindex customer_grid

11.3. AI reageert niet

Controleer:

  • of Enable AI is ingeschakeld,
  • of een correcte OpenAI API Key is opgeslagen,
  • of een model is geselecteerd,
  • of de time-out niet te laag is,
  • of var/log geen fouten toont bij requests naar OpenAI.

11.4. Meldingen worden niet verzonden

Controleer:

  • of de Magento-crons werken,
  • of Enable Notifications actief is,
  • of records worden opgeslagen in kowal_affiliate_notification_log,
  • of u handmatig kunt uitvoeren:
bin/magento kowal:affiliate:process-notifications

12. Aanbevolen startconfiguratie

Voor de eerste productie-implementatie wordt de volgende set aanbevolen:

  • Enable Module = Yes
  • Enable Affiliate Registration = Yes
  • Tracking Cookie Lifetime = 30
  • Enable Commissions = Yes
  • Default Commission Rate = 10
  • Commission Hold Period = 14
  • Enable Payouts = Yes
  • Minimum Payout Amount = 100
  • Enable Notifications = Yes
  • Block Self Referral = Yes
  • Enable AI = No bij de start, als de webshop vanaf de eerste dag geen AI nodig heeft

13. Samenvatting

Na correcte installatie en configuratie maakt Kowal_Affiliate het mogelijk om in Magento 2 een volledig partnerprogramma te starten met:

  • affiliates,
  • verwijzingslinks,
  • affiliatecodes,
  • kortingscoupons van affiliates,
  • commissies,
  • payouts,
  • meldingen,
  • partnerdashboard,
  • basisbeveiliging en automatisering.
Write Your Own Review
You're reviewing: Geavanceerde affiliatiemodule Affiliate voor Magento 2
Your Rating:
Prijs
Kwaliteit
Ondersteuning
loader
Loading...

You submitted your review for moderation.

This form is protected by reCAPTCHA - the Google Privacy Policy and Terms of Service apply.

Update cookie preferences