Wichtige API-Identifikatoren

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

Allgemeine Identifikatoren

Anwendungscode

Ein eindeutiger Identifikator, der jeder Anwendung in Ihrem Pushwoosh-Konto zugewiesen wird. Er 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 Access.

Geräte-Identifikatoren

Hardware-ID

Ein eindeutiger Identifikator, der einem Gerät vom Pushwoosh SDK zugewiesen wird. Wird automatisch vom SDK gesetzt oder bei der Geräteregistrierung übergeben. Erfahren Sie mehr

Wo Sie sie finden

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

Push-Token

Ein von Plattformanbietern ausgegebenes Token, das ein App-Geräte-Paar für die Zustellung von Push-Benachrichtigungen identifiziert. Wird automatisch vom SDK erfasst, wenn Push-Berechtigungen erteilt werden. Erfahren Sie mehr

Wo Sie es finden

In den Geräteprotokollen. Erfahren Sie mehr
Im User Explorer geben Sie 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 gesetzt.

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

Benutzer-Identifikatoren

Benutzer-ID

Ein benutzerdefinierter Identifikator, der 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-Identifikatoren

Nachrichtencode

Ein eindeutiger Identifikator, der jeder Nachricht bei ihrer Erstellung zugewiesen wird. Er folgt einem bestimmten Format: XXXX-XXXXXXXX-XXXXXXXX.

Dieser Code ist unerlässlich für:

Verfolgung des Status und der Zustellung einer bestimmten Nachricht
Stornierung (oder Löschung) einer zuvor gesendeten Nachricht
Abrufen von Nachrichtenstatistiken

Wo Sie ihn finden

Pushwoosh Control Panel: Navigieren Sie zu Message history 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.

Inhalts-Identifikatoren

Preset-Code

Ein Identifikator 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

Identifikator 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 ein eindeutiger Identifikator 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

Kampagnen-Identifikatoren

Kampagnencode

Ein eindeutiger Identifikator, der 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

Ein eindeutiger Identifikator, der 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-Identifikatoren

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

Wo Sie es finden

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

Event-Identifikatoren

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.

Geolokalisierungs-Identifikatoren

Geozone-ID

Identifiziert einen geofenced Bereich, der verwendet wird, um standortbezogene Benachrichtigungen auszulösen. Erfahren Sie mehr

Wo Sie sie finden

Pushwoosh Control Panel → Geozones.