Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Générateur de requêtes

Le Générateur de requêtes génère des rapports à partir des données de Braze dans Snowflake. Il est fourni 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.

Étant donné que le Générateur de requêtes permet un accès direct à certaines données client, vous ne pouvez y accéder que si vous disposez de l’autorisation « View PII ».

Tables de données disponibles

Le Générateur de requêtes utilise les mêmes tables SQL Snowflake que les Extensions de segments SQL et le Partage de données Snowflake. Pour une liste complète des tables disponibles et de leurs colonnes, consultez la référence des tables SQL.

Exécuter des rapports dans le Générateur de requêtes

Pour exécuter un rapport dans le Générateur de requêtes :

Accédez à Analytics > Query Builder.
Sélectionnez Create SQL Query. Si vous avez besoin d’inspiration ou d’aide pour rédiger votre requête, sélectionnez Query Template et choisissez un modèle dans la liste. Sinon, sélectionnez SQL Editor pour accéder directement à l’éditeur.
Votre rapport reçoit automatiquement un nom avec la date et l’heure actuelles. Survolez le nom et sélectionnez pour donner un nom significatif à votre requête SQL.
Écrivez votre requête SQL dans l’éditeur ou obtenez l’aide de l’IA depuis l’onglet AI Query Builder. Si vous écrivez votre propre SQL, consultez Écrire des requêtes SQL personnalisées pour les exigences et les ressources.
Sélectionnez Run Query.
Enregistrez votre requête.
Pour télécharger un CSV de votre rapport, sélectionnez Export.

Le Générateur de requêtes affichant les résultats de la requête modèle « Channel engagement and revenue for the last 30 days ».

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 dans une même journée calendaire, vous verrez les mêmes résultats dans les deux rapports.

Modèles de requêtes

Accédez aux modèles de requêtes en sélectionnant Create SQL Query > Query Template lors de la création initiale d’un rapport.

Consultez Modèles de requêtes pour une liste des modèles disponibles.

Période des données

Les requêtes renvoient les données des 60 derniers jours. Si vous utilisez Currents ou le Partage de données Snowflake, vous pourrez peut-être interroger jusqu’à deux ans de données, ce qui correspond à la durée de conservation de vos données dans Snowflake. Pour plus de détails sur la conservation étendue des données, contactez votre gestionnaire de la satisfaction client.

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 écarts de données entre votre page Email Channel Engagement (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 SQL suivant à votre requête et personnalisez-le pour le 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 Query history du Générateur de requêtes 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 de plus de sept jours sont automatiquement supprimées.

Si vous devez auditer l’utilisation des requêtes sur des périodes plus longues ou conserver des enregistrements au-delà de sept jours, nous vous recommandons d’exporter ou d’enregistrer les résultats de requêtes importants avant leur expiration.

Générer du SQL avec l’AI Query Builder

L’AI Query Builder s’appuie sur GPT, propulsé par OpenAI, pour recommander du SQL pour votre requête.

L'AI Query Builder SQL.

Pour générer du SQL avec l’AI Query Builder :

Après avoir créé un rapport dans le Générateur de requêtes, sélectionnez l’onglet AI Query Builder.
Saisissez votre prompt ou sélectionnez un exemple de prompt, puis sélectionnez Generate pour traduire votre prompt en SQL.
Vérifiez le SQL généré pour vous assurer qu’il est correct, puis sélectionnez Insert into Editor.

Conseils

Familiarisez-vous avec les tables et colonnes disponibles dans la référence des tables SQL. Demander des données qui n’existent pas dans ces tables peut amener ChatGPT à inventer une fausse table.
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 prompts par minute avec l’AI Query Builder.

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

Pour générer une sortie d’intelligence artificielle via les fonctionnalités BrazeAI qui exploitent OpenAI (« Sortie »), Braze enverra certaines informations (« Entrée ») à OpenAI. L’Entrée se compose de vos invites et peut inclure le contenu affiché dans le tableau de bord, ainsi que d’autres données de l’espace de travail pertinentes pour vos requêtes, le cas échéant. Conformément aux engagements de la plateforme API d’OpenAI, les données envoyées à l’API d’OpenAI via Braze ne sont pas utilisées pour entraîner ou améliorer les modèles d’OpenAI. OpenAI peut conserver les données pendant 30 jours à des fins de surveillance des abus, après quoi elles sont supprimées. Entre vous et Braze, la Sortie est votre propriété intellectuelle. Braze ne revendiquera aucun droit d’auteur sur cette Sortie. Braze n’offre aucune garantie de quelque nature que ce soit concernant tout contenu généré par l’intelligence artificielle, y compris la Sortie.

Écrire des requêtes SQL personnalisées

Écrivez votre requête SQL en utilisant la syntaxe Snowflake. Consultez la référence des tables pour une liste complète des tables et colonnes disponibles pour les requêtes.

Pour afficher les détails des tables dans le Générateur de requêtes :

Depuis la page Query Builder, ouvrez le panneau Reference et sélectionnez Available Data Tables pour afficher les tables de données disponibles et leurs noms.
Sélectionnez See Details pour afficher la description de la table et les informations sur les colonnes, 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 Query Template lors de la création initiale d’un rapport dans le Générateur de requêtes.

Restreindre votre requête à une période spécifique vous aidera à générer des résultats plus rapidement. Voici un exemple de requête qui obtient le nombre d’achats et le chiffre d’affaires généré 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 récupère le nombre d’envois d’e-mails 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 associées seront automatiquement incluses dans le tableau de résultats. Vous n’avez pas besoin de les inclure dans la requête SELECT elle-même.

Nom de l’ID	Colonne de nom associée
`CANVAS_ID`	Canvas Name
`CANVAS_VARIATION_API_ID`	Canvas Variant Name
`CAMPAIGN_ID`	Campaign Name

Cette requête récupère 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 campagne

Si vous souhaitez que le nom de la variante de campagne soit automatiquement rempli, incluez le nom de 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 dépassé (après 6 minutes)
- Les rapports dont l’exécution prend plus de 6 minutes expireront.
- Si un rapport expire, essayez de limiter la période sur laquelle vous interrogez les données ou d’interroger un ensemble de données plus spécifique.

Utiliser des variables

Utilisez des variables pour employer des types de variables prédéfinis en SQL afin de référencer des valeurs sans avoir à 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 depuis un menu déroulant dans l’onglet Variables.

Une fois une variable créée, elle apparaîtra dans l’onglet Variables de votre rapport du Générateur de requêtes. Les avantages de l’utilisation de variables SQL incluent :

Gagner du temps en créant une variable Campaign à sélectionner dans une liste lors de la création de votre rapport, au lieu de coller des identifiants Campaign.
Permuter les 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 (comme un événement personnalisé différent).
Réduire les erreurs utilisateur lors de la modification de votre SQL en diminuant la quantité de modifications nécessaires pour chaque rapport. Les collègues plus à l’aise avec SQL peuvent créer des rapports que des collègues moins techniques peuvent ensuite utiliser.

Directives

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 souhaitez. Les libellés 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 tant que les valeurs des variables ne seront 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 de catalogue
Options
Segments
Chaîne de caractères
Étiquettes

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 afin de pouvoir les utiliser comme plage de dates.

Exemples de valeurs

Le type 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 un seul est utilisé, seuls les types pertinents seront affichés.

Type de plage de dates	Description	Valeurs requises
Relatif	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 à la fois une date de début et une date de fin	Nécessite à 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 soit start_date soit 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 même groupe.

Canvas

Pour sélectionner un Canvas. Partager le même nom avec une campagne entraînera un bouton radio dans l’onglet Variables permettant de sélectionner soit Canvas soit Campaign.

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

Canvas (multiples)

Pour sélectionner plusieurs Canvas. Partager le même nom avec une campagne entraînera un bouton radio dans l’onglet Variables permettant de sélectionner soit Canvas soit Campaign.

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

Campaign

Pour sélectionner une campagne. Partager le même nom avec un Canvas entraînera un bouton radio dans l’onglet Variables permettant de sélectionner soit Canvas soit Campaign.

Valeur de remplacement : ID BSON de la campagne
Exemple d’utilisation : campaign_id = '{{campaign.${some name}}}'

Campaigns

Pour sélectionner plusieurs campagnes. Partager le même nom avec un Canvas entraînera un bouton radio dans l’onglet Variables permettant de sélectionner soit Canvas soit Campaign.

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

Variantes de campagne

Pour sélectionner les variantes de campagne appartenant à la campagne sélectionnée. Doit être utilisé conjointement avec une variable Campaign ou Campaigns.

Valeur de remplacement : ID API des variantes de campagne, 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 de Canvas

Pour sélectionner les variantes de Canvas appartenant à un Canvas choisi. Doit être utilisé avec une variable Canvas ou Canvas (multiples).

Valeur de remplacement : ID API des variantes de Canvas, chaînes de caractères délimitées par des virgules telles que 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 appartenant à un Canvas choisi. 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}}}'

Étapes du Canvas

Pour sélectionner les étapes du Canvas appartenant aux Canvas choisis. Doit être utilisé avec une variable Canvas ou Canvas (multiples).

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

New Stuff!