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 prise 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 la manière de l’envoyer
Choisir votre CEP
La première étape consiste à choisir quel CEP utiliser avec Decisioning Studio. Votre choix affecte la complexité de la configuration et les fonctionnalités disponibles.
CEP pris en charge
| CEP | Type d’intégration | Complexité de la configuration |
|---|---|---|
| Braze | Intégration API native (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.
Prérequis
Avant de configurer l’orchestration, rassemblez les éléments suivants en fonction de la plateforme d’engagement client (CEP) que vous avez choisie.
| Exigence | Description |
|---|---|
| Clé API REST | Une nouvelle clé API avec des permissions pour les données utilisateur, les messages, les Campaigns, 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 Paramètres > Paramètres de l’application). |
| Nom d’affichage et adresse e-mail | Les informations d’expéditeur à utiliser pour vos Campaigns (disponibles dans Paramètres > Préférences e-mail). |
| Modèles de base | Les modèles de messages que votre agent utilise pour l’orchestration. Vous créez des Campaigns déclenchées par API pour chaque modèle. |
| ID d’utilisateur test | Un ID utilisateur pour tester l’intégration avant le lancement. |
| Exigence | 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. |
| Permissions 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 avez 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 recommandations :
| Élément | Description |
|---|---|
| Capacité d’ingestion de données | Votre CEP doit être capable d’ingérer des fichiers de recommandations (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 en fonction des données de recommandation. |
| Ressources d’ingénierie personnalisées | Votre équipe doit construire l’intégration pour lire les fichiers de recommandations et déclencher les communications. |
Planifiez vos campagnes
Avant de configurer l’orchestration, tenez compte des détails 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 les points suivants :
- 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, notification 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 personnalise (comme les lignes d’objet, les CTA, les offres, le timing). Ceux-ci deviennent 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 envoyez 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
Lors de la configuration de la rééligibilité pour les tests, les agents Decisioning Studio sont conçus pour respecter les limites de fréquence et n’envoient 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 optimise. 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 plateforme d’engagement client dans cette liste 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 est disponible pour vous aider) :
Étape 1 : Créer une clé API
Accédez à Paramètres > Clés API, puis créez une nouvelle clé avec les permissions 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 des 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 Decisioning peut utiliser pour orchestrer les messages. Un agent Decisioning peut avoir 1 modèle de base ou plusieurs, auquel cas le choix du bon modèle de base pour chaque client est 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 souhaitez pouvoir 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 de notification push
Supposons qu’un agent Decisioning Studio optimise le message d’une Campaign de notification 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 votre configuration, les ID API doivent être saisis en majuscules. Cela inclut les ID de parcours, les ID de Campaign et tout autre identifiant. Si les ID API sont saisis en minuscules alors que vos données SFMC contiennent des UUID en majuscules, les filtres d’événements ne correspondent pas et les indicateurs de reporting ne se remplissent pas correctement.
Configurer d’autres intégrations de plateformes d’engagement client
Decisioning Studio peut s’intégrer à 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 de communications directement.
Dans ce scénario, l’agent fournit un « fichier de recommandations ». 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 recommandations suivant :
Pourrait être utilisé pour optimiser une Campaign e-mail qui ressemble à ceci :
Bonnes pratiques
Gardez ces bonnes pratiques à l’esprit lorsque vous préparez 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 groupe d’utilisateurs pour vérifier que le contenu dynamique s’affiche correctement.
- Documentez votre configuration : Gardez une trace des identifiants de Campaign, des identifiants de modèles, des clés API et des autres identifiants. Vous en aurez besoin pour les référencer dans le portail Decisioning Studio.
- Coordonnez-vous avec votre équipe : La mise en place de l’orchestration peut impliquer les équipes marketing, techniques et data. Assurez-vous que chacun comprend son rôle dans le processus.
- Anticipez les données de retour : L’orchestration envoie des messages et collecte les 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 :