Magento verbinden

Das bluebarry-Modul für Magento 2 und Adobe Commerce bringt bluebarry in deinen Shop, hält deinen Katalog in bluebarry aktuell und erfasst Bestellungen von Leuten, die bluebarry genutzt haben. Einen Produktfeed brauchst du nicht.

Was das Modul macht

• Lädt bluebarry auf jeder Seite, damit sich deine Quizze und veröffentlichten Popups öffnen können, und schaltet die bluebarry-Suche ein, sobald du sie in bluebarry einschaltest.
• Erfasst jede bezahlte Bestellung von Leuten, die bluebarry genutzt haben, ob sie ein Quiz gemacht, gesucht, auf eine Empfehlung geklickt, gechattet oder ein Popup gesehen haben, und fügt die Bestell-E-Mail ihrem Profil hinzu.
• Synchronisiert deinen Katalog: Produkte und ihre Varianten, Attribute, Kategorien, Preise, Sonderpreise, Bilder und Lagerbestand. Siehe Deine Produkte unten.
• Schickt deine Bestellungen: jede Bestellung, sobald sie bezahlt ist, danach Erstattungen und Stornierungen, und die letzten 12 Monate, wenn du sie unter Store data → Orders importierst. Damit funktionieren Bestseller, verkaufte Stückzahlen, Häufig zusammen gekauft und kaufbasierte Segmente.
• Sagt bluebarry, was sich Leute ansehen: Seitenaufrufe, Produktaufrufe und was in den Warenkorb kommt. Damit funktionieren Zuletzt angesehen und Häufig zusammen angesehen, personalisierte Reihenfolge, Verhaltenssegmente, Popup-Regeln nach Produkt oder Warenkorb und ein Produktchat, der die Seite kennt. Ist der Cookie-Einschränkungsmodus von Magento aktiv, erst nachdem die Person Cookies erlaubt hat.
• Legt in den Warenkorb, aus einem Quizergebnis, dem Such-Widget und Empfehlungsblöcken, und aktualisiert den Mini-Warenkorb. Stell dafür im Quiz das Button behaviour einer Ergebniskarte auf Magento: Add to cart.
• Ab Version 2.1.0: zeigt bluebarry auf deinen Produkt- und Warenkorbseiten, ohne Theme-Anpassungen, bringt Widgets mit, um es überall sonst zu platzieren, macht aus Rabatten Gutscheincodes und schickt deine Kategorien, damit sie in bluebarry als Kollektionen erscheinen.

Modul installieren

Magento-Module werden über die Kommandozeile installiert. Die meisten Shops geben diesen Teil an ihre Entwickler oder ihre Agentur.

1. Geh in bluebarry zu Store data → Integrations. Öffne unter Connect your webshop bei Bedarf View other CMS platforms und klick bei Magento 2 auf Install. Das Modul öffnet sich im Adobe Commerce Marketplace.
2. Lass das Modul installieren und aktivieren und sorg dafür, dass die Cronjobs von Magento laufen. Bestellungen und Produktänderungen gehen jede Minute per Cronjob an bluebarry.
3. Geh im Magento-Admin zu Stores → Configuration → Bluebarry → General.
4. Trag deine Tenant ID ein. Du findest sie oben auf der Seite Store data → Integrations in bluebarry.
5. Gib einen API Key ein. Du erstellst ihn in bluebarry unter Store data → Integrations: Öffne den Developer area, klick bei API keys auf Manage und erstell einen Schlüssel für Magento. Magento speichert ihn verschlüsselt. Bei mehreren Websites wechselst du oben auf der Seite den Bereich und legst Tenant ID und API Key pro Website fest.
6. Klick auf Save Config. Magento zeigt, ob jede Website verbunden ist, und unter Connection siehst du die letzte Prüfung. In bluebarry erscheint Magento dann unter Store data → Integrations als verbunden, und Manage listet deine Websites. Deine Produkte kommen innerhalb weniger Minuten an.

Deine Produkte

Sobald eine Website verbunden ist, schickt das Modul ihren ganzen Katalog an bluebarry, danach jedes Produkt, das sich ändert: wenn du es speicherst, gesammelt änderst oder importierst, und wenn eine Bestellung seinen Bestand verringert. Jede Nacht schickt es den ganzen Katalog erneut, für das, was sich ohne Speichern ändert, etwa ein Sonderpreis, der beginnt oder endet. Catalog in den Moduleinstellungen zeigt, wie viele Produkte noch warten. Um den Katalog sofort zu schicken, etwa solange Magentos Cronjobs noch nicht laufen, klicke neben Catalog auf Sync now (ab Modul 2.2.0) oder führe bin/magento bluebarry:catalog:sync aus.

• Einfache, virtuelle, herunterladbare und Bundle-Produkte werden je ein Produkt in bluebarry. Die Varianten eines konfigurierbaren Produkts sind Produkte, die unter ihm gruppiert sind, mit seinem Namen, seiner Seite und seinen Kategorien.
• Namen, Seiten, Bilder und Preise sind das, was Gäste in der Standard-Store-View der Website sehen, in deren Währung: der Preis, den sie zahlen, und der reguläre Preis, solange ein Sonderpreis oder eine Katalogpreisregel ihn senkt.
• Attribute, die du auf der Produktseite zeigst oder als Filter nutzt, kommen als attr_-Felder mit, etwa attr_color.
• Der Lagerbestand kommt mit einer Menge, solange Magento ihn ohne Nachbestellungen verwaltet. Was offene Bestellungen reserviert haben, ist schon abgezogen.
• Importierst du deine Magento-Produkte schon über einen Feed? Entfern den Feed unter Store data → Feeds, sobald die Produkte da sind, damit sie nicht doppelt erscheinen.

bluebarry live schalten

• Quizze: Kopier den Quiz-Link aus dem Veröffentlichen-Dialog des Quiz (Tab Implementation, Magento) und nutz ihn als Link auf einem Button oder Banner.
• Suche: Öffne deine Suchkonfiguration in bluebarry, geh zu Launch und schalte Search on your store ein. Schalte auch Full results page ein, damit die Suchergebnisseite von Magento die Ergebnisse von bluebarry zeigt. Mehr dazu in Suche in deinem Shop starten.

bluebarry auf deinen Produkt- und Warenkorbseiten zeigen

Geh in bluebarry zu Store data → Integrations, klick bei Magento auf Manage und öffne On your store. Schalte ein, was du zeigen willst:

• Product check button: ein Button „Is this right for me?“ unter dem Warenkorb-Button, bei Produkten mit einem Produkt-Check-Quiz. Diese Produkte wählst du im Schritt Launch des Quiz.
• Product chat: unter dem Warenkorb-Button.

Empfehlungsblöcke für Produktseiten und den Warenkorb schaltest du unter Recommendations → Placements ein. Siehe Empfehlungen gestalten und in den Shop einbauen.

Klick auf Save. Dein Shop wird sofort aktualisiert, und an deinem Theme ändert sich nichts. Ist dein Shop von außen nicht erreichbar (zum Beispiel eine Staging-Seite hinter einem Passwort), übernimmt er die Änderung innerhalb einer Stunde. Dafür brauchst du Version 2.1.0 oder neuer des Moduls, mit Luma, Hyvä und Themes, die darauf aufbauen.

Widgets

Um etwas an einer anderen Stelle zu platzieren, nutz ein Widget. Klick im Magento Admin in einer Seite oder einem Block auf Insert Widget, oder leg eins unter Content → Widgets an. Das Modul bringt fünf mit:

• bluebarry quiz button: ein Button, der ein Quiz öffnet.
• bluebarry quiz popup: öffnet ein Quiz als Popup nach einigen Sekunden, nach einem Teil der Seite oder wenn der Besucher die Seite verlassen will.
• bluebarry product check button: der Produkt-Check-Button, auf einer Produktseite.
• bluebarry recommendations: ein Empfehlungsblock. Auf einer Produktseite empfiehlt er passend zu diesem Produkt, überall sonst passend zum Warenkorb.
• bluebarry product chat: der Produkt-Chat.

Die Quiz-Widgets fragen nach einer Quiz ID. Der Schritt Launch des Quiz zeigt sie zum Kopieren.

Rabatte werden zu Gutscheincodes

Ab Version 2.1.0 legt das Modul die Rabattcodes, die bluebarry vergibt, als einmalige Magento-Gutscheincodes an. Du musst nichts einrichten.

• Angebote aus Quizzen und Empfehlungen: Sobald der Kunde ein Produkt aus dem Angebot in den Warenkorb legt, erstellt das Modul einen Code, der nur für diese Produkte gilt, und legt ihn in den Warenkorb. Der Kunde muss keinen Code eingeben. Siehe Bundles und Rabatte anbieten.
• A unique code per person aus einem Popup oder der E-Mail-Frage eines Quiz: ein Code für jeden Kunden, der sich anmeldet. Siehe Popup-Formulare aufbauen und Einen Rabattcode auf der Ergebnisseite anbieten.
• Ein Magento-Warenkorb nimmt nur einen Gutscheincode an. Hat der Kunde selbst einen Code eingegeben, behält er diesen.
• Die Codes liegen unter Warenkorb-Preisregeln mit dem Namen bluebarry: … in Marketing → Cart Price Rules. Lass diese Regeln, wie sie sind: Löschst du eine, gelten ihre Codes nicht mehr. Die Cronjobs von Magento entfernen einen Code, sobald er abgelaufen ist.

Gut zu wissen

• Eine Bestellung zählt, sobald sie bezahlt ist: wenn Magento sie auf processing oder complete setzt. Bestellungen per Überweisung, Scheck oder Nachnahme zählen, sobald du sie in Rechnung stellst.
• Ist der Cookie-Einschränkungsmodus von Magento aktiv, wird eine Bestellung nur mit der Person verknüpft, wenn sie Cookies erlaubt hat.
• Bestellbeträge werden in der Währung gemeldet, in der bezahlt wurde.
• Websites mit derselben Tenant ID teilen sich einen Katalog in bluebarry: den der Standard-Website.
• Stell Write conversion requests to debug log auf Yes, wenn Bestellungen nicht ankommen. Das Modul schreibt dann in var/log/bluebarry.log, was es gesendet hat.