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 campagne ou d’un Canvas pour une période spécifique ?
Pour récupérer les indicateurs d’une campagne ou d’un Canvas sur une période définie, utilisez l’une des approches suivantes :
- Soumettez une demande produit pour des exports alignés sur des dates lorsque vous avez besoin de rapports de type tableau de bord en dehors des fenêtres API standard.
- Appelez les endpoints d’analyse de campagne 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é aux messages en continu et interrogeables dans Amazon S3, Azure Blob Storage ou une autre destination prise en charge.
Comment modifier une intégration Currents en production ?
Pour modifier un connecteur Currents en production, ouvrez l’intégration et cliquez sur Modifier en bas à gauche de la page. Sans Modifier, 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 seules.
Comment Braze gère-t-il les fichiers Avro dans Azure Blob Storage après le téléchargement ?
Braze ne modifie pas les fichiers Avro dans Microsoft Azure Blob Storage une fois le téléchargement terminé. Azure peut bloquer la suppression d’un blob tant qu’un téléchargement est encore en cours.
Comment obtenir des données historiques ?
Currents est un flux de données en continu et en temps réel, ce qui signifie que les événements ne peuvent pas être rejoués. Toutefois, vous pouvez stocker les données Currents dans un entrepôt de données tel qu’Amazon S3 ou Microsoft Azure Blob Storage, afin de pouvoir agir sur les événements passés comme bon vous semble. Les données sont conservées pendant 30 jours, mais pour obtenir des données plus anciennes, vous pouvez interroger Snowflake.
Pourquoi Currents fournit-il des données au format Avro et non JSON ?
Avro, contrairement à JSON qui ne repose pas sur un schéma, supporte nativement l’évolution des schémas. Vous bénéficierez également de la possibilité d’envoyer des fichiers Avro en utilisant moins de bande passante et en économisant de l’espace de stockage, car Avro est hautement compressible.
Comment Braze gère-t-il la surcharge des fichiers ?
Nous mettons en place un processus ETL (extraire, transformer, charger) 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 pouvoir les interroger ?
Braze est partenaire de plusieurs entrepôts de données dans lesquels vous pouvez stocker vos données pour les interroger. Nous vous recommandons d’utiliser :
Quelle est la fiabilité des données Currents ?
Currents garantit une livraison « au moins une fois » (at-least-once), ce qui signifie que des événements en double peuvent occasionnellement être écrits dans votre compartiment de stockage. Si votre cas d’usage nécessite une livraison 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 livraison 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, ou toutes les 5 minutes, selon ce qui se produit en premier. Pour les connecteurs à fort volume, les données arrivent quasiment en temps réel. Pour les connecteurs à faible volume, comptez 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. C’est le cas le plus fréquent pour les événements de messages in-app, car les messages in-app peuvent être déclenchés hors ligne.
Comment savoir quels événements sont disponibles pour Currents ?
Pour obtenir la 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 (envois, réceptions ou ouvertures, par exemple).
Pourquoi l’external_id de mon événement d’ouverture ou de clic d’e-mail dans 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 qui a été 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 cette adresse e-mail.
Pour cette raison, l’external_id 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 conditions normales, les données Currents ne sont pas corrompues. Bien qu’un problème rare soit toujours possible, il n’existe aucune condition connue dans laquelle les données seraient systématiquement corrompues.
Pourquoi est-ce que je vois des données d’événements personnalisés datant d’avant la mise en place de mon intégration Currents ?
Braze ne remplit pas rétroactivement les événements dans Currents. Cependant, les événements personnalisés peuvent être enregistrés avec un horodatage passé (par exemple, si un appareil était hors ligne au moment de l’événement et s’est synchronisé plus tard). 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.
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é aux messages. Pour obtenir la liste complète des champs disponibles, consultez les glossaires des événements.
Currents inclut-il les étiquettes de campagne ou de Canvas, ou les paires clé-valeur ?
Non. Currents n’inclut pas les étiquettes de campagne ou de Canvas, ni les paires clé-valeur au niveau du message. Pour récupérer les données d’étiquettes, utilisez l’API REST d’exportation. En guise de solution de contournement, vous pouvez également utiliser un canal webhook dans une campagne pour envoyer les données d’étiquettes ou de paires clé-valeur vers votre propre endpoint, en utilisant Liquid pour modéliser les valeurs.
Comment Braze informe-t-il ses clients des modifications apportées à Currents ?
Lorsque des modifications sont apportées à Currents (nouveaux champs ou types d’événements, par exemple), Braze envoie un e-mail à tous les clients disposant d’intégrations Currents actives et ayant utilisé le tableau de bord au cours des 30 derniers jours. Vous pouvez également 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 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 correspondant à votre cas d’usage.
Pourquoi le nom de la campagne ou le nom de l’étape du Canvas est-il NULL dans mes données Currents ?
Lorsque vous créez une nouvelle campagne ou un nouveau Canvas, le nom peut mettre un certain temps à se propager dans tous les 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). C’est également le comportement attendu si le nom a été modifié peu avant l’enregistrement des événements. Pour éviter cela, attendez un moment après la création ou le renommage d’une campagne 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 normal de téléchargement du SDK. Le SDK Braze met en cache les données de session localement et les envoie 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 téléchargé 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 ou ne pas arriver du tout. Sur iOS, les événements de fin de session ne sont souvent envoyés que lorsque l’application est rouverte, car le SDK ne peut pas transmettre 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() à des 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 Téléchargement et téléversement de données et Les horodatages de fin et de début de session sont 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 renvoyer rétroactivement les événements qui n’ont pas été livré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 le message « You do not have any remaining Customer Behavior Events entitlements » s’affiche-t-il lorsque je modifie mon intégration Currents ?
Ce message peut apparaître lorsque vous mettez à jour une intégration Currents existante et que votre espace de travail a atteint sa limite de droits pour les événements de comportement client. Contactez votre gestionnaire de compte Braze pour demander une extension de droits ou 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 incrémenté à chaque nouvelle version de Currents, selon une cadence mensuelle (par exemple, version=6 vers version=7). Nous vous 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 livraison 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 campagne ou une étape du 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 les identifiants de campagne ou de Canvas.
Pourquoi les horodatages Currents sont-ils limités à la précision de 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 de la seconde. Certains événements incluent également un champ d’horodatage distinct en 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 a-t-il un horodatage différent de celui du Canvas ?
L’horodatage 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 des 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 télécharge les rapports d’engagement vers 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. Cela nécessite l’activation de la fonctionnalité par votre équipe de compte Braze.
Comment les impressions du groupe de contrôle pour les Content Cards et les messages in-app sont-elles enregistrées dans Currents ?
Lorsqu’un utilisateur est affecté à un groupe de contrôle pour une campagne de Content Cards ou de messages in-app, Currents émet un événement users.campaigns.EnrollInControl au lieu d’un événement d’impression.
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.