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 eine nahezu unbegrenzte Anzahl von Werten speichern. Grundsätzlich bedeutet dies, dass ein Tag ausreichen würde, um eine bestimmte Art von Informationen über jeden Endbenutzer in Ihrer Datenbank aufzuzeichnen.
Für jedes Konto sind nur wenige Tags verfügbar, aber angesichts des nahezu unendlichen Platzes für jeden Tag reichen bereits ein paar Tags aus, um eine enorme Menge an Informationen über Ihre Benutzer zu sammeln und sehr komplexe Targeting-Muster einzurichten.
Jeder Tag-Typ hat einen spezifischen Satz an anwendbaren 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, anyDieser Parameter beschreibt das Verhalten von Tags in Bezug auf verschiedene Apps im selben Konto. Anwendungsspezifische Tags können für jede App im selben Konto unterschiedliche Wertesätze haben. Anwendungsspezifische Tags hingegen speichern denselben Wert für alle Apps, die diesen Tag verwenden.
Nehmen wir an, Sie haben zwei Apps, eine Nachrichten-App und ein Spiel, und Sie möchten nur die Benutzer ansprechen, die ausdrücklich zugestimmt haben, Push-Benachrichtigungen von Ihnen zu erhalten. Also erstellen Sie einen booleschen Tag namens „Subscribed“ und setzen den Wert "true" für Benutzer, die Push-Benachrichtigungen von Ihnen erhalten möchten, und "false" für diejenigen, die nicht benachrichtigt werden möchten.
Eine Ihrer Benutzerinnen, Anna, hat beide Ihrer Apps installiert. Sie ist damit einverstanden, über Eilmeldungen benachrichtigt zu werden, hat sich aber von allen Push-Benachrichtigungen der Spiele-App abgemeldet.
Wenn der „Subscribed“-Tag anwendungsspezifisch ist, wird alles wie geplant verlaufen. Wäre dieser Tag jedoch anwendungsunspezifisch, würde jede Ihrer Apps den von der anderen App gesetzten Wert überschreiben, was Ihr Targeting ruinieren und zu Frustration führen kann.
Andererseits können anwendungsunspezifische Tags nützlich sein, wenn Sie anwendungsübergreifendes Targeting durchführen und Benutzer verfolgen möchten, die in verschiedenen Anwendungen denselben Benutzernamen haben.
Alle Tags in Pushwoosh sind von Natur aus benutzerspezifisch und werden allen Geräten eines Benutzers zugewiesen, wenn sie per UserID anstelle von HWID gesetzt werden.
{ "request":{ "application": "XXXXX-XXXXX", // Pushwoosh-Anwendungscode "userId": "die ID eines bestimmten Benutzers", "tags": { "UserSpecificStringTag": "string value", "UserSpecificIntegerTag": 42 } }}Diese Tags sind von Pushwoosh standardmäßig verfügbar, 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.
| Name | Typ | Wo es gesetzt wird | Beschreibung |
|---|---|---|---|
| Application Version | Version | SDK | Aktuelle Version der App, die auf einem Gerät installiert ist |
| 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 |
| OS Version | Version | SDK | Die Version eines Betriebssystems, das auf einem Gerät läuft |
| 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 Pushwoosh SDK, das auf einem Gerät implementiert ist |
| Unsubscribed Emails | Boolean | SDK | Gibt an, ob ein Benutzer sich vom Empfang von E-Mails Ihrer App abgemeldet hat |
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.
Sie können einen neuen Tag im Pushwoosh Control Panel hinzufügen oder die /addTag-Methode verwenden.
POST https://api.pushwoosh.com/json/1.3/addTag
Erstellt einen 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.application_specific | boolean | Definiert, ob der Tag-Wert für mehrere Apps unterschiedlich sein oder über mehrere Apps hinweg gleich sein soll. |
{ "status_code": 200, "status_message": "OK", "response": { "result": true }}{ "request": { "auth": "yxoPUlwqm…………pIyEX4H", // erforderlich, API-Zugriffstoken aus dem Pushwoosh Control Panel "tag": { "name": "TAG_NAME", // erforderlich "type": 1, // erforderlich, siehe mögliche Werte unten "application_specific": true, // oder 'false', optional. Definiert, ob der Tag-Wert für mehrere Apps unterschiedlich sein oder über mehrere Apps hinweg gleich sein soll "user_specific": true // oder 'false', optional, wird für application_specific Tags verwendet } }}Mögliche Tag-Wert-Typen:
Sobald Sie einen Tag hinzugefügt und konfiguriert haben, ist er bereit, Informationen von Ihren Benutzern zu sammeln. Befolgen Sie diese Schritte, um ihn zu implementieren:
setTags-Funktion, um Tags zuzuweisen und Benutzerdaten zu sammeln.Unten finden Sie Implementierungsbeispiele für verschiedene Frameworks unter Verwendung der setTags-Funktion.
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 einen Integer-Tag für das Gerät.
public virtual void SetIntTag(string tagName, int tagValue)Setzt einen String-Tag für das Gerät.
public virtual void SetStringTag(string tagName, string tagValue)Setzt einen Listen-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, etc. sein.Obwohl in den meisten Fällen (99 %) Tags 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", // erforderlich, Pushwoosh-Anwendungscode "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // erforderlich, Hardware-Geräte-ID, die in der /registerDevice-API verwendet wird "tags": { // erforderlich "StringTag": "string value", // Beispiel für einen String-Tag "IntegerTag": 42, // Beispiel für einen Integer-Tag "ListTag": ["string1", "string2"], // Beispiel für einen Listen-Tag "DateTag": "2024-10-02 22:11", // Hinweis: Die Zeit muss in UTC sein "BooleanTag": true // Gültige Werte: true, false } }}Für weitere Details siehe die setTags API-Dokumentation
Der Standort eines Geräts wird basierend auf 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 einen Stadtteil oder eine andere Verwaltungseinheit bezieht. Bitte seien Sie vorsichtig bei der Verwendung des Standard-City-Tags für Segmentierungszwecke: 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.