Tags sind eines der nützlichsten Werkzeuge, die Pushwoosh anbietet, und ermöglichen eine Reihe von anspruchsvollen Funktionalitäten. Durch die Verwendung von Tags können Sie Ihre Zielgruppe segmentieren und gezielte Push-Benachrichtigungen an bestimmte Benutzer basierend auf deren Attributen senden.
Tags können beliebige Daten enthalten, die mit einem bestimmten Benutzer oder Gerät verknüpft sind. Diese Daten können Benutzernamen, IDs, Städte, Lieblingsfußballmannschaften, bevorzugte Nachrichtenkategorien oder andere relevante Informationen über Ihre Benutzer umfassen.
Beginnen Sie damit, Ihre Geschäftsanforderungen zu identifizieren und festzulegen, wie Sie Ihre Zielgruppe segmentieren möchten. Berücksichtigen Sie Faktoren wie Alter, Standort, In-App-Kaufhistorie oder andere relevante Kriterien für die Zielgruppenansprache.
Tag-Werte können Ihnen helfen, Ihre Push-Kampagnen intelligenter zu gestalten. Jeder Tag kann nahezu unbegrenzt viele Werte speichern. Das bedeutet im Grunde, dass ein Tag ausreichen würde, um eine bestimmte Art von Informationen über jeden Endbenutzer in Ihrer Datenbank aufzuzeichnen.
Jeder Tag-Typ hat einen spezifischen Satz anwendbarer Operatoren. Tag-Operatoren definieren die Beziehung zwischen dem Tag und seinen Werten für Segmentierungszwecke.
is, is not, are, not in, not set, anyis, is not, are, not in, not set, anyin, not in, not set, anyis (true/false), not set, anyexactly on, on or after, on or before, between, not set, anyis, is not, greater or equals, less or equals, between, in, not in, not set, anyis, is not, greater or equals, less or equals, between, in, not in, not set, anyBeim Erstellen eines Tags wählen Sie, wie seine Werte gespeichert werden:
user_specific: false, der Standard für /addTag): Der Tag-Wert wird pro Gerät (HWID) gespeichert. Jedes Gerät desselben Benutzers kann unabhängig voneinander einen anderen Wert enthalten.user_specific: true, der Standard im Formular des Control Panels und für Tags, die automatisch durch setTags erstellt werden): Der Tag-Wert wird pro Benutzer (UserID) gespeichert. Wenn er über die UserID gesetzt wird, wird der Wert auf alle Geräte des Benutzers gleichzeitig angewendet. Nützlich für Attribute, die zur Person gehören, nicht zu einem bestimmten Gerät: Abonnementstufe, Treuepunkte, bevorzugte Sprache.Ein Benutzer hat sowohl die iOS- als auch die Android-Version Ihrer App installiert. Wenn Sie ein subscription_tier-Tag über seine UserID auf "premium" setzen, wird es sofort auf beide Geräte angewendet. Bei einem General-Tag müssten Sie es für jedes Gerät separat setzen.
{ "request":{ "application": "XXXXX-XXXXX", "userId": "the id of a specific user", "tags": { "subscription_tier": "premium", "loyalty_points": 350 } }}Diese Tags werden von Pushwoosh standardmäßig bereitgestellt, sodass Sie sie nicht manuell setzen müssen (und tatsächlich auch nicht sollten). Die meisten von ihnen werden von der Anwendung gesetzt und über registerDevice und andere API-Aufrufe an unseren Server gesendet, und einige werden vom Server selbst gesetzt. SMS Marketing Consent und Viber Marketing Consent sind eine Ausnahme. Ihre Entwickler setzen sie mit setTags, wenn eine Person Marketingnachrichten zustimmt oder sie ablehnt.
| Name | Typ | Wo es gesetzt wird | Beschreibung |
|---|---|---|---|
| Application Version | Version | SDK | Aktuelle Version der auf einem Gerät installierten App |
| Browser Type | String | SDK | Wenn ein Gerät für Ihr Webprojekt registriert wird, wird sein Typ – mobil oder Desktop – automatisch erfasst |
| City | String | Server | Letzter registrierter geografischer Standort eines Geräts |
| Country | String | Server | Letzter registrierter geografischer Standort eines Geräts |
| Device Model | String | SDK | Gibt das Gerätemodell an, auf dem die App installiert ist |
| First Install | Date | Server | Gibt den Zeitpunkt an, zu dem ein Gerät zum ersten Mal für Benachrichtigungen registriert wurde |
| In-app Product | List | SDK | Die von einem Benutzer der App gekauften In-App-Produkte |
| Last In-app Purchase date | Date | SDK | Das Datum des letzten In-App-Kaufs auf einem Gerät |
| Language | String | SDK | Zweibuchstabige Kleinschreibungsabkürzung der Ländereinstellung eines Geräts gemäß ISO-639-1; aus den Geräteeinstellungen übernommen |
| Last Application Open | Date | Server | Der Zeitpunkt des letzten App-Starts auf einem Gerät |
| Last Email Open | Date | Server | Das Datum, an dem die E-Mail-Adresse des Geräts zuletzt ein E-Mail-Öffnungsereignis registriert hat |
| Last Email Open Message Code | String | Server | Nachrichtencode der zuletzt geöffneten E-Mail (Format XXXX-XXXXXXXX-XXXXXXXX). Wird bei jedem PW_EmailOpen-Ereignis aktualisiert. Verwenden Sie ihn, um Empfänger einer bestimmten E-Mail-Kampagne danach zu segmentieren, wer sie geöffnet hat |
| Last Email Click | Date | Server | Das Datum, an dem die E-Mail-Adresse des Geräts zuletzt einen Klick auf einen E-Mail-Link registriert hat |
| Last Email Click Message Code | String | Server | Nachrichtencode der letzten E-Mail, in der ein Link angeklickt wurde (Format XXXX-XXXXXXXX-XXXXXXXX). Wird bei jedem PW_EmailLinkClicked-Ereignis aktualisiert. Verwenden Sie ihn, um Empfänger einer bestimmten E-Mail-Kampagne danach zu segmentieren, wer geklickt hat |
| Last Email Confirm | Date | Server | Das Datum der letzten Double-Opt-In-Abonnementbestätigung für die E-Mail-Adresse des Geräts |
| Bounced Email | Date | Server | Das Datum, an dem ein Hard Bounce für diese E-Mail-Adresse aufgetreten ist. Wird als Datum gespeichert, um eine zeitbasierte Segmentierung zu ermöglichen, z. B. um Benutzer mit kürzlichen Bounces auszuschließen |
| Unsubscribed Emails | Boolean | SDK | Gibt an, ob ein Benutzer den Empfang von E-Mails von Ihrer App abbestellt hat |
| SMS Marketing Consent | Boolean | Server, setTags | Ob der SMS-Abonnent Marketing-SMS zugestimmt hat: true zugestimmt, false abgemeldet, kein Wert unbekannt. Mehr erfahren |
| Viber Marketing Consent | Boolean | Server, setTags | Ob der Viber-Abonnent Marketingnachrichten über Viber zugestimmt hat: true zugestimmt, false abgemeldet, kein Wert unbekannt. Mehr erfahren |
| OS Version | Version | SDK | Die Version des auf einem Gerät laufenden Betriebssystems |
| Platform | String | SDK | Die Plattform, auf der der Benutzer Ihr Projekt verwendet. |
| Push Alerts Enabled | Boolean | SDK | Gibt an, ob Push-Benachrichtigungen in den Geräteeinstellungen erlaubt sind |
| SDK Version | Version | SDK | Die Version des auf einem Gerät implementierten Pushwoosh SDK |
| Live Activity ID | List | SDK | Wird verwendet, um Live Activities zu verwalten, indem eine Live Activity ID mit dem Gerät verknüpft wird. Wird nach 12 Stunden automatisch bereinigt. Reserviert: Sie können kein benutzerdefiniertes Tag mit diesem Namen erstellen. |
| WhatsApp Session Expires At | Date | Server | Enthält das aktuelle 24-Stunden-Kundenservicefenster, das durch die letzte eingehende WhatsApp-Nachricht des Kunden geöffnet wurde. Wird bei jeder eingehenden Nachricht automatisch gesetzt. Reserviert: Sie können kein benutzerdefiniertes Tag mit diesem Namen erstellen. Speichert nur das aktuelle Fenster, keinen Verlauf. |
| WhatsApp Ad Click ID | String | Server | Die Klick-ID der Click-to-WhatsApp-Anzeige (ctwa_clid) aus dem referral einer eingehenden WhatsApp-Nachricht. Meta sendet sie einmal, mit der Nachricht, die die Konversation eröffnet. Ein neuerer Klick überschreibt sie zusammen mit WhatsApp Ad Click Date. Ein wiederholter oder in falscher Reihenfolge eingehender Webhook setzt sie nicht zurück. |
| WhatsApp Ad Click Date | Date | Server | Der Zeitpunkt des in WhatsApp Ad Click ID erfassten Klicks. Wird zusammen damit aktualisiert: Ein neuerer Klick überschreibt das vorherige Datum. |
Hier kommt Ihre Kreativität ins Spiel, um Ihre spezifischen Geschäftsziele zu erreichen. Benutzerdefinierte Tags können basierend auf der Segmentierungslogik oder dem Targeting-Muster erstellt werden, das für Ihre einzigartigen Geschäftsanforderungen geeignet ist. Arbeiten Sie mit Ihrem Marketing-Team zusammen, um die zusätzlichen benutzerdefinierten Tags zu definieren, die für Ihre Kampagnen erforderlich sind.
Das Erstellen eines Tags im Voraus ist optional. Das Senden eines neuen Tag-Namens über setTags erstellt ihn automatisch, wobei der Typ aus dem Wert abgeleitet wird:
4.99, wird zu Price. Eine Zahl wie 5.0 wird zu Integer.2024-10-02 22:11.true oder false oder ein JSON-Array enthält, wird nach ihrem Inhalt typisiert, sodass "42" zu Integer wird, nicht zu String.Event-Attribute werten eine Zeichenkette nicht nach ihrem Inhalt aus, sodass "42" in einem Event zu String wird. Siehe Automatisch erstellte Events.
Ein automatisch erstelltes Tag ist immer User-specific (user_specific: true). Fügen Sie das Tag zuerst explizit über das Control Panel oder /addTag hinzu, wenn es ein Version-Tag sein soll, das die automatische Erstellung nicht ableiten kann, oder ein General-Tag.
Die automatische Tag-Erstellung ist für die überwiegende Mehrheit der Konten standardmäßig aktiviert. Wenn setTags kein neues Tag wie erwartet erstellt, wenden Sie sich an den Pushwoosh-Support, um zu prüfen, ob sie für Ihr Konto deaktiviert wurde.
Sie können ein neues Tag im Pushwoosh Control Panel hinzufügen oder die /addTag-Methode verwenden.
POST https://api.pushwoosh.com/json/1.3/addTag
Erstellt ein Tag in Ihrem Konto.
| Name | Typ | Beschreibung |
|---|---|---|
| auth* | string | API-Zugriffstoken aus dem Pushwoosh Control Panel. |
| tag* | object | Tag-Parameter. |
| tag.name* | string | Tag-Name. |
| tag.type* | integer | Tag-Typ. Siehe mögliche Werte unten. |
| tag.user_specific | boolean | Wenn true, wird der Tag-Wert auf Benutzerebene gespeichert und über alle Geräte eines Benutzers geteilt, wenn er per UserID gesetzt wird. Wenn false (Standard), ist das Tag auf Geräteebene und wird pro HWID gesetzt. |
{ "status_code": 200, "status_message": "OK", "response": { "result": true }}{ "request": { "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel "tag": { "name": "TAG_NAME", // required "type": 1, // required, see possible values below "user_specific": false // optional. true = user-level; false = device-level (default) } }}Mögliche Tag-Wert-Typen:
Sobald Sie ein Tag hinzugefügt und konfiguriert haben, ist es bereit, Informationen von Ihren Benutzern zu sammeln. Führen Sie die folgenden Schritte aus, um es zu implementieren:
setTags-Funktion, um Tags zuzuweisen und Benutzerdaten zu sammeln.Unten finden Sie Implementierungsbeispiele für verschiedene Frameworks, die die setTags-Funktion verwenden.
iOS Native
NSDictionary *tags = @{ @"Alias" : aliasField.text, @"FavNumber" : @([favNumField.text intValue]), @"price" : [PWTags incrementalTagWithInteger:5], @"List" : @[ @"Item1", @"Item2", @"Item3" ]};
[[PushNotificationManager pushManager] setTags:tags];Android Native
pushwoosh.setTags(Tags.intTag("intTag", 42));Cordova
PushNotification.prototype.setTags = function( config, success, fail )Flutter
Future<void> setTags(Map tags) async { await _channel.invokeMethod("setTags", {"tags" : tags});}React Native
pushNotification.setTags({ "string_tag" : "Hello world", "int_tag" : 42, "list_tag":["hello", "world"]});Unity
Setzt ein Integer-Tag für das Gerät.
public virtual void SetIntTag(string tagName, int tagValue)Setzt ein String-Tag für das Gerät.
public virtual void SetStringTag(string tagName, string tagValue)Setzt ein List-Tag für das Gerät.
public virtual void SetListTag(string tagName, List<object> tagValues)Unreal Engine
FPushwooshModule& pushwoosh = FPushwooshModule::Get();pushwoosh.SetTags("{ \"intTag\" : 1, \"stringTag\" : \"example\", \"listTag\" : [ \"a\", \"b\", \"c\" ] }");Expo
Pushwoosh.setTags({ "key": keyValue, "value": inputValue });.NET MAUI
NSDictionary *tags = @{ @"Alias" : aliasField.text, @"FavNumber" : @([favNumField.text intValue]), @"price" : [PWTags incrementalTagWithInteger:5], @"List" : @[ @"Item1", @"Item2", @"Item3" ]};[[PushNotificationManager pushManager] setTags:tags];Outsystems
Eingabeparameter
Tags – Eine Liste von Tag-Datensätzen, die TagName und TagValue enthalten.
TagName muss immer vom Typ Text sein.TagValue kann Text, Integer, Boolean, Date usw. sein.Obwohl Tags in den meisten Fällen (99 %) von der Anwendung aus gesetzt werden, können Sie Tags auch über die Pushwoosh-API setzen. Unten finden Sie ein Beispiel für eine typische Anfrage an den /setTags-Endpunkt:
POST https://api.pushwoosh.com/json/1.3/setTags
{ "request": { "application": "XXXXX-XXXXX", // required, Pushwoosh application code "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // required, hardware device ID used in /registerDevice API "tags": { // required "StringTag": "string value", // Example of a string tag "IntegerTag": 42, // Example of an integer tag "ListTag": ["string1", "string2"], // Example of a list tag "DateTag": "2024-10-02 22:11", // Note: time must be in UTC "BooleanTag": true // Valid values: true, false } }}Weitere Details finden Sie in der setTags-API-Dokumentation
Der Standort eines Geräts wird anhand seiner IP-Adresse zum Zeitpunkt des letzten Starts Ihrer App auf diesem Gerät bestimmt. GeoIP übermittelt die Standortdaten an Pushwoosh, und Pushwoosh speichert den von GeoIP erhaltenen Standort als City-Tag-Wert für ein bestimmtes Gerät.
In einigen Fällen unterscheidet sich der von GeoIP übermittelte Standort vom Stadtnamen – zum Beispiel, wenn er sich auf ein Stadtviertel oder eine andere Verwaltungseinheit bezieht. Bitte seien Sie vorsichtig, wenn Sie das standardmäßige City-Tag für Segmentierungszwecke verwenden: Stellen Sie sicher, dass Sie die richtigen Werte auswählen.
Wenn Sie beispielsweise Benutzer aus München ansprechen möchten, müssen Sie dies mit einer Reihe von City-Tag-Werten abdecken, einschließlich „München“ selbst (mit allen entsprechenden Werten, wie z. B. verschiedenen Schreibweisen, die von GeoIP zurückgegeben und als Tag-Werte gespeichert werden könnten) und mehreren nahegelegenen Gebieten.