Zum Inhalt springen

Shopify Markets

Dieser Artikel behandelt die Shopify Markets-Integration, einschließlich des Umfangs, der Funktionsweise und der Nutzung Ihrer Markets-Daten in Ihrem Messaging.

So funktioniert die Integration

Shopify Markets erweitert Ihre bestehende Shopify-Integration. Verbinden Sie Ihren Standard-Storefront über den Integrationspfad Standard oder angepasst (SDK) und wählen Sie dann aus den konfigurierten Märkten Ihres Shops die Märkte aus, die Braze synchronisieren soll. Bei bestehenden Integrationen können Sie Märkte hinzufügen, ohne Kataloge, Abo-Gruppen oder Events zu beeinträchtigen. Eine Schritt-für-Schritt-Anleitung finden Sie unter Einrichtung von Shopify Markets.

Shopify Markets bietet die folgenden Funktionen:

  • Marktbezogene Profile: Die Integration erfasst die Shopify-Locale jedes Nutzers bzw. jeder Nutzerin zusammen mit den Standardattributen für Land und Sprache in Braze. So können Sie ohne angepasste Einrichtung nach Markt segmentieren und triggern.
  • Lokalisierte Kataloge: Marktspezifische Produktdaten werden täglich synchronisiert, einschließlich Preisen und Währung sowie übersetzten Titeln, Beschreibungen und Produkt-URLs.
  • Marktbezogene Personalisierung: Verwenden Sie das Liquid-Tag {% shopify_market %}, um mit Katalogprodukten aus dem Markt der jeweiligen Nutzer:innen zu personalisieren, einschließlich der übersetzten Inhalte von Shopify. Sie können auch auf Marktdetails wie die Darstellungswährung aus unterstützten Shopify-Events wie ecommerce.order_placed verweisen.
  • Fallback auf den Standard-Shop: Wenn Nutzer:innen keinem Ihrer verbundenen Märkte angehören, verwendet Braze die Einstellungen und Produkte Ihres Standard-Shops. So erhalten alle Nutzer:innen eine vollständige und korrekte Nachricht.

Beispiele finden Sie unter Marktbezogene Nutzerdaten verwenden und Tutorial: Produkte und Preise pro Markt anzeigen.

Unterstützte Shopify-Markttypen

Sie können bis zu 25 aktive Märkte mit einem oder mehreren Ländern auswählen. Jedes Land kann nur zu einem ausgewählten Markt gehören.

Märkte für Teilregionen, Einzelhandelsmärkte, B2B-Märkte und Kanalmärkte werden nicht unterstützt.

Anforderungen für jeden Markt

Jeder ausgewählte Markt benötigt einen Marktkatalog mit aktiven Produkten. Braze liest die folgenden Daten aus diesem Katalog:

Daten Beschreibung
Preise Im Marktkatalog in der angegebenen Währung des jeweiligen Markts festgelegt. Die Shopify-Einstellung „Use local currencies“ wird nicht unterstützt.
Übersetzungen Angepasste Übersetzungen, die über die Shopify-App Translate & Adapt erstellt wurden, z. B. Produkttitel und Variantentitel. Braze unterstützt derzeit keine marktspezifischen Spracheinstellungen.

Shopify-Marktprofil für einen Markt in Australien.

Überlegungen

Allgemein

  • Ein verbundener Shop: Sie können jeweils nur einen Shopify-Shop mit aktivierten Markets mit einem Braze-Workspace verbinden.
  • Umfang der Gebietsschemata: Gebietsschemata übernehmen übersetzte Produkttitel und -beschreibungen auf Grundlage Ihrer Konfiguration in der Shopify-App Translate & Adapt sowie gebietsschemaspezifische URLs. Preis, Währung und andere gemeinsame Katalogfelder bleiben innerhalb eines Markts für alle Gebietsschemata gleich. Standardmäßig verwendet Braze die Standardsprache jedes Markts, also das primäre Gebietsschema, das Shopify diesem Markt zuweist. Wenn Sie die erweiterte Unterstützung für Gebietsschemata aktivieren, synchronisiert Braze zusätzliche Gebietsschemata, die für diesen Markt konfiguriert sind.

Marktkatalog

  • Neue Marktansichten in Ihrem ursprünglichen Shopify-Katalog: Markets erstellt keine separaten Kataloge. Stattdessen zeigt Braze sie als Teil Ihres ursprünglichen Shopify-Katalogs an. Marktdaten werden Ihrem Shopify-Katalog als neue Katalogzeilen hinzugefügt.
  • Katalogauswahlen: Bis zu 30 Katalogauswahlen.
  • Aktualisierungszeitpunkt: Die Produktdaten des Marktkatalogs werden einmal täglich aktualisiert.
  • Marktpreise und lokalisierte Inhalte: Marktzeilen enthalten den Preis des Markts und compare_at_price, einschließlich lokalisierter Produkt- und Variantentitel sowie Produkt-URLs, wenn Übersetzungen über die Shopify-App Translate & Adapt eingerichtet sind.
  • Preissenkung: Wird für Marktkataloge unterstützt. Eine Preisänderung in einem Marktkatalog wird auf Grundlage des Preises dieses Markts getriggert und nicht auf Grundlage Ihres Standard-Shoppreises. Da die Produktdaten des Marktkatalogs einmal täglich aktualisiert werden, werden Preissenkungen täglich erkannt und nicht zu dem Zeitpunkt, an dem sich der Preis in Shopify ändert.
  • Wieder auf Lager: Wieder auf Lager wird für Produkte in Ihrem Standard-Shopkatalog unterstützt. Marktzeilen triggern keine Benachrichtigungen für „Wieder auf Lager“. „Wieder auf Lager“ berücksichtigt den gesamten verfügbaren Bestand einer Produktvariante über alle Shopify-Standorte hinweg, sodass Bestand, der an einem Einzelhandelsstandort hinzugefügt wird, eine Benachrichtigung triggern kann.

Shopify Markets einrichten

Wenn Sie bereits eine aktive Shopify-Integration haben

Markets erweitert Ihre bestehende Integration. Sie müssen sie weder trennen noch Ihr Setup neu aufbauen.

  • Ihre Abo-Gruppen werden zu Ihren shopweiten Gruppen und erhalten weiterhin jedes Opt-in, einschließlich aller zusätzlich zugewiesenen Gruppen.
  • Ihre bestehenden Abonnent:innen bleiben in den Gruppen, in denen sie bereits sind. Wenn Sie später Länder-Gruppen hinzufügen, fügt Braze bestehende Abonnent:innen diesen nicht hinzu.
  • Ihr Katalog wird weiterhin synchronisiert. Markt-Zeilen werden zu diesem Katalog hinzugefügt statt zu einem neuen Katalog, und Ihre bestehenden Auswahlen funktionieren weiterhin mit Ihren Standardzeilen.
  • Ihr Standard-Shop wird neben Ihren ausgewählten Märkten angezeigt, sodass Sie ihm auf dieselbe Weise Abo-Gruppen zuweisen und Katalogauswahlen dafür erstellen können.

Wenn Ihr Shop bereits verbunden ist, beginnen Sie mit Schritt 2, um mehr über die einzelnen Konfigurationen und ihre Funktionsweise zu erfahren.

Schritt 1: Verbinden Sie Ihren Shop mit aktiviertem Shopify Markets

  1. Verbinden Sie Ihren Shop entweder über die Shopify-Standardintegration oder die angepasste Shopify-Integration. Nachdem Ihr Shop verbunden ist, konfigurieren Sie Shopify Markets im Setup-Composer.
  2. Schließen Sie den OAuth-Flow ab und vergewissern Sie sich, dass Braze im OAuth die Markets-Scopes anfordert:
    • read_markets
    • read_publications
    • read_locales
  3. Nachdem die Autorisierung erfolgreich war und der Setup-Composer geöffnet ist, wählen Sie Begin Setup aus.
  4. Aktivieren Sie die Braze SDKs.

Schritt 2: Wählen Sie Ihre Market-Nutzerdaten aus

  1. Wählen Sie unter Track Shopify Data die Option Sync Shopify Markets data aus.
  2. Wählen Sie Select Markets aus, um Ihren Markt festzulegen, und stellen Sie sicher, dass Sie das Tracking von Verhaltens-Events und Nutzerattributen ausgewählt haben.
    • (Optional) Aktivieren Sie das historische Backfill.

Markets-Nutzerdaten

Zur Unterstützung von Shopify Markets synchronisiert Braze zusätzliche Daten über die Standard-Events und -Attribute der Integration hinaus.

Attribute des Nutzerprofils
Attribut Datentyp Beschreibung Datenquelle
shopify_locale Angepasstes Attribut Das Gebietsschema der Kund:in, z. B. en oder fr-CA. Das Braze Web-Pixel setzt es anhand der Browsersprache der Käufer:in, und jede Bestellung aktualisiert es auf das Gebietsschema, in dem der Checkout erfolgt ist. Das historische Backfill importiert es außerdem aus dem Shopify-Kundendatensatz. Änderungen der Kund:in in Shopify wirken sich nicht darauf aus. Web-Pixel, Bestell-Webhooks, historisches Backfill
browser_language Standardattribut Die im Browser der Kund:in eingestellte Sprache. Braze SDKs
country Standardattribut Das Land der Kund:in. Braze SDKs
Event-Eigenschaften von Bestellungen
Eigenschaft Beschreibung Datenquelle
country Zweistelliger Ländercode der Kund:in. Die default_address der Kund:in in Shopify oder die shipping_address der Bestellung, wenn keine Standardadresse festgelegt ist
presentment_currency Die Währung, in der die Kund:in bezahlt hat. Sie kann von Ihrer Shop-Währung abweichen. Präsentationswährung der Shopify-Bestellung
market_handle Handle des Markts, der dem Land der Kund:in entspricht. Leer, wenn kein konfigurierter Markt übereinstimmt. Braze, aus Ihrer Markt-Konfiguration

Diese Eigenschaften werden folgenden Events hinzugefügt:

  • Empfohlene E-Commerce-Events: ecommerce.order_placed, ecommerce.order_cancelled, ecommerce.order_refunded
  • Angepasste Events: shopify_paid_order, shopify_fulfilled_order, shopify_partially_fulfilled_order
So funktionieren diese Markt-Event-Eigenschaften
Eigenschaft Funktionsweise
market_handle market_handle ist das Handle, das Sie dem Markt in Shopify gegeben haben, z. B. france. Dasselbe Handle steht als Präfix vor den IDs der Markt-Zeilen in Ihrem Katalog, z. B. france_46714756268231. Es ist leer, wenn Sie keine Märkte konfiguriert haben oder das Land der Bestellung keinem konfigurierten Markt entspricht. Prüfen Sie daher auf einen leeren Wert, bevor Sie es in Liquid oder einem Segment-Filter verwenden.
country country stammt aus der Standardadresse der Kund:in. Wenn keine Standardadresse vorhanden ist, wird die shipping_address verwendet. Beispielsweise behält eine Kund:in in Frankreich, die eine Bestellung nach Japan schickt, trotzdem den Markt Frankreich.
Event-Eigenschaften Event-Eigenschaften sind eine Momentaufnahme des Zeitpunkts, zu dem das Event stattgefunden hat, und ändern sich danach nicht mehr. Wenn eine Kund:in später ihre Standardadresse aktualisiert, verwenden neue Events das neue Land, während vergangene Events das Land behalten, mit dem sie erfasst wurden.
Währung

Wenn das Reporting für Shopify Markets aktiviert ist, enthalten native Shopify-Webhook-Events für Checkout, Bestellung und Rückerstattung zwei Wertesätze:

  • Ihre Shop-Währung in den bestehenden Preis- und Summenfeldern, unverändert
  • Das Objekt presentment_currency mit den Beträgen, die die Kund:in gesehen und bezahlt hat

Diese Events können außerdem zugehörige Markt-Eigenschaften wie country und market_handle enthalten.

Verwenden Sie presentment_currency, wenn Sie einer Kund:in zeigen, was sie bezahlt hat, etwa in einer Bestellbestätigung oder einer Checkout-Erinnerung. Verwenden Sie die Werte in der Shop-Währung, wenn Sie den Umsatz über Märkte hinweg vergleichen, da diese bereits in einer einheitlichen Währung vorliegen.

Warenkorb-Events aus dem Shopify-Pixel enthalten kein presentment_currency. Auch angepasste Checkout- und Kauf-Events, die Sie über eine Customer Data Platform (CDP) wie Segment senden, enthalten es nicht. Um die Marktwährung in Ihren Nachrichten und im Reporting beizubehalten, fügen Sie Ihrem Payload für angepasste Events ein entsprechendes Objekt hinzu oder lassen Sie die nativen Shopify-Events für die benötigten Event-Typen aktiviert.

Lokalisierte Produktinformationen

Unterstützte Shopify-Events enthalten Produkt- und Variantentitel in der Standardsprache Ihres Shops. Braze übersetzt keine Event-Payloads.

Übersetzte Titel, Beschreibungen und Produkt-URLs befinden sich in den Markt-Zeilen Ihres Katalogs. Um lokalisierte Produktinformationen in einer Nachricht anzuzeigen, suchen Sie das Produkt in Ihrem Katalog anhand der Produkt- oder Varianten-ID aus dem Event.

Schritt 3: Nutzer:innen verwalten

  1. Wählen Sie Ihren external_id-Typ aus dem Dropdown-Menü aus.
  2. Aktivieren Sie E-Mail- und SMS-Opt-ins aus Shopify, damit Braze die E-Mail- und SMS-Abo-Status aus Shopify synchronisieren kann. Sie haben zwei Optionen:
    • Integration verwenden: Braze synchronisiert die E-Mail- und SMS-Status. Wählen Sie die Abo-Gruppen aus, in die synchronisiert wird.
    • Eigene Lösung erstellen: Für mehr Kontrolle über die Statusverwaltung erstellen Sie eine angepasste Integration mit den Braze-Endpunkten für Abo-Gruppen.
  3. Wählen Sie die Abo-Gruppen aus, in die die Shopify-Einwilligungen synchronisiert werden:
    • Shopweite Gruppen (erforderlich): Wählen Sie mindestens eine E-Mail-Gruppe und eine SMS-Gruppe aus. Jedes Opt-in, das Braze von Shopify erhält, wird hier erfasst.
    • Länder-Gruppen (optional): Weisen Sie jedem Land in Ihren synchronisierten Märkten eine oder mehrere Gruppen zu. Opt-ins werden zusätzlich hier erfasst, wenn Braze das Land der Kund:in ermitteln kann.

So funktionieren Opt-ins und Opt-outs

In Shopify hat jede Kund:in einen E-Mail-Einwilligungsstatus und einen SMS-Einwilligungsstatus. Bei einem Opt-in abonnieren Kund:innen Ihre Marke, nicht ein Land oder eine Liste.

Braze erfasst jedes Opt-in in Ihren shopweiten Gruppen. Wenn Sie Länder-Gruppen eingerichtet haben und Braze erkennen kann, in welchem Land sich die Kund:in befindet, wird das Opt-in auch in den Gruppen dieses Landes erfasst.

Wenn Sie keine Länder-Gruppen einrichten, landen Opt-ins nur in Ihren shopweiten Gruppen. Das entspricht dem aktuellen Umgang von Shopify mit Einwilligungen.

So ermittelt Braze das Land

Kanal Ermittlung des Landes
E-Mail Verwendet zuerst das Shopify-Gebietsschema der Kund:in; falls nicht verfügbar, das Länderattribut in ihrem Braze-Profil.
SMS Verwendet das Land der Telefonnummer, ermittelt anhand der E.164-Länder-Routing-Muster.

Ein Gebietsschema identifiziert ein Land nur, wenn es eine Region enthält, z. B. fr-FR. Ein Gebietsschema fr allein reicht dafür nicht aus.

Bei SMS stammt das Land aus der Telefonnummer. Die Käufer:in muss einer Abo-Gruppe hinzugefügt werden, die Nachrichten an diese Nummer senden kann.

Was bei einem Opt-in passiert

Länderstatus Shopweite Gruppen Länder-Gruppen
Ermittelt und in Ihren Märkten konfiguriert Abonniert Gruppen dieses Landes abonniert
Kann nicht ermittelt werden Abonniert Nicht abonniert
Ermittelt, aber nicht in Ihren Märkten konfiguriert Abonniert Nicht abonniert

Die Mitgliedschaft in Abo-Gruppen basiert auf Einwilligungs-Events aus Shopify. Wenn sich das Land oder Gebietsschema einer Käufer:in ändert, ändert sich ihre Gruppenmitgliedschaft nicht. Braze aktualisiert sie erst, wenn Shopify ein neues Einwilligungs-Event sendet, etwa wenn die Einwilligung der Käufer:in in Shopify nach der Änderung des Landes oder Gebietsschemas erneut eingeholt wird.

Was bei einem Opt-out passiert

Ein Opt-out in Shopify entfernt die Nutzer:in aus allen Abo-Gruppen, die Ihrer Shopify-Integration zugewiesen sind. Das gilt unabhängig davon, ob das Opt-out über eine Markt-Website oder über die Shopify-Kontoseite erfolgt ist.

Abo-Gruppen in Ihrem Workspace, die der Integration nicht zugewiesen sind, sind davon nicht betroffen.

Opt-ins aus nicht konfigurierten Ländern

Wenn eine Kund:in aus einem Land ein Opt-in abgibt, das nicht zu Ihren konfigurierten Märkten gehört – weil Sie es nie hinzugefügt oder den Markt entfernt haben –, abonniert sie Ihre shopweiten Gruppen. Sie wird keiner Länder-Gruppe hinzugefügt.

Die Konfiguration von Märkten schränkt nicht ein, wer Nachrichten erhalten kann. Wenn Sie ein Land aus rechtlichen oder regulatorischen Gründen nicht anschreiben dürfen, schließen Sie diese Nutzer:innen mit einem Segment-Filter aus oder leiten Sie sie in eine separate Abo-Gruppe.

Bei SMS steuern die Länderberechtigungen der jeweiligen Abo-Gruppe weiterhin die Zustellung. Nutzer:innen, deren Land für die Gruppe nicht zulässig ist, erhalten keine Nachrichten von ihr.

Nutzer:innen werden später nicht zu Länder-Gruppen hinzugefügt

Wenn Braze das Land einer Kund:in beim Opt-in nicht ermitteln kann, wird sie nur Ihren shopweiten Gruppen hinzugefügt. Wenn ihr Land später bekannt wird, wird sie nicht automatisch den Gruppen dieses Landes hinzugefügt.

Wenn Sie Markets in einem bestehenden integrierten Shop aktivieren, werden Ihre bestehenden Abo-Gruppen zu Ihren shopweiten Gruppen. Bestehende Abonnent:innen bleiben für diese Gruppen angemeldet und werden nicht automatisch neuen Länder-Gruppen hinzugefügt.

Um sie selbst hinzuzufügen, erstellen Sie ein Segment für diese Nutzer:innen und melden Sie sie über einen Canvas-Schritt Nutzer-Update an.

Abonnent:innen über Gruppen hinweg zählen

Ein einzelnes Opt-in kann eine Nutzer:in mehreren Abo-Gruppen hinzufügen. Wenn Sie die Gruppensummen addieren, wird dieselbe Person also mehrfach gezählt. Verwenden Sie ein Segment, wenn Sie die Anzahl eindeutiger Abonnent:innen benötigen.

So funktioniert es

  1. Eine Kund:in abonniert SMS beim Checkout oder über ein Formular.
  2. Shopify sendet das Abonnement an Braze.
  3. Braze setzt die Nutzer:in auf „ausstehend“ und sendet Ihre Bestätigungsnachricht.
  4. Die Kund:in antwortet mit Ihrem Bestätigungs-Keyword und ist damit angemeldet.
  5. Antwortet sie nicht vor Ablauf des Bestätigungszeitraums, bleibt sie im Status „ausstehend“.

Weitere Informationen finden Sie unter Double-Opt-in.

Schritt 4: Produkte synchronisieren

  1. Um Produkte innerhalb Ihres Markts zu synchronisieren, wählen Sie Sync Shopify products and variants to Braze aus.
  2. Weisen Sie die Braze-Katalog-ID zu und konfigurieren Sie alle weiteren Einstellungen.

Ihr Katalog enthält eine marktbezogene Ansicht der Standardprodukte Ihres Shops. Für jedes in Ihrem Markt veröffentlichte Produkt fügt Braze Ihrem bestehenden Katalog eine Markt-Zeile hinzu, zusätzlich zu den bereits unterstützten standardmäßigen Shopify-Katalogfeldern. Wenn Sie Shopify Markets in einer bestehenden Integration aktivieren, kann die Synchronisierung einige Minuten dauern.

In Market-Zeilen haben diese Felder Market-spezifische Werte:

Feld Beschreibung
id Eine zusammengesetzte ID mit dem Markt-Handle als Präfix, z. B. france_46714756268231. Standardzeilen behalten ihre ursprünglichen Artikel-IDs.
market_handle Das Handle, das Sie dem Markt in Shopify gegeben haben, z. B. france.
locale Das Gebietsschema des Markts, das die Sprache der übersetzten Inhalte bestimmt.
price Marktspezifischer Preis aus der kontextuellen Preisgestaltung des Markts, nach Anwendung etwaiger Preislistenanpassungen.
compare_at_price Marktspezifischer Vergleichspreis nach Anpassungen. Braze gibt 0 zurück, wenn für diesen Markt kein Vergleichspreis ermittelt werden kann, auch wenn die Preisliste des Markts so eingestellt ist, dass Vergleichspreise aufgehoben werden.
product_title und variant_title Übersetzte Titel, sofern Übersetzungen über die Shopify-App Translate & Adapt eingerichtet sind.
product_url Die URL des Produkts für diesen Markt.

Schritt 5: Kanäle aktivieren

  1. (Optional) Legen Sie fest, ob In-Browser-Messaging aktiviert werden soll.
  2. Wählen Sie Finish Setup aus.

Markets-Nutzerdaten verwenden

Sobald diese Attribute und Eigenschaften in den Nutzerprofilen vorhanden sind, können Sie Nutzer:innen nach Markt targetieren und Nachrichten personalisieren.

Targeting nach Markt in der Segmentierung

Filtern Sie in Segmenten sowie in den Entry-Kriterien von Campaigns oder Canvases nach Land, Browsersprache oder shopify_locale, beispielsweise nach Nutzer:innen in Frankreich oder nach einem Canvas-Pfad anhand von shopify_locale.

Sie können auch die Segmentfilter für Shopify Markets verwenden. Diese targetieren nach dem Markt, der mit der Bestellaktivität von Kund:innen verknüpft ist. Um nur Kund:innen zu erreichen, die Ihrem Standardmarkt zugeordnet sind, erstellen Sie ein Segment, das Nutzer:innen in jedem synchronisierten Nicht-Standardmarkt ausschließt. Beispiel: alle, die eine Bestellung aufgegeben haben, außer wenn der Markt Mexiko ist.

Informationen zur Auswahl von Katalogprodukten nach Markt-Handle (auch wenn market_handle für Standard-Produktzeilen default ist) finden Sie unter Tutorial: Produkte und Preise pro Markt anzeigen.

Mit Liquid triggern und personalisieren

Mit diesen Liquid-Variablen können Sie Marktdaten in Ihren Nachrichten referenzieren.

Aus dem Nutzerprofil

Attribut Liquid
Die Sprache der Kund:innen {{custom_attribute.${shopify_locale}}}
Das Land der Kund:innen {{${country}}}

Aus Bestell-Events

Event-Eigenschaft Liquid
Das Land der Bestellung {{event_properties.${country}}}
Der Markt der Bestellung {{event_properties.${market_handle}}}
Die Währung, in der die Kund:innen bezahlt haben {{event_properties.${metadata}.presentment_currency.code}}
Der Bestellbetrag in dieser Währung {{event_properties.${metadata}.presentment_currency.<total_value>}}

Preise in der Währung der Kund:innen anzeigen

Kombinieren Sie einen Betrag immer mit seinem Währungscode. Ein Betrag ohne Währung ist der häufigste Fehler im Messaging für mehrere Märkte, denn „129,95“ bedeutet in jedem Markt etwas anderes.

Verwenden Sie den Bestellbetrag für Nachrichten auf Bestellebene, etwa eine Bestätigung, und den Produktpreis für Inhalte auf Produktebene, etwa einen Warenkorb oder eine Empfehlung.

Thanks for your order! Your total: {{event_properties.${metadata}.presentment_currency.code}}
{{event_properties.${metadata}.presentment_currency.<total field>}}

Da diese Eigenschaften mit dem Event übermittelt werden, bleibt die Nachricht für den Markt aller Kund:innen ohne zusätzliche Einrichtung korrekt.

Auf leere Werte prüfen

Zwei Werte sind nicht immer vorhanden, und beide werden falsch dargestellt, wenn sie fehlen.

market_handle ist leer, wenn das Land der Kund:innen keinem konfigurierten Markt entspricht. Prüfen Sie dies, bevor Sie darauf basierend verzweigen:

{% if event_properties.${market_handle} != blank %}
  ...
{% endif %}

compare_at_price gibt 0 zurück, wenn für diesen Markt kein Vergleichspreis ermittelt wird. Prüfen Sie auf 0, bevor Sie den Wert anzeigen oder einen Rabatt berechnen, da Kund:innen sonst einen durchgestrichenen Preis von null sehen.

Lokalisierte Produktinformationen anzeigen

Produktnamen in Events sind in der Standardsprache Ihres Shops. Um übersetzte Titel, Beschreibungen oder Produkt-URLs anzuzeigen, suchen Sie das Produkt anhand der Produkt- oder Varianten-ID aus dem Event in Ihrem Katalog. Ein Beispiel finden Sie unter Tutorial: Produkte und Preise pro Markt anzeigen.

Nachrichten anhand von Bestellaktivitäten triggern

Markteigenschaften sind in unterstützten Shopify-Events enthalten, sodass eine durch eine Bestellung getriggerte Campaign oder ein Canvas sie ohne zusätzliche Einrichtung nutzen kann. Diese Events enthalten country, presentment_currency und market_handle.

Event-Typ Events
Empfohlene E-Commerce-Events ecommerce.order_placed, ecommerce.order_cancelled, ecommerce.order_refunded
Angepasste Events shopify_paid_order, shopify_fulfilled_order, shopify_partially_fulfilled_order

presentment_currency ist in unterstützten Checkout-, Bestell- und Rückerstattungs-Events enthalten, sodass eine Checkout-Erinnerung oder Bestellbestätigung den Betrag anzeigen kann, den Kund:innen gesehen haben. Warenkorb-Events enthalten weder presentment_currency noch country oder market_handle. Weitere Informationen finden Sie unter Währung.

Markets-Berichte

Wenn Markets aktiviert ist, schlüsselt Braze Umsatz und Nachrichten-Performance nach Land auf.

Umsatz nach Land

Ihr Umsatzbericht enthält neben der Aufschlüsselung nach App auch eine Aufschlüsselung nach Land, sowohl für die Lifetime als auch für einen ausgewählten Zeitraum.

Jede Bestellung wird genau einem Land zugeordnet, und ihr gesamter Umsatz wird diesem Land zugerechnet. Das Land wird zuerst aus der Bestellung und anschließend aus dem Profil der Käufer:innen ermittelt. Bestellungen, für die keine dieser Angaben verfügbar ist, erscheinen unter Unknown.

Der Umsatz wird wie im restlichen Umsatzbericht in USD angezeigt. Um zu sehen, was Käufer:innen tatsächlich bezahlt haben, verwenden Sie presentment_currency im Bestell-Event.

Performance nach Land

Die Analytics für Campaigns und Canvas enthalten eine Tabelle Performance nach Land, die zeigt, wie eine Nachricht in den einzelnen Ländern abgeschnitten hat, sowie eine Gesamtzeile für jedes Land. Währung und Gesamtumsatz werden anhand der presentment_currency der Bestellung aggregiert.

Spalte Was sie anzeigt
Land Jedes Land, das Ihre Nachricht erreicht hat.
Währung Die Währung des Umsatzes für dieses Land, aggregiert nach der presentment_currency.
Gesamtumsatz Der diesem Land zugeordnete Umsatz.
Käufe Die diesem Land zugeordneten Käufe.

Sie können die Performance von Campaigns und Canvas außerdem im Berichts-Builder nach Land aufschlüsseln, indem Sie Countries (Shopify Markets) als Zeile oder Drilldown verwenden.

Einen Markt entfernen

Wenn Sie einen Markt entfernen, synchronisiert Braze keine neuen Daten mehr für die zugehörigen Länder. Bereits vorhandene Daten werden dabei nicht gelöscht.

Abo-Gruppen

Das Entfernen eines Markts aktualisiert Ihre Markets-Konfiguration. Abo-Gruppen werden dabei nicht aus Ihrem Workspace gelöscht, und Nutzer:innen, die bereits Länder-Gruppen abonniert haben, werden nicht entfernt.

Was sich in Ihrem Setup ändert

  • Länder aus dem entfernten Markt werden in der Markets-UI nicht mehr angezeigt.
  • Braze entfernt die Abo-Gruppen-Zuordnungen dieser Länder aus Ihrer Integrationskonfiguration.

Was gleich bleibt

  • Länder-Abo-Gruppen bleiben in Ihrem Workspace erhalten und stehen weiterhin für das Targeting zur Verfügung, aber Shopify synchronisiert keine Opt-outs mehr dorthin. Nutzer:innen, die sich in Shopify abmelden, können in diesen Länder-Gruppen weiterhin als abonniert erscheinen, sofern Sie ihren Abo-Status nicht auf anderem Weg aktualisieren – zum Beispiel über die Endpunkte für Abo-Gruppen oder einen Opt-out-Workflow in Braze.
  • Nutzer:innen, die bereits Länder-Gruppen eines entfernten Markts abonniert haben, bleiben abonniert.
  • Neue Opt-ins von Käufer:innen in entfernten Ländern werden nur mit Ihren shopweiten Gruppen synchronisiert – genauso wie Opt-ins aus Ländern, die Sie nicht konfiguriert haben.
  • Braze synchronisiert keine neuen Opt-ins oder Opt-outs mehr mit den Länder-Gruppen der entfernten Länder.
  • Shopweite Abo-Gruppen erhalten weiterhin Updates zu Einwilligungen.

Nutzerdaten

  • Attribute, die bereits im Profil von Nutzer:innen gespeichert sind, einschließlich shopify_locale und country, ändern sich nicht.
  • Der market_handle in neuen Bestell-Events ist nicht mehr verfügbar.
  • Segment-Filter für Shopify Markets sind für entfernte Märkte nicht mehr verfügbar.
  • Liquid, das auf einen entfernten Markt verweist, ist nicht mehr verfügbar.

Kataloge

  • Marktzeilen für diesen Markt werden nicht mehr aktualisiert und aus Ihrem Katalog entfernt.
  • Katalogauswahlen, die auf diesen Marktzeilen basieren, geben keine Produkte mehr zurück. Aktualisieren oder entfernen Sie diese vor Ihrem nächsten Versand.
  • Ihre Standardzeilen und alle darauf basierenden Auswahlen sind davon nicht betroffen.

Tutorial: Produkte und Preise pro Markt anzeigen

Mit einem marktbezogenen Katalog erstellen Sie eine einzige Nachricht, die allen Nutzer:innen die Produkte und Preise ihres eigenen Marktes anzeigt.

  1. Erstellen Sie eine Selektion, die Marktdaten verwendet.
  2. Referenzieren Sie die Selektion mit Liquid in einer Nachricht.

Wenn eine Nachricht nur auf einen bestimmten Markt abzielt, können Sie einen festen Markt verwenden.

Schritt 1: Eine Selektion mit Marktdaten erstellen

Selektionen sind kuratierte Produktsets, die Sie in Nachrichten referenzieren. Bei Shopify-Katalogen mit synchronisierten Märkten enthält der Abschnitt Filter settings einen Bereich Market scope, der Produktdaten auf einen Markt beschränkt oder sie pro Nutzer:in personalisiert.

  1. Öffnen Sie Ihren Shopify-Katalog und wechseln Sie zum Tab Selections.
  2. Wählen Sie Create Selection aus. Benennen Sie dann die Selektion, fügen Sie optional eine Beschreibung hinzu und legen Sie ein Ergebnislimit fest.
  3. Wählen Sie unter Filter settings im Bereich Market scope im Dropdown-Menü Market aus, wie die Selektion marktspezifische Produkte auflöst:
    • Personalized: Alle Empfänger:innen sehen Produkte und Preise des Marktes, der zum Attribut country in ihrem Profil passt.
    • Ein synchronisierter Markt: Wählen Sie einen Markt nach Namen aus, um die Selektion fest an die Produkte und Preise dieses Marktes zu binden. Verwenden Sie diese Option, wenn eine Nachricht nur auf einen einzigen Markt abzielt.
  4. Legen Sie gegebenenfalls weitere Filterkriterien fest und speichern Sie dann die Selektion.
  5. Wählen Sie unter Preview for user eine:n Nutzer:in aus, um zu sehen, was die Selektion für dieses Profil zurückgibt. Selektionen mit Personalized lassen sich erst in der Vorschau anzeigen, nachdem Sie eine:n Nutzer:in ausgewählt haben.
Ziel Filter
Ein bestimmter Markt market_handle = au
Nur Standardprodukte market_handle = default

Schritt 2: Marktbezogene Katalogselektionen zu Nachrichten hinzufügen

Um allen Nutzer:innen in einer einzigen Nachricht die Produkte ihres eigenen Marktes auszuspielen, erstellen Sie eine Selektion mit diesem Filter:

Name der Selektion Feld Operator Wert
market_products market_handle ist gleich {{shopify_market.handle}}
default_products market_handle ist gleich default

Beim Versand ersetzt Braze {{shopify_market.handle}} durch den Markt der jeweiligen Nutzer:innen, sodass market_products allen die richtigen Produkte liefert. default_products dient als Fallback für Nutzer:innen ohne passenden Markt.

Referenzieren Sie Ihre Selektion in Ihrer Nachricht mit dem Tag {% shopify_market %}:

{% shopify_market %}
{% if shopify_market.handle %}
  {% catalog_selection_items <your_catalog_name> <your_market-catalog_selection_name> %}
  {% for item in items %}
    {{ item.product_title }} — {{ item.price }}
  {% endfor %}
{% else %}
  {% catalog_selection_items <your_catalog_name> <your_default-catalog_selection_name> %}
  {% for item in items %}
    {{ item.product_title }} — {{ item.price }}
  {% endfor %}
{% endif %}
  • Platzieren Sie {% shopify_market %} vor {% catalog_selection_items %}, damit der Markt der Nutzer:innen festgelegt ist, bevor die Selektion ausgeführt wird.
  • Ersetzen Sie <your_catalog_name> durch Ihren Katalog und verwenden Sie Ihre eigenen Selektionsnamen, falls diese abweichen.
  • Die Prüfung von {{shopify_market.handle}} leitet Nutzer:innen ohne passenden Markt zu default_products weiter, sodass sie trotzdem Produkte statt einer leeren Nachricht erhalten.
  • Wenn Sie compare_at_price in Liquid verwenden, prüfen Sie auf „0“, bevor Sie den Wert anzeigen oder einen Rabatt berechnen. Ein Markt ohne Vergleichspreis zeigt sonst einen Preis von null an oder erzeugt einen falschen Rabatt.

Zeigen Sie die Vorschau als Nutzer:in in Ihrem Markt an, um zu bestätigen, dass die Nachricht die Produkte, Preise und übersetzten Titel dieses Marktes anzeigt.

New Stuff!