Générateur de requêtes

Apprenez à utiliser le générateur de rapports, afin de pouvoir générer des rapports à partir des 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.

Conditions préalables

Vous aurez besoin des autorisations “Voir les informations confidentielles” pour utiliser le générateur de requêtes, car il permet d’accéder directement à certaines données des clients.

Utilisation du générateur de requêtes

Étape 1 : Créer une requête SQL

Pour créer une nouvelle requête, accédez à Analyse/analytique > Générateur de requêtes, puis sélectionnez Créer une requête SQL.

Si vous avez besoin d’inspiration ou d’aide pour rédiger votre requête, choisissez Modèle de requête et sélectionnez un modèle préétabli. Pour commencer avec une requête vierge, sélectionnez Éditeur SQL.

Votre rapport reçoit automatiquement un nom avec la date et l’heure actuelles. Survolez le nom et sélectionnez pour donner un nom pertinent à votre requête SQL.

Étape 2 : Créez votre requête

Lors de la construction de votre requête, vous pouvez choisir de vous faire aider par l’intelligence artificielle ou de la créer vous-même.

• using brazeai
• on my own

1
2
3
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()));

1
2
3
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()));

1
2
3
SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED 
LIMIT 100

Étape 3 : Générer votre rapport

Lorsque vous avez fini de créer votre requête, sélectionnez Exécuter la requête. S’il n’y a pas d’erreur ou de dépassement de délai, un fichier CSV sera généré à partir de la requête.

Pour télécharger le rapport CSV, sélectionnez Exporter.

Signaler les dépassements de délai

Les rapports qui s’exécutent en plus de six minutes sont interrompus. S’il s’agit de la première requête que vous exécutez depuis un certain temps, son traitement peut prendre plus de temps et il y a donc plus de chances qu’elle s’interrompe. Si cela se produit, essayez d’exécuter le rapport à nouveau.

Si, après plusieurs tentatives, votre rapport n’aboutit toujours pas, contactez le service d’assistance.

Données et résultats

Toutes les requêtes portent sur les données des 60 derniers jours. Lorsque vous exportez vos résultats, ils ne contiennent pas plus de 1 000 lignes. Pour les rapports nécessitant de plus grandes quantités de données, vous pouvez utiliser des outils tels que Currents ou l’endpoint API d’exportation.

Crédits Snowflake

Chaque entreprise dispose de 5 crédits Snowflake par mois, partagés entre tous les espaces de travail. Une petite partie d’un crédit Snowflake est utilisée chaque fois que vous exécutez une requête ou que vous prévisualisez une table.

L’utilisation des crédits est corrélée à la durée d’exécution de votre requête SQL. Plus la durée d’exécution est longue, plus la part d’un crédit Snowflake que coûtera une requête sera élevée. La durée d’exécution peut varier en fonction de la complexité et de la taille de vos requêtes au fil du temps. Plus vous exécutez des requêtes complexes et fréquentes, plus votre allocation de ressources est importante et plus votre temps d’exécution est court.

Les crédits ne sont pas utilisés lorsque vous rédigez, modifiez ou enregistrez des rapports dans l’éditeur SQL de Braze. Vos crédits seront rétablis à 5 le premier de chaque mois à 12 heures UTC. Vous pouvez suivre l’utilisation de votre crédit mensuel en haut de la page du générateur de requêtes.

Lorsque vous atteignez le plafond de crédit, vous ne pouvez plus exécuter de requêtes, mais vous pouvez créer, modifier et enregistrer des rapports SQL. Si vous souhaitez acheter plus de crédits pour le gestionnaire de requêtes (Query Builder), veuillez contacter votre gestionnaire de compte.