Questions fréquemment posées
Cette page fournit des réponses à certaines questions fréquemment posées au sujet de Currents.
Puis-je exporter les données d’une Campaign ou d’un Canvas pour une période spécifique ?
Pour récupérer les indicateurs d’une Campaign ou d’un Canvas sur une plage de dates définie, utilisez l’une des approches suivantes :
- Si date-aligned campaign or Canvas exports for dashboard-style reporting outside standard API windows vous intéresse, envoyez un retour produit.
- Appelez les endpoints d’analyse de Campaign ou d’analyse de Canvas avec les paramètres
ending_atetlength(ou utilisez/campaigns/data_serieset/canvas/data_series) pour obtenir des données de séries temporelles. - Diffusez les événements vers votre entrepôt de données avec Currents lorsque vous avez besoin de données d’engagement liées aux messages, interrogeables en continu, dans Amazon S3, Azure Blob Storage ou toute autre destination prise en charge.
Comment modifier une intégration Currents en cours d’exécution ?
Pour modifier un connecteur Currents actif, ouvrez l’intégration et sélectionnez Edit. Sans Edit, l’interface de l’intégration reste en lecture seule et vous ne pouvez pas modifier les paramètres du connecteur à partir des icônes uniquement.
Comment Braze gère-t-il les fichiers Avro dans Azure Blob Storage après le téléversement ?
Braze ne modifie pas les fichiers Avro dans Microsoft Azure Blob Storage une fois le téléversement terminé. Azure peut bloquer la suppression d’un blob tant qu’un téléversement est encore en cours.
Comment obtenir des données historiques ?
Currents est un flux de données en temps réel et en direct, ce qui signifie que les événements ne peuvent pas être rejoués. Cependant, vous pouvez stocker les données Currents dans un entrepôt de données tel qu’Amazon S3 ou Microsoft Azure Blob Storage, afin d’exploiter les événements passés comme bon vous semble. Les données sont conservées pendant 30 jours, mais pour des données plus anciennes, vous pouvez interroger Snowflake.
Pourquoi Currents produit-il les données au format Avro plutôt qu’en JSON ?
Avro, contrairement à JSON qui ne repose pas sur un schéma, prend nativement en charge l’évolution des schémas. Vous bénéficierez également de la possibilité d’envoyer des fichiers Avro avec moins de bande passante et un espace de stockage réduit, car Avro est hautement compressible.
Comment Braze gère-t-il la surcharge liée aux fichiers ?
Nous mettons en place un processus d’extraction, transformation et chargement (ETL), qui vous permet d’extraire de grandes quantités de données d’une base de données pour les placer et les stocker dans une autre.
Où dois-je stocker ces données pour les interroger ?
Braze est partenaire de plusieurs entrepôts de données dans lesquels vous pouvez stocker vos données à des fins de requête. Nous recommandons d’utiliser :
Quelle est la fiabilité des données Currents ?
Currents garantit une distribution « au moins une fois », ce qui signifie que des événements dupliqués peuvent occasionnellement être écrits dans votre compartiment de stockage. Si votre cas d’usage nécessite une distribution exactement une fois, vous pouvez dédupliquer les événements à l’aide du champ d’identifiant unique (id) envoyé avec chaque événement. Pour plus de détails, consultez la section Sémantique de distribution des événements.
À quelle fréquence les données sont-elles synchronisées avec Currents ?
Les données sont diffusées en continu. Braze envoie un lot d’événements chaque fois qu’un lot complet est prêt à être envoyé, ou toutes les 5 minutes, selon la condition remplie en premier. Pour les connecteurs à volume élevé, les données arrivent quasiment en temps réel. Pour les connecteurs à faible volume, prévoyez un délai de 5 à 30 minutes. Pour plus de détails, consultez la section Seuil d’écriture Avro.
Si un appareil n’est pas connecté à Internet, la création de l’événement peut être retardée. Ce cas est le plus fréquent pour les événements liés aux messages in-app, car les messages in-app peuvent être déclenchés hors ligne.
Comment puis-je trouver quels événements sont disponibles pour Currents ?
Pour une liste complète des événements enregistrés par Currents, consultez les glossaires des événements de comportement client et des événements d’engagement lié aux messages. Vous pouvez filtrer ces glossaires par type d’événement (comme les envois, les réceptions ou les ouvertures).
Pourquoi mes comptages d’événements Currents ne correspondent-ils pas aux indicateurs de mon tableau de bord ou de mon rapport d’engagement ?
Currents et le tableau de bord de Braze calculent certains indicateurs différemment, il n’est donc pas attendu que les événements Currents correspondent exactement aux indicateurs du tableau de bord.
Clics uniques : Pour les e-mails, le tableau de bord suit les clics uniques sur une période de sept jours et les mesure par dispatch_id. Currents enregistre chaque événement de clic brut. Pour aligner les comptages de clics uniques basés sur Currents avec les indicateurs du tableau de bord, filtrez les événements où is_unique est true.
Désabonnements : L’indicateur Désabonnement du tableau de bord reflète les clics sur le lien de désabonnement standard de Braze. Les pages de désabonnement personnalisées n’incrémentent pas cet indicateur, sauf si vous mettez à jour l’utilisateur via l’API. L’événement Currents users.messages.email.Unsubscribe est un événement de clic spécialisé qui se déclenche lorsqu’un utilisateur clique sur un lien de désabonnement dans le corps ou le pied de page de l’e-mail, ou via l’en-tête list-unsubscribe. Il ne représente pas chaque changement d’état d’abonnement aux e-mails.
Horodatages et fuseaux horaires : Tous les horodatages Currents sont en UTC. Les indicateurs du tableau de bord suivent le fuseau horaire de votre entreprise. Agréger les données Currents par jour calendaire sans les convertir dans le fuseau horaire de votre entreprise peut entraîner un décalage des comptages dans des plages de dates différentes de celles affichées dans le tableau de bord.
Événements en double : Currents fournit une distribution au-moins-une-fois, ce qui signifie que des événements en double peuvent occasionnellement être enregistrés. Dédupliquez à l’aide du champ unique id de chaque événement avant de comparer les totaux aux indicateurs du tableau de bord.
Pourquoi l’external_user_id (schéma Braze : external_id) dans mon événement d’ouverture ou de clic d’e-mail Currents diffère-t-il du profil utilisateur dans le tableau de bord de Braze ?
- Dans le tableau de bord de Braze : Lorsqu’un utilisateur associé à une adresse e-mail ouvre ou clique sur un e-mail, tous les profils utilisateur partageant cette adresse e-mail sont marqués comme ayant ouvert ou cliqué sur cet e-mail. Pour en savoir plus, consultez Que se passe-t-il lorsqu’un e-mail est envoyé et que plusieurs profils partagent la même adresse e-mail ?.
- Dans Currents : Cette même ouverture ou ce même clic est stocké sur un seul profil. Braze l’attribue au profil initialement ciblé pour l’envoi si ce profil partage toujours l’adresse e-mail. Sinon, Braze l’attribue à un profil sélectionné aléatoirement parmi ceux qui partagent l’adresse e-mail.
Pour cette raison, la valeur external_user_id (nommée external_id dans la table de mappage du schéma Braze) d’un événement d’ouverture ou de clic d’e-mail dans Currents peut ne pas correspondre au profil utilisateur attendu lorsque vous comparez Currents au tableau de bord de Braze.
Tous les événements d’envoi sont-ils enregistrés dans Currents ?
Tous les événements sont enregistrés dans Currents. Il n’existe aucun scénario dans lequel un événement serait intentionnellement supprimé du flux Currents.
Les données peuvent-elles être corrompues dans Currents ?
Dans des circonstances normales, les données de Currents ne sont pas corrompues. Bien qu’il existe toujours une possibilité de problème rare, il n’y a pas de conditions connues dans lesquelles les données seraient systématiquement corrompues.
Pourquoi des données d’événements personnalisés antérieures à la configuration de mon intégration Currents apparaissent-elles ?
Braze ne remplit pas rétroactivement les événements dans Currents. Cependant, des événements personnalisés peuvent être enregistrés avec un horodatage passé (par exemple, si un appareil était hors ligne lorsque l’événement s’est produit et s’est synchronisé ultérieurement). Dans ces cas, l’horodatage de l’événement reflète le moment où l’événement s’est réellement produit, ce qui peut être antérieur à la configuration de l’intégration Currents.
Quels identifiants utilisateur sont inclus dans les événements Currents ?
Les événements d’engagement lié aux messages (envois, ouvertures, clics, etc.) incluent l’identifiant utilisateur Braze (user_id) et, lorsqu’il est présent sur le profil, l’identifiant externe (external_user_id dans les payloads d’événements, désigné comme external_id dans la table de mappage du schéma Braze). Certains événements d’engagement lié aux e-mails incluent également email_address. Les attributs personnalisés ne sont pas inclus.
Si vous acheminez les données Currents vers un entrepôt de données ou un CRM et que vous devez effectuer une jointure avec les données de profil, réalisez cette jointure dans votre système en aval en utilisant user_id ou external_user_id.
Puis-je inclure des attributs personnalisés dans les événements d’envoi Currents ?
Non. Currents n’inclut pas d’attributs personnalisés dans les événements d’envoi. Currents enregistre les événements personnalisés et les événements d’engagement liés aux messages. Pour obtenir la liste complète des champs disponibles, consultez les glossaires d’événements.
Currents inclut-il les tags de Campaign ou de Canvas, ou les paires clé-valeur ?
Non. Currents n’inclut pas les tags de Campaign ou de Canvas, ni les paires clé-valeur au niveau des messages. Pour récupérer les données de tags, utilisez l’API REST d’exportation. Comme autre solution de contournement, vous pouvez utiliser un canal webhook dans une Campaign pour envoyer les données de tags ou de paires clé-valeur vers votre propre endpoint, en utilisant Liquid pour modéliser les valeurs.
Comment Braze informe-t-il les clients des modifications apportées à Currents ?
Dans les rares cas où des modifications non rétrocompatibles surviennent, Braze envoie un e-mail anticipé au contact de toute intégration active ainsi qu’à tous les administrateurs disposant d’intégrations Currents actives et ayant utilisé le tableau de bord au cours des 30 derniers jours. Pour les modifications non impactantes, comme de nouveaux événements ou de nouveaux champs ajoutés à un événement existant, Braze n’envoie pas de notification. Vous pouvez consulter le journal des modifications de Currents pour connaître les dernières modifications.
De combien d’espace de stockage ai-je besoin pour les données Currents ?
Les besoins en espace de stockage dépendent de votre volume d’événements et des types d’événements que vous exportez. Braze fournit des exemples d’événements au format Avro que vous pouvez utiliser pour estimer la taille des fichiers en fonction de votre cas d’usage.
Pourquoi le nom de la Campaign ou de l’étape du Canvas est-il NULL dans mes données Currents ?
Lorsque vous créez une nouvelle Campaign ou un nouveau Canvas, le nom peut mettre un certain temps à se propager dans l’ensemble des systèmes Braze. Les événements envoyés via Currents pendant cette période peuvent contenir NULL dans les champs de nom (tels que campaign_name ou canvas_step_name). Ce comportement est également attendu si le nom a été modifié peu avant l’enregistrement des événements. Pour éviter cela, laissez un certain délai après la création ou le renommage d’une Campaign ou d’une étape du Canvas avant de procéder à l’envoi.
Pourquoi les événements de fin de session sont-ils retardés ou absents dans Currents ?
Les événements de fin de session suivent le calendrier d’envoi normal du SDK. Le SDK Braze met en cache les données de session localement et les transmet périodiquement en fonction de la qualité du réseau — par exemple, environ toutes les 10 secondes sur une connexion stable. Tant que le SDK n’a pas envoyé l’événement, celui-ci n’apparaît pas dans Currents.
Si un utilisateur force la fermeture de l’application ou passe hors ligne avant le prochain envoi, l’événement de fin de session peut arriver en retard, voire ne jamais arriver. Sur iOS, les événements de fin de session ne sont souvent pas transmis tant que l’application n’est pas rouverte, car le SDK ne peut pas envoyer de données lorsque l’application est en arrière-plan.
Lorsque vous avez besoin de limites de session plus réactives dans Currents, appelez requestImmediateDataFlush() aux moments clés du cycle de vie, par exemple lorsque l’application passe en arrière-plan ou revient au premier plan. Pour en savoir plus, consultez Envoi et téléchargement de données et La fin de session et le début de session ont des horodatages similaires (iOS).
Que se passe-t-il si mon compartiment de stockage est indisponible lorsque Currents tente d’écrire des données ?
Si votre compartiment de stockage est indisponible au moment du transfert de données, ces données sont perdues. Braze n’est pas en mesure de rattraper les événements qui n’ont pas été distribués avec succès. Pour éviter toute perte de données, assurez-vous que votre compartiment de stockage est disponible et correctement configuré en permanence.
Pourquoi des messages de limite d’autorisations s’affichent-ils lors de la création ou de la modification d’une intégration Currents ?
Currents utilise des pools d’autorisations distincts pour les différentes fonctionnalités des connecteurs :
- Événements d’engagement : requis pour créer ou mettre à niveau un connecteur Currents standard.
- Événements de comportement client : requis pour activer Track Customer Behavior and User Events.
- Profils et attributs utilisateur : requis pour activer Track user profiles and attributes.
Si un pool est épuisé, Braze affiche un avertissement d’autorisation et bloque l’action concernée. Contactez votre gestionnaire de compte Braze pour demander des autorisations supplémentaires ou obtenir de l’aide pour ajuster votre configuration.
À quelle fréquence la version de Currents dans le chemin de stockage change-t-elle ?
Le segment version=<currents_version> dans le chemin de stockage est mis à jour à chaque nouvelle version de Currents, selon une cadence mensuelle (par exemple, de version=6 à version=7). Nous recommandons de lire les fichiers de manière récursive à partir du chemin racine plutôt que de coder en dur un segment de version spécifique, afin que votre pipeline récupère automatiquement les données après un changement de version. Pour plus de détails sur le format du chemin, consultez la section Sémantique de distribution des événements. Pour un historique des modifications par version, consultez le journal des modifications de Currents.
Pourquoi campaign_id ou canvas_id sont-ils absents d’un événement d’engagement lié aux messages ?
Selon le type d’événement et le contexte, un événement d’engagement lié aux messages peut ne pas être associé à une Campaign ou une étape Canvas spécifique. Dans ces cas, les champs campaign_id, canvas_id et les champs de nom associés peuvent être omis du payload de l’événement. Si vous ne voyez pas ces champs pour un événement donné, vérifiez si ce type d’événement et ce contexte incluent normalement des identifiants de Campaign ou de Canvas.
Pourquoi les horodatages de Currents sont-ils limités à la précision à la seconde ?
Le champ time dans les événements Currents est stocké sous forme d’entier 32 bits et est donc limité à la précision à la seconde. Certains événements incluent également un champ d’horodatage distinct de 64 bits avec une précision à la milliseconde ; consultez le glossaire des événements pour connaître les champs disponibles pour chaque type d’événement.
Pourquoi l’événement users.canvas.Conversion de Currents affiche-t-il une heure différente de celle du Canvas ?
L’heure de l’événement users.canvas.Conversion dans Currents reflète la fenêtre de conversion totale — la durée du Canvas plus la date limite de conversion — mesurée à partir de l’entrée dans le Canvas.
Que se passe-t-il lorsque les rapports d’engagement sont envoyés vers S3 ?
Si des identifiants S3 sont configurés pour l’exportation de données mais pas pour Currents, Braze charge les rapports d’engagement dans le compartiment S3 spécifié. L’utilisateur indiqué dans le champ Send Report To reçoit un e-mail contenant un lien vers le rapport dans S3.
Les données d’utilisateurs anonymes peuvent-elles être envoyées à Amplitude via Braze Currents ?
Les données d’utilisateurs anonymes, identifiées par device_id, peuvent être envoyées à Amplitude via Currents. Cette fonctionnalité nécessite une activation par votre équipe de compte Braze.
Comment les utilisateurs du groupe de contrôle sont-ils enregistrés dans Currents pour les Content Cards, les messages in-app et les bannières ?
Lorsqu’un utilisateur est assigné à un groupe de contrôle pour une Campaign de Content Cards ou de messages in-app, Currents émet un événement users.campaigns.EnrollInControl plutôt qu’un événement d’impression.
Les Campaigns de bannières fonctionnent différemment. Les utilisateurs du groupe de contrôle ne sont pas enregistrés dans users.campaigns.EnrollInControl. L’exposition au contrôle est plutôt enregistrée en tant qu’événement users.messages.banner.Impression après que le SDK a enregistré une impression, y compris lorsque votre intégration appelle insertBanner pour une bannière de contrôle et masque le conteneur. Pour identifier les utilisateurs du groupe de contrôle dans Currents ou le partage de données, filtrez sur le message_variation_id ou le message_variation_name (Control Group) de la variante de contrôle.
Pour les schémas de table, consultez Événements d’impression de bannière et USERS_MESSAGES_BANNER_IMPRESSION_SHARED.
Que se passe-t-il lorsque vous ciblez un utilisateur inexistant via l’API ?
Lorsque vous ciblez un utilisateur qui n’existe pas, l’API renvoie une réponse 200, mais l’envoi est annulé avec le résultat « Unknown external ID ». Aucun événement Currents n’est généré pour cet envoi. Notez que le paramètre send_to_existing_only est défini par défaut sur true, de sorte que les envois vers des utilisateurs inconnus sont silencieusement ignorés, sauf si vous le définissez explicitement sur false.