Configurer l’orchestration
Les agents de décision doivent se connecter à une plateforme d’engagement client (CEP) pour orchestrer les communications une fois qu’ils ont ingéré les données client et personnalisé au niveau 1:1. Cet article couvre ce que vous devez préparer et comment configurer l’intégration pour chaque CEP pris en charge.
Qu’est-ce que l’orchestration ?
L’orchestration est la connexion entre Decisioning Studio et votre plateforme d’engagement client (CEP). Une fois que votre agent de décision a déterminé l’action optimale pour chaque client, l’orchestration exécute ces décisions en déclenchant des communications personnalisées via votre CEP.
Voyez les choses ainsi :
- Decisioning Studio décide quoi envoyer et quand l’envoyer
- Votre CEP gère comment l’envoyer
Choisir votre CEP
La première étape consiste à choisir quelle CEP utiliser avec Decisioning Studio. Votre choix affecte la complexité de la configuration et les fonctionnalités disponibles.
CEP prises en charge
| CEP | Type d’intégration | Complexité de configuration |
|---|---|---|
| Braze | Intégration native via API (recommandée) | Faible |
| Salesforce Marketing Cloud | Événements API + Journey Builder | Moyenne |
| Autres CEP | Personnalisée (fichier de recommandation) | Élevée |
Si vous utilisez déjà Braze comme CEP, nous vous recommandons d’utiliser l’intégration native Braze pour une expérience de configuration optimale.
Conditions préalables
Avant de configurer l’orchestration, rassemblez les éléments suivants en fonction de la CEP choisie.
| Élément requis | Description |
|---|---|
| Clé REST API | Une nouvelle clé API avec des autorisations pour les données utilisateur, les messages, les Campaigns, les Canvas, les Segments et les modèles. |
| URL du tableau de bord de Braze | L’URL de votre instance Braze (par exemple, https://dashboard-01.braze.com). |
| ID de l’application | La clé API associée à l’application que vous souhaitez suivre (disponible dans Settings > App Settings). |
| Nom d’affichage et adresse de l’expéditeur | Les informations d’expéditeur à utiliser pour vos Campaigns (disponibles dans Settings > Email Preferences). |
| Modèles de base | Les modèles de messages que votre agent utilisera pour l’orchestration. Vous créerez des Campaigns déclenchées par API pour chaque modèle. |
| ID utilisateur test | Un ID utilisateur pour tester l’intégration avant le lancement. |
| Élément requis | Description |
|---|---|
| Identifiants du package d’application | Client ID, Client Secret, Authentication Base URI, REST Base URI et SOAP Base URI provenant d’un package installé avec une intégration API serveur à serveur. |
| Autorisations API | Portées pour les canaux, les ressources, les automatisations, les parcours, les contacts, les extensions de données et les événements de suivi. |
| Extensions de données | Vous aurez besoin d’extensions de données pour les données d’abonnés, les données d’engagement et les recommandations. |
| Modèles d’e-mail | Les modèles que vous souhaitez que Decisioning Studio utilise, avec les ID de modèle pour chacun. |
| Accès à Journey Builder | Accès pour créer et activer des parcours multi-étapes avec des sources d’entrée par événement API. |
Si vous utilisez une CEP autre que Braze ou Salesforce Marketing Cloud, Decisioning Studio peut s’intégrer via une approche par fichier de recommandation :
| Élément | Description |
|---|---|
| Capacité d’ingestion de données | Votre CEP doit être capable d’ingérer des fichiers de recommandation (généralement CSV ou JSON) contenant des décisions personnalisées pour chaque client. |
| Prise en charge du contenu dynamique | Vos Campaigns doivent prendre en charge le remplissage dynamique des champs à partir des données de recommandation. |
| Ressources d’ingénierie personnalisées | Votre équipe devra créer l’intégration pour lire les fichiers de recommandation et déclencher les communications. |
Planifier vos Campaigns
Avant de configurer l’orchestration, prenez en compte les éléments suivants :
Modèles de base
Un modèle de base est tout modèle de message que votre agent de décision pourrait utiliser. Considérez :
- Combien de modèles ? Votre agent peut fonctionner avec un seul modèle ou plusieurs. S’il y en a plusieurs, l’agent peut personnaliser le modèle que chaque client reçoit.
- Quels canaux ? E-mail, push, SMS ou une combinaison. Chaque canal peut nécessiter des modèles et des Campaigns distincts.
- Quels éléments dynamiques ? Identifiez les parties de votre message que l’agent personnalisera (lignes d’objet, CTA, offres, timing, etc.). Ceux-ci deviendront des propriétés de déclenchement API ou des marques substitutives dynamiques.
Paramètres de rééligibilité
Vos Campaigns doivent permettre aux utilisateurs de recevoir des messages plusieurs fois :
- Pour les tests, vous voudrez envoyer la même Campaign au même utilisateur de manière répétée
- En production, l’agent peut déterminer que la même Campaign est optimale pour un utilisateur sur des jours consécutifs
Bien que la rééligibilité soit configurée pour les tests, les agents Decisioning Studio sont conçus pour respecter les limites de fréquence et n’enverront pas la même Campaign à un utilisateur plus d’une fois par jour en production.
Propriétés de déclenchement API
Pour les intégrations Braze, planifiez les dimensions que votre agent optimisera. Celles-ci deviennent des propriétés de déclenchement API qui transmettent des valeurs dynamiques dans vos Campaigns :
| Exemple de dimension | Propriété de déclenchement API |
|---|---|
| Ligne d’objet | {{api_trigger_properties.${subject_line}}} |
| Appel à l’action | {{api_trigger_properties.${cta_message}}} |
| Offre | {{api_trigger_properties.${offer_id}}} |
| Montant de la remise | {{api_trigger_properties.${discount}}} |
Configuration de l’intégration
Sélectionnez votre CEP ci-dessous pour commencer la configuration de l’intégration.
Configurer l’intégration Braze
Suivez ces étapes pour intégrer un agent Decisioning Studio avec les capacités d’orchestration de Braze (l’équipe de services Braze sera disponible pour vous aider) :
Étape 1 : Créer une clé API
Accédez à Settings > API Keys, puis créez une nouvelle clé avec les autorisations suivantes :
| Autorisation | Objectif | Requise ? |
|---|---|---|
/users/track |
Met à jour les attributs personnalisés des profils utilisateurs, en plus de créer des profils utilisateurs temporaires lors de l’utilisation d’envois de tests. | ✓ |
/users/delete |
Supprime les profils utilisateurs temporaires créés lors des envois de tests. | Uniquement pour les envois de tests |
/users/export/segment |
Met à jour les communications d’audience disponibles chaque matin en exportant la liste des utilisateurs de chaque segment sélectionné. | ✓ |
/users/export/ids |
Récupère une liste d’identifiants lors du ciblage des utilisateurs à l’aide d’un external_id au lieu d’un segment. Étant donné que Decisioning Studio n’accepte pas les informations personnelles identifiables (PII), vous devez vous assurer que votre paramètre fields_to_export renvoie uniquement des champs non PII. |
Seulement si vous utilisez des external_ids |
/messages/send |
Envoie les variantes recommandées à l’heure recommandée à l’aide des Campaigns API configurées pour l’expérimentateur de Decisioning Studio. | ✓ |
/campaigns/list |
Récupère la liste des Campaigns actives et extrait le contenu des e-mails disponibles à des fins d’expérimentation. | ✓ |
/campaigns/data_series |
Exporte les données agrégées des Campaigns afin de permettre la création de rapports, la validation et la résolution des problèmes dans Decisioning Studio, ce qui vous permet de comparer les valeurs des rapports et d’analyser les performances de référence. Cette autorisation n’est pas obligatoire, mais elle est recommandée. |
|
/campaigns/details |
Récupère le contenu HTML, la ligne d’objet et les ressources d’images des Campaigns existantes à des fins d’expérimentation. | ✓ |
/canvas/list |
Récupère la liste des Canvas actifs afin d’extraire le contenu des e-mails disponibles à des fins d’expérimentation. | ✓ |
/canvas/data_series |
Exporte les données agrégées des Canvas à des fins de création de rapports et de validation, notamment lorsque le BAU est orchestré via Canvas. Cette autorisation n’est pas obligatoire, mais elle est recommandée. |
|
/canvas/details |
Récupère le contenu HTML, la ligne d’objet et les ressources d’images des Canvas existants à des fins d’expérimentation. | ✓ |
/segments/list |
Récupère tous les segments existants en tant qu’audiences cibles potentielles pour l’expérimentateur de Decisioning Studio. | ✓ |
/segments/data_series |
Exporte les informations relatives à la taille des segments, qui s’affichent dans Decisioning Studio lors de la sélection d’une audience. | ✓ |
/segments/details |
Récupère les détails des segments, tels que les critères d’entrée et de sortie, pour aider à comprendre les changements de taille ou de performances des audiences. | |
/templates/email/create |
Crée des copies des modèles HTML de base sélectionnés avec des marques substitutives dynamiques (étiquettes Liquid de Braze) à des fins d’expérimentation, en évitant de modifier les originaux. | ✓ |
/templates/email/update |
Transmet les mises à jour aux copies de modèles créées par Decisioning Studio lorsque les critères d’expérimentation changent, tels que les appels à l’action. | ✓ |
/templates/email/info |
Récupère les informations relatives aux modèles créés par Decisioning Studio dans votre instance Braze. | ✓ |
/templates/email/list |
Vérifie que les modèles ont bien été copiés dans votre instance Braze. | ✓ |
Étape 2 : Configurer les Campaigns déclenchées par API
Configurez une Campaign déclenchée par API pour chaque modèle de base avec des propriétés de déclenchement API pour toutes les dimensions optimisées.
Un modèle de base est tout modèle que l’agent de décision pourrait utiliser pour orchestrer les messages. Un agent de décision peut avoir 1 modèle de base ou plusieurs, auquel cas le choix du bon modèle de base pour chaque client sera l’une des décisions que l’agent personnalise.
Étape 3 : Configurer la rééligibilité
Assurez-vous que toutes les Campaigns déclenchées par API permettent aux utilisateurs de redevenir éligibles dans un délai de 15 minutes.
Bien que l’agent Decisioning Studio n’envoie jamais la même Campaign plus d’une fois par jour, vous voudrez avoir la possibilité d’envoyer les mêmes Campaigns plusieurs fois par jour à des fins de test.
Étape 4 : Ajouter des marques substitutives dynamiques
Celles-ci servent de marques substitutives dynamiques pour les décisions que l’agent Decisioning Studio optimise.
Exemple 1 : Campaign e-mail
Supposons que l’agent Decisioning Studio optimise une Campaign e-mail. La configuration pourrait ressembler à ceci :
En supposant que l’agent optimise le choix des modèles et le message d’appel à l’action (CTA), une Campaign déclenchée par API devrait être créée pour chaque modèle, et la section CTA d’un modèle pourrait ressembler à :
Exemple 2 : Campaign push
Supposons qu’un agent Decisioning Studio optimise le message d’une Campaign push. La configuration pourrait ressembler à ceci :
Ce qui donne le message suivant :
Exemple 3 : Campaign SMS
Supposons que l’agent Decisioning Studio optimise les champs d’une Campaign SMS. La configuration pourrait ressembler à ceci :
Ce qui donne le message suivant :
Configurer l’intégration SFMC
Decisioning Studio prend en charge l’intégration native avec Salesforce Marketing Cloud. Decisioning Studio déclenche des événements API dans un parcours avec les données nécessaires pour remplir les éléments dynamiques.
Pour les étapes détaillées de configuration de l’intégration SFMC, suivez les instructions SFMC dans la documentation Decisioning Studio Go.
Configurer les intégrations avec d’autres CEP
Decisioning Studio peut s’intégrer avec n’importe quelle plateforme d’engagement client. Cependant, cela peut nécessiter un travail d’ingénierie personnalisé de la part de votre équipe, car Decisioning Studio ne peut pas déclencher directement les communications.
Dans ce scénario, l’agent fournira un « fichier de recommandation ». Ce fichier contient des lignes pour chaque client, avec des colonnes indiquant toutes les décisions personnalisées pour ce client.
Par exemple, le fichier de recommandation suivant :
Pourrait être utilisé pour optimiser une Campaign e-mail qui ressemble à ceci :
Bonnes pratiques
Gardez ces bonnes pratiques à l’esprit lors de la préparation de l’orchestration :
- Commencez avec un périmètre restreint. Utilisez un seul canal et un ou deux modèles au départ. Vous pourrez élargir par la suite en fonction de ce qui fonctionne.
- Testez minutieusement. Avant le lancement, testez votre intégration avec un petit ensemble d’utilisateurs pour vérifier que le contenu dynamique se remplit correctement.
- Documentez votre configuration. Gardez une trace des ID de Campaign, des ID de modèle, des clés API et des autres identifiants. Vous devrez les référencer dans le portail Decisioning Studio.
- Coordonnez-vous avec votre équipe. La configuration de l’orchestration peut impliquer les équipes marketing, ingénierie et données. Assurez-vous que chacun comprend son rôle dans le processus.
- Prévoyez les données de retour. L’orchestration inclut l’envoi de messages et la collecte des données d’engagement et de conversion qui aident votre agent à apprendre. Consultez Préparer vos données pour plus de détails.
Étapes suivantes
Après avoir configuré l’orchestration, passez à la conception de votre agent :