Wichtige API-Kennungen

Dieser Beitrag listet die wesentlichen Kennungen auf, die in Pushwoosh-API-Anfragen verwendet werden. Diese Kennungen sind für die Authentifizierung, Nachrichtenerstellung, Zielgruppenansprache, Segmentierung, Nachverfolgung und Verwaltung von Benutzern in Ihren Anwendungen erforderlich.

Allgemeine Kennungen

Anwendungscode

Eine eindeutige Kennung, die jeder Anwendung in Ihrem Pushwoosh-Konto zugewiesen wird. Sie ist in den meisten API-Aufrufen erforderlich, um die Ziel-App anzugeben.

Wo Sie ihn finden

Pushwoosh Control Panel → Unter dem Anwendungsnamen.

API-Zugriffstoken

Ein eindeutiges Token, das einem Pushwoosh-Konto zugewiesen ist und zur Authentifizierung von API-Anfragen verwendet wird. Es ermöglicht den Zugriff zur Verwaltung von Projekten, zum Senden von Nachrichten, zum Ändern von Einstellungen und zum Abrufen von Daten. Jedes Konto hat standardmäßig mindestens ein Token erstellt. Erfahren Sie mehr

Wo Sie ihn finden

Pushwoosh Control Panel → API-Zugriff.

Gerätekennungen

Hardware-ID

Eine eindeutige Kennung, die einem Gerät vom Pushwoosh SDK zugewiesen wird. Sie wird automatisch vom SDK festgelegt oder bei der Geräteregistrierung übergeben. Erfahren Sie mehr

Wo Sie sie finden

In den Geräteprotokollen. Erfahren Sie mehr
Im User Explorer bei der Suche nach Benutzer-ID (User ID)
In der CSV-Datei, die von der Segmentliste heruntergeladen wird

Push-Token

Ein von Plattformanbietern ausgegebenes Token, das ein App-Geräte-Paar zur Zustellung von Push-Benachrichtigungen identifiziert. Es wird automatisch vom SDK erfasst, wenn Push-Berechtigungen erteilt werden. Erfahren Sie mehr

Wo Sie es finden

In den Geräteprotokollen. Erfahren Sie mehr
Geben Sie im User Explorer die HWID in das Suchfeld ein, um das zugehörige Gerät zu finden, und öffnen Sie dann die Gerätedetails, um das Push-Token anzuzeigen.

Gerätetyp

Gibt die Plattform des Zielgeräts mit einem numerischen Code an. Wird automatisch vom SDK festgelegt.

Unterstützte Werte:

1 – iOS
3 – Android
7 – macOS
8 – Windows
9 – Amazon
10 – Safari
11 – Chrome
12 – Firefox
14 – Email
17 – Huawei
18 – SMS
21 – WhatsApp
22 – Line

Benutzerkennungen

Benutzer-ID (User ID)

Eine benutzerdefinierte Kennung, die einem Benutzer zugewiesen wird und eine geräteübergreifende und personalisierte Zielgruppenansprache ermöglicht. Erfahren Sie mehr

Wo Sie sie finden

Pushwoosh Control Panel → Audience → User Explorer

Kennungen für Nachrichten

Nachrichtencode

Eine eindeutige Kennung, die jeder Nachricht bei ihrer Erstellung zugewiesen wird. Sie folgt einem bestimmten Format: XXXX-XXXXXXXX-XXXXXXXX.

Dieser Code ist unerlässlich für:

Die Verfolgung des Status und der Zustellung einer bestimmten Nachricht
Das Abbrechen (oder Löschen) einer zuvor gesendeten Nachricht
Das Abrufen von Nachrichtenstatistiken

Wo Sie ihn finden

Pushwoosh Control Panel: Navigieren Sie zum Nachrichtenverlauf und öffnen Sie dann die Eigenschaften der gewünschten Nachricht. Der Nachrichtencode wird dort angezeigt.
/createMessage API-Antwort: Beim Erstellen einer neuen Nachricht über die API ist der Nachrichtencode in der Antwort enthalten.

Inhaltskennungen

Preset-Code

Eine Kennung für ein gespeichertes Nachrichten-Preset (zum Beispiel für Push oder SMS). Erfahren Sie mehr

Wo Sie ihn finden

Pushwoosh Control Panel → Content → Presets.

Sie können den Preset-Code an zwei Stellen finden:

In der Listenansicht, unter dem Preset-Namen angezeigt.
In der URL beim Bearbeiten oder Erstellen eines Presets (es ist der letzte Teil der URL).

Beispiel:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/sms-presets/edit/AAAAA-BBBBB

Preset-Code: AAAAA-BBBBB

Rich-Media-Code

Kennung für eine In-App-Nachrichtenvorlage. Erfahren Sie mehr

Wo Sie ihn finden

Pushwoosh Control Panel → Content → Rich media.

Beispiel: URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/rich-media/AAAAA-BBBBB/statistics Rich-Media-Code: AAAAA-BBBBB

E-Mail-Inhaltscode

Der E-Mail-Inhaltscode ist eine eindeutige Kennung für gespeicherte E-Mail-Inhalte. Erfahren Sie mehr

Wo Sie ihn finden

Pushwoosh Control Panel → Content → Email content.

Der Code ist der letzte Teil der URL.

Beispiel:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/email-content/edit/AAAAA-BBBBB E-Mail-Inhaltscode: AAAAA-BBBBB

Kampagnenkennungen

Kampagnencode

Eine eindeutige Kennung, die verwendet wird, um auf eine bestimmte Kampagne zur Nachverfolgung und Analyse zu verweisen.

Wo Sie ihn finden

Der Kampagnencode erscheint in der URL, wenn Sie kampagnenbezogene Statistiken im Pushwoosh Control Panel anzeigen. Um ihn zu finden, gehen Sie zu Statistiken → Aggregierte Statistiken, klicken Sie auf die gewünschte Kampagne und kopieren Sie den Code, der sich am Ende der URL befindet.

Beispiel:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/statistics/aggregated-message?campaignCode=YYYYY-YYYYY

Kampagnencode: YYYYY-YYYYY

Journey-ID

Eine eindeutige Kennung, die verwendet wird, um Nachrichten mit bestimmten Marketingkampagnen zur Nachverfolgung und Leistungsanalyse zu verknüpfen.

Wo Sie sie finden

Die Journey-ID erscheint in der URL des Kampagnen-Canvas im Pushwoosh Control Panel.

Beispiel: URL: https://app.pushwoosh.com/journeys/XXXXX-XXXXX/1/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Journey-ID: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Kennungen für Segmentierung und Zielgruppenansprache

Segment- / Filtername

Der Name eines vordefinierten Benutzersegments, das in Pushwoosh für die Zielgruppenansprache erstellt wurde. Erfahren Sie mehr

Wo Sie ihn finden

Pushwoosh Control Panel → Segmente.

Segment- / Filtercode

Ein eindeutiger Code im Format XXXXX-XXXXX, der ein Segment (auch Filter genannt) in Pushwoosh identifiziert. Dieser Code wird in API-Aufrufen, Automatisierungslogik und dynamischen Segmentierungsregeln verwendet.

Wo Sie ihn finden

Über die /listFilters API-Methode.
In der Adressleiste, wenn Sie ein Segment im Pushwoosh Control Panel anzeigen:

Beispiel:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/segments/XXXE9-XXX49/detail Segmentcode: XXXE9-XXX49

Tag

Ein benutzerdefiniertes Attribut, das Benutzern oder Geräten zugewiesen wird. Wird für die dynamische Segmentierung und Personalisierung verwendet. Erfahren Sie mehr

Wo Sie ihn finden

Pushwoosh Control Panel → Tags oder über die /getTags API.

Event-Kennungen

Event-Name

Der Name eines nachverfolgten Events (z. B. purchase, login, subscription). Wird verwendet, um automatisierte Arbeitsabläufe auszulösen oder für Analysen. Erfahren Sie mehr

Wo Sie ihn finden

Pushwoosh Control Panel → Audience → Events.

Geolokalisierungskennungen

Geozone-ID

Identifiziert einen Geofence-Bereich, der verwendet wird, um standortbasierte Benachrichtigungen auszulösen. Erfahren Sie mehr

Wo Sie sie finden

Pushwoosh Control Panel → Geozones.