シグナルを使用したオーケストレーションキャンペーンのトリガー trigger-signal
固定スケジュールではなくシグナルを使用して、オーケストレーションされたキャンペーンを開始できます。 キャンペーンがシグナルを受信すると、そのシグナルが実行され、ペイロードでパラメーターを渡すことができます。 ターゲティング、条件、式の変数として使用できます。
シグナルは、次のいずれかから得られます。
- REST API — アプリケーションまたは統合がトリガーエンドポイントを呼び出します（ キャンペーンの公開とトリガーおよびAPI リファレンス を参照）。
- 別のオーケストレーションされたキャンペーン – アップストリームキャンペーンの終了 アクティビティは、ブランチが完了したときに同じ種類のシグナルを送信します。 終了アクティビティの設定方法を説明します。
このページでは、シグナル（スケジュール、パラメーター、テスト、公開）を受信するキャンペーンを設定する方法と、APIまたはEnd アクティビティから実行する方法について説明します。 変数が使用可能になったら、ルールと テスト 条件での変数の使用方法について詳しくは、 オーケストレーションされたキャンペーンでの変数の使用を参照してください。
トリガーエンドポイントのREST仕様（パス、ヘッダー、本文、レスポンス、およびエラー）については、Adobe Journey Optimizer API ドキュメントのトリガーオーケストレーションされたキャンペーン APIを参照してください。
シグナルを使用してオーケストレーションされたキャンペーンをトリガーするエンドツーエンドのプロセス：
orchestrated-campaign.publish）が必要です。 組み込み権限を参照してください。シグナルによってトリガーされるキャンペーンをスケジュールします configure-signal
スケジュールではなくシグナルで開始するようにオーケストレーションされたキャンペーンを設定するには、次の手順に従います。
-
シグナルを使用してトリガーするオーケストレーションキャンペーンを開きます。
-
スケジュール設定を開きます。 オーケストレーションされたキャンペーンをスケジュールする方法について説明します。
-
キャンペーンがスケジュールで実行するのではなくシグナルを待つように、シグナルによってトリガーを選択します。
信号ペイロードのパラメーターを追加します（オプション） parameters
トリガーシグナルでパラメーターを渡し、ターゲティング、条件、式など、キャンペーンの実行コンテキストでパラメーターを使用できます。 最初にスケジュール設定で各パラメーターを定義し、トリガー APIを呼び出すときや、アップストリームキャンペーンの終了 アクティビティからパラメーターをマッピングするときにその値を渡します（以下を参照）。
-
キャンペーンスケジューラーを開き、パラメーターを追加を選択します。
-
信号ペイロードで送信する各パラメーターの名前とデータタイプを定義します。 キャンペーンをテストモードでトリガーするときに使用する テスト値 を指定することもできます。 トリガーされたキャンペーンをテストする方法を説明します。
キャンペーンのテスト build-and-test
キャンバスでキャンペーンを作成し、REST APIを介してシグナルを送信して公開する前に ドラフト でテストします。
-
REST APIによってトリガーされるオーケストレーションされたキャンペーン – 次の手順を使用して、キャンペーンをドラフトで実行し、公開前にターゲティング、パラメーター、配信ロジックを検証します。
-
終了アクティビティによってトリガーされたオーケストレーションされたキャンペーン – 下書きでチェーン全体をエンドツーエンドで実行することはできません。上流キャンペーンが公開されると、その終了 アクティビティは公開された下流キャンペーンのみを開始します。 両方のキャンペーンが公開される前にダウンストリームサイドをテストするには、そのキャンペーンを ドラフト に保持し、スケジューラーで信号パラメーターに テスト値 を設定し（信号ペイロードのパラメーターを追加）、次のAPI手順に従います。 トリガー API呼び出しは、実行時にEnd アクティビティと同じペイロードを使用するので、ダウンストリームキャンペーンを公開し、アップストリーム End アクティビティ （別のキャンペーンの終了アクティビティからのトリガー）を設定する前に、パラメータルーティングとキャンバスロジックを検証できます。
-
キャンバス上のアクティビティ（オーディエンス、ターゲティング、配信）を追加して接続します。 キャンペーンアクティビティの調整方法の詳細情報
-
シグナルでパラメーターを定義した場合は、キャンバスロジック（条件やターゲティングなど）にパラメーターをワイヤー接続できます。 この例では、「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呼び出しを送信します。 リクエストとレスポンスの詳細については、トリガー オーケストレーション キャンペーン APIを参照してください。
テスト結果に満足したら、 キャンペーンを公開します。
キャンペーンの公開とトリガー publish
キャンペーン 🔗を テストした後、それを公開して、アプリケーションまたは別のキャンペーンの終了 アクティビティからシグナルを受信できるようにします。 キャンペーンの開始と監視の詳細。
次に、REST APIまたは別のキャンペーンのEnd アクティビティからトリガーできます。 以下のセクションを参照してください。
REST APIを使用したシグナルの送信 publish-api
公開後、独自のアプリケーションからキャンペーンをトリガーするたびに、次の手順に従います。
-
キャンペーンスケジューラーを開き、API リクエストをコピーを選択し、形式（cURLまたはHTTP リクエスト）を選択します。
コピーされた情報には、オーケストレーションされたキャンペーン ID、サンドボックス名、組織ID、およびパラメーターが含まれます（一部を追加した場合）。
-
システムからトリガー APIを呼び出します。 ライブエンドポイントの仕様については、トリガーオーケストレーションキャンペーン APIを参照してください。
note important IMPORTANT ライブオーケストレーションされたキャンペーンの場合、スロットルガードレールにより、2つのAPIトリガーの実行の間に最低1時間の間隔が適用されます。 間隔が経過する前にAPIを再度呼び出すと、APIはHTTP 429 （リクエストが多すぎる）を返します。 このガードレールは、ドラフトバージョンをトリガーしてテストする場合は適用されません。 シグナルペイロードにパラメーターを追加した場合、API呼び出しで渡した値は、キャンペーンの実行時にキャンペーンイベント変数として公開されます。 それらを調べるには、キャンペーンキャンバスツールバーからキャンペーンログを開きます。 「タスク」タブで、シグナルに対応するタスクを特定し、鉛筆アイコンをクリックして関連するイベント変数にアクセスします。 ログとタスクへのアクセス方法を確認する。
別のキャンペーンの終了アクティビティからのシグナルの送信 signal-end
このパスを使用して、オーケストレーションされたキャンペーンをチェーンします。アップストリームキャンペーンがブランチを完了すると、終了 アクティビティは、シグナルによってトリガーされたに既に設定されているダウンストリームキャンペーンにシグナルを送信します。 これにより、小規模な施策を再利用し、各呼び出し元から異なるペイロードを渡すことができます。
- 同じキャンバスで複数のEnd アクティビティを使用し、それぞれ設定して異なるダウンストリームキャンペーンをトリガーできます。
- 複数のキャンペーンが同じダウンストリームキャンペーンをトリガーできます。 各呼び出しは異なるペイロードを送信できます。
最初に実行する必要があるキャンペーンで、次の手順に従います。
-
シグナルを送信する必要があるオーケストレーションキャンペーンを開き、ダウンストリームキャンペーンが開始する前に完了する必要があるブランチの末尾にあるEnd アクティビティを選択します。
-
外部シグナル セクションで、トリガーするダウンストリームキャンペーンを選択します。
-
オプションで、パラメーターを追加します。ダウンストリームキャンペーンのスケジュールと同じ名前を使用し、各値を設定します。
-
ダウンストリームキャンペーンを公開する前にドラフトモードでテストするには、「 キャンペーンをテスト 」セクションの手順に従って、ドラフトでREST APIとトリガーします。
ダウンストリームキャンペーンは、アップストリームキャンペーンをトリガーするEnd アクティビティに到達するのに十分な距離まで実行する前に公開する必要があります。 ターゲットキャンペーンが公開されていない間にシグナルが送信された場合、実行は失敗します。 ダウンストリームキャンペーンを公開し、必要に応じて再開または再起動します。