How to Use Aliases and Tags

I. Grundkonzept erklärt

1. Alias: Verknüpfung von Geschäfts-ID mit Registrierungs-ID

Aliases ermöglichen eine eindeutige Zuordnung zwischen der eindeutigen Benutzerkennung (z. B. User-ID, Telefonnummer, E-Mail-Adresse usw.) im Geschäftssystem und der Registrierungs-ID (registrationID/UID) im EngageLab Push-System.

Registrierungs-ID ist eine vom WebPush- oder AppPush-SDK für jede Nutzerin/jeden Nutzer generierte eindeutige Kennung, die zur Identifikation von Push-Benachrichtigungen verwendet wird. Sie ist für das Geschäftssystem in der Regel bedeutungslos und nicht fest an ein Gerät gebunden.

Kernmerkmale:

🧩 Eindeutige Zuordnung: Jede Registrierungs-ID kann nur mit einem Alias verknüpft werden.
🧠 Geschäftliche Nachvollziehbarkeit: Nutzt die ursprüngliche Benutzerkennung aus dem Geschäftssystem und vereinfacht so die Geschäftslogik.
🔒 Persistente Zuordnung: Die Verknüpfung bleibt bestehen, bis sie explizit aufgehoben wird.

Beispielanwendungen:

Benachrichtigung über Statusänderungen von Bestellungen (z. B. „Die Bestellung von user123 wurde versandt“)
Sicherheitsbenachrichtigungen zum Konto (z. B. „Das Passwort von user456 wurde geändert“)

2. Tag: Dynamische Gruppierung anhand von Attributen

Tags dienen dazu, Nutzerinnen und Nutzer anhand von Attributen, Verhalten oder Status zu segmentieren und so eine dynamische Gruppierung und zielgerichtete Push-Kommunikation zu ermöglichen.

Kernmerkmale:

🔁 Viele-zu-viele-Beziehung: Eine Registrierungs-ID kann mehrere Tags haben, und ein Tag kann mehreren Nutzerinnen und Nutzern zugeordnet sein.
📈 Echtzeit-Updates: Tags können dynamisch hinzugefügt oder entfernt werden, um auf Verhaltensänderungen zu reagieren.
🧱 Unterstützung mehrerer Dimensionen: Beispielsweise „VIP-Mitglied“, „seit 30 Tagen inaktiv“, „iOS-Nutzer:in“.

Beispielanwendungen:

Versand von Aktivierungsbelohnungen an „VIP-Nutzer:innen, die 3 Tage in Folge inaktiv waren“
Versand von zeitlich begrenzten Erinnerungen an Nutzer:innen mit nicht abgeschlossenen Warenkörben

II. Warum Aliases und Tags verwenden?

🎯 Welche Probleme werden gelöst?

Die Push-Registrierungs-ID von EngageLab wird automatisch vom SDK generiert und ist nicht direkt mit den Nutzerinnen und Nutzern des Geschäftssystems verknüpft. Um eine geschäftsbezogene, zielgerichtete Push-Kommunikation zu ermöglichen, müssen Entwicklerinnen und Entwickler:

✅ Eine Verknüpfung zwischen Benutzer-ID → Registrierungs-ID im Geschäftssystem herstellen (mittels Alias).
✅ Nutzerinnen und Nutzer nach geschäftlichen Anforderungen in Gruppen segmentieren (mittels Tags).

✨ Kernaussagen zum Mehrwert

Funktion	Geschäftlicher Mehrwert	Technischer Mehrwert
Alias	Gezielte Einzelbenachrichtigung für Bestellstatus, Kontowarnungen	Keine separate Pflege der Zuordnung zwischen Registrierungs-ID und Geschäfts-ID notwendig
Tag	Gruppenaktionen (VIP, inaktive, aktive Nutzer:innen)	Kein eigenes User-Segmentierungssystem erforderlich
Kombinierte Nutzung von Alias und Tags	Aufbau präziser Zielgruppen durch Kombination von Region + Verhalten + Attributen	Deutlich reduzierte Push-Logik und effizientere Wartung

III. Detaillierte Anwendungshinweise

1. Aliases und Tags setzen

✅ Serverseitige API-Konfiguration

Dokumentation: Alias und Tags setzen
Beispiel-Request:

POST /v4/devices/{registration_id} { "tags": { "add": [ "VIP", "iOS-Nutzer:in" ] }, "alias": "user_5678" }

              
              POST /v4/devices/{registration_id}
{
    "tags": {
        "add": [
            "VIP",
            "iOS-Nutzer:in"
        ]
    },
    "alias": "user_5678"
}

Diesen Codeblock im schwebenden Fenster anzeigen

✅ Clientseitige SDK-Konfiguration

Web SDK: setTagsAlias
Android SDK: Tags und Alias API
iOS SDK: Tags und Alias API

2. Push-Benachrichtigungen auslösen

✅ Bedienung über die Konsole

Auswahl von Tag- oder Alias-Nutzergruppen auf der Push-Erstellungsseite.

✅ API-Methode

Dokumentation: Push-API erstellen
Beispiel-Request:

POST v4/push { "from": "push", "to": { "tag": [ "VIP" ], "tag_and": [ "seit 30 Tagen inaktiv" ] }, "body": { "platform": "all", "notification": { "alert": "Hallo, MTPush!", "android": { "alert": "Willkommensgeschenk", "title": "Liebe:r VIP-Nutzer:in, willkommen zurück! Jetzt exklusives Angebot sichern." }, "ios": { "alert": { "title": "Willkommensgeschenk", "body": "Liebe:r VIP-Nutzer:in, willkommen zurück! Jetzt exklusives Angebot sichern." } } } } }

              
              POST v4/push
{
    "from": "push",
    "to": {
        "tag": [
            "VIP"
        ],
        "tag_and": [
            "seit 30 Tagen inaktiv"
        ]
    },
    "body": {
        "platform": "all",
        "notification": {
            "alert": "Hallo, MTPush!",
            "android": {
                "alert": "Willkommensgeschenk",
                "title": "Liebe:r VIP-Nutzer:in, willkommen zurück! Jetzt exklusives Angebot sichern."
            },
            "ios": {
                "alert": {
                    "title": "Willkommensgeschenk",
                    "body": "Liebe:r VIP-Nutzer:in, willkommen zurück! Jetzt exklusives Angebot sichern."
                }
            }
        }
    }
}