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 Audience → 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.

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 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 Integrations in bluebarry.
5. Gib einen API Key ein. Du erstellst ihn in bluebarry unter 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 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.

• 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 Products → 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 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.
• Recommendations on product pages: ein Empfehlungsblock unter den Produktdetails.
• Recommendations in the cart: ein Empfehlungsblock unter dem Warenkorb.

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.

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.