Kunden über ein Produkt-Update benachrichtigen

Was „Kunden benachrichtigen“ macht

„Kunden benachrichtigen“ sendet jedem früheren Käufer eines Produkts eine E-Mail mit einer Schaltfläche, die den eigenen Download dieses Käufers mit den neuesten Dateien öffnet. Sie starten den Versand von der Produktseite im Alva-Admin: Produkt öffnen, auf Kunden benachrichtigen klicken, Empfänger auswählen, optional eine Notiz hinzufügen, Vorschau prüfen und senden.

Die E-Mail ist ein fester Produkt-Update-Hinweis in Ihrer Shop-Sprache, keine Marketing-E-Mail. Sie geht über einen von Ihren Liefer-E-Mails getrennten Versand-Stream hinaus, mit ausgeschaltetem Öffnungs- und Klick-Tracking, damit der Download-Link nie umgeschrieben wird. Wer sich abgemeldet oder eine frühere E-Mail als Spam markiert hat, wird automatisch übersprungen.

Wer die E-Mail erhält

Jeder Kunde, der eine der ausgewählten Varianten gekauft hat und weiterhin für E-Mails angemeldet ist, erhält genau eine Nachricht. Liefern die Varianten eines Produkts unterschiedliche Dateien, zeigt der Dialog pro Satz Dateien ein Kontrollkästchen, beschriftet mit den Varianten, die er bedient; standardmäßig sind alle ausgewählt. Wer mehrere ausgewählte Varianten gekauft hat, erhält eine einzige E-Mail.

Diese eine E-Mail verlinkt auf den jüngsten Kauf des Käufers unter den ausgewählten Varianten. Die andere Variante bleibt über ihren ursprünglichen Download-Link und die Bestellstatusseite erreichbar. Die Empfängeranzahl aktualisiert sich, während Sie die Auswahl ändern, und darunter steht, wie viele Käufer sich abgemeldet haben — diese sind von hier aus nicht erreichbar.

Käufe, deren Download-Zugriff deaktiviert ist oder die Ihre Betrugsprüfung nicht bestanden haben, bleiben außen vor. Personalisierte Produkte haben keine gemeinsame Datei, die man erneut senden könnte, und zeigen die Schaltfläche daher gar nicht; ein Produkt, dessen Zuordnungen keine Dateien, Pakete oder Links enthalten, kann nicht benachrichtigt werden.

Was in der E-Mail steht

Die E-Mail ist eine gesperrte Vorlage: Betreff, Anrede, Einleitungszeile, die Schaltfläche Dateien herunterladen und die Fußzeile sind fest und in Ihre Shop-Sprache übersetzt. Das Einzige, was Sie hinzufügen können, ist eine reine Textnotiz von bis zu 2.000 Zeichen, die als „Eine Nachricht von {Ihr Shop}:“ zwischen Einleitungszeile und Schaltfläche erscheint. Käufer sehen, in dieser Reihenfolge:

• Betreff: Aktualisierung deines Kaufs von {Produkttitel}
• Hallo {Vorname},
• {Shop-Name} hat deinen Kauf von {Produkttitel} aktualisiert. Klicke unten, um die neueste Version herunterzuladen.
• Eine Nachricht von {Shop-Name}:, gefolgt von Ihrer Notiz — nur, wenn Sie eine hinzugefügt haben
• Die Schaltfläche Dateien herunterladen, die die eigene Download-Seite des Käufers öffnet
• Eine Fußzeile mit Ihrem Shop-Namen und einem Abmeldelink

Eine Notiz hinzufügen

Geben Sie die Notiz in das Feld Notiz hinzufügen (optional) ein. Nur Text: Links und E-Mail-Adressen sind nicht erlaubt — Webadressen, www. und bloße Domainnamen eingeschlossen —, und das Feld weist sie ab, bevor Sie senden können, damit die Schaltfläche „Dateien herunterladen“ der einzige Link in der E-Mail bleibt. Packen Sie keine Rabatte oder Werbeaktionen in die Notiz: Diese E-Mail ist ein Produkt-Update, kein Marketing.

Variablen, die Sie in der Notiz verwenden können

Drei Schaltflächen unter dem Feld fügen die ersten drei Variablen ein; ein Menü Produkt-Metafeld listet die Metafelder des Produkts für die vierte:

• {customer.first_name} — der Vorname des Käufers, mit einer neutralen Anrede, wenn er unbekannt ist. Am besten liest er sich am Zeilenanfang.
• {shop.name} — der Name Ihres Shops.
• {product.title} — der Produkttitel, wie im Betreff.
• {product.metafields.<namespace>.<key>} — der Wert eines Shopify-Metafelds des Produkts, zum Beispiel {product.metafields.custom.edition}. Eine Notiz kann bis zu fünf verschiedene Metafelder verwenden. Das Menü listet die ersten 50 Metafelder des Produkts mit ihren aktuellen Werten.

Unterstützte Metafeld-Typen sind ein- und mehrzeiliger Text, ganze und Dezimalzahlen, Datumsangaben (ausgeschrieben in Ihrer Shop-Sprache) und Textlisten. Ein Metafeld eines anderen Typs — ein Link, ein Wahrheitswert, eine Referenz, Rich Text oder eine Datei — kann in einer E-Mail nicht angezeigt werden; die Notiz wird daher mit einem Inline-Fehler abgewiesen, bis Sie es entfernen. Dasselbe gilt für ein Metafeld ohne Wert bei diesem Produkt, für eine Variable, die Alva nicht kennt, für eine nicht geschlossene geschweifte Klammer und für einen Link in einem Metafeldwert.

Vorschau vor dem Senden

Die E-Mail-Vorschau unter der Notiz zeigt Betreff und Inhalt genau so, wie ein Käufer sie sieht, in Ihrer Shop-Sprache, mit der Notiz und ihren Variablen aus den echten Werten des Produkts gefüllt. Vorschau und versendete E-Mail werden vom selben Code erzeugt — was Sie sehen, geht auch raus. Ändert sich ein Metafeld, während der Dialog offen ist, aktualisiert sich die Vorschau und bittet Sie, sie erneut zu prüfen.

ZIP-Produkte: Die E-Mail wartet auf das Archiv

Liefert ein Produkt ein ZIP-Archiv und haben Sie gerade seine Dateien ersetzt, wartet der Versand, bis Alva das Archiv neu erstellt hat, damit kein Käufer die alte Version herunterlädt. Bis dahin zeigt der Benachrichtigungsverlauf „Wartet, bis das Archiv fertig erstellt ist, bevor gesendet wird.“; der Versand steht weiter in der Warteschlange und kann noch abgebrochen werden.

Schlägt die Neuerstellung fehl, scheitert der Versand mit der Begründung „Das ZIP-Archiv für dieses Produkt konnte nicht erstellt werden, daher wurde nichts gesendet.“ Korrigieren Sie die Dateien — das Ersetzen startet eine neue Neuerstellung — und benachrichtigen Sie erneut. Wird das Archiv nach einer Stunde immer noch neu erstellt, scheitert der Versand ebenfalls und sagt das, und Sie können erneut benachrichtigen, sobald die Neuerstellung abgeschlossen ist. In beiden Fällen wurde nichts gesendet, das 7-Tage-Limit ist also nicht verbraucht.

Produkte, die einzelne Dateien oder Links liefern, haben kein Archiv und werden nie zurückgehalten.

Der Benachrichtigungsverlauf

Unter der Karte „Einstellungen“ des Produkts listet der Benachrichtigungsverlauf die letzten zehn Versände für das Produkt: das Datum, die Anzahl der Empfänger, wie viele E-Mails gesendet wurden, fehlgeschlagen sind, unterdrückt wurden oder Beschwerden auslösten, wer gesendet hat, und den Status — In Warteschlange, Wird gesendet, Abgeschlossen, Teilweise, Fehlgeschlagen oder Abgebrochen. Ein Badge zeigt die Quelle: Admin, API oder Zuordnungsaktualisierung (API).

Eine Zeile zeigt außerdem, wie viele Varianten sie anvisiert hat, und die ersten Zeilen ihrer Notiz. Eine fehlgeschlagene Zeile nennt den Grund in Worten: Kunden-E-Mails waren deaktiviert, daher wurde nichts gesendet; die gespeicherte Notiz konnte nicht gerendert werden; die Notiz enthielt einen Link; das Archiv wurde nach einer Stunde immer noch neu erstellt; das ZIP-Archiv konnte nicht erstellt werden; oder der Versand wurde durch einen Serverneustart unterbrochen. Teilweise bedeutet, dass einige E-Mails fehlgeschlagen sind oder unterdrückt wurden — die Zahlen sagen, wie viele.

Über die API

Alles, was die Schaltfläche kann, steht auch über die externe Alva-API zur Verfügung — für Shops, deren eigenes System die Dateien aktualisiert. POST /api/v1/products/{id}/notifications reiht eine Kampagne für ein Produkt ein; senden Sie "dry_run": true, um dieselben Prüfungen auszuführen und Empfängeranzahl, Betreff und gerenderte Notiz zu erhalten, ohne etwas zu senden. GET /api/v1/notifications/{id} liest das Ergebnis.

POST /api/v1/notifications/{id}/cancel stoppt eine Kampagne, die noch in der Warteschlange steht; wie der Abbruch im Admin behält er das 7-Tage-Limit des Produkts bei. Legt Ihr System Zuordnungen bereits über die API an oder ersetzt sie, fügen Sie notify_customers zu POST /api/v1/mappings oder PUT /api/v1/mappings/{id} hinzu, und die Käufer dieser Zuordnung werden benachrichtigt, sobald die neuen Dateien bereitstehen — das Warten auf das Archiv gilt auch dort. Das Limit ist mit der Schaltfläche geteilt: Innerhalb der Woche antwortet die API mit 429 notification_cooldown und dem Zeitpunkt, zu dem das Produkt wieder frei ist; planen Sie den nächsten Aufruf für dann, statt es erneut zu versuchen. Request-Bodys, Fehlercodes und Idempotenz-Regeln stehen in der API-Referenz.