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

Application code

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 access token

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, zur Änderung 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. 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 bei der Suche nach User ID
In der CSV-Datei, die von der Segments-Liste heruntergeladen wurde

Push token

Ein von Plattformanbietern ausgegebenes Token, das ein App-Geräte-Paar zur 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.

Device type

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
13 – Internet Explorer
14 – Email
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

Message code

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 Message Code wird dort angezeigt.
/createMessage API-Antwort: Wenn eine neue Nachricht über die API erstellt wird, ist der Message Code in der Antwort enthalten.

Request ID

Korreliert eine Nachricht mit der HTTP-Anfrage, die sie erstellt hat, sodass Sie eine einzelne Sendung von Anfang bis Ende nachverfolgen können – vom HTTP-Aufruf über die Routing-Schicht von Pushwoosh bis zur resultierenden Nachricht.

Vorhanden bei jeder Nachricht, die durch einen HTTP-Aufruf an /createMessage oder die Messaging API v2 erstellt wurde, einschließlich Nachrichten, die aus dem Control Panel gesendet werden. Nachrichten, die durch Journeys, Cron-Sendungen oder andere interne Nicht-HTTP-Trigger erstellt wurden, haben keine Request ID.

Einen eigenen Wert festlegen

Übergeben Sie einen X-Request-ID-Header mit der Anfrage. Wenn der Wert 8–128 Zeichen lang ist und nur lateinische Buchstaben, Ziffern, Punkte, Unterstriche und Bindestriche enthält, verwendet Pushwoosh ihn wieder; andernfalls – oder wenn der Header weggelassen wird – generiert Pushwoosh einen für Sie. Ein ungültiger Wert wird stillschweigend ersetzt, sodass die Anfrage niemals deswegen fehlschlägt. Die Eindeutigkeit wird nicht erzwungen, verwenden Sie also einen Wert, der pro Anfrage tatsächlich eindeutig ist, wenn Sie sich für die Nachverfolgung darauf verlassen.

Wo Sie sie finden

Pushwoosh Control Panel → eine Nachricht öffnen → Message Details → Show all properties → Message settings → Request ID (mit einem Kopier-Button).

Beispiel: a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d

In-app code

Ein eindeutiger Code, der eine Instant-In-App-Kampagne identifiziert. Wo Sie ihn finden

Pushwoosh Control Panel → Campaigns → Instant in-apps. In der Liste wird der Code unter dem Kampagnennamen angezeigt.

Beispiel: AAAAA-BBBBB

Inhaltskennungen

Preset code

Eine Kennung für eine gespeicherte Nachrichtenvorlage (z. B. 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 Namen der Vorlage angezeigt.
In der URL beim Bearbeiten oder Erstellen einer Vorlage (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

Email content code

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

Campaign code

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

In der URL des Kampagnen-Canvas im Pushwoosh Control Panel.
Wählen Sie einen Punkt auf dem Canvas aus und drücken Sie Strg+I (Cmd+I) – dies kopiert <journey UUID>/<point UUID> in die Zwischenablage; die Journey ID ist der Teil vor dem Schrägstrich.

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 / Filter name

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 / Filter code

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 Segment-Code: 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-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.