Déclencher des campagnes orchestrées à l’aide d’un signal trigger-signal
Vous pouvez déclencher une campagne orchestrée en lui envoyant un signal au lieu de l’exécuter selon un planning. Le signal est envoyé via un appel API à partir d’un système ou d’une application externe. Lors de l’utilisation d’un signal , vous pouvez transmettre des paramètres. Elles sont ensuite mises à disposition dans la campagne orchestrée sous la forme de variables d’événement dans le contexte d’exécution, à utiliser dans le ciblage, les conditions ou les expressions.
Processus de bout en bout pour déclencher une campagne orchestrée à l'aide d'un signal :
orchestrated-campaign.publish). Voir Autorisations intégrées .Planifier la campagne à déclencher par un signal configure-signal
Pour définir une campagne orchestrée pour démarrer sur un signal au lieu d’un planning, procédez comme suit :
-
Ouvrez la campagne orchestrée à déclencher à l’aide d’un signal.
-
Ouvrez la configuration du planning. Découvrez comment planifier une campagne orchestrée.
-
Sélectionnez Déclenché par un signal afin que la campagne attende un signal au lieu de s’exécuter selon un planning.
Ajout de paramètres pour la payload du signal (facultatif) parameters
Vous pouvez transmettre des paramètres dans le signal de déclenchement et les utiliser dans votre campagne dans le contexte d’exécution, par exemple dans le ciblage, les conditions ou les expressions. Définissez d’abord chaque paramètre dans les paramètres de planification, puis transmettez sa valeur lorsque vous appelez l’API de déclenchement.
-
Ouvrez le planificateur de campagne et sélectionnez Ajouter un paramètre.
-
Définissez le nom et le type de données de chaque paramètre à envoyer dans la payload du signal. Vous pouvez également fournir des Valeurs de test qui seront utilisées lorsque vous déclencherez la campagne en mode test. Découvrez comment tester une campagne déclenchée.
Créer et tester la campagne build-and-test
Créez votre campagne sur la zone de travail, puis testez-la éventuellement dans le brouillon en déclenchant le signal via l’API avant de la publier.
-
Ajoutez et connectez les activités (audience, ciblage, diffusions) sur la zone de travail. Découvrez comment orchestrer des activités de campagne.
-
Si vous avez défini des paramètres dans le signal, vous pouvez les connecter à votre logique de zone de travail (par exemple, dans des conditions ou un ciblage). Dans cet exemple, le paramètre « channel » est utilisé comme condition dans une activité Test.
Pour utiliser un paramètre de signal dans l’éditeur d’expression (par exemple, pour créer une requête dans une activité Créer une audience), saisissez
$(vars/@<parameterName>)dans le champ d’expression. Remplacez<parameterName>par le nom du paramètre défini dans le planificateur, par exemple$(vars/@channel). Découvrez comment utiliser l’éditeur d’expression. -
Ouvrez le planificateur de campagne, sélectionnez Copier la requête d’API et choisissez le format (cURL ou requête HTTP).
Les informations copiées incluent l’identifiant de campagne orchestré, le nom du sandbox, l’identifiant d’organisation et les valeurs de test pour vos paramètres si vous en avez ajouté.
accordion Exemple de requête cURL avec un paramètre et une valeur de test code language-bash POST https://platform.adobe.io/ajo/campaign-orchestration/orchestratedCampaigns/1c7529c7-7a8c-491a-a2c6-3d8131d2e17d/trigger Headers: Authorization: Bearer ## Access token ## Content-Type: application/json x-api-key: ## Provide API Key here ## x-api-version: 1 x-gw-ims-org-id: 123456ABCDEFG@LumaOrg x-sandbox-name: prod Body: { "variables": { "channel": "sms" } } -
Cliquez sur Démarrer pour démarrer la campagne.
-
Envoyez l’appel API déclencheur à l’aide de l’exemple de requête que vous avez copié à partir du planificateur.
Lorsque les résultats des tests vous conviennent, publiez la campagne.
Publier et déclencher la campagne publish
Une fois que vous avez créé et testé la campagne, publiez la campagne afin qu’elle puisse être déclenchée à partir de votre application.
-
Cliquez sur Publier dans la zone de travail de la campagne. La campagne doit être publiée avant de pouvoir être déclenchée à partir d’un système externe. En savoir plus sur le démarrage et le suivi de la campagne.
-
Ouvrez le planificateur de campagne, sélectionnez Copier la requête d’API et choisissez le format (cURL ou requête HTTP).
Les informations copiées incluent l’identifiant de campagne orchestré, le nom du sandbox, l’identifiant d’organisation et les paramètres si vous en avez ajouté.
-
Appelez l’API de déclenchement depuis votre système.
note important IMPORTANT Pour une campagne orchestrée en direct, un mécanisme de sécurisation de ralentissement applique un intervalle minimum d’une heure entre deux exécutions de déclencheur d’API. Si vous appelez à nouveau l’API avant l’expiration de cet intervalle, l’API renvoie une erreur HTTP 429 (Trop de requêtes). Ce mécanisme de sécurisation n’est pas appliqué lorsque vous déclenchez un brouillon pour le tester. Si vous avez ajouté des paramètres à la payload du signal, les valeurs que vous transmettez dans l’appel API sont exposées en tant que variables d’événement de campagne lors de l’exécution de la campagne. Pour les examiner, ouvrez les journaux de campagne dans la barre d’outils de la zone de travail de campagne. Dans l’onglet Tâches, identifiez la tâche correspondant au signal et cliquez sur l’icône en forme de crayon pour accéder aux variables d’événement associées. Découvrez comment accéder aux journaux et aux tâches.
