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

Panneau de contrôle 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

Panneau de contrôle Pushwoosh → Accès API.

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 l’Explorateur d’utilisateurs lors d’une recherche 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 des notifications push. Il est collecté automatiquement par le SDK lorsque les autorisations push sont accordées. En savoir plus

Où le trouver

Dans les journaux de l’appareil. En savoir plus
Dans l’Explorateur d’utilisateurs, 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 d’utilisateur

ID utilisateur

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

Où le trouver

Panneau de contrôle Pushwoosh → Audience → Explorateur d’utilisateurs

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 le statut et la livraison d’un message spécifique
Annuler (ou supprimer) un message précédemment envoyé
Obtenir les statistiques du message

Où le trouver

Panneau de contrôle Pushwoosh : Accédez à l’Historique des messages, puis ouvrez les propriétés du message souhaité. Le code de message y sera affiché.
Réponse de l’API /createMessage : Lors de la création d’un nouveau message via l’API, le code de 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

Panneau de contrôle Pushwoosh → Contenu → Préréglages.

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 Rich Media

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

Où le trouver

Panneau de contrôle Pushwoosh → Contenu → Rich Media.

Exemple : URL : https://app.pushwoosh.com/applications/XXXXX-XXXXX/rich-media/AAAAA-BBBBB/statistics Code de Rich Media : 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

Panneau de contrôle Pushwoosh → Contenu → Contenu d’e-mail.

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 panneau de contrôle Pushwoosh. Pour le localiser, allez dans Statistiques → Statistiques agrégées, 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 panneau de contrôle 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 de l’audience. En savoir plus

Où le trouver

Panneau de contrôle 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 panneau de contrôle 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

Panneau de contrôle Pushwoosh → Tags ou via l’API /getTags.

Identifiants d’événement

Nom de l’événement

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

Où le trouver

Panneau de contrôle Pushwoosh → Audience → Événements.

Identifiants de géolocalisation

ID de Geozone

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

Panneau de contrôle Pushwoosh → Geozones.