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. Verwenden Sie addTag für ein Version-Tag, da die automatische Erstellung diesen nicht ableiten kann, oder für ein benutzerspezifisches Tag. 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.

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.

{
  "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
    }, {
      "name":"List tag",
      "type":3
    }]
  }
}

{
  "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”