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 de Campaign ou de Canvas pour une période précise ?

Pour récupérer les indicateurs d’une Campaign ou d’un Canvas sur une plage de dates définie, choisissez 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_at et length (ou utilisez /campaigns/data_series et /canvas/data_series) pour obtenir des données de séries temporelles.
• Transmettez les événements en continu vers votre entrepôt de données avec Currents lorsque vous avez besoin de données d’engagement lié aux messages actualisées 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 sélectionnez Modifier. Sans passer par Modifier, l’interface de l’intégration reste en lecture seule et les icônes seules ne vous permettent pas de changer les paramètres du connecteur.

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 temps réel, ce qui signifie que les événements ne peuvent pas être rejoués. Vous pouvez toutefois stocker les données Currents dans un entrepôt de données comme Amazon S3 ou Microsoft Azure Blob Storage, pour exploiter les événements passés comme bon vous semble. Les données sont conservées pendant 30 jours. Pour des données plus anciennes, vous pouvez interroger Snowflake.

Pourquoi Currents produit-il des données au format Avro plutôt que JSON ?

Contrairement à JSON, qui n’a pas de schéma, Avro prend en charge nativement l’évolution des schémas. Avro se compresse aussi très bien : vous pouvez donc envoyer des fichiers en consommant moins de bande passante et économiser de l’espace de stockage.

Comment Braze gère-t-elle la surcharge des fichiers ?

Nous mettons en place un processus d’extraction, de transformation et de 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 pouvoir les interroger ?

Braze s’est associé à plusieurs entrepôts de données dans lesquels vous pouvez stocker vos données pour les interroger. Nous vous recommandons d’utiliser :

• Amazon S3
• Microsoft Azure Blob Storage
• Google Cloud Storage.

Quelle est la fiabilité des données Currents ?

Currents garantit une distribution « au moins une fois » (at-least-once), ce qui signifie que des événements en double peuvent parfois ê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 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 dès 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 entre 5 et 30 minutes avant leur arrivée. Pour plus de détails, consultez la section Seuil d’écriture Avro.

Comment savoir quels événements sont disponibles pour Currents ?

Pour consulter la liste complète des événements enregistrés par Currents, reportez-vous aux glossaires des événements de comportement client et des événements d’engagement liés aux messages. Vous pouvez filtrer ces glossaires par type d’événement, par exemple les envois, les réceptions ou les ouvertures.

Pourquoi le nombre d’événements Currents ne correspond-il pas aux indicateurs de mon tableau de bord ou de mes rapports d’engagement ?

Currents et le tableau de bord de Braze calculent certains indicateurs différemment. Il ne faut donc pas s’attendre à une correspondance exacte entre les événements Currents et les 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 le nombre de clics uniques issu de Currents sur les indicateurs du tableau de bord, filtrez les événements dont is_unique est true.

Désabonnements : l’indicateur Désabonnements 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écifique 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 tous les changements 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. Si vous agrégez les données Currents par jour calendaire sans les convertir dans le fuseau horaire de votre entreprise, certains décomptes peuvent tomber sur des dates différentes de celles affichées dans le tableau de bord.

Événements en double : Currents garantit une distribution « au moins une fois », ce qui signifie que des événements en double peuvent parfois être écrits. Dédupliquez les événements à 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) de mon événement Currents d’ouverture ou de clic d’e-mail diffère-t-il du profil utilisateur affiché dans le tableau de bord de Braze ?

• Dans le tableau de bord de Braze : Lorsqu’un utilisateur associé à une adresse e-mail ouvre un e-mail ou clique dessus, tous les profils utilisateurs qui partagent cette adresse e-mail sont marqués comme ayant ouvert cet e-mail ou cliqué dessus. 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 enregistré sur un seul profil. Braze l’attribue au profil initialement ciblé par l’envoi, à condition que ce profil partage toujours l’adresse e-mail. Sinon, Braze l’attribue à un profil sélectionné au hasard parmi ceux qui partagent l’adresse e-mail.

Par conséquent, la valeur external_user_id (nommée external_id dans la table de mappage du schéma Braze) d’un événement Currents d’ouverture ou de clic d’e-mail 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 ?

Braze enregistre dans Currents les événements issus des Campaigns et des Canvas actifs. Hormis les envois de test, Braze ne supprime volontairement aucun événement du flux Currents.

Les envois de test ne génèrent pas d’événements d’engagement lié aux messages dans Currents. Cela inclut les messages de test envoyés depuis une Campaign ou une étape du Canvas, ainsi que les messages envoyés avec Envoyer tous les messages de test lorsque vous testez un Canvas. Pour voir les événements d’engagement lié aux messages dans Currents, effectuez l’envoi depuis une Campaign ou un Canvas actif.

Les données peuvent-elles être corrompues dans Currents ?

Dans des circonstances normales, les données Currents ne sont pas corrompues. Un problème rare reste toujours possible, mais aucune condition connue n’entraînerait une corruption systématique des données.

Pourquoi des données d’événements personnalisés sont-elles datées d’avant la configuration de mon intégration Currents ?

Braze ne remplit pas rétroactivement Currents avec des événements passés. Toutefois, un événement personnalisé peut être enregistré avec un horodatage antérieur, par exemple si un appareil était hors ligne au moment de l’événement et s’est synchronisé plus tard. Dans ce cas, l’horodatage indique le moment où l’événement s’est réellement produit, qui peut précéder 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’ID utilisateur Braze (user_id) et, lorsqu’il figure dans le profil, l’identifiant externe (external_user_id dans les payloads d’événements, désigné par external_id dans le tableau de mappage du schéma Braze). Certains événements d’engagement liés 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 les joindre aux données de profil, effectuez cette jointure dans votre système en aval à l’aide de user_id ou de external_user_id.

Qu’est-ce que le champ app_group_id dans les événements Currents ?

Le champ app_group_id contient l’identifiant API de l’espace de travail auquel appartient l’événement. Cette valeur est un UUID. Il s’agit de la même valeur que celle de la colonne app_group_api_id dans les tables SQL du Générateur de requêtes, des extensions de segments SQL et du partage de données Snowflake. Vous pouvez donc l’utiliser pour joindre les données Currents à ces tables.

Dans ses champs d’ID, Currents utilise des identifiants API plutôt que des ID internes de Braze : les autres champs suivent donc la même logique. Par exemple, dans Currents, canvas_id contient l’identifiant API du Canvas.

La valeur app_group_id n’est pas un identifiant de connexion : vous ne pouvez donc pas l’utiliser pour authentifier des requêtes REST API. Pour effectuer des requêtes REST API pour un espace de travail, utilisez une clé REST API.

Puis-je inclure des attributs personnalisés dans les événements d’envoi de Currents ?

Non. Currents n’inclut pas les 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 d’événements.

Currents inclut-il les tags de Campaign ou de Canvas, ou les paires clé-valeur ?

Non. Currents n’inclut ni les tags de Campaign ou de Canvas, ni les paires clé-valeur au niveau du message. Pour récupérer les données de tags, utilisez l’API REST d’exportation. Autre solution de contournement : utilisez un canal webhook dans une Campaign pour envoyer les données de tags ou de paires clé-valeur vers votre propre endpoint. Les valeurs sont alors modélisées avec Liquid.

Comment Braze informe-t-elle les clients des modifications apportées à Currents ?

Dans les rares cas où des modifications majeures surviennent, Braze envoie un e-mail préalable au contact de toute intégration active ainsi qu’à tous les administrateurs disposant d’intégrations Currents actives qui ont utilisé le tableau de bord au cours des 30 derniers jours. Pour les modifications mineures, 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.

Quelle période couvre une notification de rétablissement Currents ?

Lorsqu’une intégration Currents se rétablit après une erreur, comme des identifiants incorrects ou des erreurs 500 renvoyées par l’endpoint de la destination, Braze envoie un e-mail à l’adresse de contact de l’intégration pour indiquer que l’intégration « est en cours de rétablissement ». Une fois le retard rattrapé, Braze indique qu’elle « est entièrement rétablie » et que toutes les données en attente ont été envoyées. Ces notifications ne précisent pas la période couverte par les données en attente.

Pour déterminer la période rétablie :

1. Retrouvez la première notification d’échec envoyée par Braze pour cette intégration. Elle indique approximativement quand l’intégration a commencé à échouer.
2. Notez la date à laquelle vous avez reçu la notification « est entièrement rétablie ».

Les données en attente envoyées par Braze couvrent les événements survenus entre le début de l’échec de l’intégration et son rétablissement.

Si l’intégration a échoué pendant plus de cinq jours, certains événements ont pu être perdus. Les événements perdus ne peuvent pas être récupérés. Pour en savoir plus, consultez la section Exigences.

Quel espace de stockage faut-il prévoir pour les données Currents ?

L’espace de stockage nécessaire dépend du volume d’événements et des types d’événements que vous exportez. Braze met à votre disposition des exemples d’événements au format Avro qui vous permettent d’estimer la taille des fichiers pour 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, la propagation du nom dans l’ensemble des systèmes de Braze peut prendre un certain temps. Les événements envoyés via Currents pendant cette période peuvent contenir NULL dans les champs de nom (comme campaign_name ou canvas_step_name). C’est également normal si le nom a été modifié peu de temps avant l’enregistrement des événements. Pour éviter ce problème, attendez un moment après avoir créé ou renommé une Campaign ou une étape du Canvas avant de lancer 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 habituel du SDK. Le SDK de Braze met en cache les données de session localement et les envoie régulièrement en fonction de la qualité du réseau, par exemple environ toutes les 10 secondes avec une bonne connexion. 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 se retrouve hors ligne avant le prochain envoi, l’événement de fin de session peut arriver en retard, voire jamais. Sur iOS, les événements de fin de session ne sont souvent envoyés qu’à la réouverture de l’application, car le SDK ne peut pas transmettre de données lorsque l’application est en arrière-plan.

Si vous avez besoin de limites de session plus rapidement disponibles dans Currents, appelez requestImmediateDataFlush() à certains moments clés du cycle de vie, par exemple lorsque l’application passe en arrière-plan ou revient au premier plan. Pour plus d’informations, consultez Chargement et téléchargement des données et La fin 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 Braze ne parvient pas à écrire dans votre compartiment de stockage, Braze place en file d’attente les événements qu’il ne peut pas écrire et continue de réessayer, quelle que soit l’erreur renvoyée par votre compartiment. Dès que le compartiment accepte à nouveau les écritures, Braze livre les événements en file d’attente, puis les nouveaux événements.

Tant que Braze ne peut pas écrire dans votre compartiment, vous pouvez recevoir une notification d’erreur d’intégration à l’adresse e-mail de contact de votre intégration. Selon l’erreur renvoyée par votre compartiment, cette notification peut indiquer que vos identifiants sont invalides, même s’ils n’ont pas changé.

Si le problème persiste plus de cinq jours, Braze commence à abandonner des événements, et les événements abandonnés ne peuvent pas être récupérés. Pour en savoir plus, consultez Exigences.

Comment vérifier que votre compartiment est disponible

Votre compartiment est disponible lorsqu’il existe sous le nom enregistré dans votre intégration Currents et qu’il accepte les écritures de Braze. Pour le vérifier, procédez comme suit :

1. Dans Braze, accédez à Intégrations partenaires > Currents et ouvrez votre intégration. Notez le nom du compartiment (ou le nom du conteneur pour Azure Blob Storage) ainsi que le chemin du dossier ou le préfixe.
2. Dans la console de votre fournisseur cloud, vérifiez qu’un compartiment portant exactement ce nom existe :
   • Pour Amazon S3, vérifiez le compte AWS propriétaire du compartiment.
   • Pour Google Cloud Storage, vérifiez le projet indiqué comme project_id dans votre fichier de clé JSON.
   • Pour Azure Blob Storage, vérifiez le compte de stockage indiqué dans l’endpoint de votre compte ou dans votre chaîne de connexion.
3. Si le compartiment n’existe pas, créez-en un nouveau et mettez à jour votre intégration avec son nom.
4. Si vous restreignez l’accès réseau à votre compartiment, par exemple avec des règles de pare-feu ou des endpoints privés, vérifiez que vos règles autorisent Braze à écrire. Pour connaître les adresses IP à partir desquelles Braze envoie les données Currents, consultez Liste d’autorisation des adresses IP. Pour Azure Blob Storage, consultez Braze peut-il fournir des adresses IP à ajouter à la liste d’autorisation pour Azure Blob Storage ?.
5. Une fois que votre compartiment accepte les écritures, recherchez de nouveaux fichiers dans le chemin du dossier ou le préfixe. Braze livre d’abord les événements en file d’attente, puis les nouveaux événements.

Comment vérifier que votre compartiment est correctement configuré

Braze a besoin du nom exact du compartiment, d’identifiants valides et de l’autorisation d’écrire dans votre compartiment. Pour vérifier votre configuration, procédez comme suit :

1. Dans votre intégration Currents, vérifiez que le nom du compartiment correspond exactement à celui de votre compartiment. Saisissez uniquement le nom du compartiment dans le champ prévu, sans barre oblique ni chemin. Saisissez le chemin éventuel dans le champ du chemin du dossier ou du préfixe.
2. Vérifiez que les identifiants de votre intégration disposent des autorisations requises :
   • Amazon S3 : votre politique IAM autorise s3:ListBucket et s3:GetBucketLocation sur le compartiment, ainsi que s3:PutObject et s3:GetObject sur les objets du compartiment. Votre compartiment ne doit pas non plus utiliser le chiffrement SSE-KMS ni Object Lock. Pour en savoir plus, consultez Intégration Amazon S3 et Résolution des problèmes.
   • Google Cloud Storage : le rôle de votre compte de service inclut storage.objects.create, storage.objects.delete, storage.objects.list, storage.objects.get et storage.buckets.get. Si votre compartiment utilise un espace de noms hiérarchique, le rôle doit également inclure storage.folders.create. Pour en savoir plus, consultez Étape 1 : Créer un rôle.
   • Azure Blob Storage : si vous utilisez l’authentification par principal de service avec certificat ou par fédération d’identité de charge de travail, votre inscription d’application dispose du rôle Storage Blob Data Contributor sur votre conteneur. L’application des attributions de rôle peut prendre jusqu’à 30 minutes. Pour la fédération d’identité de charge de travail, vérifiez également que l’émetteur, l’identifiant du sujet et l’audience des identifiants fédérés correspondent aux valeurs affichées par Braze. Pour en savoir plus, consultez Étape 4 : Accorder l’accès à votre compte de stockage pour le principal de service avec certificat, ou Étape 2 : Ajouter des identifiants fédérés et Étape 3 : Accorder l’accès à votre compte de stockage pour la fédération d’identité de charge de travail.
3. Vérifiez que vos identifiants sont à jour. Si vous avez renouvelé une clé, un rôle ou un certificat, mettez à jour votre intégration. Pour en savoir plus, consultez Mise à jour des identifiants Amazon S3 pour Currents, Mise à jour des identifiants Azure pour Currents ou Mise à jour de Currents.

Puis-je déplacer mon compartiment de stockage sans perdre de données Currents ?

Oui. Si vous déplacez un compartiment de stockage connecté à une intégration Currents en production (par exemple, avec la relocalisation de compartiment de Google Cloud Storage) et que le nom du compartiment, les identifiants et le préfixe restent identiques, vous n’avez pas besoin de modifier votre intégration Currents. Pendant le déplacement, Braze met en file d’attente les événements qu’elle ne peut pas écrire et les distribue dès que le compartiment accepte à nouveau les écritures.

Terminez le déplacement dans un délai de cinq jours pour éviter toute perte d’événements.

Pourquoi des messages de limite de droits s’affichent-ils lorsque je crée ou modifie une intégration Currents ?

Currents utilise des réserves de droits distinctes selon les capacités du connecteur :

• Événements d’engagement : nécessaires pour créer ou mettre à niveau un connecteur Currents standard.
• Événements de comportement client : nécessaires pour activer Suivre le comportement des clients et les événements utilisateur.
• Profils et attributs utilisateur : nécessaires pour activer Suivre les profils et attributs utilisateur.

Si l’une de ces réserves est épuisée, Braze affiche un avertissement sur les droits et bloque l’action concernée. Contactez votre gestionnaire de compte Braze pour demander des droits supplémentaires ou obtenir de l’aide pour ajuster votre configuration.

À quelle fréquence la version de Currents change-t-elle dans le chemin de stockage ?

Le segment version=<currents_version> du chemin de stockage est incrémenté à chaque nouvelle version de Currents, selon un rythme mensuel (par exemple, de version=6 à 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. Votre pipeline récupère ainsi automatiquement les données après un changement de version. Pour en savoir plus sur le format du chemin, consultez Sémantique de la livraison d’événements. Pour consulter l’historique des modifications par version, reportez-vous au 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 son contexte, un événement d’engagement lié aux messages n’est pas toujours associé à une campagne ou à une étape du Canvas précise. Dans ce cas, campaign_id, canvas_id et les champs de nom associés peuvent être omis du payload de l’événement. Si ces champs n’apparaissent pas sur un événement donné, vérifiez si ce type d’événement et ce contexte incluent normalement des identifiants de campagne ou de Canvas.

Pourquoi les horodatages de Currents sont-ils limités à la seconde près ?

Le champ time des événements Currents est stocké sous forme d’entier 32 bits, ce qui limite sa précision à la seconde. Certains événements comportent également un champ d’horodatage distinct de 64 bits, précis à 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 une heure différente de celle du Canvas ?

L’heure de l’événement users.canvas.Conversion dans Currents correspond à la fenêtre de conversion totale, mesurée à partir de l’entrée dans le Canvas. Cette fenêtre est égale à la durée du Canvas plus la date limite de conversion.

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 télécharge les rapports d’engagement dans le compartiment S3 spécifié. L’utilisateur indiqué dans le champ Envoyer le rapport à reçoit un e-mail contenant un lien vers le rapport dans S3.

Les données des utilisateurs anonymes peuvent-elles être envoyées à Amplitude via Braze Currents ?

Les données des utilisateurs anonymes, identifiés par device_id, peuvent être envoyées à Amplitude via Currents. Cette fonctionnalité doit être activée par l’équipe de votre 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 sur true par défaut : les envois à des utilisateurs inconnus sont donc ignorés sans notification, sauf si vous le définissez explicitement sur false.