Générateur de requêtes

Découvrez comment 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.

Prérequis

Pour utiliser le Générateur de requêtes, vous aurez besoin des permissions suivantes :

• View PII : Le Générateur de requêtes permet un accès direct à certaines données client.
• View Dashboard Reports : Cette permission est requise pour les utilisateurs non-administrateurs afin de visualiser le Générateur de requêtes dans le tableau de bord.

Utiliser le Générateur de requêtes

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

Pour créer une nouvelle requête, accédez à Analytics > 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 élaborer votre requête, choisissez Modèle de requête et sélectionnez un modèle prédéfini. 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 significatif à votre requête SQL.

Étape 2 : Construire votre requête

Lors de la construction de votre requête, vous pouvez choisir de vous faire aider par l’IA ou de la construire vous-même.

• utiliser brazeai
• par moi-même

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 terminé de construire votre requête, sélectionnez Exécuter la requête. S’il n’y a pas d’erreurs ou de dépassements de délai de rapport, un fichier CSV sera généré à partir de la requête.

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

Important

Chaque rapport ne peut générer des résultats qu’une seule fois par jour. Si vous exécutez le même rapport plusieurs fois au cours d’une même journée calendaire, vous verrez les mêmes résultats dans chaque rapport.

Délais d’expiration des rapports

Les rapports dont l’exécution dépasse six minutes expireront. Si c’est la première requête que vous exécutez depuis un certain temps, le traitement peut prendre plus de temps et le risque d’expiration 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 le support.

Interroger les raisons d’abandon

Vous pouvez interroger la colonne ABORT_TYPE de n’importe quelle table USERS_MESSAGES_*_ABORT_SHARED pour analyser pourquoi 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 associé ABORT_LOG contient des détails supplémentaires (tels que 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 affichent les données des 60 derniers jours. Lorsque vous exportez vos résultats, le fichier ne contient que 1 000 lignes au maximum. Pour les rapports nécessitant de plus grandes quantités de données, vous pouvez utiliser des outils tels que Currents ou l’endpoint d’exportation de l’API.

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 prévisualisez un tableau.

Remarque

Les crédits Snowflake ne sont pas partagés entre les fonctionnalités. Par exemple, les crédits des extensions de segments SQL et du Générateur de requêtes sont indépendants les uns des autres.

L’utilisation des crédits est corrélée au temps d’exécution de votre requête SQL. Plus le temps d’exécution est long, plus la part d’un crédit Snowflake consommée par une requête sera élevée. Le temps d’exécution peut varier en fonction de la complexité et de la taille de vos requêtes au fil du temps. Plus vos requêtes sont complexes et fréquentes, plus l’allocation de ressources est importante et plus le temps d’exécution diminue.

Les crédits ne sont pas utilisés lors de la rédaction, de la modification ou de l’enregistrement de rapports dans l’éditeur SQL de Braze. Vos crédits sont réinitialisés à 5 le premier jour de chaque mois à 00h00 UTC. Vous pouvez suivre votre utilisation 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 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, veuillez contacter votre gestionnaire de compte.