Skip to content

Segment Extensions SQL

Vous pouvez générer une extension de segmentation à l’aide de requêtes SQL de données Snowflake. Le SQL peut vous aider à déverrouiller de nouveaux cas d’utilisation de segments parce qu’il offre la flexibilité nécessaire pour décrire les relations entre les données de manières qui ne sont pas réalisables par d’autres fonctionnalités de segmentation.

À l’instar des 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é que cette fonctionnalité permet d’accéder à des données à caractère confidentiel, vous devez disposer des autorisations nécessaires pour exécuter des requêtes SQL sur le segment.

Création d’une extension de segmentation

Étape 1 : Choisissez 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.

  • Actualiser complètement : À chaque fois que votre segment est actualisé, Braze interroge toutes les données disponibles pour mettre à jour votre segment, ce qui utilise plus de crédits que les actualisations incrémentielles. Les extensions à actualisation complète peuvent régénérer automatiquement l’adhésion tous les jours, mais ne peuvent pas être actualisées à l’aide de l’actualisation incrémentielle.
  • Actualisation progressive : L’actualisation incrémentale ne calcule que les données des deux derniers jours, ce qui est plus économique et consomme moins de crédits à chaque fois. Lorsque vous créez un segment SQL à actualisation incrémentielle, vous pouvez le configurer pour qu’il régénère automatiquement l’adhésion tous les jours. Cela vous permet de configurer votre segment pour actualiser automatiquement les membres quotidiennement, ce qui permet de réduire le coût de l’actualisation quotidienne des données pour les extensions de segments SQL.
  • Générateur d’intelligence artificielle SQL : Le générateur SQL de l’intelligence artificielle vous permet de rédiger une invite en langage clair et la transforme en requêtes SQL pour votre segmentation. C’est un moyen rapide de commencer sans avoir à écrire le code SQL vous-même.

Pour créer une extension de segments SQL entièrement actualisée :

  1. Sélectionnez Audience > Extensions de segments.
  2. Sélectionnez Créer une nouvelle extension, puis sélectionnez Actualiser complètement.



  3. Ajoutez un nom pour votre Segment Extension et saisissez votre SQL. Reportez-vous à l’étape 2 pour connaître les exigences et les ressources.

    Éditeur SQL montrant un exemple d'extension de segmentation SQL.

  4. Enregistrer votre Segment Extension.

L’éditeur SQL d’actualisation incrémentale permet à l’utilisateur d’effectuer des requêtes agrégées par date pour un événement situé dans un laps de temps donné. Pour créer une extension de segment SQL à actualisation incrémentielle :

  1. Sélectionnez Audience > Extensions de segments.

2. Sélectionnez Créer une nouvelle extension et sélectionnez Actualiser par incréments.



3. Ajoutez un nom pour votre Segment Extension et saisissez votre SQL. Pour connaître les exigences et les ressources, reportez-vous à la section Écriture de code SQL.

Éditeur SQL montrant un exemple d'extension de segments SQL à actualisation incrémentielle.

4. Si vous le souhaitez, sélectionnez Regénérer l’extension quotidiennement.

Case à cocher pour regénérer l'extension quotidiennement.

Lorsque cette option est sélectionnée, Braze met automatiquement à jour la segmentation chaque jour. Cela signifie que chaque jour à minuit dans le fuseau horaire de votre entreprise (avec un retard potentiel d’une heure), Braze vérifiera s’il y a de nouveaux utilisateurs dans votre segmentation et les ajoutera automatiquement à votre segmentation. Si une extension de segment n’a pas été utilisée depuis 7 jours, Braze interrompt automatiquement la regénération quotidienne. Une extension de segments inutilisée est une extension qui ne fait pas partie d’une campagne ou d’un Canvas (la campagne ou le Canvas n’a pas besoin d’être actif pour que l’extension soit considérée comme “utilisée”).

5. Enregistrer votre Segment Extension.

Le générateur SQL basé sur l’IA s’appuie sur GPT d’OpenAI pour recommander du code SQL pour votre segment SQL.

Générateur SQL basé sur l’IA, avec l'invite « Utilisateurs ayant reçu une notification au cours du mois passé »

Pour utiliser le générateur SQL basé sur l’IA, procédez comme suit :

  1. Sélectionnez Lancer le générateur SQL de l’intelligence artificielle après avoir créé un segment SQL à l’aide d’une actualisation complète ou incrémentielle.
  2. Saisissez votre invite et sélectionnez Générer pour traduire votre invite en SQL.
  3. Passez en revue le code SQL généré pour vous assurer qu’il est correct, puis enregistrez votre segment.

Exemples d’invites

  • Utilisateurs ayant reçu un e-mail au cours du dernier mois
  • Utilisateurs ayant effectué moins de cinq achats au cours de l’année écoulée

Conseils

  • Familiarisez-vous avec les tableaux de données Snowflake disponibles. Si vous demandez des données qui n’existent pas dans ces tableaux, ChatGPT risque de créer un faux tableau.
  • Familiarisez-vous avec les règles d’écriture SQL pour cette fonctionnalité. Le non-respect de ces règles entraînera une erreur. Par exemple, votre code SQL doit sélectionner la colonne user_id. Il peut être utile de commencer votre invite par « Utilisateurs qui ».
  • Vous pouvez envoyer jusqu’à 20 invites par minute avec le générateur SQL basé sur l’IA.

#### How is my data used and sent to OpenAI? {#ai-policy}

In order to generate AI output through Braze AI features that Braze identifies as leveraging OpenAI (“Output”), Braze will send your prompt, such as message content, brand guidelines, past campaign data, or any other input, as applicable (“Input”) to OpenAI. Input sent to OpenAI from Braze does not identify you or your Users unless you choose to include uniquely identifiable information in your Input. Per OpenAI’s API platform commitments, data sent to OpenAI’s API via Braze is not used to train or improve OpenAI models and will be deleted after 30 days by OpenAI from their systems. Between you and Braze, Output is your intellectual property. Braze will not assert any claims of copyright ownership on such Output. Braze makes no warranty of any kind with respect to any AI-generated content generally, including Output.

Lorsque l’extension termine son traitement, vous pouvez créer un segment à l’aide de votre extension de segment et cibler ce nouveau segment avec vos campagnes et Canvases.

Étape 2 : Ecrivez votre SQL

Votre requête SQL doit être écrite en utilisant la syntaxe Snowflake. Consultez la référence du tableau pour obtenir la liste complète des tableaux et des colonnes pouvant être interrogés.

Votre SQL doit de surcroit respecter les règles suivantes :

  • Rédigez une seule instruction SQL. N’ajoutez pas de points-virgules.
  • Votre SQL ne doit sélectionner qu’une seule colonne : la colonne user_id. Cela signifie que votre SQL doit contenir :
1
SELECT DISTINCT user_id FROM "INSERT TABLE NAME"
  • Il n’est pas possible d’interroger les utilisateurs n’ayant participé à aucun événement, ce qui signifie que toute interrogation portant sur des utilisateurs ayant participé à un événement moins de X fois devra suivre cette solution de contournement :
    1. Ecrivez une requête pour sélectionner les utilisateurs qui ont l’événement PLUS de X fois.
    2. Lorsque vous faites référence à votre extension de segment dans votre segment, sélectionnez doesn't include pour inverser le résultat.

Règles supplémentaires

En outre, votre requête SQL standard doit respecter les règles suivantes :

  • Vous ne pouvez pas utiliser les déclarations DECLARE.

Toutes les requêtes d’actualisation incrémentale se composent de deux parties : une requête et les détails du schéma.

  1. Dans l’éditeur, écrivez une requête qui sélectionne les user_id dans la table de votre choix.
  2. Ajoutez des détails sur le schéma en sélectionnant un opérateur, un nombre de fois et une période de temps dans les champs situés au-dessus de l’éditeur. La requête vérifiera si la somme de la colonne agrégée remplit une certaine condition spécifiée par les marqueurs substitutifs {{operator}} et {{number of times}}. Le fonctionnement est similaire à celui du processus de création des extensions de segments classiques.

    • Opérateur : Indiquez si l’événement s’est produit plus de fois, moins de fois ou autant de fois qu’un nombre d’occurrences donné.
      Champ opérateur avec "Plus de" sélectionné.

    • Nombre de fois : Combien de fois souhaitez-vous évaluer l’événement par rapport à l’opérateur.
      Nombre de fois où "5" a été saisi.

    • Période : Nombre de jours, de 1 à 730, pendant lesquels vous souhaitez vérifier les instances de l’événement. Cette période se réfère aux jours passés par rapport au jour actuel. L’exemple suivant présente une requête pour les utilisateurs qui ont effectué l’événement plus de 5 fois au cours des 365 derniers jours.
      Champ de la période de temps avec "365" saisi.

Dans l’exemple suivant, le segment obtenu contiendra les utilisateurs qui ont effectué l’événement favorited plus de 3 fois au cours des 30 derniers jours, après une date spécifiée.

Éditeur SQL montrant un exemple d'extension de segments SQL à actualisation incrémentielle.

Aperçu SQL d'une extension de segment SQL à actualisation incrémentielle.

Règles supplémentaires

En outre, votre requête d’actualisation incrémentielle doit respecter les règles suivantes :

  • Rédigez une seule instruction SQL. N’ajoutez pas de points-virgules.
  • Votre segment SQL à actualisation incrémentielle ne pourrait se référer qu’à un seul événement. Vos listes déroulantes pour la date et le nombre font référence à l’événement que vous avez choisi.
  • Votre code SQL doit comporter les colonnes suivantes : user_id, $start_date et une fonction d’agrégation (telle que COUNT). Tout SQL enregistré sans ces trois champs entraînera une erreur.
  • Vous ne pouvez pas utiliser les déclarations DECLARE.

É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 vos 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’inclura pas les critères supplémentaires de votre opérateur, le nombre de fois et les champs de la période.

Étape 4 : Déterminez si vous devez inverser SQL

Ensuite, déterminez si vous devez inverser SQL. Bien qu’il ne soit pas possible de requêter directement les utilisateurs dont les événements sont nuls, vous pouvez utiliser Invert SQL pour cibler ces utilisateurs.

Par exemple, pour cibler les utilisateurs qui ont effectué moins de trois achats, écrivez d’abord une requête pour sélectionner les utilisateurs qui ont effectué trois achats ou plus. Ensuite, sélectionnez l’option Inverser SQL pour cibler les utilisateurs ayant effectué moins de trois achats (y compris ceux ayant effectué zéro achat).

Extension de segmentation nommée "A cliqué sur 1 à 4 e-mails au cours des 30 derniers jours" avec l'option d'inversion de SQL sélectionnée.

Actualiser l’effectif du segment

Pour actualiser la composition des segments 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 à un segment.

Section de l'éditeur SQL consacrée à l'envoi de messages et montrant où le segment de message est utilisé.

Désigner 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 segmentation en fonction de votre adhésion d’utilisateur à ce moment-là. Utilisez le comportement par défaut si vous ne souhaitez générer l’audience qu’une seule fois et la cibler ensuite avec une campagne ponctuelle.

Votre segmentation commencera toujours à être traitée après l’enregistrement initial. À chaque fois que votre segment est actualisé, Braze ré-exécute le segment et met à jour l’appartenance au segment pour refléter les utilisateurs de 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ésignant des paramètres d’actualisation, sélectionnez Activer l’actualisation. L’option permettant d’actualiser les paramètres 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

Intervalle d'actualisation Paramètres avec une fréquence d'actualisation hebdomadaire, une heure de début de 10 heures et le lundi sélectionné comme jour.

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

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

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é dans des campagnes ou des canvas actifs
  • Non utilisé dans un segment d’une campagne ou d’un canvas actifs.
  • Non utilisé dans un segment où le suivi analytique est activé.
  • N’a pas été modifié depuis plus de sept jours
  • N’a pas été ajouté à une campagne ou à 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.

Une notification indiquant que "Les actualisations planifiées ont été désactivées pour cette extension car elle n'est pas utilisée dans des campagnes, des canevas ou des segments actifs". L'extension de segmentation a été désactivée le 23 février 2025 à 12h00."

Lorsque vous êtes prêt à utiliser une extension de segment 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 toutes les modifications.

Crédits Snowflake

Chaque espace de travail Braze dispose de 5 crédits Snowflake par mois. Si vous avez besoin de plus de crédits, contactez votre gestionnaire de compte. Les crédits sont utilisés chaque fois que vous actualisez, ou enregistrez et actualisez, l’adhésion à 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.

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 une 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 est court.

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

Vos crédits seront rétablis à 5 le premier de chaque mois à 12 heures UTC. Vous pouvez suivre l’utilisation de votre crédit tout au long du mois dans le panneau d’utilisation des crédits. Dans la page Extensions de segments, cliquez sur View SQL Credit Usage.

Panneau "SQL Credit Usage" dans la page "SQL Segment Extensions"

Lorsque vos crédits atteignent zéro, il se produit ce qui suit :

  • Toutes les extensions de segments SQL configurées pour s’actualiser automatiquement cessent de s’actualiser, ce qui a un impact sur l’appartenance à ces segments et sur toutes les campagnes ou les canevas qui ciblent ces segments.
  • Vous ne pouvez enregistrer les nouvelles extensions de segments SQL en tant que brouillons que jusqu’à la fin du mois.

Tous les utilisateurs de l’entreprise qui ont créé un segment SQL et 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 pouvez créer d’autres segments SQL, et les actualisations automatiques reprendront.

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

New Stuff!