Wichtige API-Kennungen

Dieser Beitrag listet wesentliche 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 wird und zur Authentifizierung von API-Anfragen dient. 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 es finden

Pushwoosh Control Panel → API Access.

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 der User ID
In der CSV-Datei, die von der Segmentliste heruntergeladen wurde

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
13 – Internet Explorer
14 – E-Mail
16 – Baidu Android
17 – Huawei
18 – SMS
20 – Web
21 – WhatsApp
22 – Line
23 – Kakao Talk
24 – Telegram
25 – Apple Wallet
26 – Google Wallet
27 – Viber

Benutzerkennungen

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 Nachverfolgung 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 zu Campaigns → One-time messages und öffnen Sie dann die Eigenschaften der gewünschten Nachricht. Der Nachrichtencode wird dort angezeigt.
/createMessage API-Antwort: Wenn Sie eine neue Nachricht über die API erstellen, ist der Nachrichtencode in der Antwort enthalten.

Inhaltskennungen

Preset-Code

Eine Kennung für ein gespeichertes Nachrichten-Preset (zum Beispiel 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 zur Referenzierung einer bestimmten Kampagne für Nachverfolgung und Analyse verwendet wird.

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 Statistics → Aggregated statistics, klicken Sie auf die gewünschte Kampagne und kopieren Sie den Code am Ende der URL.

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 → Segments.

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. Es wird für die dynamische Segmentierung und Personalisierung verwendet. Erfahren Sie mehr

Wo Sie es finden

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

Ereigniskennungen

Ereignisname

Der Name eines nachverfolgten Ereignisses (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 zum Auslösen standortbasierter Benachrichtigungen verwendet wird. Erfahren Sie mehr

Wo Sie sie finden

Pushwoosh Control Panel → Geozones.