Identifiants clés de l'API

Cet article répertorie les identifiants essentiels utilisés dans les requêtes de l’API Pushwoosh. Ces identifiants sont nécessaires pour l’authentification, la création de messages, le ciblage, la segmentation, le suivi et la gestion des utilisateurs dans vos applications.

Identifiants généraux

Code d’application

Un identifiant unique attribué à chaque application dans votre compte Pushwoosh. Il est requis dans la plupart des appels API pour spécifier l’application cible.

Où le trouver

Control Panel Pushwoosh → Sous le nom de l’application.

Jeton d’accès à l’API

Un jeton unique attribué à un compte Pushwoosh, utilisé pour authentifier les requêtes API. Il permet de gérer les projets, d’envoyer des messages, de modifier les paramètres et de récupérer des données. Chaque compte dispose d’au moins un jeton créé par défaut. En savoir plus

Où le trouver

Control Panel Pushwoosh → API Access.

Identifiants d’appareil

ID matériel (HWID)

Un identifiant unique attribué à un appareil par le SDK Pushwoosh. Il est défini automatiquement par le SDK ou transmis lors de l’enregistrement de l’appareil. En savoir plus

Où le trouver

Dans les journaux de l’appareil. En savoir plus
Dans User Explorer en recherchant par ID utilisateur
Dans le fichier CSV téléchargé depuis la liste des segments

Jeton push

Un jeton émis par les fournisseurs de plateformes qui identifie une paire application-appareil pour la livraison de notifications push. Il est collecté automatiquement par le SDK lorsque les autorisations de push sont accordées. En savoir plus

Où le trouver

Dans les journaux de l’appareil. En savoir plus
Dans User Explorer, saisissez le HWID dans le champ de recherche pour trouver l’appareil associé, puis ouvrez les détails de l’appareil pour voir le jeton push.

Type d’appareil

Indique la plateforme de l’appareil cible à l’aide d’un code numérique. Il est défini automatiquement par le SDK.

Valeurs prises en charge :

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

Identifiants utilisateur

ID utilisateur

Un identifiant personnalisé attribué à un utilisateur, permettant un ciblage multi-appareils et personnalisé. En savoir plus

Où le trouver

Control Panel Pushwoosh → Audience → User Explorer

Identifiants de messagerie

Code de message

Un identifiant unique attribué à chaque message lors de sa création. Il suit un format spécifique : XXXX-XXXXXXXX-XXXXXXXX.

Ce code est essentiel pour :

Suivre l’état et la livraison d’un message spécifique
Annuler (ou supprimer) un message précédemment envoyé
Obtenir les statistiques d’un message

Où le trouver

Control Panel Pushwoosh : Naviguez vers Campaigns → One-time messages, puis ouvrez les propriétés du message souhaité. Le code du message y sera affiché.
Réponse de l’API /createMessage : Lors de la création d’un nouveau message via l’API, le code du message est inclus dans la réponse.

Identifiants de contenu

Code de préréglage

Un identifiant pour un préréglage de message enregistré (par exemple, push ou SMS). En savoir plus

Où le trouver

Control Panel Pushwoosh → Content → Presets.

Vous pouvez trouver le code de préréglage à deux endroits :

Dans la vue en liste, affiché sous le nom du préréglage.
Dans l’URL lors de la modification ou de la création d’un préréglage (c’est la dernière partie de l’URL).

Exemple :

URL : https://app.pushwoosh.com/applications/XXXXX-XXXXX/sms-presets/edit/AAAAA-BBBBB

Code de préréglage : AAAAA-BBBBB

Code de média enrichi

Identifiant pour un modèle de message in-app. En savoir plus

Où le trouver

Control Panel Pushwoosh → Content → Rich media.

Exemple : URL : https://app.pushwoosh.com/applications/XXXXX-XXXXX/rich-media/AAAAA-BBBBB/statistics Code de média enrichi : AAAAA-BBBBB

Code de contenu d’e-mail

Le code de contenu d’e-mail est un identifiant unique pour le contenu d’e-mail enregistré. En savoir plus

Où le trouver

Control Panel Pushwoosh → Content → Email content.

Le code est la dernière partie de l’URL.

Exemple :

URL : https://app.pushwoosh.com/applications/XXXXX-XXXXX/email-content/edit/AAAAA-BBBBB Code de contenu d’e-mail : AAAAA-BBBBB

Identifiants de campagne

Code de campagne

Un identifiant unique utilisé pour référencer une campagne spécifique à des fins de suivi et d’analyse.

Où le trouver

Le code de campagne apparaît dans l’URL lors de la consultation des statistiques relatives à la campagne dans le Control Panel Pushwoosh. Pour le localiser, allez dans Statistics → Aggregated statistics, cliquez sur la campagne souhaitée et copiez le code qui se trouve à la fin de l’URL.

Exemple :

URL : https://app.pushwoosh.com/applications/XXXXX-XXXXX/statistics/aggregated-message?campaignCode=YYYYY-YYYYY

Code de campagne : YYYYY-YYYYY

ID de Journey

Un identifiant unique utilisé pour associer des messages à des campagnes marketing spécifiques à des fins de suivi et d’analyse des performances.

Où le trouver

L’ID de Journey apparaît dans l’URL du canevas de la campagne dans le Control Panel Pushwoosh.

Exemple : URL : https://app.pushwoosh.com/journeys/XXXXX-XXXXX/1/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

ID de Journey : aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Identifiants de segmentation et de ciblage

Nom du segment / filtre

Le nom d’un segment d’utilisateurs prédéfini créé dans Pushwoosh pour le ciblage d’audience. En savoir plus

Où le trouver

Control Panel Pushwoosh → Segments.

Code du segment / filtre

Un code unique au format XXXXX-XXXXX qui identifie un segment (également appelé filtre) dans Pushwoosh. Ce code est utilisé dans les appels API, la logique d’automatisation et les règles de segmentation dynamique.

Où le trouver

Via la méthode API /listFilters.
Dans la barre d’adresse lors de la consultation d’un segment dans le Control Panel Pushwoosh :

Exemple :

URL : https://app.pushwoosh.com/applications/XXXXX-XXXXX/segments/XXXE9-XXX49/detail Code de segment : XXXE9-XXX49

Tag

Un attribut personnalisé attribué aux utilisateurs ou aux appareils. Utilisé pour la segmentation dynamique et la personnalisation. En savoir plus

Où le trouver

Control Panel Pushwoosh → Tags ou via l’API /getTags.

Identifiants d’événement

Nom de l’événement

Le nom d’un événement suivi (par exemple, purchase, login, subscription). Utilisé pour déclencher des flux de travail automatisés ou pour l’analyse. En savoir plus

Où le trouver

Control Panel Pushwoosh → Audience → Events.

Identifiants de géolocalisation

ID de géozone

Identifie une zone géorepérée utilisée pour déclencher des notifications basées sur la localisation. En savoir plus

Où le trouver

Control Panel Pushwoosh → Geozones.