Variables au niveau organisation
Stocker des paires clé-valeur réutilisables propres à chaque organisation pour les modèles, les add-ons et les expériences Pages.
Les variables d'organisation permettent de conserver des valeurs locales réutilisables au niveau organisation au lieu de recopier ces valeurs dans chaque campagne, modèle ou intégration. Elles sont particulièrement utiles lorsque plusieurs organisations partagent la même structure de campagne mais ont besoin de coordonnées, de liens ou de valeurs de routage différents.
Quand utiliser Variables plutôt que Général
Utilisez les champs intégrés de Général pour les paramètres d'identité standard de l'organisation, comme Nom de l'Entreprise, Email de Notification, Adresse, les liens sociaux ou les valeurs de CTA.
Utilisez Variables lorsque vous avez besoin de valeurs supplémentaires propres à une organisation qui ne disposent pas déjà de leur propre champ dédié, par exemple :
- une URL de support
- un code de site externe
- un lien vers une application locale
- un libellé de marque réutilisé dans des modèles
À quoi ressemble une variable
Les variables d'organisation sont stockées comme un objet plat, par exemple :
| Clé | Exemple de valeur | Usage habituel |
|---|---|---|
location_code | paris-centre | Router les données vers le bon site externe |
support_url | https://example-brand.com/help | Réutiliser un lien local d'aide ou d'information |
contact_phone | +33 1 80 00 00 00 | Réutiliser des coordonnées locales |
brand_label | Centre Paris | Insérer un libellé local dans un modèle ou un script |
La clé est réutilisée telle qu'elle est écrite, donc le choix du nom compte.
Dans les contenus compatibles Liquid, une variable comme support_url peut être réutilisée avec {{support_url}}.
Besoin d'aide ? Consultez {{support_url}} ou appelez {{contact_phone}}.Où les variables d'organisation sont utilisées
Les variables d'organisation sont généralement réutilisées dans ces contextes :
| Contexte | Comment la variable est exposée |
|---|---|
| Configuration d'add-on | Les add-ons d'organisation peuvent utiliser des variables personnalisées ou des valeurs de routage propres à l'organisation |
| Modèles ou notifications compatibles Liquid | Les clés personnalisées sont exposées directement dans Liquid, donc une clé comme support_url peut être appelée avec {{support_url}} |
| Scripts Pages | Les expériences Pages peuvent réutiliser l'ensemble des variables de l'organisation actuellement sélectionnée |
OmniLab fournit aussi certains bindings intégrés distincts dans les contextes compatibles Liquid, comme enterprise_name, group_name et group_display_name.
Limites importantes
| Limite | Ce que cela veut dire |
|---|---|
| Objet plat uniquement | L'écran Variables stocke une liste simple de clés et de valeurs, sans sections ni objets imbriqués |
| Pas de bascule d'héritage pour Variables | Les variables sont stockées par organisation et ne sont pas automatiquement héritées de Global dans l'interface Variables |
| Changer une clé casse ses consommateurs | Renommer ou supprimer une clé casse tout modèle, script ou add-on qui attend exactement cette clé |
Conseils de nommage
- Préférez des clés stables et explicites comme
support_url,contact_phoneoulocation_code - Gardez une seule signification par clé pour que les équipes sachent exactement à quoi sert chaque valeur
- Renommez ou supprimez une clé uniquement après avoir mis à jour tous les modèles, scripts ou add-ons qui en dépendent
Gérer les variables
Ouvrir l'onglet Variables
Basculez vers l'organisation cible, puis ouvrez Paramètres généraux ou Paramètres de l'organisation et sélectionnez Variables.
Ajouter ou modifier les paires clé-valeur
Créez la clé et définissez la valeur qui doit être réutilisée dans cette organisation. Préférez des noms stables et explicites pour faciliter la réutilisation.
Enregistrer puis tester le consommateur
Après l'enregistrement, testez l'endroit qui lit la variable, comme un champ d'add-on, un modèle Liquid ou un script Pages.
Nettoyer uniquement quand la clé n'est plus utilisée
Supprimez ou renommez une variable uniquement après avoir confirmé qu'aucune campagne active, aucun modèle, aucun add-on ni aucun script n'en dépend encore.
Point important lors du partage de modèles
Les variables ne se déplacent pas automatiquement entre organisations
Quand un modèle est réutilisé dans une autre organisation, revoyez les clés de variables et les valeurs d'add-on de l'organisation de destination. La réutilisation d'un modèle ne garantit pas que l'organisation cible possède déjà la même table de variables locales.
Pour aller plus loin
Modèles : exporter, importer et réutiliser
Utiliser le flux ZIP lorsqu'un modèle doit changer d'environnement ou d'organisation.
Partager un modèle entre organisations
Voir le flux de partage direct entre organisations.
Organisations et portée dans OmniLab
Revoir pourquoi les modèles et les paramètres sont rattachés à l'organisation sélectionnée.
Paramètres de l'organisation (valeurs par défaut générales)
Revoir les champs de l'onglet Général d'une organisation et décider quand garder des valeurs locales ou hériter de Global.
Scripts (injection de JavaScript personnalisée)
Configurer, tester et publier les scripts de l'organisation globale qui s'exécutent dans Pages et peuvent lire des variables au niveau organisation.