É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 sur les sites web, quel que soit leur secteur d’activité ou leur fonctionnalité. Ces actions clés de l’utilisateur 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 aucune configuration 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 Create Event.
3. Sélectionnez Default Event dans le menu déroulant.
4. Dans la fenêtre contextuelle, choisissez l’événement souhaité et cliquez sur Activate.

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

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 arrivants grâce aux statistiques de l’événement.
• Engagez les utilisateurs dès leur première visite : accueillez-les avec des messages In-App déclenchés par l’événement DeviceRegistered.

PW_DeviceUnregistered

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

Attributs de l’événement

• message_id (chaîne)
• message_code (chaîne)
• campaign_id (chaîne)

Cas d’utilisation

• Fidélisez les utilisateurs lorsqu’ils décident de ne plus 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 lui envoyer un e-mail ou afficher un message 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 (code entier du type d’appareil, consultez registerDevice pour plus de détails)
• application_version

Cas d’utilisation

• Rassemblez des statistiques sur la rétention des utilisateurs basées sur les statistiques de l’événement ApplicationOpen.
• Lancez des campagnes de messagerie In-App pour les utilisateurs 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
• device_type (code entier du type d’appareil, consultez registerDevice pour plus de détails)
• screen_name (nom technique de l’écran obtenu de votre application)

Cas d’utilisation

• Envoyez des messages parfaitement pertinents aux utilisateurs qui ont manifesté 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 en 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 (code entier du type d’appareil, consultez registerDevice pour plus de détails)
• application_version

Cas d’utilisation

• Suivez la durée moyenne de la session 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 encore dans l’application — capturant 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 message 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 :

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

Attributs de l’événement

• screen_name (chaîne) — l’écran où l’utilisateur est devenu inactif. Formaté en ActivityName/FragmentName sur Android et ParentVC/ChildVC sur iOS lorsque l’écran actuel est imbriqué ; sinon, le nom de l’activité ou du contrôleur de vue.
• idle_seconds (entier) — la temporisation d’inactivité configurée qui s’est écoulée.
• session_duration (entier) — secondes depuis la dernière mise au premier plan de l’application.
• device_type (code entier du type d’appareil, consultez registerDevice pour plus de détails)
• application_version (chaîne)

Comportement

• Se déclenche au maximum 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 — toucher, faire défiler et taper — 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 passer à l’action.
• 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 n’y revient pas dans un délai configurable. Contrairement à PW_ApplicationMinimized, qui se déclenche immédiatement lorsque l’utilisateur quitte l’application, PW_ApplicationExit ne se déclenche qu’après l’écoulement du délai configuré — confirmant 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 :

• Pour Android :
  • ajoutez les méta-données com.pushwoosh.exit_intent_timeout_seconds (entier, 10–30) à votre fichier AndroidManifest.xml.
• Pour 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) — le dernier écran actif lorsque l’utilisateur a mis l’application en arrière-plan.
• session_duration (entier) — secondes depuis la dernière mise au premier plan de l’application.
• 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 (code entier du type d’appareil, consultez registerDevice pour plus de détails)
• application_version (chaîne)

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

PW_SiteOpened

Pour les plateformes 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 (code entier du type d’appareil, consultez registerDevice pour plus de détails)
• title – le titre de la page visitée
• url – l’URL de la page visitée

Cas d’utilisation

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

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 ce 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 virtuelle, 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 :

• Pour iOS :
  • activez l’événement PW_InAppPurchase dans votre Control Panel ;
  • définissez le paramètre Pushwoosh_PURCHASE_TRACKING_ENABLED du SDK Pushwoosh pour iOS sur ‘yes’.
• Pour 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 (obtenu de l’App Store)
• quantity – le nombre d’articles achetés
• transactionDate – date de l’achat
• status – 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 (Wait for Trigger) après le message promotionnel.

PW_NotificationOpen

Pour les plateformes mobiles et web

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

Cas d’utilisation

• Configurez l’heure optimale pour envoyer un push.
• Créez des Segments basés sur les performances des notifications sur une période donnée.

PW_NotificationSend

Pour les plateformes mobiles et web

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)
• message_code (chaîne)
• campaign_id (chaîne)

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 son comportement ultérieur.

PW_EmailLinkClicked

Pour la plateforme e-mail 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)
• message_code (chaîne)
• campaign_id (chaîne)
• redirect_link (chaîne)
• original_link (chaîne)

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 à effectuer une autre action).

PW_EmailOpen

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) : Le code unique de la campagne associée à l’e-mail.
• campaign_id (chaîne) : L’ID de la campagne.
• message_code (chaîne) : L’identifiant unique du message e-mail spécifique.
• message_id (chaîne) : 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 des campagnes pour affiner vos lignes d’objet et vos stratégies de synchronisation des e-mails pour des campagnes telles que les lancements de produits ou les promotions saisonnières.

PW_InAppShown

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

Attributs de l’événement

• message_code (chaîne) : L’identifiant unique du message spécifique associé au message In-App.
• message_id (entier) : L’ID du message.
• campaign_code (chaîne) : Le code unique de la campagne associée au message In-App.
• campaign_id (entier) : L’ID de la campagne qui a déclenché le message In-App.
• rich_media_code (chaîne) : L’identifiant unique du contenu rich media affiché dans le message In-App.
• inapp_code (chaîne) : Le code unique identifiant le message In-App spécifique affiché.

Cas d’utilisation

• Suivez la fréquence d’affichage des messages In-App pour ajuster votre stratégie de messagerie, par exemple en supprimant les messages redondants qui pourraient ennuyer 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 qu’aucun clic n’est effectué, 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

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) : L’identifiant unique du message spécifique associé au message In-App.
• message_id (entier) : L’ID du message.
• campaign_code (chaîne) : Le code unique de la campagne associée au message In-App.
• campaign_id (entier) : L’ID de la campagne qui a déclenché le message In-App.
• rich_media_code (chaîne) : L’identifiant unique du contenu rich media affiché dans le message In-App (le cas échéant).
• inapp_code (chaîne) : Le code unique identifiant le message In-App spécifique sur lequel l’utilisateur a cliqué.
• element_id (chaîne) : L’identifiant de l’élément spécifique dans le message In-App sur lequel l’utilisateur a cliqué (par exemple, un bouton ou un lien).
• link (chaîne) : 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 la redirection des utilisateurs vers une page de produit spécifique ou l’envoi d’une notification push.

PW_WhatsAppReceived

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) : Le contenu ou l’identifiant du message WhatsApp reçu.

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 avec les messages WhatsApp pour permettre une messagerie ciblée ou des campagnes personnalisées.