シグナルを活用したトリガーオーケストレーションされたキャンペーン trigger-signal
オーケストレーションされたキャンペーンをスケジュールどおりに実行するのではなく、シグナルを送ることでトリガーできます。 シグナルは、外部システムまたはアプリケーションからのAPI呼び出しを介して送信されます。 信号を使用する場合は、パラメーターを渡すことができます。 これらの変数は、オーケストレーションされたキャンペーンで実行コンテキストのイベント変数として使用できるようになり、ターゲティング、条件、式で使用できます。
シグナルを使用してオーケストレーションされたキャンペーンをトリガーするエンドツーエンドのプロセス：
シグナルによってトリガーされるキャンペーンをスケジュールします configure-signal
スケジュールではなくシグナルで開始するようにオーケストレーションされたキャンペーンを設定するには、次の手順に従います。
-
シグナルを使用してトリガーするオーケストレーションキャンペーンを開きます。
-
スケジュール設定を開きます。 オーケストレーションされたキャンペーンをスケジュールする方法について説明します。
-
キャンペーンがスケジュールで実行するのではなくシグナルを待つように、シグナルによってトリガーを選択します。
信号ペイロードのパラメーターを追加します（オプション） parameters
トリガーシグナルでパラメーターを渡し、ターゲティング、条件、式など、キャンペーンの実行コンテキストでパラメーターを使用できます。 最初にスケジュール設定で各パラメーターを定義し、トリガー APIを呼び出すときにその値を渡します。
-
キャンペーンスケジューラーを開き、パラメーターを追加を選択します。
-
信号ペイロードで送信する各パラメーターの名前とデータタイプを定義します。 キャンペーンをテストモードでトリガーするときに使用する テスト値 を指定することもできます。 トリガーされたキャンペーンをテストする方法を説明します。
キャンペーンの構築とテスト build-and-test
キャンバス上でキャンペーンを構築し、オプションでAPI経由でシグナルをトリガーしてドラフトでテストしてから公開します。
-
キャンバス上のアクティビティ（オーディエンス、ターゲティング、配信）を追加して接続します。 キャンペーンアクティビティの調整方法の詳細情報
-
シグナルでパラメーターを定義した場合は、キャンバスロジック（条件やターゲティングなど）にパラメーターをワイヤー接続できます。 この例では、「channel」パラメーターがTest アクティビティの条件として使用されています。
式エディターで信号パラメーターを使用するには（例えば、オーディエンスを作成 アクティビティでクエリを作成するには）、「式」フィールドに「
$(vars/@<parameterName>)」と入力します。<parameterName>を、スケジューラーで定義されているパラメーター名（例：$(vars/@channel)）に置き換えます。 詳しくは、式エディターの操作方法を参照してください。 -
キャンペーンスケジューラーを開き、API リクエストをコピーを選択し、形式（cURLまたはHTTP リクエスト）を選択します。
コピーされた情報には、オーケストレーションされたキャンペーン ID、サンドボックス名、組織ID、およびパラメーターのテスト値が含まれています。
accordion パラメーターとテスト値を含むcURL リクエストのサンプル 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" } } -
「開始」をクリックして、キャンペーンを開始します。
-
スケジューラーからコピーしたサンプルリクエストを使用して、トリガー API呼び出しを送信します。
テスト結果に満足したら、 キャンペーンを公開します。
キャンペーンの公開とトリガー publish
キャンペーンを作成してテストした後、キャンペーンを公開して、アプリケーションからトリガーできるようにします。
-
キャンペーンキャンバスで「公開」をクリックします。 外部システムからキャンペーンをトリガーする前に、キャンペーンを公開する必要があります。 キャンペーンの開始と監視の詳細。
-
キャンペーンスケジューラーを開き、API リクエストをコピーを選択し、形式（cURLまたはHTTP リクエスト）を選択します。
コピーされた情報には、オーケストレーションされたキャンペーン ID、サンドボックス名、組織ID、およびパラメーターが含まれます（一部を追加した場合）。
-
システムからトリガー APIを呼び出します。
note important IMPORTANT ライブオーケストレーションされたキャンペーンの場合、スロットルガードレールにより、2つのAPIトリガーの実行の間に 最低1時間 の間隔が適用されます。 間隔が経過する前にAPIを再度呼び出すと、APIはHTTP 429 エラー（リクエストが多すぎます）を返します。 このガードレールは、ドラフトバージョンをトリガーしてテストする場合は適用されません。 シグナルペイロードにパラメーターを追加した場合、API呼び出しで渡した値は、キャンペーンの実行時にキャンペーンイベント変数として公開されます。 それらを調べるには、キャンペーンキャンバスツールバーからキャンペーンログを開きます。 「タスク」タブで、シグナルに対応するタスクを特定し、鉛筆アイコンをクリックして関連するイベント変数にアクセスします。 ログとタスクへのアクセス方法を確認する。
