Tags API

Um Tag-Werte für HWIDs und UserIDs festzulegen, verwenden Sie die Methode /setTags aus der Device API. addTag ist optional, da setTags jeden noch nicht erkannten Tag-Namen erstellt und den Typ aus dem Wert ableitet: eine ganze Zahl wird zu Integer, eine Zahl mit einem Dezimalpunkt wird zu Price, eine Zeichenfolge wird zu String (oder Date, für ein erkanntes Datums-Zeit-Format wie 2024-10-02 22:11), ein Array wird zu List und ein boolescher Wert wird zu Boolean. Ein automatisch erstelltes Tag ist immer User-specific (user_specific: true). Verwenden Sie addTag für ein Version-Tag, da die automatische Erstellung diesen nicht ableiten kann, oder für ein General-Tag (user_specific: false). Die automatische Tag-Erstellung ist für die überwiegende Mehrheit der Konten standardmäßig aktiviert. Wenn setTags ein neues Tag nicht wie erwartet erstellt, kontaktieren Sie den Pushwoosh Support, um zu prüfen, ob diese Funktion für Ihr Konto deaktiviert wurde.

Um strukturierte Daten wie eine Bestellung oder eine Liste von Bestellungen in einem einzigen Tag zu speichern, verwenden Sie Objekt-Tags (Beta). addTag kann sie nicht erstellen, da diese Methode keine Felder annimmt.

addTag

POST https://api.pushwoosh.com/json/1.3/addTag

Erstellt ein Tag in Ihrem Konto.

Request-Body

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 gerätebezogen und wird pro HWID gesetzt.
tag.application_specific	boolean	Veraltet. Wird akzeptiert, aber ignoriert, weil Tags nicht mehr in anwendungsspezifische und kontoweite Tags unterteilt werden. Sie können den Parameter weglassen.

{
  "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
      "user_specific": false        // optional. true = Tag auf Benutzerebene (über alle Geräte geteilt); false = Tag auf Geräteebene (Standard)
    }
  }
}

Mögliche Tag-Wert-Typen:

1 - Integer (Ganzzahl)
2 - String (Zeichenfolge)
3 - List (Liste)
4 - Date (Datum)
5 - Boolean (Boolescher Wert)
6 - Decimal (Dezimalzahl). Bsp: 19.95
7 - Version. Bsp: “1.0.0.0”

deleteTag

POST https://api.pushwoosh.com/json/1.3/deleteTag

Entfernt ein Tag mit allen zugehörigen Informationen vollständig aus der Datenbank.

Request-Body

Name	Typ	Beschreibung
auth*	string	API-Zugriffstoken aus dem Pushwoosh Control Panel.
tag*	object	Tag-Parameter.
tag.name*	string	Name eines zu löschenden Tags.

{
  "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. Name eines zu löschenden Tags
    }
  }
}

POST https://api.pushwoosh.com/json/1.3/listTags

Ruft eine Liste der Tags im Konto ab.

Request-Body

Name	Typ	Beschreibung
auth*	string	API-Zugriffstoken aus dem Pushwoosh Control Panel.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "tags": [{
      "name":"Language",
      "type":2,
      "isUserSpecific":true,
      "isApplicationSpecific":true
    }, {
      "name":"List tag",
      "type":3,
      "isUserSpecific":false,
      "isApplicationSpecific":true
    }]
  }
}

isUserSpecific zeigt, ob der Tag User-specific ist. isApplicationSpecific ist immer true und bleibt nur aus Gründen der Abwärtskompatibilität erhalten, weil Tags nicht mehr in anwendungsspezifische und kontoweite Tags unterteilt werden. Verlassen Sie sich nicht auf dieses Feld.

{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H" // API-Zugriffstoken aus dem Pushwoosh Control Panel
  }
}

Tag-Typen:

1 - Integer (Ganzzahl)
2 - String (Zeichenfolge)
3 - List (Liste)
4 - Date (Datum)
5 - Boolean (Boolescher Wert)
6 - Decimal (Dezimalzahl). Bsp: 19.95
7 - Version. Bsp: “1.0.0.0”