Magento koppelen

De bluebarry-module voor Magento 2 en Adobe Commerce voegt bluebarry toe aan je webshop, houdt je catalogus in bluebarry bij en volgt bestellingen van klanten die bluebarry hebben gebruikt. Een productfeed heb je niet nodig.

Wat de module doet

• Laadt bluebarry op elke pagina, zodat je quizzen en gepubliceerde pop-ups kunnen openen, en zet de zoekfunctie van bluebarry aan zodra je die in bluebarry aanzet.
• Volgt elke betaalde bestelling van een klant die bluebarry gebruikte, of die nu een quiz deed, zocht, op een aanbeveling klikte, chatte of een pop-up zag, en koppelt het e-mailadres van de bestelling aan het profiel van de klant.
• Synchroniseert je catalogus: producten en hun varianten, attributen, categorieën, prijzen, aanbiedingsprijzen, afbeeldingen en voorraad. Zie Je producten hieronder.
• Stuurt je bestellingen: elke bestelling zodra die betaald is, daarna terugbetalingen en annuleringen, en de afgelopen 12 maanden als je ze importeert onder Store data → Orders. Daarmee werken bestsellers, verkochte aantallen, vaak samen gekocht en aankoopsegmenten.
• Vertelt bluebarry wat klanten bekijken: paginaweergaven, productweergaven en wat ze in de winkelwagen leggen. Daarmee werken recent bekeken en vaak samen bekeken, gepersonaliseerde volgorde, gedragssegmenten, pop-upregels op product of winkelwagen en productchat die de pagina kent. Staat de cookiebeperkingsmodus van Magento aan, dan pas nadat de klant cookies heeft toegestaan.
• Legt producten in de winkelwagen vanuit een quizresultaat, de zoekwidget en aanbevelingsblokken, en werkt de mini-winkelwagen bij. Zet daarvoor in de quiz het Button behaviour van een resultaatkaart op Magento: Add to cart.
• Vanaf versie 2.1.0: toont bluebarry op je product- en winkelwagenpagina's zonder aanpassingen aan je thema, voegt widgets toe om het op elke andere plek te zetten, maakt van kortingen kortingscodes en stuurt je categorieën, zodat ze als collecties in bluebarry staan.

De module installeren

Magento-modules installeer je via de command line. De meeste webshops laten dit deel daarom over aan hun developer of bureau.

1. Ga in bluebarry naar Store data → Integrations. Open onder Connect your webshop zo nodig View other CMS platforms en klik op de Magento 2-kaart op Install. De module opent in de Adobe Commerce Marketplace.
2. Laat je developer de module installeren en inschakelen, en zorg dat de cronjobs van Magento draaien. Bestellingen en productwijzigingen gaan elke minuut via cronjobs naar bluebarry.
3. Ga in Magento Admin naar Stores → Configuration → Bluebarry → General.
4. Vul je Tenant ID in. Die vind je bovenaan de pagina Store data → Integrations in bluebarry.
5. Vul een API Key in. Die maak je in bluebarry aan onder Store data → Integrations: open de Developer area, klik bij API keys op Manage en maak een sleutel voor Magento. Magento bewaart hem versleuteld. Heb je meerdere websites, kies dan bovenaan de pagina het bereik en stel de Tenant ID en API Key per website in.
6. Klik op Save Config. Magento laat zien of elke website verbonden is, en bij Connection zie je de laatste controle. In bluebarry staat Magento dan als verbonden onder Store data → Integrations, waar Manage je websites toont. Binnen een paar minuten komen je producten binnen.

Je producten

Zodra een website verbonden is, stuurt de module de hele catalogus naar bluebarry, en daarna elk product dat verandert: als je het opslaat, in bulk aanpast of importeert, en als een bestelling voorraad afneemt. Elke nacht stuurt de module de hele catalogus opnieuw, voor wat verandert zonder dat je opslaat, zoals een aanbiedingsprijs die begint of eindigt. Bij Catalog in de module-instellingen zie je hoeveel producten nog wachten. Wil je de catalogus meteen sturen, bijvoorbeeld zolang de cronjobs van Magento nog niet draaien? Klik dan naast Catalog op Sync now (vanaf module 2.2.0) of voer bin/magento bluebarry:catalog:sync uit.

• Enkelvoudige, virtuele, downloadbare en bundelproducten worden elk een product in bluebarry. De varianten van een configureerbaar product zijn producten die eronder gegroepeerd zijn, met de naam, pagina en categorieën van dat product.
• Namen, pagina's, afbeeldingen en prijzen zijn wat gasten zien in de standaard store view van de website, in de valuta daarvan: de prijs die ze betalen, en de normale prijs zolang een aanbiedingsprijs of catalogusprijsregel die verlaagt.
• Attributen die je op de productpagina toont of als filter gebruikt, komen mee als attr_-velden, zoals attr_color.
• De voorraad komt met een aantal zolang Magento hem beheert zonder nabestellingen. Wat openstaande bestellingen gereserveerd hebben, is al afgetrokken.
• Importeer je je Magento-producten al via een feed? Verwijder de feed onder Store data → Feeds zodra de producten binnen zijn, zodat ze niet dubbel staan.

bluebarry live zetten

• Quizzen: kopieer de quizlink uit het publicatievenster van de quiz (tabblad Implementation, Magento) en gebruik die als link op een knop of banner.
• Zoeken: open je zoekconfiguratie in bluebarry, ga naar Launch en zet Search on your store aan. Zet ook Full results page aan om de resultaten van bluebarry op de zoekresultatenpagina van Magento te tonen. Meer hierover lees je in Zoeken live zetten op je webshop.

bluebarry tonen op je product- en winkelwagenpagina's

Ga in bluebarry naar Store data → Integrations, klik bij Magento op Manage en open On your store. Zet aan wat je wilt tonen:

• Product check button: een knop “Is this right for me?” onder de winkelwagenknop, bij producten met een productcheck-quiz. Die producten kies je in de stap Launch van de quiz.
• Product chat: onder de winkelwagenknop.

Aanbevelingsblokken voor productpagina's en de winkelwagen zet je aan onder Recommendations → Placements. Zie Aanbevelingen vormgeven en in je webshop plaatsen.

Klik op Save. Je winkel wordt direct bijgewerkt, en aan je thema verandert niets. Is je winkel van buitenaf niet bereikbaar (bijvoorbeeld een staging-site achter een wachtwoord), dan neemt die de wijziging binnen een uur over. Hiervoor heb je versie 2.1.0 of nieuwer van de module nodig, met Luma, Hyvä en thema's die daarop gebouwd zijn.

Widgets

Wil je iets op een andere plek zetten, gebruik dan een widget. Klik in Magento Admin in een pagina of blok op Insert Widget, of maak er een aan onder Content → Widgets. De module voegt er vijf toe:

• bluebarry quiz button: een knop die een quiz opent.
• bluebarry quiz popup: opent een quiz als pop-up na een aantal seconden, na een deel van de pagina, of als de bezoeker op het punt staat weg te gaan.
• bluebarry product check button: de productcheck-knop, op een productpagina.
• bluebarry recommendations: een aanbevelingsblok. Op een productpagina beveelt het aan bij dat product, overal elders bij de winkelwagen.
• bluebarry product chat: productchat.

De quiz-widgets vragen om een Quiz ID. De stap Launch van de quiz toont die om te kopiëren.

Kortingen worden kortingscodes

Vanaf versie 2.1.0 maakt de module de kortingscodes die bluebarry uitdeelt aan als eenmalige Magento-kortingscodes. Je hoeft niets in te stellen.

• Aanbiedingen in quizzen en aanbevelingen: zodra de klant een product uit de aanbieding toevoegt, maakt de module een code aan die alleen voor die producten geldt en zet die op de winkelwagen. Klanten typen geen code. Zie Bundels en kortingen aanbieden.
• A unique code per person vanuit een pop-up of de e-mailvraag van een quiz: een code voor elke klant die zich inschrijft. Zie Formulieren voor pop-ups bouwen en Een kortingscode aanbieden op de resultaatpagina.
• Een Magento-winkelwagen neemt één kortingscode. Heeft een klant zelf al een code ingevuld, dan blijft die code staan.
• De codes staan onder winkelwagenprijsregels met de naam bluebarry: … in Marketing → Cart Price Rules. Laat die regels zoals ze zijn: verwijder je er een, dan werken de codes ervan niet meer. De cronjobs van Magento ruimen een code op zodra die verlopen is.

Goed om te weten

• Een bestelling telt zodra die betaald is: als Magento haar op processing of complete zet. Bestellingen via overschrijving, cheque of rembours tellen zodra je ze factureert.
• Staat de cookiebeperkingsmodus van Magento aan, dan wordt een bestelling alleen aan de klant gekoppeld als die cookies toestond.
• Bestelbedragen worden gerapporteerd in de valuta waarin de klant betaalde.
• Websites met dezelfde Tenant ID delen één catalogus in bluebarry: die van de standaardwebsite.
• Zet Write conversion requests to debug log op Yes als bestellingen niet verschijnen. De module schrijft dan naar var/log/bluebarry.log wat ze heeft verstuurd.