Event Streams

​

Cas d’usage courants

1. Cartographie du parcours client et personnalisation : diffusez des événements vers un CRM ou une plateforme de données clients (CDP) pour créer des profils clients complets et adapter les campagnes à travers différents points de contact.
2. Analyse et reporting : envoyez des événements de messages (par ex. envois, ouvertures, clics) vers un entrepôt de données pour analyser les modèles d’engagement ou les tendances à long terme à travers les canaux.
3. Conformité et reporting réglementaire : diffusez toutes les données de messages envoyés vers un entrepôt de données à des fins d’audit et de conformité.
4. IA et modèles prédictifs : envoyez des données d’événements de messages vers des IA internes ou des modèles prédictifs pour créer des cohortes clients complètes et comprendre les risques de désabonnement—tels que les désabonnements d’e-mails ou les rejets de messages, qui peuvent indiquer un désabonnement potentiel.
5. Automatisation marketing : envoyez des événements d’engagement (comme les ouvertures ou clics de messages) vers d’autres outils pour déclencher automatiquement les prochaines étapes du parcours utilisateur ou mettre à jour les profils clients et l’activité récente.
6. Fragmentation des données : les données clients précieuses résident souvent dans des outils séparés (tels que les plateformes d’engagement client, CRM, outils d’analyse et entrepôts de données). La diffusion d’événements aide à centraliser ces données, augmentant la visibilité des données first-party précieuses et permettant des résultats de revenus plus rapides.
7. Communication lente entre les systèmes : en envoyant des événements d’engagement en direct vers d’autres systèmes, vous pouvez déclencher des actions immédiatement après qu’un événement se produise, plutôt que d’attendre des heures ou des jours pour des mises à jour par lots. Cela élimine la dépendance aux importations manuelles ou aux synchronisations de données.
8. Inflation des dépenses et dette technique : au lieu de gérer plusieurs outils intermédiaires, vous pouvez connecter directement OneSignal avec votre entrepôt de données. Cela réduit les frais généraux coûteux de gestion de multiples intégrations ou pipelines de données personnalisés, diminue la dette technique et préserve des ressources techniques précieuses pour le produit et le marketing.

​

Comment collaborer avec votre équipe technique

1. Expliquez les avantages : partagez votre stratégie d’utilisation de ces données et comment elles peuvent améliorer les campagnes marketing, personnaliser les expériences utilisateur, consolider les données et réduire la dette technique.
2. Définissez la portée : identifiez où vous souhaitez envoyer les données, quels événements vous souhaitez suivre et le volume de données estimé. Cela aidera à configurer correctement les endpoints.
3. Fournissez la documentation technique : partagez la documentation technique et les instructions de configuration de OneSignal. Votre équipe de développement devra configurer les endpoints destinataires et l’event stream dans OneSignal, en s’assurant que les données sont acheminées correctement.
4. Discutez du volume de données et de la gestion : confirmez que vos systèmes peuvent gérer les flux de données en temps réel. Il est recommandé que le gestionnaire d’API enregistre les événements sans traitement en ligne supplémentaire pour maintenir des temps de réponse faibles.
5. Testez et dépannez : effectuez des tests pour vous assurer que tout fonctionne correctement avant la mise en production.

​

Configuration

​

Exigences

• Une URL ou adresse IP valide pointant vers votre serveur HTTP(S)
• Les URL et adresses IP doivent être accessibles publiquement
• Les domaines doivent inclure un domaine de premier niveau reconnu (par ex. “.com”, “.net”)

​

Sélection d’événements

Trigger Webhook

Event Selection

​

Filtres d’event stream

Filtering events by template

Copying the Template ID of a template

• Template – https://dashboard.onesignal.com/apps/{APP_ID}/templates/{TEMPLATE_ID}
• Push – https://dashboard.onesignal.com/apps/{APP_ID}/notifications/{MESSAGE_ID}
• Email – https://dashboard.onesignal.com/apps/{APP_ID}/email/{MESSAGE_ID}
• SMS – https://dashboard.onesignal.com/apps/{APP_ID}/sms/{MESSAGE_ID}

​

Configurer l’Event Stream

​

En-têtes d’authentification

• En-tête Authorization : Ajoutez un en-tête Authorization, où YOUR_TOKEN est fourni par votre système ou un tiers comme :
  • Basic {{YOUR_TOKEN}}
  • Bearer {{YOUR_TOKEN}}
  • ApiKey {{YOUR_API_KEY}}
• En-têtes personnalisés : Vous pouvez également ajouter des en-têtes personnalisés comme :
  • X-API-Key: {{YOUR_API_KEY}}

​

Tester votre configuration

Configure Webhook

​

En-têtes non autorisés

• content-length
• referer
• metadata-flavor
• x-google-metadata-request
• host
• x-onesignal*

​

Corps

Event Stream Body Options

cURL Preview of Event Stream

​

Personnalisation

​

Exemple de corps

{
  "Event Data": {
    "event.kind": "{{ event.kind }}",
    "event.id": "{{ event.id }}",
    "event.timestamp": "{{ event.timestamp }}",
    "event.datetime": "{{ event.datetime }}",
    "event.app_id": "{{ event.app_id }}",
    "event.subscription_device_type": "{{ event.subscription_device_type }}",
    "event.subscription_id": "{{ event.subscription_id }}",
    "event.onesignal_id": "{{ event.onesignal_id }}",
    "event.external_id": "{{ event.external_id }}"
  },
  "Message Data": {
    "message.id": "{{ message.id }}",
    "message.name": "{{ message.name }}",
    "message.title": "{{ message.title.en }}",
    "message.contents": "{{ message.contents.en }}",
    "template_id": "{{ message.template_id }}",
    "message.template_id": "{{ message.template_id }}",
    "message.url": "{{ message.url }}",
    "message.app_url": "{{ message.app_url }}",
    "message.web_url": "{{ message.web_url }}"
  }
}

Custom Body

​

Utilisation de la syntaxe Liquid dans JSON

• Chaînes → Doivent être enveloppées dans des guillemets.
• Nombres → Ne doivent pas être enveloppés dans des guillemets.
• Objets → Ne doivent pas être enveloppés dans des guillemets.

​

Chaînes

// Wrap string values in quotes
{
  "user_id": "{{ user.onesignal_id }}"
}

{
  "user_id": {{ user.onesignal_id }}
}

​

Nombres et booléens

// Don't wrap numbers or booleans in quotes
{
  "user_score": {{ user.tags.score }}
}

{
  "user_score": "{{ user.tags.score }}"
}

​

Objets

// Don't wrap objects in quotes.
{
  "user_data": {{ user.tags }}
}

{
  "user_data": "{{ user.tags }}"
}

1. Utilisez des vérifications de langue directes : Vérifiez toujours user.language directement dans les conditionnels, pas dans des variables comme userLang, pour une meilleure compatibilité.
2. Commencez simplement : Commencez par des phrases de base, puis ajoutez progressivement de la complexité.
3. Évitez l’imbrication excessive : Gardez les conditionnels plats pour éviter les problèmes d’analyse.
4. Testez d’abord la ponctuation de base : Commencez par des phrases simples et de la ponctuation avant d’utiliser des caractères spéciaux.
5. Utilisez des solutions de secours : Assurez-vous d’avoir une langue par défaut (par ex. anglais) en cas de traductions manquantes.
6. Tenez-vous-en aux clés standard : Utilisez des clés OneSignal standard comme content/title/en pour la fiabilité.

​

Résultats et débogage

Event Stream Logs and Metrics

​

Nouvelles tentatives / Désactivation

​

Conseils pour réussir

• Vous voudrez généralement que les event streams se connectent à vos propres serveurs, pas aux services tiers.
  • Bien qu’il n’y ait rien de mal à se connecter directement à un tiers, ce qui suit peut être plus difficile à gérer : Il sera plus difficile de configurer/déboguer
• Le volume de requêtes ne sera pas géré dans OneSignal.
  • Les événements d’event stream seront envoyés aussi rapidement que les utilisateurs atteignent les étapes de votre journey et cela pourrait submerger d’autres services, atteindre les limites de débit, ou faire monter VOTRE facture de manière inattendue. C’est particulièrement courant lorsque vous essayez d’utiliser un autre canal de messagerie pour quelque chose comme SMS. La flexibilité des event streams signifie que OneSignal ne sait pas ce que vous essayez d’accomplir avec eux, donc vous voudrez peut-être créer un service simple de votre propre qui accepte les requêtes d’event stream et gère ensuite correctement vos limites de connexion tierces, limites de débit et file d’attente.
• De nombreux services ont des API HTTP publiques, ce qui signifie que vous pouvez vous y connecter avec un event stream ; recherchez leurs docs API et des exemples de comment faire une requête HTTP pour trouver le bon endroit pour commencer.

​

Limitations des données d’événements de message

​

Tests

The URL matches the "Your unique URL" from webhook.site

Push message events selected, but any can be used for testing.

Example using webhook.site

• Host : l’adresse IP d’où provient la requête. Voir Aperçu de l’API REST pour une liste des IP possibles.
• Request Content : les données envoyées dans le corps de l’event stream.