Sync Data

Anpassung der Produktdaten #

Senden einfacher Attribute aus dem Magento 2 Admin #

Wenn die Attribute, die Sie senden möchten, bereits als einfache Attribute in Ihrem Magento 2 Admin verfügbar sind, können sie einfach auf der Erweiterungsseite hinzugefügt werden.

1. Beginnen Sie mit Stores -> Produkt

Hier sehen Sie alle verfügbaren Attribute in Ihrem Shop. Finden Sie die Attributcodes derjenigen, die Sie an Clerk.io: senden möchten.

2. Stellen Sie sicher, dass Ihr Attribut sowohl Sichtbar als auch in Produktlisten verwendet wird. Sie können dies überprüfen, indem Sie auf das Attribut klicken und zu Storefront-Eigenschaften: gehen.

3. Gehen Sie zu Stores->Configuration->Clerk->Configuration

4. Unter Synchronisierung -> Zusätzliche Felder schreiben Sie die Attributcodes, getrennt durch Kommas :

5. Klicken Sie auf Konfiguration speichern in der rechten Ecke.

(**Wenn Sie die Clerk-Erweiterung nicht finden können, stellen Sie sicher, dass Sie den richtigen Shop auswählen, indem Sie auf " Scope" oben links klicken.)

6. Gehen Sie zu System -> Cache-Verwaltung

7. Leeren Sie die verschiedenen Caches hier:

8. Nachdem Sie Ihre Attribute implementiert haben, gehen Sie zu my.clerk.io->Data und klicken Sie auf Neue Daten-Synchronisierung starten in der oberen rechten Ecke.

Wenn die Attribute, die Sie senden möchten, bereits als Teil Ihrer konfigurierbaren/gruppierten Produktdaten in Ihrem Magento2 Admin verfügbar sind, können sie einfach mit der neuesten Version Ihres Plugins synchronisiert werden. Sie erscheinen als child_attribute, zum Beispiel child_color, child_skus usw.

Senden benutzerdefinierter Attribute #

Benutzerdefinierte Attribute können über die Erweiterung in FTP hinzugefügt werden.

Diese Datei verarbeitet die Produktattribute:

vendor->clerk->magento2->Model->Adapter->Product.php

Jedes Attribut hat seinen eigenen fieldHandler in der Funktion addFieldHandlers()

Fügen Sie einfach Ihr Attribut hier mit der folgenden Syntax hinzu:

$this->addFieldHandler('CLERK_ATTRIBUTE_NAME', function($item) {
   return MAGENTO2_LOGIC;
});

Wo CLERK_ATTRIBUTE_NAME den Namen definiert, den Sie in Clerk.io haben möchten, und MAGENTO2_LOGIC der Code ist, um das Attribut aus Magento 2 abzurufen.

Importieren einfacher Produktdaten für konfigurierbare Produkte #

Der folgende Code kann verwendet werden, um beliebige Daten, die Sie von einfachen Produkten innerhalb eines konfigurierbaren Produkts abrufen möchten, zu holen, damit Clerk.io sie als Array von Daten empfangen kann.

Dies ist besonders nützlich für Attribute wie SKUs, Größen oder Farben, um diese in Clerk.io durchsuchbar und filterbar zu machen.

Wie das oben genannte benutzerdefinierte Attribut-Skript können Produktdaten für konfigurierbare Produkte über die Erweiterung in FTP hinzugefügt werden.

Diese Datei verarbeitet die Produktattribute:

vendor->clerk->magento2->Model->Adapter->Product.php

Fügen Sie den folgenden Code in die Datei ein:

{%raw%}
$this->addFieldHandler('CLERK_ATTRIBUTE_NAME', function ($item) {
 $simple_products_array = [];
 if ($item->getTypeId() === Configurable::TYPE_CODE) {
  $simple_products = $item->getTypeInstance()->getUsedProducts($item);
   foreach ($simple_products as $product) {
    array_push($simple_products_array, $product->getATTRIBUTE_TEXT());
         }
       }
  return array_values(array_unique($simple_products_array));
            });
{%endraw%}

Wo CLERK_ATTRIBUTE_NAME den Namen definiert, den Sie in Clerk.io haben möchten, und getATTRIBUTE_TEXT die get-Funktion mit dem Text für das Attribut ist, das Sie aufrufen, zum Beispiel $product->getSKU().

Fügen Sie schließlich Ihre neuen Attribute in die Clerk.io Erweiterung im Magento 2 Admin unter Synchronisierung -> Zusätzliche Felder hinzu. (Wie in Punkt 4 erklärt)

Nachdem Sie Ihre Attribute implementiert haben, gehen Sie zu my.clerk.io->Data und klicken Sie auf Neue Daten-Synchronisierung starten in der oberen rechten Ecke.

Anpassung der Kundendaten #

Wie bei Produkten werden Kunden in Clerk.io durch Attribute dargestellt.

Durch das Senden von Kundenattributen können Sie Audience als Customer Data Platform (CDP) verwenden und Zielgruppen basierend auf beliebigen Attributen, die Sie senden, wie Region, Geschlecht, Steuercodes usw. erstellen.

Sie können hier mehr über die Art und Weise lesen, wie Magento2 Kundenattribute behandelt.

1. Beginnen Sie damit, herauszufinden, welche Attribute Sie verfügbar haben und was ihre Attributcodes sind. Sie finden dies im Magento2 Backend unter Stores > Attribute > Kunden.

2. Sobald Sie die Attributcodes haben, die Sie möchten, gehen Sie zu:

Stores > Einstellungen > Konfiguration > Clerk > Konfiguration > Kundensynchronisierung

3. Fügen Sie in Zusätzliche Kundenattribute eine durch Kommas getrennte Liste der Attribute hinzu, die Sie synchronisieren möchten.

4. Klicken Sie auf Konfiguration speichern.

5. Gehen Sie zu my.clerk.io > Data und klicken Sie auf Neue Daten-Synchronisierung starten, um die neuen Attribute zu synchronisieren:

Auswahl der zu importierenden Produkte #

Standardmäßig importiert die Magento 2 Erweiterung nur Produkte, die auf Lager und verkaufbar sind.

Dies kann bei Bedarf geändert werden.

Einbeziehen von nicht vorrätigen Produkten oder mit spezifischen Sichtbarkeiten #

Gehen Sie im Magento 2 Backend zu Stores->Configuration->Clerk->Configuration.

Unter Produkte-Synchronisierung haben Sie zwei Optionen zur Auswahl der Produkte, die importiert werden sollen:

• Nur verkaufbare Produkte synchronisieren lässt Sie wählen, ob Produkte gesendet werden sollen, die nicht gekauft werden können, aber dennoch angezeigt werden.

• Nur Produkte mit Sichtbarkeit synchronisieren lässt Sie eine spezifische Sichtbarkeit wählen, die die Produkte haben sollten.

Nachdem Sie Ihre Änderungen vorgenommen haben, klicken Sie auf Konfiguration speichern.

Wenn Sie dies tun, empfehlen wir Ihnen auch, ein zusätzliches Attribut zu Magento 2 hinzuzufügen, das angibt, wann ein Produkt nicht verkaufbar ist, damit Sie es in Ihrem Design anzeigen können.

Angenommen, Sie erstellen ein Attribut namens is_saleable, das entweder true oder false ist, können Sie es so in Designs verwenden:

{% raw %}
{% if product.is_saleable %}
   <div class="in-stock">Auf Lager</div>
{% else %}
  <div class="not-in-stock">Nicht auf Lager</div>
{% endif %}
{% endraw %}

Gehen Sie dann zu my.clerk.io -> Daten-Synchronisierung und klicken Sie auf Synchronisierung starten, um mit den neuen Regeln zu synchronisieren.

Hinzufügen benutzerdefinierter Regeln #

Die folgende Datei steuert, welche Produkte an Clerk.io: importiert werden.

vendor->clerk->magento2->Model->Adapter->Product.php

Suchen Sie am Ende dieser Datei die Funktion mit dem Namen prepareCollection().

Falls erforderlich, können Sie dieser Funktion erweiterte Regeln hinzufügen, um zu steuern, welche Produkte an uns gesendet werden:

Gehen Sie dann zu my.clerk.io -> Daten und klicken Sie auf Vollständige Daten-Synchronisierung starten, um mit den neuen Regeln zu synchronisieren.

Deaktivieren der Bestellsynchronisierung #

Nachdem die erste Daten-Synchronisierung erfolgreich durchgeführt wurde, kann die Bestellsynchronisierung von Magento2 deaktiviert werden, da das Verkaufs-Tracking von der Erweiterung übernommen wird.

Um die Bestellsynchronisierung zu deaktivieren, gehen Sie in Ihr Magento2 Backend, klicken Sie auf STORES und dann auf KONFIGURATION:

Scrollen Sie dann nach unten und finden Sie die Registerkarte mit dem Namen CLERK, klicken Sie darauf und drücken Sie KONFIGURATION:

Klicken Sie auf SYNCHRONISIERUNG, ändern Sie das Feld BESTELLSYNCHRONISIERUNG DEAKTIVIEREN auf NEIN und drücken Sie SPEICHERN oben auf der Seite:

Die Änderungen treten sofort in Kraft.