Générateur de requêtes

Apprenez à utiliser le générateur de requêtes pour générer des rapports à partir des données de Braze dans Snowflake. Le générateur de requêtes inclut des modèles de requêtes SQL prédéfinis pour vous aider à démarrer, mais vous pouvez aussi é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 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 à 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 basé sur la date et l’heure actuelles. Survolez le nom et sélectionnez pour donner un nom pertinent à votre requête SQL.

Étape 2 : Créer votre requête

Lors de la création de votre requête, vous pouvez choisir de vous faire aider par l’intelligence artificielle ou de la construire 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

Une fois votre requête finalisée, sélectionnez Exécuter la requête. En l’absence d’erreurs ou de dépassements 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.

Dépassements de délai des rapports

Les rapports dont l’exécution dépasse six minutes sont interrompus. S’il s’agit de la première requête que vous exécutez depuis un certain temps, le traitement peut prendre plus de temps et le risque de dépassement de délai est donc plus élevé. Si cela se produit, essayez d’exécuter le rapport à nouveau.

Si votre rapport continue d’expirer après plusieurs tentatives, contactez l’assistance.

Interroger les raisons d’abandon

Vous pouvez interroger la colonne ABORT_TYPE de n’importe quelle table USERS_MESSAGES_*_ABORT_SHARED pour analyser les raisons pour lesquelles des messages n’ont pas été envoyés. Le champ ABORT_TYPE contient une valeur de chaîne de caractères décrivant la raison spécifique de l’abandon, et le champ complémentaire ABORT_LOG fournit des détails supplémentaires (comme la règle de limite de fréquence qui a été déclenchée).

Par exemple, pour compter les abandons d’e-mails par type au cours des 30 derniers jours :

1
2
3
4
5
SELECT ABORT_TYPE, COUNT(*) as abort_count
FROM USERS_MESSAGES_EMAIL_ABORT_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('day', -30, CURRENT_DATE())
GROUP BY ABORT_TYPE
ORDER BY abort_count DESC

Pour la liste complète des valeurs ABORT_TYPE et leurs descriptions, consultez Types d’abandon.

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 société 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 consommée chaque fois que vous exécutez une requête ou prévisualisez une table.

La consommation de crédits est proportionnelle à la durée d’exécution de votre requête SQL. Plus la durée d’exécution est longue, plus la part de crédit Snowflake consommée 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 augmente et plus votre temps d’exécution diminue.

Les crédits ne sont pas consommés lorsque vous rédigez, modifiez ou enregistrez des rapports dans l’éditeur SQL de Braze. Vos crédits sont réinitialisés à 5 le premier de chaque mois à 00 h 00 UTC. Vous pouvez suivre votre consommation mensuelle de crédits en haut de la page du générateur de requêtes.

Lorsque vous atteignez le plafond de crédits, vous ne pouvez plus exécuter de requêtes, mais vous pouvez toujours créer, modifier et enregistrer des rapports SQL. Si vous souhaitez acheter des crédits supplémentaires pour le générateur de requêtes, contactez votre Account Manager.