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

Pushwoosh Control Panel → Unter dem Anwendungsnamen.

API access token

Ein eindeutiges Token, das einem Pushwoosh-Konto zugewiesen ist und zur Authentifizierung von API-Anfragen verwendet wird. Es 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 ein Token. 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 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 für die 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
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 festgelegt.

Unterstützte Werte:

1 – iOS
3 – Android
7 – macOS
8 – Windows
9 – Amazon
10 – Safari
11 – Chrome
12 – Firefox
13 – Internet Explorer
14 – Email
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

Nachrichten-Kennungen

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:

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 Campaigns → One-time messages und öffnen Sie dann die Eigenschaften der gewünschten Nachricht. Der Message Code wird dort angezeigt.
/createMessage API-Antwort: Beim Erstellen einer neuen Nachricht über die API 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 wird, einschließlich Nachrichten, die vom Control Panel gesendet werden. Nachrichten, die durch Journeys, Cron-Sendungen oder andere interne Nicht-HTTP-Trigger erstellt werden, haben keine Request ID.

Einstellen eines eigenen Wertes

Ü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 einer Kopierschaltfläche).

Beispiel: a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d

In-app code

Ein eindeutiger Code, der eine sofortige 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 Nachrichtenvoreinstellung (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 des Presets 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

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 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 spezifischen 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 Ctrl+I (Cmd+I) – 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

Segmentierungs- und Zielgruppenkennungen

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 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-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 geofenced-Bereich, der verwendet wird, um standortbasierte Benachrichtigungen auszulösen. Erfahren Sie mehr

Wo Sie sie finden

Pushwoosh Control Panel → Geozones.