Extensions de segments SQL

Vous pouvez générer une extension de segment à l’aide de requêtes SQL Snowflake sur des données Snowflake. Le SQL vous aide à exploiter de nouveaux cas d’utilisation de segments, car il offre la flexibilité nécessaire pour décrire les relations entre les données d’une manière qui n’est pas réalisable avec les autres fonctionnalités de segmentation.

Comme les extensions de segments standard, vous pouvez interroger les événements des deux dernières années (730 jours) dans votre extension de segment SQL. Contrairement aux extensions de segments standard, les extensions de segments SQL consomment des crédits.

Conditions préalables

Étant donné qu’il est possible d’accéder à des données PII via cette fonctionnalité, vous devez disposer des autorisations PII pour exécuter des requêtes de segments SQL.

Création d’une extension de segment

Étape 1 : Choisir un éditeur

Vous avez le choix entre deux types d’éditeurs SQL lors de la création de votre extension de segment SQL : l’éditeur SQL et l’éditeur SQL incrémentiel.

• Actualisation complète : À chaque actualisation de votre segment, Braze interroge toutes les données disponibles pour mettre à jour votre segment, ce qui consomme plus de crédits que les actualisations incrémentielles. Les extensions à actualisation complète peuvent régénérer automatiquement l’appartenance chaque jour, mais ne peuvent pas être actualisées de manière incrémentielle.
• Actualisation incrémentielle : L’actualisation incrémentielle est un moyen plus économique de configurer votre requête, bien que la configuration nécessite quelques étapes supplémentaires. Si vous pouvez effectuer ces étapes supplémentaires lors de la construction de votre segment, il est recommandé de choisir cette option, car votre requête s’exécutera en utilisant moins de crédits.
• Générateur SQL par intelligence artificielle : Le générateur SQL par intelligence artificielle vous permet de rédiger une invite en langage courant et la transforme en requête SQL pour votre segment. C’est un moyen rapide de démarrer sans avoir à écrire le SQL vous-même.

• full refresh
• incremental refresh
• ai sql generator

Une fois le traitement de l’extension terminé, vous pouvez créer un segment à l’aide de votre extension de segment et cibler ce nouveau segment avec vos campagnes et Canvas.

Étape 2 : Rédiger votre requête SQL

Votre requête SQL doit être écrite en utilisant la syntaxe Snowflake. Consultez la référence des tables pour obtenir la liste complète des tables et colonnes disponibles.

• sql editor
• incremental sql editor

1
SELECT DISTINCT user_id FROM "INSERT TABLE NAME"

1
2
3
SELECT * FROM CATALOGS_ITEMS_SHARED
WHERE CATALOG_ID = 'XYZ'
LIMIT 10

Étape 3 : Prévisualiser la requête

Avant d’enregistrer, vous pouvez exécuter un aperçu de votre requête. Les aperçus de requêtes sont automatiquement limités à 100 lignes et expireront au bout de 60 secondes. L’exigence de la colonne user_id ne s’applique pas lors de l’exécution d’un aperçu.

Pour les extensions de segments SQL incrémentielles, l’aperçu n’inclut pas les critères supplémentaires de votre opérateur, nombre de fois et période.

Étape 4 : Déterminer si vous devez inverser le SQL

Ensuite, déterminez si vous devez inverser le SQL. Bien qu’il ne soit pas possible d’interroger directement les utilisateurs n’ayant aucun événement, vous pouvez utiliser Inverser SQL pour cibler ces utilisateurs.

Par exemple, pour cibler les utilisateurs ayant effectué moins de trois achats, rédigez d’abord une requête pour sélectionner les utilisateurs ayant effectué trois achats ou plus. Ensuite, sélectionnez Inverser SQL pour cibler les utilisateurs ayant effectué moins de trois achats (y compris ceux n’ayant effectué aucun achat).

Actualiser l’appartenance au segment

Pour actualiser l’appartenance au segment d’une extension de segment créée à l’aide de SQL, ouvrez l’extension de segment et sélectionnez Actualiser.

Gestion de vos extensions de segments

Sur la page Extensions de segments, les segments générés à l’aide de SQL sont signalés par à côté de leur nom.

Sélectionnez une extension de segment SQL pour voir où l’extension est utilisée, archiver l’extension ou actualiser manuellement l’appartenance au segment.

Définir les paramètres d’actualisation

Si vous n’avez pas besoin que votre extension soit actualisée à intervalles réguliers, vous pouvez l’enregistrer sans utiliser les paramètres d’actualisation, et Braze générera par défaut votre extension de segments en fonction de l’appartenance des utilisateurs à ce moment-là. Utilisez le comportement par défaut si vous souhaitez générer l’audience une seule fois, puis la cibler avec une campagne ponctuelle.

Votre segment commencera toujours à être traité après l’enregistrement initial. À chaque actualisation de votre segment, Braze réexécute le segment et met à jour l’appartenance au segment pour refléter les utilisateurs présents dans votre segment au moment de l’actualisation. Cela peut aider vos campagnes récurrentes à atteindre les utilisateurs les plus pertinents.

Mise en place d’une actualisation récurrente

Pour établir une planification récurrente en définissant des paramètres d’actualisation, sélectionnez Activer l’actualisation. L’option de définition des paramètres d’actualisation est disponible pour tous les types d’Extensions de segments, y compris les segments SQL, les Extensions de segments CDI et les Extensions de segments basées sur des formulaires simples.

Sélectionner vos paramètres d’actualisation

Dans le panneau Paramètres d’intervalle d’actualisation, vous pouvez sélectionner la fréquence à laquelle cette extension de segments sera actualisée : toutes les heures, tous les jours, toutes les semaines ou tous les mois. Vous devrez également sélectionner l’heure précise (dans le fuseau horaire de votre société) à laquelle l’actualisation doit avoir lieu, par exemple :

• Si vous avez une campagne d’e-mail envoyée tous les lundis à 11 h, heure de la société, et que vous souhaitez vous assurer que votre segment est actualisé juste avant l’envoi, vous devriez choisir une planification d’actualisation hebdomadaire à 10 h les lundis.
• Si vous souhaitez que votre segment soit actualisé tous les jours, sélectionnez la fréquence d’actualisation quotidienne, puis choisissez l’heure de l’actualisation.

Consommation de crédits et coûts supplémentaires

Étant donné que les actualisations réexécutent la requête de votre segment, chaque actualisation pour les segments SQL consommera des crédits de segment SQL, et chaque actualisation pour les Extensions de segments CDI entraînera un coût au sein de votre entrepôt de données third-party.

Critères de désactivation automatique des extensions périmées

Les actualisations planifiées sont automatiquement désactivées lorsqu’une Extension de segments est périmée. Une Extension de segments est périmée si elle répond aux critères suivants :

• Non utilisée dans des campagnes ou des Canvas actifs
• Non utilisée dans un segment faisant partie d’une campagne ou d’un Canvas actif
• Non utilisée dans un segment où le suivi analytique est activé
• Non modifiée depuis plus de sept jours
• Non ajoutée à une campagne, un Canvas (y compris les brouillons) ou un segment depuis plus de sept jours

Si l’actualisation planifiée est désactivée pour une Extension de segments, une notification l’indique pour cette extension.

Lorsque vous êtes prêt à utiliser une Extension de segments périmée, passez en revue les paramètres d’actualisation, sélectionnez la planification d’actualisation qui correspond à votre cas d’utilisation, puis enregistrez les modifications.

Crédits Snowflake

Chaque espace de travail Braze dispose de 5 crédits Snowflake par mois. Si vous avez besoin de crédits supplémentaires, contactez votre gestionnaire de compte. Les crédits sont consommés chaque fois que vous actualisez, ou enregistrez et actualisez, l’appartenance d’un segment SQL. Les crédits ne sont pas utilisés lorsque vous exécutez des aperçus dans un segment SQL ou lorsque vous enregistrez ou actualisez une extension de segment classique.

La consommation de 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 requête coûtera de crédits. 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 diminue.

Pour économiser des crédits, prévisualisez votre requête pour vous assurer qu’elle est correcte avant d’enregistrer l’extension de segment SQL.

Vos crédits sont réinitialisés à 5 le premier de chaque mois à 00h00 UTC. Vous pouvez suivre votre consommation de crédits tout au long du mois dans le panneau d’utilisation des crédits. Depuis la page Extensions de segments, cliquez sur View SQL Credit Usage.

Voici ce qui se passe lorsque vos crédits atteignent zéro :

• Toutes les extensions de segments SQL configurées pour s’actualiser automatiquement cessent de s’actualiser, ce qui impacte l’appartenance à ces segments ainsi que toutes les campagnes ou Canvas qui ciblent ces segments.
• Vous ne pouvez enregistrer les nouvelles extensions de segments SQL qu’en tant que brouillons pour le reste du mois.

Tous les utilisateurs de l’entreprise ayant créé un segment SQL ainsi que les administrateurs de votre entreprise recevront un e-mail de notification lorsque vous aurez utilisé 50 %, 80 % et 100 % de vos crédits. Après la réinitialisation de vos crédits au début du mois suivant, vous pourrez créer de nouveaux segments SQL et les actualisations automatiques reprendront.

Si vous souhaitez acheter des crédits de segments SQL supplémentaires ou des extensions de segments supplémentaires, contactez votre gestionnaire de compte.