Événements par défaut

Note

Disponible à partir du SDK 5.2.2

Que sont les événements par défaut ?

Les événements par défaut sont des interactions de base que les utilisateurs effectuent dans les applications ou les sites web, quel que soit leur secteur d’activité ou leur fonctionnalité. Ces actions clés des utilisateurs constituent le cœur de la communication client et peuvent être exploitées pour n’importe quel produit et client à n’importe quelle étape du cycle de vie du client.

Les événements par défaut sont disponibles prêts à l’emploi pour les versions à jour du SDK. Ils ne nécessitent aucun paramétrage supplémentaire, à l’exception de PW_InAppPurchase (voir les détails ci-dessous).

Pour trouver et activer les événements par défaut disponibles dans Pushwoosh, suivez ces étapes :

1. Accédez à l’onglet Events dans la section Audience.
2. Cliquez sur Créer un événement.
3. Sélectionnez Événement par défaut dans le menu déroulant.
4. Dans la fenêtre contextuelle, choisissez l’événement souhaité et cliquez sur Activer.

Une fois activés, les événements par défaut peuvent être utilisés dans la messagerie comportementale. Par exemple, utilisez-les comme une Entrée basée sur un déclencheur dans un Customer Journey ou comme un déclencheur pour les messages In-App.

Conseil

Pour voir comment vous pouvez utiliser les événements par défaut pour créer une campagne marketing dans Pushwoosh et convertir automatiquement les utilisateurs gratuits en clients payants, regardez ce tutoriel :

Vidéo Youtube : Comment utiliser les événements par défaut pour créer une campagne marketing dans Pushwoosh et convertir automatiquement les utilisateurs gratuits en clients payants

Utilisation de l’appareil et de l’application

PW_DeviceRegistered

Cet événement est déclenché une seule fois pour chaque appareil, lors du premier lancement de l’application et de l’initialisation du SDK. Comme son nom l’indique, cet événement suit l’enregistrement de l’appareil dans votre application.

Cas d’utilisation

• Lancez une campagne d’accueil pour les nouveaux utilisateurs enregistrés. Ajoutez l’Entrée basée sur un déclencheur utilisant l’événement PW_DeviceRegistered à un Customer Journey d’accueil.
• Identifiez les activités d’acquisition qui vous apportent le plus de nouveaux venus grâce aux statistiques de l’événement.
• Engagez les utilisateurs dès leur première visite. Accueillez-les avec des In-Apps déclenchés par l’événement DeviceRegistered.

PW_DeviceUnregistered

Cet événement se déclenche lorsque l’application est désinstallée, ou qu’un utilisateur se désabonne des e-mails ou des notifications push.

Attributs de l’événement

• message_id (chaîne de caractères)
• message_code (chaîne de caractères)
• campaign_id (chaîne de caractères)

Cas d’utilisation

• Fidélisez les utilisateurs lorsqu’ils décident d’arrêter d’utiliser votre application. Par exemple, vous pouvez envoyer un e-mail avec une offre spéciale à chaque utilisateur qui a désinstallé l’application.
• Maintenez la communication avec les utilisateurs qui se sont désabonnés de l’un de vos canaux. Par exemple, si un utilisateur ne souhaite plus recevoir de notifications push, vous pouvez envoyer un e-mail ou afficher un in-app pour l’encourager à utiliser l’application plus souvent.

PW_ApplicationOpen

Pour les applications mobiles uniquement

L’événement ApplicationOpen est déclenché chaque fois qu’un utilisateur lance votre application mobile sur son appareil.

Attributs de l’événement

• device_type (entier) : code du type d’appareil. Consultez registerDevice pour plus de détails.
• application_version (chaîne de caractères) : la version de l’application.

Cas d’utilisation

• Rassemblez des statistiques de rétention des utilisateurs basées sur les statistiques de l’événement ApplicationOpen.
• Lancez des campagnes de messagerie in-app pour les utilisateurs qui sont actifs dans l’application.

PW_ScreenOpen

Pour les applications mobiles uniquement

Cet événement se déclenche chaque fois qu’un utilisateur consulte un écran spécifique dans votre application mobile.

Attributs de l’événement

• application_version (chaîne de caractères) : la version de l’application.
• device_type (entier) : code du type d’appareil. Consultez registerDevice pour plus de détails.
• screen_name (chaîne de caractères) : nom technique de l’écran obtenu depuis votre application.

Cas d’utilisation

• Envoyez des messages parfaitement pertinents aux utilisateurs qui ont montré leur intérêt pour des sections spécifiques de l’application en démarrant des Customer Journeys avec l’événement PW_ScreenOpen.
• Évaluez et améliorez l’efficacité de vos promotions. Testez A/B/n deux ou plusieurs versions de votre offre, attendez que l’événement ScreenOpen se produise, puis voyez quel contenu a été le plus performant.
• Découvrez quels écrans de l’application sont les plus visités. Filtrez les statistiques de l’événement par nom d’écran.

PW_ApplicationMinimized

Pour les applications mobiles uniquement

Cet événement se déclenche lorsqu’un utilisateur minimise (mais ne force pas l’arrêt) l’application sur son appareil.

Attributs de l’événement

• device_type (entier) : code du type d’appareil. Consultez registerDevice pour plus de détails.
• application_version (chaîne de caractères) : la version de l’application.

Cas d’utilisation

• Suivez le temps de session moyen entre les événements ApplicationOpen et ApplicationMinimized.
• Envoyez des notifications push pendant que l’application s’exécute en arrière-plan pour attirer l’attention des utilisateurs et les faire revenir dans l’application.

PW_UserIdle

Pour les applications mobiles uniquement

Assistance d'un développeur requise

Pour commencer à recevoir les événements PW_UserIdle, vous aurez besoin de l’aide de votre équipe de développeurs. Partagez les notes de configuration du SDK ci-dessous.

Cet événement se déclenche lorsqu’un utilisateur se trouve dans votre application mais n’a pas interagi avec l’écran pendant une période configurable. Contrairement à PW_ApplicationMinimized, qui se déclenche après que l’utilisateur a quitté l’application, PW_UserIdle se déclenche alors que l’utilisateur est toujours dans l’application. Il capture le moment où l’attention baisse, où l’utilisateur hésite ou est distrait. Utilisez-le comme un signal côté serveur pour afficher un In-App opportun, offrir de l’aide ou inciter l’utilisateur à passer à l’étape suivante.

La détection d’inactivité est désactivée par défaut sur les deux plateformes. Lorsque la clé de temporisation est absente ou définie sur 0, aucun événement PW_UserIdle n’est envoyé. Pour l’activer, définissez la temporisation (minimum 30 secondes) dans la configuration de la plateforme de votre application :

• iOS : ajoutez la clé Pushwoosh_IDLE_TIMEOUT_SECONDS (Nombre, minimum 30) au fichier Info.plist de votre application.
• Android : ajoutez les méta-données com.pushwoosh.idle_timeout_seconds (entier, minimum 30) à votre AndroidManifest.xml.

Attributs de l’événement

• screen_name (chaîne de caractères) : l’écran où l’utilisateur est devenu inactif. Sur Android, formaté en ActivityName/FragmentName lorsque l’écran actuel est imbriqué. Sinon, le nom de l’activité. Sur iOS, formaté en ParentVC/ChildVC lorsqu’il est imbriqué. Sinon, le nom du contrôleur de vue.
• idle_seconds (entier) : la temporisation d’inactivité configurée qui s’est écoulée.
• session_duration (entier) : secondes depuis que l’application a été ramenée au premier plan pour la dernière fois.
• device_type (entier) : code du type d’appareil. Consultez registerDevice pour plus de détails.
• application_version (chaîne de caractères) : la version de l’application.

Comportement

• Se déclenche au plus une fois par session au premier plan. Revenir en arrière-plan puis au premier plan démarre une nouvelle session.
• Le minuteur se met automatiquement en pause lorsque le clavier virtuel est ouvert, lorsqu’une boîte de dialogue modale ou une invite système est à l’écran, et lorsque l’application est en arrière-plan.
• L’interaction physique avec l’écran (touchers, défilement et saisie) réinitialise le minuteur.

Cas d’utilisation

• Déclenchez une offre In-App ou un assistant contextuel lorsque les utilisateurs s’attardent sur un écran à forte intention (panier, tarification, paiement) sans agir.
• Affichez une astuce ou un tutoriel lorsque les utilisateurs calent sur une étape d’accueil.
• Identifiez où les utilisateurs perdent leur élan en filtrant les statistiques d’événements d’inactivité par screen_name.

PW_ApplicationExit

Pour les applications mobiles uniquement

Assistance d'un développeur requise

Pour commencer à recevoir les événements PW_ApplicationExit, vous aurez besoin de l’aide de votre équipe de développeurs. Partagez les notes de configuration du SDK ci-dessous.

Cet événement se déclenche lorsqu’un utilisateur met l’application en arrière-plan et ne revient pas dans un délai configurable. Contrairement à PW_ApplicationMinimized, qui se déclenche immédiatement lorsque l’utilisateur quitte, PW_ApplicationExit se déclenche uniquement après que le délai configuré s’est écoulé. Il confirme que l’utilisateur a réellement quitté la session plutôt que de changer brièvement d’application. Utilisez-le pour réengager les utilisateurs qui ont abandonné une session en cours de route, ou pour déclencher des campagnes de suivi après une sortie confirmée.

La détection d’intention de sortie est désactivée par défaut. Pour l’activer, définissez la temporisation (10–30 secondes, les valeurs en dehors de cette plage sont automatiquement ajustées) dans la configuration de la plateforme de votre application :

• Android : ajoutez les méta-données com.pushwoosh.exit_intent_timeout_seconds (entier, 10–30) à votre AndroidManifest.xml.
• iOS : ajoutez la clé Pushwoosh_APPLICATION_EXIT_TIMEOUT_SECONDS (Nombre, 10–30) au fichier Info.plist de votre application.

Attributs de l’événement

• screen_name (chaîne de caractères) : le dernier écran actif lorsque l’utilisateur a mis l’application en arrière-plan.
• session_duration (entier) : secondes depuis que l’application a été ramenée au premier plan pour la dernière fois.
• exit_intent_seconds (entier) : la temporisation effective qui s’est écoulée avant que l’événement ne se déclenche (10–30 s).
• device_type (entier) : code du type d’appareil. Consultez registerDevice pour plus de détails.
• application_version (chaîne de caractères) : la version de l’application.

Comportement

• Le minuteur démarre lorsque l’application est mise en arrière-plan et est annulé si l’utilisateur revient avant l’expiration de la temporisation.
• Le nom de l’écran et la durée de la session sont capturés au moment de la mise en arrière-plan, et non lorsque l’événement se déclenche.
• L’événement ne se déclenche pas si la détection d’intention de sortie est désactivée (la clé de temporisation est 0 ou n’est pas définie).

Cas d’utilisation

• Réengagez les utilisateurs qui ont abandonné un flux d’achat ou d’inscription. Déclenchez une notification push ou un e-mail avec un rappel ou une réduction.
• Démarrez un Customer Journey de reconquête pour les utilisateurs qui quittent sans terminer une action clé (par exemple, en laissant un panier ou en s’arrêtant au milieu de l’accueil).
• Identifiez les écrans à fort taux d’abandon en filtrant les statistiques d’événements par screen_name.

Web

PW_SiteOpened

Pour le web uniquement

L’événement SiteOpened se déclenche chaque fois qu’un utilisateur ouvre l’une des pages de votre site web.

Attributs de l’événement

• device_type (entier) : code du type d’appareil. Consultez registerDevice pour plus de détails.
• title (chaîne de caractères) : le titre de la page visitée.
• url (chaîne de caractères) : l’URL de la page visitée.

Cas d’utilisation

• Analysez la répartition du trafic de votre site et comparez le nombre de fois que les utilisateurs ouvrent des pages spécifiques du site. Pour cela, filtrez les statistiques de l’événement par ses attributs.
• Faites un suivi de la visite d’un utilisateur sur le site web avec une communication pertinente. Créez un parcours commençant par l’événement SiteOpened configuré pour un attribut title ou url spécifique.

Commerce

PW_InAppPurchase

Pour les applications mobiles uniquement

Assistance d'un développeur requise

Pour configurer l’événement d’achat In-App, vous aurez besoin de l’aide de votre équipe de développeurs. Partagez le guide avec eux.

L’événement InAppPurchase se déclenche chaque fois qu’un utilisateur achète un article in-app dans votre application. Les exemples incluent les abonnements payants, les éléments de mécanique de jeu, la monnaie in-app, etc.

Note

Veuillez garder à l’esprit que ces articles doivent être spécifiés sur la page App Store de votre application.

Pour implémenter l’événement d’achat In-App :

• iOS : activez l’événement PW_InAppPurchase dans votre Control Panel. Réglez le paramètre Pushwoosh_PURCHASE_TRACKING_ENABLED du SDK Pushwoosh pour iOS sur yes.
• Android : activez l’événement PW_InAppPurchase dans votre Control Panel. Configurez l’envoi des informations d’achat à Pushwoosh en utilisant ce guide.

Attributs de l’événement

• productIdentifier (chaîne de caractères) : obtenu de l’App Store.
• quantity (entier) : le nombre d’articles achetés.
• transactionDate (chaîne de caractères) : date de l’achat.
• status (chaîne de caractères) : statut de l’achat.

Cas d’utilisation

• Rassemblez des statistiques sur les achats in-app.
• Lancez des promotions et suivez leur succès. Définissez l’événement Attendre le déclencheur après le message promotionnel.

Notifications push

PW_NotificationSend

Pour mobile et web uniquement

Cet événement se déclenche une fois qu’un message Pushwoosh est envoyé à l’appareil d’un utilisateur.

Attributs de l’événement

• message_id (chaîne de caractères)
• message_code (chaîne de caractères)
• campaign_id (chaîne de caractères)

Cas d’utilisation

• Suivez si un message est envoyé, quel que soit le canal utilisé.
• Créez des Segments d’utilisateurs en fonction du nombre de messages envoyés.
• Affichez tous les messages envoyés à un utilisateur dans l’historique des événements et analysez le comportement ultérieur de l’utilisateur.

PW_NotificationOpen

Pour mobile et web uniquement

Cet événement se déclenche chaque fois qu’un utilisateur ouvre une notification push envoyée avec Pushwoosh.

Cas d’utilisation

• Configurez le moment optimal pour envoyer une notification push.
• Créez des Segments en fonction des performances des notifications sur une période donnée.

E-mail

PW_EmailSent

Pour les e-mails uniquement

Cet événement se déclenche une fois qu’un e-mail est envoyé au fournisseur de messagerie. Vérifiez status_code pour le résultat.

Attributs de l’événement

• message_id (chaîne de caractères) : l’ID du message.
• message_code (chaîne de caractères) : l’identifiant unique du message e-mail spécifique.
• status_code (entier) : le code de statut de livraison retourné par le fournisseur de messagerie pour cette tentative d’envoi.
• campaign_id (chaîne de caractères) : l’ID de la campagne. Inclus uniquement si l’e-mail a été envoyé dans le cadre d’une campagne.
• campaign_code (chaîne de caractères) : le code unique de la campagne. Inclus lorsque l’envoi fait partie d’une campagne et que la recherche de la campagne réussit. campaign_code peut être manquant même lorsque campaign_id est présent.

Cas d’utilisation

• Suivez les résultats de l’envoi en utilisant status_code, indépendamment du fait que l’e-mail ait été ouvert ou cliqué par la suite.
• Créez des Segments d’utilisateurs en fonction du nombre d’e-mails envoyés.
• Affichez tous les e-mails envoyés à un utilisateur dans l’historique des événements et analysez le comportement ultérieur de l’utilisateur.

PW_EmailOpen

Pour les e-mails uniquement

Cet événement se déclenche lorsqu’un utilisateur ouvre un e-mail envoyé via Pushwoosh.

Attributs de l’événement

• campaign_code (chaîne de caractères) : le code unique de la campagne associée à l’e-mail.
• campaign_id (chaîne de caractères) : l’ID de la campagne.
• message_code (chaîne de caractères) : l’identifiant unique du message e-mail spécifique.
• message_id (chaîne de caractères) : l’ID du message.

Cas d’utilisation

• Suivez les ouvertures d’e-mails pour identifier les utilisateurs qui interagissent activement avec vos e-mails. Utilisez ces données pour créer des campagnes de suivi, comme l’envoi de codes de réduction aux utilisateurs qui ouvrent des e-mails promotionnels.
• Si les utilisateurs ouvrent un e-mail mais ne terminent pas l’action souhaitée (par exemple, effectuer un achat), vous pouvez déclencher des e-mails de suivi avec des rappels ou des offres personnalisées.
• Analysez les taux d’ouverture à travers les campagnes pour affiner vos lignes d’objet et vos stratégies de synchronisation des e-mails pour des campagnes comme les lancements de produits ou les promotions saisonnières.

PW_EmailLinkClicked

Pour les e-mails uniquement

Cet événement se déclenche chaque fois qu’un utilisateur clique sur un lien dans un e-mail.

Attributs de l’événement

• message_id (chaîne de caractères)
• message_code (chaîne de caractères)
• campaign_id (chaîne de caractères)
• redirect_link (chaîne de caractères)
• original_link (chaîne de caractères)

Cas d’utilisation

• Lancez des campagnes ciblées pour les utilisateurs qui cliquent sur un lien spécifique dans un e-mail.
• Envoyez un autre message aux utilisateurs qui ont ignoré le lien dans le premier e-mail pour les encourager à cliquer dessus (ou à prendre une autre mesure).

Messages in-app

PW_InAppShown

Pour les applications mobiles uniquement

Cet événement se déclenche lorsqu’un message in-app est affiché à l’utilisateur.

Attributs de l’événement

• message_code (chaîne de caractères) : l’identifiant unique du message spécifique associé à l’in-app.
• message_id (entier) : l’ID du message.
• campaign_code (chaîne de caractères) : le code unique de la campagne associée à l’in-app.
• campaign_id (entier) : l’ID de la campagne qui a déclenché l’in-app.
• rich_media_code (chaîne de caractères) : l’identifiant unique du contenu rich media affiché dans l’in-app.
• inapp_code (chaîne de caractères) : le code unique identifiant le message in-app spécifique affiché.

Cas d’utilisation

• Suivez la fréquence des vues de messages in-app pour ajuster votre stratégie de messagerie, comme la suppression des messages redondants qui pourraient agacer les utilisateurs.
• Utilisez les données d’impressions in-app pour évaluer la portée des campagnes promotionnelles comme les ventes flash ou les mises à niveau d’abonnement.
• Si un message in-app est affiché mais pas cliqué, vous pouvez déclencher une action de suivi, comme l’envoi d’une notification push avec un contenu similaire pour renforcer le message.

PW_InAppClicked

Pour les applications mobiles uniquement

Cet événement se déclenche lorsqu’un utilisateur interagit avec un message in-app en cliquant dessus.

Attributs de l’événement

• message_code (chaîne de caractères) : l’identifiant unique du message spécifique associé à l’in-app.
• message_id (entier) : l’ID du message.
• campaign_code (chaîne de caractères) : le code unique de la campagne associée à l’in-app.
• campaign_id (entier) : l’ID de la campagne qui a déclenché l’in-app.
• rich_media_code (chaîne de caractères) : l’identifiant unique du contenu rich media affiché dans l’in-app (le cas échéant).
• inapp_code (chaîne de caractères) : le code unique identifiant le message in-app spécifique cliqué.
• element_id (chaîne de caractères) : l’identifiant de l’élément spécifique dans le message in-app qui a été cliqué (par exemple, un bouton ou un lien).
• link (chaîne de caractères) : l’URL ou le lien profond associé à l’élément cliqué.

Cas d’utilisation

• Analysez le comportement des clics pour identifier les boutons ou les liens avec lesquels les utilisateurs interagissent le plus souvent et optimisez les futures conceptions de messages in-app. Par exemple, testez différents CTA dans les campagnes de mise à niveau d’abonnement.
• Déclenchez des actions automatisées basées sur les clics des utilisateurs, comme rediriger les utilisateurs vers une page de produit spécifique ou envoyer une notification push.

SMS

PW_SMSSent

Pour les SMS uniquement

Cet événement se déclenche une fois qu’un SMS est envoyé au fournisseur de SMS. Vérifiez status_code pour le résultat.

Attributs de l’événement

• message_id (chaîne de caractères) : l’ID du message.
• message_code (chaîne de caractères) : l’identifiant unique du message SMS spécifique.
• status_code (entier) : le code de statut de livraison retourné par le fournisseur de SMS pour cette tentative d’envoi. Utilisez-le pour distinguer le succès de l’échec.
• campaign_id (chaîne de caractères) : l’ID de la campagne. Inclus uniquement si le SMS a été envoyé dans le cadre d’une campagne.
• campaign_code (chaîne de caractères) : le code unique de la campagne. Inclus lorsque l’envoi fait partie d’une campagne et que la recherche de la campagne réussit. campaign_code peut être manquant même lorsque campaign_id est présent.

Cas d’utilisation

• Suivez les résultats de l’envoi en utilisant status_code, quel que soit le canal utilisé ailleurs dans le même parcours.
• Créez des Segments d’utilisateurs en fonction du nombre de messages SMS envoyés.
• Affichez tous les messages SMS envoyés à un utilisateur dans l’historique des événements et analysez le comportement ultérieur de l’utilisateur.

WhatsApp

PW_WhatsAppSent

Pour WhatsApp uniquement

Cet événement se déclenche une fois qu’un message WhatsApp est envoyé au fournisseur WhatsApp. Vérifiez status_code pour le résultat.

Attributs de l’événement

• message_id (chaîne de caractères) : l’ID du message.
• message_code (chaîne de caractères) : l’identifiant unique du message WhatsApp spécifique.
• status_code (entier) : le code de statut de livraison retourné par le fournisseur WhatsApp pour cette tentative d’envoi. Utilisez-le pour distinguer le succès de l’échec.
• campaign_id (chaîne de caractères) : l’ID de la campagne. Inclus uniquement si le message WhatsApp a été envoyé dans le cadre d’une campagne.
• campaign_code (chaîne de caractères) : le code unique de la campagne. Inclus lorsque l’envoi fait partie d’une campagne et que la recherche de la campagne réussit. campaign_code peut être manquant même lorsque campaign_id est présent.

Cas d’utilisation

• Suivez les résultats de l’envoi en utilisant status_code, séparément du statut de livraison ou de lecture.
• Créez des Segments d’utilisateurs en fonction du nombre de messages WhatsApp envoyés.
• Affichez tous les messages WhatsApp envoyés à un utilisateur dans l’historique des événements et analysez le comportement ultérieur de l’utilisateur.

PW_WhatsAppReceived

Pour WhatsApp uniquement

Cet événement se déclenche lorsqu’un message WhatsApp est reçu via le système.

Attributs de l’événement

• message (chaîne de caractères) : le contenu du message reçu. Pour les messages de localisation, contient les coordonnées au format "latitude,longitude" (par exemple, "55.751244,37.618423").
• latitude (nombre) : la latitude de la localisation partagée. Inclus uniquement lorsque l’utilisateur partage sa position actuelle.
• longitude (nombre) : la longitude de la localisation partagée. Inclus uniquement lorsque l’utilisateur partage sa position actuelle.

Cas d’utilisation

• Automatisez les actions de suivi en réponse aux messages WhatsApp entrants (comme le démarrage d’un Customer Journey ou le suivi des événements d’engagement des utilisateurs).
• Segmentez les utilisateurs en fonction de leurs interactions par message WhatsApp pour permettre une messagerie ciblée ou des campagnes personnalisées.
• Utilisez les attributs latitude et longitude pour déclencher des parcours basés sur la localisation lorsqu’un utilisateur partage sa position.