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 Zielanwendung anzugeben.

Wo Sie ihn finden

Pushwoosh Control Panel → Unter dem Anwendungsnamen.

API-Zugangstoken

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

Wo Sie ihn finden

Pushwoosh Control Panel → API-Zugang.

Gerätekennungen

Hardware-ID

Eine eindeutige Kennung, die von dem Pushwoosh SDK einem Gerät 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
In der CSV-Datei, die von der Segmentliste heruntergeladen wurde

Push-Token

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

Wo Sie ihn 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 den 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

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

Nachrichten-Kennungen

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 Stornieren (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 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 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

Segmentierungs- und Targeting-Kennungen

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 API-Methode /listFilters.
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 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 standortbezogener Benachrichtigungen verwendet wird. Erfahren Sie mehr

Wo Sie sie finden

Pushwoosh Control Panel → Geozones.