Passer au contenu

Intégration RudderStack

RudderStack est une plateforme de données clients qui collecte les événements de vos applications, sites web, serveurs et entrepôts de données et les transmet à d’autres outils. Avec la destination Pushwoosh dans RudderStack, les données que vous y collectez déjà arrivent dans Pushwoosh sans code supplémentaire dans votre application :

  • Les événements track deviennent des événements Pushwoosh. Utilisez-les pour créer des segments et pour lancer ou ramifier des customer journeys.
  • Les traits identify deviennent des tags spécifiques à l’utilisateur. Utilisez-les pour cibler et personnaliser les notifications push, les messages in-app et les e-mails.

Avant de commencer

Anchor link to

La destination associe toutes les données par User ID, vérifiez donc d’abord ces prérequis :

  • Le SDK Pushwoosh est intégré à votre application.
  • Votre application appelle setUserId avec la même valeur que celle que RudderStack envoie comme userId. Pushwoosh relie les événements et traits entrants aux utilisateurs grâce à cette valeur.
  • L’appareil de chaque utilisateur est enregistré avec ce User ID avant que RudderStack n’envoie des appels identify pour cet utilisateur. Les traits d’un User ID que Pushwoosh ne connaît pas encore sont ignorés.
  • Vous avez accès à Settings → API Access dans Pushwoosh pour créer un token API.
  • Vous disposez d’un workspace RudderStack avec au moins une source qui envoie des appels track ou identify.

Configurer la destination Pushwoosh dans RudderStack

Anchor link to

La configuration comporte deux parties : vous récupérez deux valeurs dans Pushwoosh, puis vous créez la destination dans RudderStack.

Obtenir le code d’application et un Device API token

Anchor link to

RudderStack a besoin de deux valeurs pour envoyer des données à votre application : son code d’application et un Device API token.

  1. Dans Pushwoosh, ouvrez l’application à laquelle vous voulez envoyer des données.
  2. Copiez le code d’application. Il s’affiche sous le nom de l’application dans le coin supérieur gauche et ressemble à XXXXX-XXXXX.
  3. Allez dans Settings → API Access et cliquez sur Generate New Token.
  4. Dans Token type, choisissez device.
  5. Dans Name, saisissez un nom pour le token, par exemple RudderStack.
  6. Cliquez sur Generate.
  7. Dans la liste des tokens, cliquez sur le menu à trois points à côté du nouveau token et choisissez Edit token….
  8. Sous Applications, sélectionnez l’application de l’étape 1 et cliquez sur Save.
  9. Copiez la valeur du token depuis la liste des tokens.

Un Device API token suffit pour la destination. Vous n’avez pas besoin d’un Server API token.

Ajouter la destination dans RudderStack

Anchor link to

La destination Pushwoosh connecte vos sources RudderStack à votre application Pushwoosh.

  1. Dans le tableau de bord RudderStack, allez dans Collect → Destinations.
  2. Cliquez sur New destination.
  3. Sélectionnez Pushwoosh dans la liste.
  4. Saisissez un nom pour la destination et cliquez sur Continue.
  5. Sélectionnez les sources que vous voulez envoyer à Pushwoosh.
  6. Dans Application Code, collez le code d’application.
  7. Dans API Token, collez le Device API token.
  8. Terminez la configuration pour enregistrer la destination.

RudderStack envoie les données à Pushwoosh depuis ses propres serveurs (cloud mode), pour chaque type de source pris en charge par la destination.

Pour la partie RudderStack de la configuration, consultez le guide de la destination Pushwoosh dans la documentation RudderStack.

Quelles données RudderStack envoie à Pushwoosh

Anchor link to

La destination prend en charge deux types d’appels, track et identify. RudderStack rejette tout autre type d’appel, comme page, screen, group ou alias, pour cette destination.

Chaque appel doit avoir un userId. RudderStack n’envoie pas les appels qui n’en ont pas, car Pushwoosh ne peut pas attribuer un appel anonyme à un utilisateur.

Les appels track deviennent des événements Pushwoosh

Anchor link to

Chaque appel track devient un événement Pushwoosh portant le même nom que l’événement RudderStack :

Champ RudderStackPushwoosh
eventNom de l’événement
propertiesAttributs de l’événement
userIdUser ID
timestamp (ou originalTimestamp)Heure de l’événement
context.device.idDevice ID, s’il est présent
context.device.type ou context.os.namePlateforme : android ; ios pour iOS, iPadOS, watchOS et tvOS ; web pour toute autre valeur ou en l’absence de valeur

Si l’événement ou un attribut n’existe pas encore dans l’application, Pushwoosh le crée automatiquement.

Pushwoosh rejette l’événement entier dans les cas suivants. Aucune erreur n’est renvoyée, donc RudderStack signale l’événement comme livré :

  • L’appel comporte plus de 100 propriétés.
  • La valeur d’une propriété dépasse 10 Ko.
  • Le nom de l’événement dépasse 255 caractères.
  • L’événement est nouveau, et son nom dépasse 128 caractères ou contient des caractères de contrôle.

Un événement conserve jusqu’à 100 attributs. Lorsqu’un événement a 100 attributs connus, Pushwoosh continue d’enregistrer les nouveaux appels, mais les nouveaux noms de propriétés ne sont pas ajoutés comme attributs.

Les objets imbriqués dans properties arrivent sous forme de chaînes JSON, et les propriétés de valeur null sont ignorées.

Les appels identify deviennent des tags spécifiques à l’utilisateur

Anchor link to

Chaque appel identify définit ses traits comme tags de l’utilisateur ayant le userId indiqué. Les traits proviennent de traits, ou de context.traits lorsque traits est vide.

  • Seuls les tags spécifiques à l’utilisateur sont écrits. Si la création automatique de tags est activée pour votre compte, un trait portant un nouveau nom crée un tag spécifique à l’utilisateur. Si un tag General du même nom existe déjà, Pushwoosh ignore ce trait sans erreur.
  • Une valeur doit correspondre au type du tag. Si un tag existe déjà et que la valeur du trait ne correspond pas à son type, comme du texte pour un tag Integer, Pushwoosh ignore ce trait sans erreur.
  • L’utilisateur doit déjà exister dans Pushwoosh. Les tags ne sont appliqués que si le SDK Pushwoosh a enregistré un appareil avec setUserId défini sur le même userId. Les traits d’un utilisateur inconnu sont ignorés sans erreur.
  • Les traits d’identité et de contact ne sont pas copiés dans les tags. email, phone, firstName, lastName, name, address, id, userId et anonymousId ne sont jamais envoyés comme tags. Un appel identify qui ne contient que ces traits échoue avec No traits left to send as Pushwoosh tags.
  • Une valeur vide efface le tag. Un trait avec une chaîne vide ou une liste vide supprime la valeur actuelle de ce tag pour l’utilisateur.
  • Les objets imbriqués arrivent sous forme de chaînes JSON. Les traits de valeur null sont ignorés.

Ce que la destination ne fait pas

Anchor link to

La destination envoie uniquement les données track et identify. Ces tâches restent en dehors de son périmètre :

  • Elle n’enregistre pas les appareils ni les adresses e-mail. Les appareils proviennent du SDK Pushwoosh.
  • Elle ne supprime pas les utilisateurs. Les demandes de suppression d’utilisateurs de RudderStack ne sont pas prises en charge pour cette destination.

Vérifier que l’intégration fonctionne

Anchor link to

Une fois la destination enregistrée, envoyez un appel track et un appel identify de test depuis une source avec un userId qui possède déjà un appareil dans Pushwoosh.

  • Événements : dans Pushwoosh, allez dans Audience → Events, ouvrez l’événement et vérifiez qu’il est comptabilisé.
  • Tags : allez dans Audience → User Explorer, recherchez l’utilisateur par User ID et vérifiez les valeurs des tags.

Les erreurs de livraison de chaque appel s’affichent dans la vue Live Events de la destination dans RudderStack.

Dépannage

Anchor link to

Trouvez le message d’erreur que RudderStack affiche pour la destination dans Live Events pour en connaître la cause et la solution.

Les appels track échouent avec unauthorized

Anchor link to

Le token API ne correspond pas au code d’application. Vérifiez que le token appartient au même compte Pushwoosh que l’application.

Les appels identify ne vérifient pas le token, ils continuent donc de réussir avec un token incorrect. Utilisez un appel track pour tester le token.

Les appels échouent avec application not found ou application code is not valid

Anchor link to

Le code d’application est incorrect, ou le compte n’est pas hébergé sur app.pushwoosh.com. Les appels track échouent avec application not found, et les appels identify échouent avec application code is not valid. Vérifiez le code dans le Pushwoosh Control Panel. Si le code est correct, contactez votre Customer Success Manager ou le support.

Les appels échouent avec Missing required value from userId

Anchor link to

L’appel n’a pas de userId. Les appels anonymes ne sont pas envoyés à Pushwoosh. Appelez identify dans votre source RudderStack après la connexion de l’utilisateur, afin que les appels suivants contiennent le userId.

Les appels échouent avec Invalid enum value

Anchor link to

Le type d’appel n’est ni track ni identify. Pushwoosh n’accepte que ces deux types. Ne connectez pas les sources qui envoient uniquement des appels page, screen, group ou alias, ou ignorez ces erreurs.

Les appels identify échouent avec No traits left to send as Pushwoosh tags

Anchor link to

Tous les traits de l’appel sont des traits d’identité ou de contact, comme email ou phone, qui ne sont jamais copiés dans les tags. Ajoutez au moins un autre trait ou ignorez l’appel.

Les appels identify réussissent mais les tags n’apparaissent pas

Anchor link to

Vérifiez les points suivants dans l’ordre :

  1. Un appareil avec ce User ID est enregistré dans Pushwoosh. Recherchez l’utilisateur dans Audience → User Explorer.
  2. L’application appelle setUserId avec exactement la même valeur que celle que RudderStack envoie comme userId.
  3. Le tag portant ce nom est User-specific. Un trait pour un tag General existant est ignoré. Modifiez la portée du tag ou renommez le trait.
  4. La valeur du trait correspond au type du tag existant.
  5. Le trait ne fait pas partie des traits d’identité ou de contact qui ne sont jamais copiés, comme email ou phone.