Heb je een MailBlue Starter-abonnement en wil je Magento koppelen? Bekijk dan dit artikel om Magento en MailBlue te koppelen.
Om je Magento 2 webshop te koppelen met MailBlue is er een plugin beschikbaar voor Magento. Via deze koppeling komen bestellingen vanuit jouw Magento webshop binnen in MailBlue, en kun je dit automatisch opvolgen. Ook verlaten winkelwagen-mails kunnen middels de plugin vanuit MailBlue worden verzonden.
In deze handleiding leggen we je uit hoe je deze plugin installeert en inricht. Voor het installeren heb je toegang nodig tot de CLI / SSH / Terminal van de server waar Magento op staat geïnstalleerd.
Let op: dit is een technische handleiding. Laat dit uitvoeren door je website-ontwikkelaar.
Systeem vereisten
PHP 7.4/8
Magento 2.3/2.4
Elastic Search 7
Downloaden plugin
De plugin is te vinden op: https://commercemarketplace.adobe.com/activecampaign-module-integration.html
Download de release
De gedownloade inhoud dient geplaatst te worden in de map: /app/code/ActiveCampaign
Bestaat deze map nog niet, maak deze dan aan.
Installatie plugin
Voer onderstaand commando uit om de laatste versie van de module te installeren en te activeren.
composer update activecampaign/module-integration --with-dependencies
Om de installatie te voltooien, updaten of de-installeren, voer de volgende commando's uit
$ cd /path/to/your/site
$ php bin/magento setup:upgrade
$ php bin/magento setup:di:compile
$ php bin/magento setup:static-content:deploy
$ php bin/magento cache:flush
$ php bin/magento cache:clean
Configuratie plugin
Om de plugin te configureren heb je de API gegevens nodig van je MailBlue account. Voor meer informatie over waar je deze gegevens terug kunt vinden, klik hier. Deze gegevens heb je nodig bij de volgende stappen:
Ga in je Magento installatie naar Stores -> Configuration
Klik in het linker menu op ActiveCampaign -> Configuration
Pas de volgende gegevens aan:
Status: Enabled
API URL: [url uit je MailBlue account (xxx.api-us1.com of xxx.activehosted.com]
API Key: [api key uit je MailBlue account]
Klik op 'Connect'
Krijg je hier een foutmelding, controleer dan de gegevens.
Is alles goed gegaan dan krijg je nu een melding om de Magento cache te vernieuwen, klik op de link en reset de caches die ongeldig zijn.
Synchronisatie bestellingen, klanten, verlaten winkelwagen
Onder de instellingen voor de API gegevens kun je aanpassen hoe je wenst dat gegevens doorgezet worden naar MailBlue.
Order sync configuration
Hier kun je aangeven hoe orders naar MailBlue doorgestuurd gaan worden. Mocht je een drukke store hebben dan is het aan te raden om de cronjob vaker te laten lopen. Standaard staat deze ingesteld op elke vijfde minuut van het uur.
Ook kun je hier aangeven of orders direct na het plaatsen doorgestuurd moeten worden. Heb je dit aan staan, dan geldt de cronjob niet.
Abandoned Cart
Met verlaten winkelwagens kun je een opvolging maken binnen MailBlue, waarmee je de klant nog kan overhalen om de bestelling af te ronden. Deze worden binnen Magento opgeslagen en doorgestuurd naar MailBlue. Standaard gebeurt dit elk uur, op het hele uur. Is je webshop drukker, dan is het aan te raden om deze instelling aan te passen om het vaker te laten draaien.
Binnen Magneto kunnen ook oude verlaten winkelwagentjes opgeslagen staan. Er is een mogelijkheid om deze te synchroniseren. Let hier wel mee op, het kan namelijk zo zijn dat deze data niet 100% accuraat is, gezien het historische data betreft.
Customer
Klanten synchroniseren is een basis die altijd aan moet staan; zonder klanten synchroniseren kunnen bestellingen ook niet worden doorgezet. Je kunt hier aanpassen hoe vaak klanten gesynchroniseerd mogen worden. Standaard staat dit ingesteld op één keer per uur, op de tiende minuut van het uur. Voor drukkere webshops raden we aan om dit vaker te laten lopen.
Sync Log Settings
Ervaar je problemen met de synchronisatie van gegevens? In dat geval raden we je aan de 'Sync log' aan te zetten. Let op: doe dit wel altijd in Debug mode. Dit zorgt ervoor dat je gedetailleerde logging krijgt over de acties die uitgevoerd worden. De log wordt opgeslagen op /var/log/activecampaign.log. Heb je "SyncLog Delete" aan staan dan wordt de log na 7 dagen automatisch geleegd. Dit zorgt ervoor dat er niet onnodig veel logging bewaard blijft.
Historische orders sync
De plugin beschikt niet over een mogelijkheid om in bulk reeds geplaatste bestellingen te synchroniseren. De enige mogelijkheid om deze bestellingen wel in je MailBlue account te krijgen is om dit te doen door naar Orders te gaan, de gewenste orders te selecteren bij Actions te kiezen voor 'Send to ActiveCampaign'