Grundlagen zu Schlüssel-Wert-Paaren

Übersicht

Erfahre, was Schlüssel-Wert-Paare sind und wie du sie sowohl mit Standard- als auch mit stillen Push-Benachrichtigungen verwendest. Schlüssel-Wert-Paare sind benutzerdefinierte Daten, die in Push-Benachrichtigungen enthalten sind und mit denen du App-Verhalten auslösen, Nachrichten mit einem Tag versehen, Benachrichtigungen anpassen und vieles mehr kannst.

Was sind Schlüssel-Wert-Paare?

Schlüssel-Wert-Paare sind benutzerdefinierte Daten, die zusammen mit Push-Benachrichtigungen enthalten sein können, sowohl standardmäßigen (die Nutzer*innen angezeigt werden) als auch stillen (die für Nutzer*innen unsichtbar sind). Der Schlüssel ist ein Name, den deine App erkennt, und der Wert sind die Informationen, die du für diesen Schlüssel sendest.

Sowohl stille als auch Standard-Benachrichtigungen können verwendet werden, um App-Inhalte zu aktualisieren, Hintergrundaufgaben auszulösen oder Nachrichten für Reporting-Zwecke zu taggen.

Mit Standard-Push können sie auch verwendet werden, um benutzerdefinierte Push-Vorlagen zu erstellen und zu befüllen.

So verwendest du Schlüssel-Wert-Paare

Um Schlüssel-Wert-Paare verwenden zu können, muss deine App so eingerichtet sein, dass sie Schlüssel erkennt und auf deren Werte reagiert. Arbeite daher unbedingt mit deinen App-Entwickler*innen zusammen, um sicherzustellen, dass deine App so entwickelt ist, dass sie deine Anwendungsfälle unterstützt. Stelle außerdem sicher, dass du Push-Benachrichtigungen für iOS oder Android in deinem Klaviyo Konto eingerichtet hast.

Fülle für jedes Paar beide Felder aus und verwende für jedes Paar einen anderen Schlüssel. Wenn du einen Schlüssel wiederholst, wird nur der letzte Wert gespeichert.

1. Wenn du eine Push-Benachrichtigung erstellst, öffne den Tab Inhalt und wähle unter Typ Standard oder Stumm aus.
2. Wähle den Tab Verhalten aus und aktiviere Benutzerdefinierte Daten, falls er deaktiviert ist. Wenn du Stumm auswählst, wird es automatisch aktiviert.
3. Gib einen Schlüssel und einen Wert ein. Klicke auf Hinzufügen, um ein weiteres Paar hinzuzufügen. Du kannst pro Push-Benachrichtigung bis zu 10 Schlüssel-Wert-Paare hinzufügen.
4. Speichere deine Änderungen. Klicke in einem Flow auf Speichern & weiter. Klicke in einer Kampagne je nach Editor auf Weiter oder Speichern und zurückkehren.

Schauen wir uns ein Beispiel für eine E-Commerce-App an:

• Wir möchten die im unserer App angezeigten Prämienpunkte einer*s Kund*in aktualisieren, nachdem er*sie einen Online-Kauf getätigt hat. Das machen wir, indem wir einen Silent Push mit einer Profileigenschaften für Prämienpunkte als Schlüssel-Wert-Paar senden.
• Wir haben bereits einen Danke-Flow, der durch ein Placed Order -Ereignis ausgelöst wird. Wir fügen am Ende dieses Flows einen stillen Push hinzu, um den in unserer App angezeigten Wert der Prämienpunkte zu aktualisieren.
• Der Silent Push enthält ein Schlüssel-Wert-Paar, bei dem der Schlüssel rewardspoints entspricht und der Wert auf {{ person.rewardspoints }} gesetzt ist. Der Name der Klaviyo-Profileigenschaft, in der wir diese Punkte speichern, lautet rewardspoints, und unsere App ist korrekt konfiguriert, um basierend auf diesem Schlüssel-Wert-Paar zu aktualisieren.
• In diesem Beispiel haben wir sichergestellt, dass der Wert rewardspoints in Klaviyo aktualisiert wurde, bevor er über diesen Flow an unsere App gesendet wurde, damit er korrekt widergespiegelt wird.

Use Cases

Es gibt viele Anwendungsfälle für Schlüssel-Wert-Paare, unter anderem:

• App-Inhalte personalisieren
  Du kannst eine stille Push-Benachrichtigung senden, um App-Inhalte basierend auf den Attributen der Empfänger*innen zu personalisieren (wie im obigen Beispiel mit den Prämienpunkten).
• Tags für das Reporting erstellen
  Du kannst Key-Value-Paare in Push-Benachrichtigungen (standardmäßig oder ohne Ton) einfügen, um Nachrichten zu „taggen“ und dann Daten für alle Nachrichten mit bestimmten Tags abzurufen, um sie zu aggregieren. Diese Tags könnten beispielsweise UTM-Parameter sein.
• Benutzerdefinierte Push-Vorlagen erstellen
  Du kannst die Schriftgröße und -farbe für den Text deiner Push-Benachrichtigung festlegen oder einen benutzerdefinierten Sound einstellen, der abgespielt wird, wenn die Push-Benachrichtigung zugestellt wird. Konten können in ihrer Benachrichtigung auch Live-Daten anzeigen, z. B. den Standort einer Lieferung oder einen Countdown, bis ein Angebot abläuft.

Wir empfehlen, mit eurer*eurem App-Entwickler*in zusammenzuarbeiten, um Support für eure spezifischen Anwendungsfälle zu entwickeln.

Weitere Ressourcen