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 à travers vos applications.

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.

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 par défaut d’au moins un jeton créé. En savoir plus

Où le trouver

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

Un identifiant unique attribué à un appareil par le SDK Pushwoosh. 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 de la recherche par ID utilisateur
• Dans le fichier CSV téléchargé depuis la liste des Segments

Un jeton émis par les fournisseurs de plateforme qui identifie une paire application-appareil pour la livraison des notifications push. 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 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 afficher le jeton de push.

Indique la plateforme de l’appareil cible à l’aide d’un code numérique. 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

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

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 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 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.

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

Identifiant pour un modèle de rich media. 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

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

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 liées à 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

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

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.

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

Vous pouvez trouver le code du segment dans l’aperçu de la définition du segment, dans la section Segments du Panneau de contrôle Pushwoosh. Le code du filtre apparaît au début de la logique de ciblage.

Exemple :

Tag("XXXXX-XXXXX", "In-app Purchase", noteq, "0.00")

Dans ce cas, XXXXX-XXXXX est le code du filtre (segment).

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.

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

Où le trouver

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

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

Où le trouver

Panneau de contrôle Pushwoosh → Géozones.