Générateur de requêtes

Le générateur de rapports génère des rapports utilisant les données de Braze dans Snowflake. Le générateur de requêtes est livré avec des modèles de requêtes SQL prédéfinis pour vous aider à démarrer, ou vous pouvez écrire vos propres requêtes SQL personnalisées pour obtenir encore plus d’informations.

Le générateur de requêtes permettant d’accéder directement à certaines données personnalisées, vous ne pouvez accéder au générateur de requêtes que si vous disposez de l’autorisation “Voir les DPI”.

Exécuter des rapports dans le générateur de rapports

Pour exécuter un générateur de rapports :

Allez dans Analyse/analytique > Générateur de requêtes(si utilisé comme adjectif).
Sélectionnez Créer une requête SQL. Si vous avez besoin d’inspiration ou d’aide pour rédiger votre requête, sélectionnez Modèle de requête et choisissez un modèle dans la liste. Sinon, sélectionnez SQL Editor pour accéder directement à l’éditeur.
Un nom est automatiquement attribué à votre rapport avec la date et l’heure actuelles. Survolez le nom et sélectionnez pour donner un nom significatif à votre requête SQL.
Rédigez votre requête SQL dans l’éditeur ou demandez l’aide de l’intelligence artificielle à partir de l’onglet AI Query Builder. Si vous écrivez votre propre code SQL, consultez la section Écrire des requêtes SQL personnalisées pour connaître les conditions requises et les ressources.
Sélectionnez Exécuter la requête.
Enregistrez votre requête.
Pour télécharger un fichier CSV de votre rapport, sélectionnez Exporter.

Générateur de requêtes affichant les résultats de la requête type “Engagement et chiffre d’affaires des canaux pour les 30 derniers jours”.](/docs/fr/assets/img_archive/query_builder.png?5097986890f115229594b9f066dec792)

Les résultats de chaque rapport peuvent être générés une fois par jour. Si vous exécutez le même rapport plus d’une fois au cours d’un même jour calendrier, vous verrez les mêmes résultats dans les deux rapports.

Modèles de requête

Accédez aux modèles de requêtes en sélectionnant Créer une requête SQL > Modèle de requête lors de la première création d’un rapport.

Voir Modèles de requête pour une liste des modèles disponibles.

Calendrier des données

Toutes les requêtes portent sur les données des 60 derniers jours.

Fuseau horaire du générateur de requêtes

Le fuseau horaire par défaut pour interroger notre base de données Snowflake est UTC. Par conséquent, il peut y avoir des divergences de données entre votre page d’ engagement du canal e-mail (qui suit le fuseau horaire de votre entreprise) et les résultats de votre générateur de requêtes.

Pour convertir le fuseau horaire dans les résultats de votre requête, ajoutez le code SQL suivant à votre requête et personnalisez-le en fonction du fuseau horaire de votre entreprise :

SELECT
DATE_TRUNC(
'day',
CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME))
) AS send_date_sydney,
COUNT(ID) AS emails_sent
USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE
-- Apply the date range in Sydney time as well
CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME)) >= '2025-03-25 00:00:00'
AND CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME)) < '2025-03-29 00:00:00'
AND APP_GROUP_ID = 'your app group ID'
GROUP BY
send_date_sydney
ORDER BY
send_date_sydney;

Historique des requêtes

La section Historique des requêtes de Query Builder affiche vos requêtes précédemment exécutées pour vous aider à suivre et à réutiliser votre travail. L’historique des requêtes est conservé pendant sept jours, ce qui signifie que les requêtes datant de plus de sept jours sont automatiquement supprimées.

Si vous devez contrôler l’utilisation des requêtes sur de longues périodes ou conserver des enregistrements au-delà de sept jours, nous vous recommandons d’exporter ou d’enregistrer les résultats des requêtes importantes avant qu’ils n’expirent.

Générer des requêtes SQL avec le générateur de requêtes de l’intelligence artificielle

Le générateur de requêtes de l’intelligence artificielle s’appuie sur GPT, alimenté par OpenAI, pour recommander SQL pour votre requête.

!Le générateur de requêtes de l’intelligence artificielle SQL.

Pour générer des requêtes SQL avec le générateur de requêtes de l’intelligence artificielle :

Après avoir créé un rapport dans le générateur de requêtes, sélectionnez l’onglet du générateur de requêtes sur l’intelligence artificielle.
Saisissez votre invite ou sélectionnez un exemple d’invite et sélectionnez Générer pour traduire votre invite en SQL.
Examinez le code SQL généré pour vous assurer qu’il est correct, puis sélectionnez Insérer dans l’éditeur.

Conseils

Familiarisez-vous avec les tableaux de données disponibles dans Snowflake. Si vous demandez des données qui n’existent pas dans ces tableaux, ChatGPT risque de créer un faux tableau.
Familiarisez-vous avec les règles d’écriture SQL pour cette fonctionnalité. Le non-respect de ces règles entraînera une erreur.
Vous pouvez envoyer jusqu’à 20 invites par minute avec le générateur de requêtes de l’intelligence artificielle.

Comment mes données sont-elles utilisées et envoyées à OpenAI ?

Afin de générer votre SQL, Braze enverra vos invites à la plateforme API d’OpenAI. Toutes les requêtes envoyées à OpenAI depuis Braze sont anonymisées, ce qui signifie qu’OpenAI ne sera pas en mesure d’identifier de qui la requête a été envoyée, à moins que vous n’incluiez des informations identifiables de manière unique dans le contenu que vous fournissez. Comme détaillé dans les engagements de la plateforme API d’OpenAI, les données envoyées à l’API d’OpenAI via Braze ne sont pas utilisées pour former ou améliorer leurs modèles et seront supprimées après 30 jours. Veuillez vous assurer que vous adhérez aux politiques de l’OpenAI qui vous concernent, y compris la politique d’utilisation. Braze n’offre aucune garantie de quelque nature que ce soit en ce qui concerne tout contenu généré par l’intelligence artificielle.

Rédaction de requêtes SQL personnalisées

Rédigez votre requête SQL en utilisant la syntaxe Snowflake. Consultez la référence du tableau pour obtenir la liste complète des tableaux et des colonnes pouvant être interrogés.

Pour afficher les détails d’une table dans le générateur de requêtes :

Dans la page Générateur de requête, ouvrez le panneau Référence et sélectionnez Tables de données disponibles pour afficher les tables de données disponibles et leurs noms.
Sélectionnez Voir les détails pour afficher la description du tableau et des informations sur les colonnes du tableau, telles que les types de données.
Pour insérer le nom de la table dans votre SQL, sélectionnez .

Pour utiliser des requêtes pré-écrites fournies par Braze, sélectionnez Modèle de requête lors de la première création d’un rapport dans le générateur de requêtes.

En limitant votre recherche à une période spécifique, vous obtiendrez des résultats plus rapidement. Voici un exemple de requête qui permet d’obtenir le nombre d’achats et le chiffre d’affaires générés au cours de la dernière heure.

SELECT COUNT(*) as Purchases, SUM(price) as Revenue
FROM USERS_BEHAVIORS_PURCHASE_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('hour', -1, date_trunc('day',CURRENT_DATE()));

Cette requête permet de connaître le nombre d’e-mails envoyés au cours du dernier mois :

SELECT COUNT(*) as Sends
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('month', -1, date_trunc('day',CURRENT_DATE()));

Si vous interrogez CANVAS_ID, CANVAS_VARIATION_API_ID, ou CAMPAIGN_ID, les colonnes de noms qui leur sont associées seront automatiquement incluses dans le tableau des résultats. Vous n’avez pas besoin de les inclure dans la requête SELECT elle-même.

Nom de l’ID	Colonne des noms associés
`CANVAS_ID`	Nom de la toile
`CANVAS_VARIATION_API_ID`	Nom de la variante du canvas
`CAMPAIGN_ID`	Nom de la campagne

Cette requête permet de récupérer les trois ID et leurs colonnes de noms associées avec un maximum de 100 lignes :

SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED 
LIMIT 100

Remplir automatiquement le nom de la variante de la campagne

Si vous souhaitez que le nom de la variante de la campagne se remplisse automatiquement, incluez le nom de la colonne MESSAGE_VARIATION_API_ID dans votre requête, comme dans cet exemple :

SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID, MESSAGE_VARIATION_API_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED 
LIMIT 100

Résolution des problèmes

Votre requête peut échouer pour l’une des raisons suivantes :

Erreurs de syntaxe dans votre requête SQL
Délai de traitement (après 6 minutes)
- Les rapports qui s’exécutent en plus de 6 minutes seront interrompus.
- Si un rapport n’aboutit pas, essayez de limiter l’intervalle de temps dans lequel vous interrogez les données ou interrogez un ensemble de données plus spécifique.

Utilisation de variables

Utilisez des variables pour utiliser des types de variables prédéfinis dans SQL afin de référencer des valeurs sans devoir copier manuellement la valeur. Par exemple, au lieu de copier manuellement l’ID d’une campagne dans l’éditeur SQL, vous pouvez utiliser {{campaign.${My campaign}}} pour sélectionner directement une campagne dans une liste déroulante de l’onglet Variables.

Une fois la variable créée, elle apparaît dans l’onglet Variables de votre rapport Query Builder. Les avantages de l’utilisation des variables SQL sont les suivants

Enregistrez-vous en créant une variable de campagne à sélectionner dans une liste lors de la création de votre rapport, au lieu de coller les ID de campagne.
Échangez des valeurs en ajoutant des variables qui vous permettent de réutiliser le rapport pour des cas d’utilisation légèrement différents à l’avenir (par exemple, un événement personnalisé différent).
Réduisez les erreurs de l’utilisateur lorsqu’il modifie votre SQL en réduisant la quantité d’édition nécessaire pour chaque rapport. Les membres de l’équipe qui sont plus à l’aise avec SQL peuvent créer des rapports que les membres de l’équipe moins techniques peuvent ensuite utiliser.

Lignes directrices

Les variables doivent respecter la syntaxe Liquid suivante : {{ type.${name}}}, où type doit être l’un des types acceptés et name peut être ce que vous voulez. Les étiquettes de ces variables correspondent par défaut au nom de la variable.

Par défaut, toutes les variables sont obligatoires (et votre rapport ne s’exécutera pas si les valeurs des variables ne sont pas sélectionnées), à l’exception de la plage de dates, qui prend par défaut les 30 derniers jours lorsque la valeur n’est pas fournie.

Types de variables

Les types de variables suivants sont acceptés :

Nombre
Plage de dates
Envoi de messages
Produits
Événements personnalisés
Propriétés d’événements personnalisés
Espace de travail
Catalogues
Champs du catalogue
Options
Segmentations
Chaîne de caractères
Tags

Nombre

Valeur de remplacement : La valeur fournie, telle que 5.5
Exemple d’utilisation : some_number_column < {{number.${some name}}}

Plage de dates

Si vous utilisez à la fois start_date et end_date, ils doivent avoir le même nom pour que vous puissiez les utiliser comme plage de dates.

Exemples de valeurs

Le type de plage de dates peut être relatif, date de début, date de fin ou plage de dates.

Les quatre types sont affichés si start_date et end_date sont utilisés avec le même nom. Si vous n’en utilisez qu’un seul, seuls les types pertinents seront affichés.

Type de plage de dates Description Valeurs requises

Relative Spécifie les X derniers jours Nécessite start_date

Date de début Spécifie une date de début Nécessite start_date

Date de fin Spécifie une date de fin Nécessite end_date

Plage de dates Spécifie une date de début et une date de fin Requiert à la fois start_date et end_date

Valeur de remplacement : Remplace start_date et end_date par un horodatage Unix en secondes pour une date spécifiée en UTC, tel que 1696517353.
Exemple d’utilisation : Pour toutes les variables relatives, date de début, date de fin et plage de dates :
- time > {{start_date.${some name}}} AND time < {{end_date.${some name}}}
  - Vous pouvez utiliser start_date ou end_date si vous ne souhaitez pas de plage de dates.

Envoi de messages

Toutes les variables d’envoi de messages doivent partager le même identifiant lorsque vous souhaitez lier leur état dans un seul groupe.

Canevas

Pour la sélection d’une toile. Si vous partagez le même nom avec une campagne, un bouton radio apparaîtra dans l’onglet Variables, permettant de sélectionner soit Canvas, soit la campagne.

Valeur de remplacement : Canvas BSON ID
Exemple d’utilisation : canvas_id = ‘{{canvas.${some name}}}’

Toiles

Pour sélectionner plusieurs toiles. Si vous partagez le même nom avec une campagne, un bouton radio apparaîtra dans l’onglet Variables pour sélectionner soit Canvas, soit la campagne.

Valeur de remplacement : Toiles BSON IDs
Exemple d’utilisation : canvas_id IN ({{canvases.${some name}}})

Campagne

Pour la sélection d’une campagne. Si vous partagez le même nom avec un Canvas, un bouton radio apparaîtra dans l’onglet Variables, permettant de sélectionner soit le Canvas, soit la campagne.

Valeur de remplacement : Campagne ID BSON
Exemple d’utilisation : campaign_id = ‘{{campaign.${some name}}}’

Campagnes

Pour les campagnes à sélection multiple. Si vous partagez le même nom avec un Canvas, un bouton radio apparaîtra dans l’onglet Variables pour sélectionner soit le Canvas, soit la campagne.

Valeur de remplacement : Campagnes ID BSON
Exemple d’utilisation : campaign_id IN ({{campaigns.${some name}}})

Variantes de campagne

Pour sélectionner les variantes de campagne qui appartiennent à la campagne sélectionnée. Elle doit être utilisée en conjonction avec une campagne ou une variable de campagne.

Valeur de remplacement : Variantes de campagne ID API, chaînes de caractères délimitées par des virgules telles que api-id1, api-id2.
Exemple d’utilisation : message_variation_api_id IN ({{campaign_variants.${some name}}})

Variantes du canvas

Pour sélectionner les variantes du canvas qui appartiennent à un canevas choisi. Elle doit être utilisée avec une ou plusieurs toiles.

Valeur de remplacement : Variantes de Canvas ID API, chaînes de caractères délimitées par des virgules comme dans api-id1, api-id2.
Exemple d’utilisation : canvas_variation_api_id IN ({{canvas_variants.${some name}}})

Étape du canvas

Pour sélectionner une étape du canvas qui appartient à un canvas choisi. Il doit être utilisé avec une variable Canvas.

Valeur de remplacement : ID API de l’étape du canvas
Exemple d’utilisation : canvas_step_api_id = ‘{{canvas_step.${some name}}}’

Les étapes du canvas

Pour sélectionner les étapes du canvas qui appartiennent aux canevas choisis. Elle doit être utilisée avec une ou plusieurs toiles.

Valeur de remplacement : ID de l’API des étapes du canvas
Exemple d’utilisation : canvas_step_api_id IN ({{canvas_steps.${some name}}})

Modifier cette page sur GitHub

New Stuff!