Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

Vous pouvez taguer les utilisateurs dans OneSignal en fonction des pages avec lesquelles ils interagissent sur votre site ou application, puis segmenter ces tags pour une messagerie ciblée. Cette page couvre deux modèles distincts — choisissez celui qui correspond à votre objectif, ou exécutez les deux en parallèle.

Choisissez votre modèle

ModèleQuand le code s’exécuteCe qu’il définitPlateformes
Taguer par thème de pageÀ chaque visite de page ou d’écranUn tag compteur par thème (gaming = 5)Web, Android, iOS
Taguer à l’abonnementUne fois, lorsqu’un utilisateur opte pour le pushUn tag d’attribution (subscription_page = gaming)Web uniquement
Taguer par thème de page construit un profil d’intérêt comportemental qui grandit avec l’engagement — utile pour les recommandations de contenu, les campagnes de réengagement et la segmentation basée sur les catégories, y compris pour les utilisateurs qui n’optent jamais explicitement pour un thème. Taguer à l’abonnement capture un signal unique au moment de l’opt-in — utile pour la messagerie de bienvenue consciente de la source et les campagnes drip où la page depuis laquelle un utilisateur s’est abonné prédit ce qu’il veut lire ensuite.

Prérequis


Taguer par thème de page (à chaque visite)

Taguez les utilisateurs avec les thèmes qui les engagent le plus afin de proposer une messagerie plus personnalisée — augmentant la pertinence, les taux de clics et la satisfaction. Exemples de cas d’utilisation :
  • Sur un site de mode, un utilisateur s’intéresse uniquement aux chaussures pour hommes — pas aux robes pour femmes.
  • Sur une application d’actualités, un utilisateur visite régulièrement des articles de finance et de sport — mais jamais de divertissement ou de politique.

1. Définir votre taxonomie de thèmes

Commencez par identifier les catégories de contenu ou les thèmes que vous souhaitez suivre. Il peut s’agir de :
  • Grandes verticales comme sports, finance ou entertainment
  • Types de produits comme laptops, accessories ou premium
  • Auteurs ou marques
  • Commencez avec 3 à 8 thèmes pour simplifier la gestion.
  • Restez en dessous de 20 thèmes au total pour éviter la surcharge.

2. Ajouter du code pour suivre les visites thématiques

Les exemples ci-dessous font trois choses :
  • Suivre un ou plusieurs thèmes par page ou écran.
  • Incrémenter le compteur de visites chaque fois que le thème est consulté.
  • Taguer l’utilisateur avec le nombre mis à jour à chaque consultation.
const topics = ["sports", "entertainment"]; // One or many

if (typeof localStorage !== "undefined" && Array.isArray(topics)) {
  topics.forEach(topic => {
    let count = parseInt(localStorage.getItem(topic), 10);
    count = isNaN(count) ? 1 : count + 1;
    localStorage.setItem(topic, count);
    OneSignal.User.addTag(topic, count.toString());
  });
}

3. Segmenter et envoyer des messages personnalisés

Une fois les tags appliqués aux utilisateurs, vous pouvez les cibler en utilisant :
  • Des segments pour créer des groupes basés sur des règles (par exemple, utilisateurs avec gaming >= 3).
  • Des filtres API pour inclure dynamiquement des utilisateurs dans une campagne unique.
Exemples de cas d’utilisation :
  • Envoyer des messages aux utilisateurs sur des thèmes spécifiques uniquement lorsqu’ils ont visité des pages associées 5 fois ou plus.
  • Promouvoir des articles auprès des utilisateurs ayant lu plus de 3 articles d’un auteur spécifique.
  • Offrir des réductions aux acheteurs qui reviennent régulièrement sur une catégorie de produits spécifique.

Meilleures pratiques

À faire :
  • Testez votre logique de marquage avec console.log() (web) ou le logger de votre plateforme avant de lancer des campagnes.
  • Utilisez des conventions de nommage de thèmes cohérentes sur toutes les pages.
  • Conservez la liste des thèmes dans un emplacement central (fichier de configuration ou configuration distante) afin de pouvoir l’ajuster sans toucher à chaque page.
À éviter :
  • Utiliser des clés de tag longues ou trop spécifiques (titres complets d’articles, URL longues).
  • Dépasser les limites de tags de OneSignal.
  • Marquer avec des informations personnellement identifiables (PII).

Taguer à l’abonnement (unique, web uniquement)

Taguez les abonnés push web avec des données contextuelles — telles que le thème de la page ou le chemin URL depuis lequel ils se sont abonnés — pour diffuser des campagnes de suivi ciblées. Ce modèle détecte l’opt-in, applique les tags et alimente les segments pour la messagerie de type drip.

1. Taguer les utilisateurs à l’opt-in

Lorsqu’un utilisateur s’abonne aux notifications push, utilisez le listener PushSubscription change pour détecter l’opt-in et appliquer des tags avec des données contextuelles sur la page qu’il consultait.
function pushSubscriptionChangeListener(event) {
  if (event.current.optedIn && !event.previous.optedIn) {
    // User just opted in — tag with subscription context
    var pathSegment = window.location.pathname.split('/')[1] || 'home';
    var pageTopic = document.querySelector('meta[name="article-topic"]')?.content || 'general';

    OneSignal.User.addTags({
      subscription_page: pathSegment,
      subscription_page_topic: pageTopic,
    });
  }
}

OneSignalDeferred.push(function(OneSignal) {
  OneSignal.User.PushSubscription.addEventListener("change", pushSubscriptionChangeListener);
});
Comment ça fonctionne :
  • L’événement change se déclenche lorsque l’état d’abonnement push de l’utilisateur change (opt-in, opt-out, actualisation du token).
  • event.current.optedIn est true lorsque l’utilisateur a un abonnement actif. Vérifier !event.previous.optedIn garantit que les tags ne sont appliqués qu’au premier opt-in, pas à chaque changement d’état.
  • window.location.pathname.split('/')[1] capture le premier segment de chemin comme contexte d’abonnement. Par exemple, si l’URL est https://example.com/gaming/article-123, le tag subscription_page est défini sur gaming.
  • pageTopic est extrait d’une balise <meta>, avec 'general' comme valeur par défaut. Ajustez-le pour correspondre à la structure des métadonnées de votre site.

2. Segmenter les utilisateurs par tag

Une fois les tags appliqués, utilisez les Segments ou les Filtres API pour cibler les utilisateurs en fonction de ces tags. Par exemple :
  • Envoyer une campagne aux utilisateurs où subscription_page est gaming.
  • Créer des segments dynamiques basés sur les valeurs de tags et le timing (par exemple, heures depuis la première session).

3. Automatiser la messagerie de suivi

Construisez des campagnes de type drip qui déclenchent des messages en fonction du moment où l’utilisateur s’est abonné et du contenu sous lequel il s’est abonné. Exemple : Campagne drip pour les abonnés gaming
Nom du segmentFiltresDescription
Gaming 1subscription_page = gaming AND First Session > 2h AND < 24hContacter 2–24 heures après l’abonnement.
Gaming 2subscription_page = gaming AND First Session > 24h AND < 48hSuivi 1 jour plus tard.
Gaming 3subscription_page = gaming AND First Session > 72h AND < 96hDernier contact après 3 jours.
Utilisez des limites de temps supérieures (<) pour éviter que les utilisateurs ne restent dans les segments une fois la fenêtre de messagerie passée.

4. Combiner les segments avec des modèles de messages

Une fois les segments créés :
  • Construisez des modèles pour chaque étape de la campagne (introduction, rappel, promo).
  • Utilisez Journeys pour envoyer ces messages lorsque les utilisateurs entrent dans le segment approprié.
Exemples d’idées de messages :
  • Inviter à rejoindre une communauté gaming ou un groupe social.
  • Recommander des articles populaires liés à leur thème.
  • Envoyer une offre exclusive ou un code de réduction.

Meilleures pratiques

  • Utilisez des noms et des valeurs de tags significatifs qui reflètent l’intention réelle de l’utilisateur.
  • Extrayez les valeurs de tags dynamiquement depuis les métadonnées de page lorsque c’est possible.
  • Ne taguez qu’au premier opt-in — l’exemple de listener ci-dessus vérifie !event.previous.optedIn pour éviter de re-taguer à chaque changement d’état.
N’incluez pas d’informations personnellement identifiables (PII) telles que des noms ou des adresses e-mail dans les valeurs de tags. Évitez de coder en dur des valeurs de tags sur l’ensemble de votre site — extrayez-les dynamiquement depuis le contexte de la page.

FAQ

Quel modèle dois-je utiliser ?

Utilisez Taguer par thème de page pour construire un profil d’intérêt comportemental au fil du temps. Le compteur grandit à chaque visite, donc les segments peuvent être affinés par profondeur d’engagement (gaming >= 5). Utilisez Taguer à l’abonnement pour capturer une attribution ponctuelle unique à l’opt-in, utile pour la messagerie de bienvenue consciente de la source où vous voulez réagir à l’endroit où l’utilisateur s’est abonné avant qu’il n’ait un long historique de visites. Les deux modèles peuvent être exécutés en parallèle sur le même site — ils définissent des tags différents et répondent à des questions différentes.

Les tags persistent-ils si l’utilisateur efface les données du navigateur ?

Non. Effacer les données du navigateur sur le web crée un nouvel Abonnement, et les compteurs par thème stockés dans localStorage sont réinitialisés en même temps. Si l’utilisateur se réabonne (manuellement ou via le réabonnement automatique), le listener change se déclenche à nouveau et réapplique le tag d’abonnement en fonction de la page actuelle, mais les compteurs de visite recommencent à zéro.

Puis-je mettre à jour les tags après l’abonnement initial ?

Oui. Vous pouvez appeler OneSignal.User.addTag() ou OneSignal.User.addTags() à tout moment pour ajouter ou mettre à jour des tags. Le listener d’abonnement est utile pour le contexte initial, mais vous pouvez également taguer les utilisateurs en fonction de leur comportement continu.

Dois-je utiliser ces modèles à la place des filtres d’événements de message ?

Ils servent à des fins différentes. Utilisez les modèles de cette page lorsque vous souhaitez segmenter par quelles pages un utilisateur a visitées ou depuis lesquelles il s’est abonné — c’est-à-dire un signal qui provient de votre site ou application. Utilisez les Filtres d’événements de message lorsque vous souhaitez segmenter par avec quels messages OneSignal un utilisateur a interagi (livré, cliqué, etc.). Ils sont complémentaires, non redondants.

Le modèle de source d’abonnement fonctionne-t-il sur mobile ?

Pas directement. L’API PushSubscription.addEventListener("change", ...) est spécifique au web. Sur iOS et Android, vous pouvez obtenir une attribution similaire en appelant addTag depuis l’intérieur de votre flux d’opt-in — par exemple, immédiatement après que l’utilisateur accepte une invite de permission, taguez-le avec l’écran ou la fonctionnalité sur laquelle il se trouvait.

Pages connexes

Tags

Ajoutez des propriétés personnalisées aux utilisateurs pour la personnalisation et la segmentation.

Segments

Regroupez les utilisateurs par propriétés, tags et comportement pour une messagerie ciblée.

Référence Web SDK

Référence complète du OneSignal Web SDK incluant les listeners d’abonnement et les méthodes de taguage.

Référence SDK Mobile

Référence complète du OneSignal SDK Mobile incluant les méthodes de taguage.

Journeys

Construisez des flux de messagerie en plusieurs étapes déclenchés par l’entrée dans un segment ou des événements personnalisés.