シグナルアクティビティのトリガー triggering-a-signal-activity
Adobe Campaign Standard ワークフローでは、1つ以上の外部シグナル アクティビティを設定できます。 これらのアクティビティは、トリガーされるのを待つ「リスナー」です。
Campaign Standard APIを使用すると、外部信号 アクティビティをトリガーしてワークフローを呼び出すことができます。 API呼び出しには、ワークフローのイベント変数（ターゲットとなるオーディエンス名、インポートするファイル名、メッセージコンテンツの一部など）に取り込まれるパラメーターを含めることができます。 これにより、Campaignの自動処理機能を外部システムと簡単に統合できます。
ワークフローをトリガーするには、次の手順に従います。
-
ワークフローでGET リクエストを実行して、外部シグナルアクティビティのトリガー URLを取得します。
GET https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<workflowID> -
返されたURLに対してPOST リクエストを実行し、ペイロードに"source" パラメーターを含むシグナル アクティビティをトリガーします。 この属性は必須です。トリガーリクエストソースを示すことができます。
パラメーターを使用してワークフローを呼び出す場合は、"parameters"属性を使用してペイロードに追加します。 構文は、パラメーターの名前とその値で構成されます（次のタイプはサポートされています：文字列、数値、ブール値、日付/時刻）。
-X POST <TRIGGER_URL>
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json;charset=utf-8' \
-H 'Content-Length:79' \
-i
-d {
-d "source":"<SOURCE>",
-d "parameters":{
-d "<PARAMETER_NAME":"<PARAMETER_VALUE>",
-d "<PARAMETER_NAME":"<PARAMETER_VALUE>",
-d "<PARAMETER_NAME":"<PARAMETER_VALUE>",
-d "<PARAMETER_NAME":"<PARAMETER_VALUE>"
-d }
-d }
サンプルリクエスト
ワークフローに対してGET リクエストを実行します。
-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<workflowID> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'
ワークフローシグナルのアクティビティと関連するトリガーのURLを返します。
{
"PKey": "<PKEY>",
"activities": {
"activity": {
"signal1": {
...
"trigger": {
"href": "https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<PKEY>/activities/activity/<PKEY>/trigger/"
},
...
}
}
}
}
シグナル アクティビティをトリガーするには、「source」を指定してトリガー URLに対してPOST リクエストを実行します。 パラメーターを使用してワークフローを呼び出す場合は、「パラメーター」属性を追加します。
-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<PKEY>/activities/activity/<PKEY>/trigger \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>' \
-i
-d '{
-d "source":"API",
-d "parameters":{
-d "audience":"audience",
-d "email":"anna.varney@mail.com",
-d "template":"05",
-d "contentURL":"http://www.adobe.com",
-d "test":"true",
-d "segmentCode":"my segment",
-d "attribute":"2019-04-03 08:17:19.100Z"}
-d }'
外部シグナル アクティビティでパラメーターの1つが宣言されていない場合、POST リクエストは、欠落しているパラメーターを示す以下のエラーを返します。
RST-360011 An error has occurred - please contact your administrator.
'contentURL' parameter isn't defined in signal activity.
XTK-170006 Unable to parse expression 'HandleTrigger(@name, $(source), $({parameters}))'.
RST-360000 Error while assessing 'HandleTrigger(@name, $(source), $({parameters}))' expression ('xtk:workflow:execution/activities/signal/trigger' resource)