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 diese 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 diese 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 diese 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 wird

Push-Token

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

Wo Sie diese 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 mithilfe eines numerischen Codes 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 diese 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 Abbrechen (oder Löschen) einer zuvor gesendeten Nachricht
Das Abrufen von Nachrichtenstatistiken

Wo Sie diese 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: 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 (z. B. Push oder SMS). Erfahren Sie mehr

Wo Sie diese 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, wenn Sie ein Preset bearbeiten oder erstellen (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 diese 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 diese 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 diese 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, der am Ende der URL steht.

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 diese 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 diese 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 diese 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 diese 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 diese finden

Pushwoosh Control Panel → Audience → Events.

Geolokalisierungs-Kennungen

Geozone-ID

Identifiziert einen Geofence-Bereich, der zum Auslösen standortbasierter Benachrichtigungen verwendet wird. Erfahren Sie mehr

Wo Sie diese finden

Pushwoosh Control Panel → Geozones.