Skip to content

Shopify Standard-Integration einrichten

Auf dieser Seite erfahren Sie, wie Sie Braze mithilfe unserer Standardintegration für Nutzer:innen mit einem Shopify-Onlineshop in Shopify integrieren können. Wenn Sie eine Shopify-Headless-Website verwenden oder weitere angepasste Lösungen implementieren möchten, lesen Sie bitte den Abschnitt Einrichtung der angepassten Integration in Shopify.

1. Schritt: Verbinden Sie Ihren Shopify-Shop

  1. Gehen Sie in Braze zu Partnerintegrationen > Technologie-Partner und suchen Sie dann nach „Shopify“.
  2. Wählen Sie auf der Shopify-Partnerseite Begin setup, um die Integration zu starten.

    Shopify-Integrationsseite mit Button, um mit der Einrichtung zu beginnen.

  3. Installieren Sie im Shopify App Store die Braze-Anwendung.

    Die Braze-App-Store-Seite mit einem Button zur Installation der Anwendung.
  1. Nach der Installation der Braze-App werden Sie zu Braze weitergeleitet, um den Workspace zu bestätigen, den Sie mit Shopify verbinden möchten. Ein Shopify-Shop kann nur mit einem Workspace verbunden werden. Wenn Sie wechseln müssen, wählen Sie den richtigen Workspace aus.

    Ein Fenster, das Sie auffordert zu bestätigen, dass Sie sich im richtigen Workspace befinden.
  1. Wählen Sie Begin setup.

    „Integrationseinstellungen“ mit einem Feld zur Eingabe der Domain und einem Button zum Starten der Einrichtung.

2. Schritt: Braze Web SDKs aktivieren

Für Shopify-Onlineshops können Sie das Standard-Setup auswählen, um das Braze Web SDK und das JavaScript SDK automatisch zu implementieren.

Schritt „Web SDK aktivieren“ mit Optionen zur Implementierung über eine Standardeinrichtung oder eine angepasste Einrichtung.

Nachdem Sie den Standard-Onboarding-Pfad ausgewählt haben, müssen Sie aus einer der folgenden Optionen auswählen, wann Braze die SDKs initialisieren und laden soll:

  • Beim Seitenbesuch, z. B. zu Beginn der Sitzung
    • Tracking von identifizierten und anonymen Nutzer:innen
  • Bei der Kontoanmeldung, z. B. beim Account-Login
    • Nur identifizierte Nutzer:innen tracken
    • Startet das Tracking von Daten, wenn sich Besucher:innen der Website registrieren oder bei ihren Konten anmelden

3. Schritt: Konfigurieren Sie Ihre Shopify-Daten

Standard-Dateneinrichtung

Jetzt wählen Sie die Shopify-Daten aus, die Sie tracken möchten.

Abschnitt „Tracking von Shopify-Daten“ mit einem Kontrollkästchen zum Tracking von Verhaltens-Events und Nutzerattributen.

Die folgenden Events werden in der Standardintegration standardmäßig aktiviert.

Von Braze empfohlene Events Angepasste Shopify-Events Angepasste Shopify-Attribute
  • Produkt angesehen
  • Warenkorb aktualisiert
  • Checkout gestartet
  • Bestellung aufgegeben
  • shopify_account_login
  • shopify_paid_order
  • shopify_order_canceled
  • shopify_order_refunded
  • shopify_order_fulfilled
  • shopify_order_partially_fulfilled
  • shopify_tags
  • shopify_total_spent
  • shopify_order_count
  • shopify_last_order_id
  • shopify_last_order_name
  • shopify_zipcode
  • shopify_province

Weitere Informationen zu den Daten, die durch die Integration getrackt werden, finden Sie unter Shopify-Daten-Features.

Historisches Backfill einrichten

Wählen Sie im Schritt Track Shopify data das Kontrollkästchen aus, um den anfänglichen historischen Datenimport als Teil Ihrer Integration einzuschließen.

Informationen zu den importierten Daten, zum Verhalten der Umsatzberichterstattung, zu Screenshots der Einrichtung und zur Vorgehensweise, wenn Sie Braze bereits mit aktiven Campaigns oder Canvases nutzen, finden Sie unter Historisches Backfill.

(Fortgeschritten) Angepasstes Daten-Tracking einrichten

Mit den Braze SDKs können Sie angepasste Events oder angepasste Attribute tracken, die über die Standard-Events für diese Integration hinausgehen. Angepasste Events erfassen einzigartige Interaktionen in Ihrem Shop, wie zum Beispiel:

(Fortgeschritten) Angepasstes Daten-Tracking einrichten
Angepasste Events Angepasste Attribute
  • Einen angepassten Rabattcode verwenden
  • Mit einer personalisierten Produktempfehlung interagieren
  • Der Bestellung eine Geschenkbotschaft beifügen
  • Bevorzugte Marken oder Produkte
  • Bevorzugte Einkaufskategorien
  • Mitgliedschafts- oder Treuestatus

Das Tracking angepasster Daten bietet tiefere Insights in das Nutzerverhalten und unterstützt eine zusätzliche Personalisierung. Um angepasste Events zu implementieren, müssen Sie den Theme-Code Ihres Storefronts in der Datei theme.liquid bearbeiten. Möglicherweise benötigen Sie die Hilfe Ihrer Entwickler:innen.

Das folgende JavaScript-Snippet prüft zum Beispiel, ob die aktuelle Nutzer:in einen Newsletter abonniert hat, und protokolliert dies als angepasstes Event im Nutzerprofil in Braze:

1
2
3
4
5
6
7
8
9

braze.logCustomEvent(
  “subscribed_to_newsletter”,
  {
    newsletterName: ‘News and Offers’,
    customerEmail: ‘customer_1@gmail.com’,
    sendOffers: true
  }
);

Das SDK muss auf dem Gerät der Nutzer:in initialisiert sein (auf Aktivitäten lauschen), um Events oder angepasste Attribute zu protokollieren. Mehr über die Protokollierung angepasster Daten erfahren Sie unter User object und logCustomEvent object.

4. Schritt: Konfigurieren Sie die Nutzerverwaltung

Wählen Sie Ihren external_id-Typ aus der Dropdown-Liste aus.

Abschnitt „Abonnent:innen sammeln“.

Standardmäßig wandelt Braze E-Mails von Shopify automatisch in Kleinbuchstaben um, bevor sie als externe ID verwendet werden. Wenn Sie E-Mail oder gehashte E-Mail als externe ID verwenden, vergewissern Sie sich, dass Ihre E-Mail-Adressen ebenfalls in Kleinbuchstaben umgewandelt werden, bevor Sie sie als externe ID zuweisen oder bevor Sie sie aus anderen Datenquellen hashen. Dies hilft, Diskrepanzen bei externen IDs zu vermeiden und die Erstellung doppelter Nutzerprofile in Braze zu verhindern.

Schritt 4.1: Erstellen Sie das Metafeld braze.external_id

  1. Gehen Sie in Ihrem Shopify-Admin-Panel zu Settings > Metafields and metaobjects.
  2. Wählen Sie Customers > Add definition.
  3. Geben Sie für Name braze.external_id ein.
  4. Wählen Sie den automatisch generierten Namespace und Schlüssel (custom.braze_external_id) aus, um ihn zu bearbeiten und in braze.external_id zu ändern.
  5. Wählen Sie unter Type den ID Type aus.

Nachdem Sie das Metafeld erstellt haben, füllen Sie es für Ihre Kund:innen aus. Wir empfehlen die folgenden Ansätze:

  • Auf Webhooks zur Kund:innen-Erstellung lauschen: Richten Sie einen Webhook ein, um auf customer/create-Events zu lauschen. Damit können Sie das Metafeld schreiben, wenn eine neue Kund:in angelegt wird.
  • Bestehende Kund:innen nachfüllen: Verwenden Sie die Admin API oder die Customer API, um das Metafeld für zuvor erstellte Kund:innen zu füllen.

Mögliche Race-Condition

Der Shopify-Webhook customers/create kann ausgelöst werden, bevor das Metafeld braze.external_id in das Nutzerprofil geschrieben wurde. In diesem Fall:

  1. Wenn das Metafeld fehlt, ruft Braze den konfigurierten Endpunkt (Schritt 4.2) auf, um die externe ID abzurufen.
  2. Wenn auch dieser Aufruf fehlschlägt oder ein Timeout auftritt, erstellt Braze ein temporäres Nutzerprofil mit der Shopify-Kund:innen-ID als externe ID.
  3. Bei jedem nachfolgenden Event, bei dem das Metafeld vorhanden ist (z. B. customers/update oder orders/create für ein ecommerce.order_placed-Event), erkennt Braze automatisch die Abweichung und führt das temporäre Profil mit der korrekten externen ID zusammen.

Das bedeutet, dass temporäre doppelte Profile möglich sind, sich aber automatisch korrigieren. Sie müssen keine manuellen Maßnahmen ergreifen, um diese Profile zusammenzuführen.

Schritt 4.2: Erstellen Sie einen Endpunkt zum Abrufen Ihrer externen ID

Sie müssen einen öffentlichen Endpunkt erstellen, den Braze zum Abrufen der externen ID aufrufen kann. Dadurch kann Braze die ID in Szenarien abrufen, in denen Shopify das Metafeld braze.external_id nicht direkt bereitstellen kann.

Endpunkt-Spezifikationen

Methode: GET

Braze sendet die folgenden Parameter an Ihren Endpunkt:

Parameter Erforderlich Datentyp Beschreibung
shopify_customer_id Ja String Die Shopify-Kund:innen-ID.
shopify_storefront Ja String Der Storefront-Name für die Anfrage. Bsp.: <storefront_name>.myshopify.com
email_address Nein String Die E-Mail-Adresse der angemeldeten Nutzer:in.

Dieses Feld kann in bestimmten Webhook-Szenarien fehlen. Ihre Endpunkt-Logik sollte hier Nullwerte berücksichtigen (z. B. die E-Mail über die shopify_customer_id abrufen, wenn Ihre interne Logik dies erfordert).

Beispiel-Endpunkt

1

GET https://mystore.com/custom_id?shopify_customer_id=1234&[email protected]&shopify_storefront=dev-store.myshopify.com

Erwartete Antwort

Braze erwartet einen 200-Statuscode, der die externe ID als JSON zurückgibt:

1
2
3

{
  "external_id": "my_external_id"
}

Validierung

Es ist wichtig, dass Sie überprüfen, ob shopify_customer_id und email_address (falls vorhanden) mit den Kund:innen-Werten in Shopify übereinstimmen. Sie können die Shopify Admin API oder die Customer API verwenden, um diese Parameter zu validieren und das richtige braze.external_id-Metafeld abzurufen.

Fehlerverhalten und Zusammenführung

Jeder andere Statuscode als 200 wird als Fehler betrachtet.

  • Auswirkungen auf die Zusammenführung: Wenn der Endpunkt fehlschlägt (nicht 200 oder Timeout), kann Braze die externe ID nicht abrufen. Folglich wird die Zusammenführung zwischen der Shopify-Nutzer:in und dem Braze-Nutzerprofil zu diesem Zeitpunkt nicht stattfinden.
  • Wiederholungslogik: Braze kann standardmäßig sofortige Netzwerk-Wiederholungsversuche unternehmen. Wenn der Fehler jedoch weiterhin besteht, wird die Zusammenführung bis zum nächsten qualifizierenden Event aufgeschoben (z. B. wenn die Nutzer:in ihr Profil aktualisiert oder einen Checkout abschließt).
  • Verfügbarkeit: Um die rechtzeitige Zusammenführung von Nutzer:innen zu unterstützen, stellen Sie sicher, dass Ihr Endpunkt hochverfügbar ist und das optionale Feld email_address zuverlässig verarbeitet.

Schritt 4.3: Geben Sie Ihre externe ID ein

Wiederholen Sie Schritt 4 und geben Sie Ihre Endpunkt-URL ein, nachdem Sie die angepasste externe ID als Ihren externen Braze-ID-Typ ausgewählt haben.

Überlegungen

  • Wenn Ihre externe ID nicht generiert wird, wenn Braze eine Anfrage an Ihren Endpunkt sendet, verwendet die Integration standardmäßig die Shopify-Kund:innen-ID, wenn die Funktion changeUser aufgerufen wird. Dieser Schritt ist entscheidend für die Zusammenführung des anonymen Nutzerprofils mit dem identifizierten Nutzerprofil. Daher kann es vorübergehend vorkommen, dass in Ihrem Workspace verschiedene Arten von externen IDs existieren.
  • Wenn die externe ID im Metafeld braze.external_id verfügbar ist, wird die Integration diese externe ID priorisieren und zuweisen.
    • Wenn die Shopify-Kund:innen-ID zuvor als externe Braze-ID festgelegt wurde, wird sie durch den Wert des Metafelds braze.external_id ersetzt.

Schritt 4.4: Sammeln Sie Ihre E-Mail- oder SMS-Opt-ins von Shopify (optional)

Sie haben die Möglichkeit, Ihre Opt-ins für E-Mail- oder SMS-Marketing von Shopify zu sammeln.

Wenn Sie die Kanäle E-Mail oder SMS nutzen, können Sie Ihre Opt-in-Status für E-Mail- und SMS-Marketing mit Braze synchronisieren. Wenn Sie Opt-ins für das E-Mail-Marketing von Shopify synchronisieren, erstellt Braze automatisch eine E-Mail-Abo-Gruppe für alle Nutzer:innen, die mit diesem Shop verbunden sind. Sie müssen einen eindeutigen Namen für diese Abo-Gruppe erstellen.

Abschnitt „Abonnent:innen sammeln“ mit der Option, Opt-ins für E-Mail- oder SMS-Marketing zu sammeln.

5. Schritt: Produkte synchronisieren (optional)

Sie können alle Produkte aus Ihrem Shopify-Shop mit einem Braze-Katalog synchronisieren, um die Personalisierung von Nachrichten zu vertiefen. Automatische Updates erfolgen nahezu in Realtime, sodass Ihr Katalog stets aktuelle Produktdaten enthält. Mehr dazu erfahren Sie unter Shopify-Produktsynchronisation.

Schritt 4 der Einrichtung mit „Shopify Variant ID“ als „Bezeichner für das Produkt im Katalog“.

6. Schritt: Kanäle aktivieren (optional)

Sie können In-Browser-Nachrichten ohne Entwickler:in aktivieren, indem Sie sie in Ihrem Setup konfigurieren.

Einrichtungsschritt zur Aktivierung von Kanälen, wobei die verfügbare Option In-Browser-Messaging ist.

Unterstützung für zusätzliche SDK-Kanäle

Die Braze SDKs ermöglichen verschiedene Messaging-Kanäle, einschließlich Content Cards.

Content Cards und Feature-Flags

Um Content Cards oder Feature-Flags hinzuzufügen, müssen Sie mit Ihren Entwickler:innen zusammenarbeiten, um den erforderlichen SDK-Code direkt in Ihre theme.liquid-Datei einzufügen. Eine ausführliche Anleitung finden Sie unter Integration des Braze SDK.

Web-Push-Benachrichtigungen

Web-Push wird für die Shopify-Integration derzeit nicht unterstützt. Um Support anzufordern, stellen Sie eine Produktanfrage über das Braze-Produktportal.

7. Schritt: Einrichtung abschließen

  1. Nachdem Sie Ihre Einrichtung konfiguriert haben, wählen Sie Finish Setup.
  2. Aktivieren Sie die Braze-App-Einbettung in Ihren Shopify-Themeneinstellungen. Wählen Sie Open Shopify, um zu Ihrem Shopify-Konto weitergeleitet zu werden und die App-Einbettung in den Themeneinstellungen Ihres Shops zu aktivieren.

Ein Banner, das darauf hinweist, dass Sie die Braze-App-Einbettung in Shopify aktivieren müssen, und einen Button zum Öffnen von Shopify enthält.

  1. Nachdem Sie die App-Einbettung aktiviert haben, ist Ihre Einrichtung abgeschlossen! Bestätigen Sie, dass Sie Ihre Integrationseinstellungen, den Status der ersten Datensynchronisation und Ihre aktiven Shopify-Events einsehen können.

    Shopify-Partnerseite mit den Integrationseinstellungen.
New Stuff!