Koppelen met Magento 2.3 of hoger

De koppeling tussen je Magento webshop (versie 2.3 of hoger) en je Spotler account verloopt via het Connector Platform van Spotler. Hiervoor installeer je onze plugin in je Magento webshop. De data op het Connector Platform blijft bij Spotler en wordt niet verwerkt via een derde partij.

Op het Connector Platform wordt de koppeling ingesteld zodat het bronsysteem (Magento) kan communiceren met het doelsysteem (Spotler account). Het werkt als volgt:

Het Connector Platform haalt via de Magento Connector de data op uit jouw Magento webshop en zet deze gegevens vervolgens door naar jouw Spotler account. Periodiek worden de wijzigingen uit Spotler opgehaald en worden door het Connector Platform doorgezet naar Magento. Zo blijven alle systemen up-to-date. De koppeling synchroniseert standaard elke 15 minuten nieuwe en gewijzigde data.

Voorwaarden om succesvol te koppelen

Er is een aantal voorwaarden om te koppelen voor een goede werking:

• Je draait Magento versie 2.3 of hoger.
• Je hebt onze plugin: https://github.com/SpotlerSoftware/magento2-mailplus-connector geïnstalleerd. Spotler levert hiervoor een implementatie handleiding aan.
• De volgende IP-adressen zijn toegevoegd op de whitelist: 46.31.48.0/21, 213.34.87.217 en 188.204.90.130 
• Je maakt geen gebruik van rate limiters
• Je maakt geen gebruik van user agent filters op de API. De blacklist op user agent staat uit. Of exclude user agent "Jersey".
• Je maakt geen gebruik van een hypernode-omgeving voor ons Connector Platform.
• Standaard voegt Spotler Google analytics code toe aan productlinks. Zorg ervoor dat je website de opbouw van deze linkjes accepteert.
• Voor meerdere sites (merken of lables) in Magento 2, heb je meerdere Spotler accounts nodig (meer licenties). De triggers voor de Spotler eCom campagnes voor Magento 2 werken namelijk maar met één nieuwsbrief permissie.
• Als je met meerdere talen werkt in je Magento webshop kunnen dat meerdere storeviews zijn. Maar merken of labels moeten per site zijn ingericht. Dit heeft te maken met de opt-in voor je nieuwsbrieven. Magento 2 kan maar met één nieuwsbriefpermissie per site omgaan.
• De Magento 2 “base_media_url” mag geen redirect hebben naar een externe image hosting voor de productafbeeldingen. In de “base_media_url” dient de directe verwijzing te staan naar de afbeelding.
• De productafbeelding dient een RGB image zijn. CMYK images worden niet ondersteund.

Opmerkingen

• Wij geven alleen aan wat er moet worden toegevoegd aan Magento om met Spotler te kunnen koppelen. Spotler is geen Magento specialist en adviseert niet over hoe Magento wordt ingericht.
• Het niet direct vrijgeven van de API voor Spotler is van invloed op de doorlooptijd om de koppeling te realiseren.
• Voornaam en achternaam worden verplicht teruggegeven van Spotler naar Magento wanneer een contact is gewijzigd in Spotler. Dit is een vereiste van Magento 2.
• Bij nieuwsbrief subscribers (gast registraties) wordt alleen het e-mailadres doorgegeven met een nieuwsbrief permissie. Bij klanten kunnen ook andere velden gesynchroniseerd worden naar Spotler. Denk aan NAW-gegevens.
• In Magento 2 kan je op verschillende manieren 'van' en 'voor' prijzen meegeven. Tijdens de implementatie bespreken we welke we gaan gebruiken in de koppeling.

• Custom prijsvelden en custom productvelden die met een plugin aan Magento 2 zijn toegevoegd, kunnen niet gebruikt worden in Spotler. De koppeling gebruikt de standaard Magento 2 productvelden.

• Configurable producten kan je niet opnemen als product in je mailing.
• Elke 15 minuten worden nieuwe contacten, producten, orders en conversie van Magento 2 naar Spotler verwerkt.
• Contactwijzigingen uit Spotler worden elke 15 minuten aan Magento 2 aangeboden.
• Als je alleen producten gaat synchroniseren, kan je geen gebruik maken van de standaard eCommerce campagnes.
• Standaard wordt de verlaten winkelwagen campagne na 240 minuten (4 uur) getriggerd door de Magento 2 koppeling voor contacten met een klantaccount en nieuwsbrief permissie. Het aantal minuten wordt ingesteld door Spotler. De campagne gaat af na de ingestelde tijd + de ingestelde synchronisatie tijd (standaard 15 minuten) van de koppeling. Het moment van de trigger ligt door het moment van synchroniseren dus tussen de 240 en 255 minuten (ingestelde tijd + 15).
• Product wijzigingen worden door de koppeling alleen verwerkt als het product in Magento 2 een wijzigdatum heeft gekregen (updated_at datum).
• Je ziet dubbele producten staan in Spotler als meerdere storeviews op één site in de webshop aanwezig zijn. Er komen dan dubbel zoveel producten in Spotler terecht. In de Storesync in Spotler  (instellingen > integraties > producten) is dit herkenbaar aan de prefix die door de connector toegevoegd wordt aan de productId`s 1- of 2- (taalvarianten). Bijvoorbeeld productId 1-123456.
• In de mailingstatistieken van Spotler kunnen orderconversies doorkomen. Voor een goede werking zijn we afhankelijk van de Magento inrichting en instelling van de orderstatussen op het Connector Platform.
• Conversie wordt in de mailingstatistieken opgenomen als direct vanuit de mailing een aankoop gedaan is op de webshop.
• Wanneer je de Magento versie update of je andere Magento plugins update/installeert kan dat effect hebben op je koppeling met Spotler.
• De koppeling test je zelf (eventueel met een Magento partner). Hiervoor is een testplan beschikbaar.