Hoe je coupons instelt (voor Magento 1.x)
Klaviyo's Magento 1-integratie accepteert geen nieuwe installaties meer en zal eind 2027 volledig end-of-support bereiken. Klaviyo Support kan niet langer helpen bij Magento 1-gerelateerde verzoeken.
Wat je leert
Magento ondersteunt Winkelwagenprijsregels die kunnen worden gebruikt om korting toe te passen op de bestelling van een klant. Couponcodes kunnen worden gemaakt voor bestaande prijsregels, zodat shoppers eenvoudig een bepaalde code kunnen gebruiken om tijdens het afrekenproces korting toe te passen.
Met de functie Coupons for Magento van Klaviyo kunnen Magento 1.0-winkels het volgende doen:
- Maak nieuwe coupons in Klaviyo die zijn gekoppeld aan bestaande prijsregels in Magento.
- Neem unieke coupons op in flow-e-mails, zodat elke ontvanger een unieke code ontvangt.
In deze handleiding wordt uitgelegd hoe je Magento-coupons in Klaviyo instelt.
Dynamische couponcodes zijn momenteel niet beschikbaar bij het verzenden van campagne-e-mails. Het verzenden van unieke couponcodes in een campagne zou vereisen dat je duizenden codes per seconde genereert. Klaviyo kan niet garanderen dat de instellingen voor snelheidsbeperking van een specifieke Magento-server geen invloed hebben op het genereren van unieke coupons bij dit volume en deze snelheid. Daarom zijn unieke coupons alleen beschikbaar bij het verzenden van flow-e-mails.
Vereisten
Zorg er als vereiste voor dat je de Magento-integratie in Klaviyo hebt ingeschakeld en de Klaviyo-extensie in Magento hebt geïnstalleerd.
Schakel de REST API in
Begin met het inschakelen van de REST API door een nieuwe REST-rol aan te maken en volledige toegang te geven. Wijs daarna de rol toe aan een van je beheerusers.
- Klik op Systeem > Webservices > REST - Rollen.
- Maak een nieuwe rol Beheerder aan. Voer bij het veld Role Name een naam in, bijvoorbeeld "Administrator".
- Klik links op het tabblad Rol-API-bronnen. Stel Resourcetoegang in op Alles en klik op Rol opslaan.
- Navigeer vervolgens naar Systeem > Webservices > REST - Attributen.
- Selecteer Beheerder in de lijst met gebruikerstypes.
- Stel Toegang tot resources in op Alles en klik op Opslaan.
- Navigeer vervolgens naar Systeem > Machtigingen > Gebruikers.
- Selecteer een beheerder in de lijst en klik op Gebruiker bewerken.
- Klik op het tabblad REST role in de linkerzijbalk.
- Klik op het keuzerondje om de nieuwe REST-beheerdersrol aan je user toe te wijzen.
- Klik op User opslaan.
Je hebt nu de REST API ingeschakeld voor je Magento-winkel.
Als je niet zeker weet of je REST API goed is geconfigureerd, bekijk dan de stappen die in onze resource over het oplossen van problemen met coupons voor Magento 1x worden beschreven.
REST-inloggegevens genereren in Magento
Om de Magento Coupons-functies van Klaviyo in te schakelen, genereer je eerst REST API-inloggegevens in je Magento-winkel met het REST-beheeraccount dat je zojuist hebt gemaakt en plak je deze vervolgens in je Klaviyo-account.
- Log in als de REST-beheerdersgebruiker die je hebt gemaakt in de sectie REST API inschakelen hierboven.
- Klik op Systeem > Configuratie en klik vervolgens op Klaviyo onder het gedeelte Klanten.
- Klik op OAuth-tokens genereren.
De Consumer Key, Consumer Secret, Authorization Token en de Authorization Secret worden ingevuld. Je kopieert/plakt deze waarden in je Klaviyo-account in de volgende stap.
Magento-coupons instellen in Klaviyo
- Ga in je Klaviyo-account naar je Magento-integraties.
- Klik op de pijl Geavanceerde opties om de couponinstellingen uit te vouwen.
- Plak de REST-inloggegevens die je hierboven hebt gemaakt.
Je Magento-server moet HMAC-SHA1-handtekeningen ondersteunen voor OAuth-authenticatie.
- Klik op Magento-instellingen bijwerken.
Klaviyo valideert je REST-inloggegevens en je kunt beginnen met het aanmaken van coupons via het tabblad Coupon in je account.
Een Magento-coupon maken in Klaviyo
Wanneer je nadat je je REST-referenties hebt opgegeven voor het eerst naar het tabblad Coupon in je Klaviyo-account navigeert, zie je het bericht: "Je hebt nog geen coupons toegevoegd."
Voordat je een nieuwe coupon maakt, moet je eerst een Price Rule in Magento definiëren waarin alle specificaties voor de coupon staan. Price Rules kunnen niet worden gemaakt in Klaviyo. Een nieuwe coupon die in Klaviyo is gemaakt, moet verwijzen naar een bestaande Price Rule in Magento.
Houd er bij het maken van een Price Rule in Magento rekening mee dat de optie om een nieuwe Price Rule aan een specifieke coupon te koppelen ingesteld moet blijven op Specific Coupon en dat je het selectievakje Use Auto Generation moet aanvinken.
- Klik op Coupon toevoegen om een nieuwe coupon te maken.
- Vul de volgende informatie in: Coupon naam en de Magento-regel-id.
- Couponnaam: De naam die je opgeeft mag alleen letters, cijfers en onderstrepingstekens bevatten en mag maximaal 32 tekens lang zijn
- Magento-regel-ID: Maak eerst een regel aan in Magento en plak de ID van die regel hier om deze aan deze coupon te koppelen
Alle gemaakte coupons worden weergegeven met de volgende overzichtsdetails:
- Couponnaam: Naam van de coupon
- Actief tijdsbestek: er zijn de volgende opties:
- Actief, geen vervaldatum
- Datum A - geen vervaldatum
- Datum A - Datum B
- Actief, verloopt datum B
- Aanmaakdatum: datum waarop de coupon is aangemaakt
- Datum laatst bijgewerkt: Datum waarop de coupon voor het laatst is bijgewerkt
Coupons kunnen via de dropdown aan de rechterkant worden bewerkt en verwijderd op dit tabblad.
Een Magento-coupon gebruiken in een flowmail
Zodra er een coupon is aangemaakt, kun je deze in een flow-e-mail invoegen met de volgende placeholder-variabele. Je kunt per e-mail maar één couponcode toevoegen. Je kunt dezelfde couponcode op meerdere plaatsen weergeven, maar je kunt niet meerdere codes gebruiken.
{% coupon_code 'CouponName' %} Vervang CouponName door de naam van je coupon. Bijvoorbeeld:
Unieke coupons gebruiken in sms-flowberichten
Unieke coupons zijn ook beschikbaar voor je sms- en mms-berichten in flows. Genereer de codes net zoals je dat voor e-mail doet. Gebruik vervolgens de onderstaande templatetag om de couponcode toe te voegen aan je sms- of mms-bericht:
{% coupon_code 'CouponName' %}.
Verander in het fragment CouponName in de naam van de coupon die je wilt en voeg deze toe aan het bericht (voor een flow of campagne).
In tegenstelling tot e-mail kun je maar 1 couponcode per sms-bericht gebruiken. Met e-mail heb je de optie om verborgen blokken te gebruiken om verschillende coupons te sturen op basis van waar iemand woont of wat iemand heeft gedaan. Als je meerdere coupons aan een sms-bericht probeert toe te voegen, zie je een foutmelding.
Foutmeldingen oplossen
Foutmelding: “Kan geen verbinding maken met de REST API met de opgegeven REST-inloggegevens. Controleer of deze inloggegevens geldig zijn in je Magento-beheeromgeving."
Als je deze foutmelding in Klaviyo ziet, zijn er twee waarschijnlijke hoofdoorzaken:
- Je Magento-server is niet ingesteld om HMAC-SHA1-handtekeningen te ondersteunen voor OAuth-authenticatie.
- Mogelijk heb je geen volledige roltoegang voor de REST API ingeschakeld.
Om dit probleem op te lossen, schakel je HMAC-SHA1-handtekeningen in voor OAuth-authenticatie op je Magento-server. Voltooi vervolgens de volgende stappen om je REST-machtigingen bij te werken:
- Haal de commentaarmarkering weg bij de rewrite rule in je .htaccess, of voeg deze toe opnieuw genereren. Dit is de regel die je niet wilt dat wordt uitgecommentarieerd:
RewriteRule ^api/rest api.php?type=rest [QSA,L] - Controleer dubbel of je REST Role correct is ingesteld
We behandelen de instructies hiervoor in onze handleiding voor het instellen van coupons voor Magento in de sectie waarnaar hier wordt gelinkt. - Een andere veelvoorkomende oorzaak is dat verschillende Apache-modules de header “Authorization: Basic base64 (user:password)” kunnen verwijderen.
Bekijk dit bericht voor meer informatie
Couponcodes die door Klaviyo in e-mails worden ingevuld, zijn niet uniek: alle ontvangers lijken dezelfde code te ontvangen.
Wanneer je een prijsregel maakt in Magento, moet je de optie om een nieuwe prijsregel aan een specifieke coupon te koppelen ingesteld laten op Specifieke coupon en moet je het selectievakje “Automatisch genereren gebruiken” inschakelen.
Klik op je prijsregel in Magento en scrol onder General Information omlaag naar de regeloptie "Coupon" en wijzig deze instelling naar "Specific Coupon". Vink vervolgens het vakje voor automatische generatie hier aan. Dit zou het probleem moeten oplossen en ons in staat stellen om voor elke e-mailontvanger een nieuwe unieke couponcode te genereren.