Shopify-Events und -Kampagnen

Nachdem Sie die App verbunden und die von Shopify angeforderten Berechtigungen für die Nachverfolgung von Bestellungen, Warenkörben und Checkouts genehmigt haben (read_orders, write_pixels, read_customer_events), beginnen Bestell-, Checkout- und Checkout-Schritt-Events ohne separaten Pushwoosh-Tracking-Bildschirm einzutreffen. Siehe Voraussetzungen und Teil 1 für den Genehmigungsschritt. Storefront-Browsing (Produktansichten und In-den-Warenkorb-Legen) benötigt außerdem Push Init Embed ON.

Die Nachverfolgung umfasst drei unabhängige Event-Gruppen. Jede benötigt unterschiedlichen Zugriff, sodass das Deaktivieren einer Gruppe die anderen nicht pausiert:

• Bestellzahlung und Checkout: treffen von Shopify ein, auch wenn das Theme-Embed deaktiviert ist
• Storefront-Browsing (Produktansichten und In-den-Warenkorb-Legen): benötigen das Theme-Embed ON
• Checkout-Schritte: benötigen Shopifys Checkout-Tracking-Berechtigungen aus Teil 1 (write_pixels und read_customer_events), separat von der oben genannten Bestell-Tracking-Berechtigung (read_orders) genehmigt

Bevor Sie die App verbinden, prüfen Sie wie Pushwoosh Geld- und Datumsattributtypen behandelt für PW_OrderCreated und PW_AbandonedCart. Ein falscher Typ, der gesendet wird, bevor Sie es bemerken, kann nicht rückwirkend korrigiert werden.

Bestellzahlungs- und Checkout-Events

Verwenden Sie diese für Nachrichten nach dem Kauf (PW_OrderCreated), Journeys oder Segmente für abgebrochene Checkouts (PW_AbandonedCart / PW_AbandonedCartUpdate) und Kaufkonversions-Zuordnung. Sie treffen von Shopify ein, auch wenn der Käufer das Browser-Tracking blockiert:

Erfordert verbundene App und genehmigtes read_orders

Kein zusätzlicher Schalter nötig: Verbinden Sie die App in Teil 1 und genehmigen Sie Shopifys Bestell-Tracking-Berechtigung (read_orders). Anders als beim Storefront-Browsing hängen diese Events nicht davon ab, ob das Theme-Embed aktiviert ist.

Event-Name in Pushwoosh	Wann es ausgelöst wird
PW_OrderCreated	Eine Bestellung wird bezahlt
PW_AbandonedCart	Ein Käufer startet den Checkout
PW_AbandonedCartUpdate	Der Käufer fügt Artikel hinzu, entfernt sie oder ändert sie während eines laufenden Checkouts

Diese entsprechen den Bestell- und Checkout-Benachrichtigungen, die Shopify automatisch an Pushwoosh sendet (die Webhooks orders/paid, checkouts/create und checkouts/update, aufgeführt unter Synchronisierte Entitäten).

Shopifys eigene Flow-Bedingung, der checkouts/create-Webhook und die Cart-Quelle des Products-Blocks sind drei verschiedene Dinge, die alle Warenkorbabbruch genannt werden. Wählen Sie anhand der folgenden Tabelle das, was zu Ihrem Vorhaben passt.

Was Sie erstellen möchten	Was Sie verwenden sollten
Erinnerung aus Shopify Flow (Shopifys eigene Cart abandonment-Bedingung)	Shopify Flow + Aktion Pushwoosh send notification. Nicht die PW_AbandonedCart-Event-Namen.
Erinnerung oder Segment in Pushwoosh bei gestartetem Checkout oder geändertem Warenkorb	Customer Journey oder Segment auf PW_AbandonedCart / PW_AbandonedCartUpdate
Die Warenkorbartikel des Käufers innerhalb einer E-Mail anzeigen	Cart-Quelle des Products-Blocks (verwendet den Tag PW_AbandonedCartID zum Sendezeitpunkt). Unabhängig davon, welcher Trigger die Journey gestartet hat.

Wie sich diese Events verhalten. checkouts/create bedeutet nur, dass ein Checkout gestartet wurde. Shopify hat noch nicht entschieden, dass er abgebrochen wurde, und auch keine Bestellung wurde bestätigt.

Während der Käufer den Checkout bearbeitet, wird PW_AbandonedCartUpdate erneut für denselben Checkout ausgelöst und überschreibt den aus PW_AbandonedCart gespeicherten Warenkorb. Erinnerungs-E-Mails, die die Cart-Quelle verwenden, übernehmen zum Sendezeitpunkt die aktuellsten Artikel. Sie benötigen keinen zweiten Journey-Trigger nur um den Warenkorb zu aktualisieren.

PW_AbandonedCart und PW_AbandonedCartUpdate setzen beim Käufer den Tag PW_AbandonedCartID, den die Cart-Quelle zum Sendezeitpunkt liest. PW_OrderCreated löscht ihn sofort, sodass ein Käufer, der bereits ausgecheckt hat, den Block überspringt, anstatt eine Erinnerung an einen Warenkorb zu erhalten, den er nicht mehr hat. Das genaue Löschverhalten finden Sie unter Was passiert, wenn Sie PW_OrderCreated senden.

Ein Käufer, der den Checkout zweimal startet, tritt der Journey nur erneut bei, wenn Sie dies zulassen

Standardmäßig lässt eine Customer Journey niemanden, der bereits darin ist, erneut eintreten. Ein zweites checkouts/create desselben Käufers, während dessen erste Journey für abgebrochene Warenkörbe noch läuft, wird daher ignoriert, nicht neu gestartet. Aktivieren Sie Allow re-entry am Trigger, wenn jeder neue Checkout stattdessen das Timing der Erinnerung zurücksetzen soll. Siehe Steuern, ob Benutzer die Kampagne erneut betreten können.

Attribute von Bestell- und Checkout-Events

PW_OrderCreated und PW_AbandonedCart enthalten:

Attribut	Beschreibung
orderId	Der Bestell- oder Checkout-Identifikator
email	Die E-Mail-Adresse des Käufers
totalPrice	Die Gesamtsumme der Bestellung oder des Warenkorbs
shippingAmount	Die Versandkosten
taxAmount	Der Steuerbetrag
discountAmount	Der Rabattbetrag
currency	Der Währungscode
items	Die Positionen des Warenkorbs
customerId	Nur für registrierte Kunden, nicht vorhanden bei Gast-Checkouts
orderUrl	Die Bestellstatusseite für PW_OrderCreated, oder die Wiederherstellungs-URL des abgebrochenen Checkouts für PW_AbandonedCart und PW_AbandonedCartUpdate. Verwenden Sie sie, um einen „Kauf abschließen“-Link oder eine Schaltfläche zu erstellen.
createdDate	Wann die Bestellung oder der Checkout erstellt wurde
abandonedDate	Nur für PW_AbandonedCart und PW_AbandonedCartUpdate. Wann der Warenkorb zuletzt berührt wurde, nicht wann er zuerst erstellt wurde

Die richtigen Geld- und Datumsattributtypen festlegen

Pushwoosh leitet den Typ jedes Attributs aus dem ersten gesehenen Event ab, und diese Ableitung ist unzuverlässig für Geld- und Datumsfelder wie totalPrice, shippingAmount, taxAmount, discountAmount und createdDate/abandonedDate oben. Ein ganzzahliger Preis wie 129 wird als Integer abgeleitet, was 129.90 bei jedem späteren Event auf 129 kürzt.

Die App noch nicht verbunden? Deklarieren Sie PW_AbandonedCart und PW_OrderCreated vorher mit den richtigen Typen, anhand der Tabelle in Erstellen Sie die Events in Ihrem Control Panel. Überspringen Sie den Schritt Send the events from your backend dieser Anleitung. Die Shopify-Integration sendet diese bereits für Sie.

Bereits verbunden? Prüfen Sie jetzt die Typen: Gehen Sie im Control Panel zu Audience → Events, öffnen Sie PW_AbandonedCart und PW_OrderCreated, und vergleichen Sie jedes Attribut mit derselben Tabelle. Das Korrigieren eines falschen Typs dort behebt ihn für die Zukunft, aber jeder Wert, der bereits mit dem falschen Typ gesendet wurde, ist unwiderruflich verloren.

Gast-Checkouts können weiterhin Bestell- und Warenkorb-Events senden, jedoch ohne registrierte Kunden-ID im Event.

PW_AbandonedCartUpdate enthält dieselben Attribute. Wenn Ihr Konto auch die Magento-Integration verbunden hat, posten deren Bestellungen und abgebrochene Warenkörbe an dieselben Event-Namen, sodass ein Segment oder eine Journey, die auf PW_OrderCreated / PW_AbandonedCart aufgebaut ist, beide Shops erfasst, und die obigen Attributtypen gelten ebenfalls für beide. Magento hat kein Äquivalent zu PW_AbandonedCartUpdate, da es laufende Checkout-Bearbeitungen nicht nachverfolgt.

items insbesondere trifft von Shopify mit nur wenigen ausgefüllten Feldern ein.

Warenkorbartikel werden aus Ihrem Produktkatalog angereichert

Die items, die Shopify bei PW_AbandonedCart und PW_AbandonedCartUpdate sendet, enthalten nur productId, name, sku, quantity und price. Pushwoosh füllt alles andere, was diesem Artikel noch fehlt, wie description, imageUrl, productUrl, category und andere Katalogfelder, aus dem passenden Produkt in Ihrem verbundenen Produktkatalog aus (siehe Automatische Produktkatalog-Verbindung), wann immer eine productId übereinstimmt. Dafür muss nichts zusätzlich gesendet werden. Ein im Katalog fehlendes Produkt wird einfach weiterhin mit den von Shopify gesendeten Feldern angezeigt.

Storefront-Browsing-Events

Verwenden Sie diese für Browse-Abandonment-Segmente oder -Journeys sowie für E-Mail-Empfehlungsstrategien, die Produktansichten benötigen (zum Beispiel Based on what they viewed). Siehe So richten Sie Produktempfehlungen in E-Mails ein.

Erfordert Push Init Embed ON

Schalten Sie Push Init Embed in Teil 4 auf ON. Dasselbe Theme-Embed wie für Web Push. Es muss nichts weiter zum Theme hinzugefügt werden.

Ist das Embed deaktiviert, oder blockiert ein Käufer dessen Skript, verlieren Sie nur Produktansichten und In-den-Warenkorb-Legen. PW_OrderCreated und PW_AbandonedCart treffen weiterhin von Shopify ein.

Beide Events werden vom selben Theme-Embed erfasst. Es muss nichts weiter zum Theme hinzugefügt werden, sobald Push Init Embed auf ON steht:

• PW_ProductViewed: Der Käufer öffnet eine Produktseite.
• PW_AddToCart: Der Käufer legt einen Artikel in den Warenkorb, ohne die Seite neu zu laden, so wie es die meisten Shopify-Themes tun.

Zwei Dinge, die Sie prüfen sollten, bevor Sie auf diesen Events aufbauen

• PW_ProductViewed zählt jedes Laden einer Seite, ohne Filterung. Neuladungen, wiederholte Ansichten innerhalb desselben Besuchs und sogar Bot-Traffic zählen alle genauso wie eine echte Produktansicht. Eine auf diesem Event aufgebaute Empfehlungsstrategie übernimmt dieses Rauschen.
• PW_AddToCart wird nur ausgelöst, wenn die Add to cart-Schaltfläche Ihres Shops die Seite nicht neu lädt. Testen Sie dies selbst: Klicken Sie in Ihrem Shop auf Add to cart und beobachten Sie, was passiert. Wird nur der Warenkorb-Zähler aktualisiert, oder wird die ganze Seite neu geladen? Die meisten Shopify-Themes tun Ersteres und aktualisieren den Zähler ohne Neuladen (eine Hintergrundanfrage an /cart/add). Lädt Ihr Theme stattdessen die Seite neu, wird PW_AddToCart niemals ausgelöst, aber PW_ProductViewed sowie die Bestell-/Checkout-Events funktionieren trotzdem einwandfrei.

Attribute von Storefront-Browsing-Events

Beide Events enthalten:

Attribut	Beschreibung
items	Das angesehene oder hinzugefügte Produkt/die Produkte, jeweils mit productId, name, sku, quantity, price
totalPrice	Der kombinierte Preis der items
productUrl	Die Seite, auf der sich der Käufer befand
currency	Nur wenn der Storefront sie bereitstellt

Eine Nachricht, die totalPrice anzeigt, benötigt einen Fallback für den Fall, dass currency fehlt, da die Zahl allein nicht angibt, in welcher Währung sie ist.

Keines der beiden Events führt email oder customerId als Attribut mit. Der Käufer wird auf dieselbe Weise identifiziert wie der Rest des Theme-Embeds — über die SDK-Sitzung, die an die Metafeld-Benutzer-ID gebunden ist (siehe Teil 2), nicht über die Event-Payload.

Die items von PW_ProductViewed und PW_AddToCart enthalten dieselben Felder, die Shopify vor der Anreicherung sendet: productId, name, sku, quantity, price. Pushwoosh füllt für diese beiden Events nicht die übrigen Katalogfelder aus, wie es bei den items von PW_AbandonedCart der Fall ist (siehe Warenkorbartikel werden aus Ihrem Produktkatalog angereichert oben).

Eine Empfehlungsstrategie, die vollständige Produktdetails benötigt, wie Based on what they viewed, schlägt diese beim Rendern der Nachricht anhand der productId in Ihrem Produktkatalog nach. Siehe So richten Sie Produktempfehlungen in E-Mails ein für die Anforderungen der einzelnen Strategien.

Checkout-Schritt-Events

Verwenden Sie diese, um zu sehen, wo Personen vor dem Kauf abspringen, und um Personen zu erreichen, die den Checkout gestartet, aber keine bezahlte Bestellung abgeschlossen haben.

Erfordert Pixel-bezogene App-Berechtigungen

Genehmigen Sie die Checkout-Tracking-Berechtigungen, die Shopify beim Verbinden der App anfragt (write_pixels und read_customer_events). Siehe Teil 1 für diesen Schritt. Kein Theme-Embed-Schritt nötig. Shopify meldet diese Meilensteine automatisch, sobald diese Berechtigungen genehmigt sind (technisch über Shopifys Web Pixel).

• PW_CheckoutContactInfo: Der Käufer hat seine Kontaktdaten eingegeben.
• PW_PaymentInfoSubmitted: Der Käufer hat seine Zahlungsdaten übermittelt.

Ein abgeschlossener Verkauf ist PW_OrderCreated aus dem obigen Abschnitt, nicht diese beiden Events.

PW_AbandonedCart sagt Ihnen nur, dass ein Checkout gestartet wurde. Diese beiden Events markieren zwei spätere Punkte im selben Checkout, in dieser Reihenfolge: zuerst Kontaktdaten, dann Zahlungsdaten. Ein Käufer, der PW_PaymentInfoSubmitted erreicht hat und nie ein anschließendes PW_OrderCreated erhielt, ist weiter gekommen als einer, der nur PW_AbandonedCart ausgelöst hat, sodass eine auf dieser Stufe aufgebaute Nachricht gezielt eine ins Stocken geratene Zahlung ansprechen kann, statt einer generischen Warenkorb-Erinnerung.

Attribute von Checkout-Schritt-Events

Beide Events enthalten:

Attribut	Beschreibung
items	Die Positionen des Checkouts, jeweils mit productId, name, sku, quantity, price
orderId	Das Checkout-Token, oder die Shopify-Bestell-ID, sobald der Checkout eine hat
totalPrice	Die Checkout-Gesamtsumme
email	Nur wenn der Checkout eine hat. Ein telefonbasierter Checkout (keine E-Mail eingegeben) sendet das Event ohne sie.
currency	Nur wenn der Checkout eine hat

Prüfen, dass es funktioniert

Führen Sie die entsprechende Aktion im Shop aus und bestätigen Sie dann, dass der Event-Name in Pushwoosh erscheint. Das Event selbst wird in Echtzeit verarbeitet, aber die beiden Stellen, an denen Sie es prüfen würden, reagieren unterschiedlich auf einen Namen, den Pushwoosh noch nicht gesehen hat:

• Im Event-Dropdown, wenn Sie ein Segment nach Events erstellen, erscheint ein neuer Name sofort.
• Im Event-Dropdown, wenn Sie einen Customer Journey-Trigger hinzufügen, kann es bis zu 10 Minuten dauern, bis ein neuer Name erscheint (dieses Dropdown wird zwischengespeichert). Wenn Sie ihn noch nicht sehen, warten Sie, statt anzunehmen, dass die Integration defekt ist.

Testaktion	Event
Eine Testbestellung bezahlen	PW_OrderCreated
Einen Checkout starten	PW_AbandonedCart
Artikel in diesem Checkout ändern	PW_AbandonedCartUpdate
Eine Produktseite öffnen (Push Init Embed ON)	PW_ProductViewed
Einen Artikel in den Warenkorb legen	PW_AddToCart
Kontaktdaten beim Checkout eingeben	PW_CheckoutContactInfo
Zahlungsdaten beim Checkout übermitteln	PW_PaymentInfoSubmitted

Die Events verwenden

Sobald Sie wissen, welches Event Sie benötigen, verwenden Sie es an zwei Stellen:

• Als Trigger oder Segmentbedingung: Wählen Sie es im Event-Dropdown, wenn Sie ein Segment nach Events erstellen oder einen Customer Journey-Trigger hinzufügen.
• Im Nachrichtentext: Schalten Sie im Nachrichtenschritt Personalize message with event attributes ein und wählen Sie das Attribut (zum Beispiel die Bestellsumme aus PW_OrderCreated). Sie können das Attribut auch mit einem Liquid-Platzhalter einfügen. Siehe Dynamische Inhalte und Liquid-Vorlagen in Journeys.

Für bezahlte Bestellungen können Sie PW_OrderCreated auch als Conversion-Event zuordnen, damit Shopify-Käufe in die RFM-Segmentierung, Journey-Zuordnung und Product-Block-Statistiken einfließen.

Beispielkampagnen

Jede wird an einem anderen Punkt im Weg des Käufers ausgelöst und erreicht daher unterschiedliche Zielgruppen: Wie weit jemand vor dem Absprung gekommen ist, oder ob er den Checkout überhaupt erreicht hat, entscheidet, welche Kampagne zutrifft.

• Erinnerung an abgebrochenen Warenkorb. Erfasst jeden Käufer, der den Checkout gestartet hat, egal wie weit er gekommen ist — die breiteste Zielgruppe hier. Erstellen Sie sie als Customer Journey: Trigger auf PW_AbandonedCart, warten auf PW_OrderCreated, dann eine E-Mail mit einem Cart-Quelle-Block an alle senden, die noch nicht bezahlt haben. Die vollständige Einrichtung finden Sie unter So richten Sie eine Kampagne für abgebrochene Warenkörbe ein.
• Follow-up für ins Stocken geratene Checkouts. Erfasst nur Käufer, die es bis zur Eingabe der Kontaktdaten geschafft haben, aber nie bezahlt haben — ein engerer Ausschnitt der obigen Zielgruppe. Segmentieren Sie nach PW_CheckoutContactInfo, und schließen Sie dann alle aus, die auch PW_PaymentInfoSubmitted oder PW_OrderCreated haben.
• Wiederherstellung einer ins Stocken geratenen Zahlung. Erfasst Käufer, die die Zahlung erreicht, die Bestellung aber nie abgeschlossen haben — weiter fortgeschritten als das obige Follow-up und gegenseitig ausschließend dazu. Segmentieren Sie nach PW_PaymentInfoSubmitted, und schließen Sie dann alle aus, die auch PW_OrderCreated haben.
• Browse-Empfehlungs-E-Mail. Erfasst Käufer, die sich Produkte angesehen, aber nie einen Checkout gestartet haben — eine andere Zielgruppe als die obigen Erinnerungen. Verwenden Sie PW_ProductViewed mit der Based on what they viewed-Strategie des Products-Blocks. Siehe So richten Sie Produktempfehlungen in E-Mails ein.