ドキュメント Campaign Campaign Standard ドキュメント

ユースケース use-case

最終更新日： 2026年5月15日

適用対象：
Campaign Standard

トピック：
Workflows

作成対象：

Intermediate
Developer

以下のユースケースは、ワークフロー内のパラメーターを使用してワークフローを呼び出す方法を示しています。

目的は、外部パラメーターを使用してAPI呼び出しからワークフローをトリガーすることです。このワークフローは、ファイルからデータベースにデータを読み込み、関連するオーディエンスを作成します。オーディエンスを作成すると、2つ目のワークフローがトリガーされ、API呼び出しで定義された外部パラメーターを使用してパーソナライズされたメッセージが送信されます。

このユースケースを実行するには、次のアクションを実行する必要があります。

外部パラメーターを使用して、トリガーワークフロー1へのAPI呼び出しを行います。手順1: API呼び出しの設定を参照してください。
ワークフローを作成1: ワークフローはファイルを転送し、データベースに読み込みます。その後、データが空かどうかをテストし、最終的にプロファイルをオーディエンスに保存します。最後に、ワークフロー2がトリガーされます。手順2：ワークフローの設定1を参照してください。
ワークフローを作成2: ワークフローは、ワークフロー1で作成されたオーディエンスを読み取り、パーソナライズされたメッセージをパラメーターでカスタマイズされたセグメントコードを使用してプロファイルに送信します。手順3：ワークフローの設定2を参照してください。

前提条件 prerequisites

ワークフローを設定する前に、ワークフロー1と2を作成し、それぞれにExternal signal アクティビティを設定する必要があります。これにより、ワークフローの呼び出し時に、これらのシグナルアクティビティをターゲットにすることができます。

手順1:API呼び出しの設定 step-1--configuring-the-api-call

パラメーターを使用して、トリガーワークフロー1へのAPI呼び出しを行います。 API呼び出し構文について詳しくは、Campaign Standard REST API ドキュメントを参照してください。

この場合、ワークフローを次のパラメーターで呼び出します。

fileToTarget: データベースにインポートするファイルの名前。
discountDesc：割引の配達に表示する説明。

-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/<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:":"API",
-d "parameters":{
-d "fileToTarget":"profile.txt",
-d "discountDesc":"Running shoes"
-d }

手順2：ワークフローの設定1 step-2--configuring-workflow-1

ワークフロー1は次のように構築されます。

External signal アクティビティ：ワークフロー内で使用するには、外部パラメーターを宣言する必要があります。
Transfer file アクティビティ：パラメーターで定義された名前のファイルを読み込みます。
Load file アクティビティ：読み込まれたファイルからデータベースにデータを読み込みます。
Update data アクティビティ：読み込まれたファイルのデータを使用して、データベースを挿入または更新します。
Test アクティビティ：データがインポートされているかどうかを確認します。
Save audience アクティビティ：ファイルにデータが含まれている場合、プロファイルをオーディエンスに保存します。
End activity アクティビティ：ワークフロー2内で使用するパラメーターを使用して、ワークフロー2を呼び出します。

ワークフローを設定するには、次の手順に従います。

API呼び出しで定義されたパラメーターを宣言します。これを行うには、External signal アクティビティを開き、パラメーターの名前とタイプを追加します。
データをデータベースにインポートするTransfer file アクティビティを追加します。これを行うには、アクティビティをドラッグ&ドロップして開き、「Protocol」タブを選択します。

Use a dynamic file path オプションを選択し、fileToTarget パラメーターを転送するファイルとして使用します。

code language-none
`$(vars/@fileToTarget)`

ファイルからデータベースにデータをロードします。

これを行うには、Load file アクティビティをワークフローにドラッグ&ドロップし、必要に応じて設定します。
インポートしたファイルのデータをデータベースに挿入して更新します。

これを行うには、Update data アクティビティをドラッグ&ドロップし、Identification タブを選択して紐付け条件を追加します（この場合は電子メール フィールド）。
「Fields to update」タブを選択し、データベースで更新するフィールドを指定します（この場合は firstname およびemail フィールド）。
ファイルからデータを取得したかどうかを確認します。これを行うには、Test アクティビティをワークフローにドラッグ&ドロップし、Add an element ボタンをクリックして条件を追加します。

条件に名前を付けて定義します。この場合、アウトバウンドトランジションに次の構文のデータが含まれているかどうかをテストします。

code language-none
`$long(vars/@recCount)>0`

データが取得された場合は、オーディエンスに保存します。これを行うには、Save audience アクティビティを ターゲットが空でない 移行に追加してから開きます。

Use a dynamic label オプションを選択し、fileToTarget パラメーターをオーディエンスのラベルとして使用します。

code language-none
`$(vars/@fileToTarget)`

パラメーターを使用してワークフロー2を呼び出すEnd アクティビティをドラッグ&ドロップし、開きます。
「External signal」タブを選択し、トリガーするワークフローと関連するシグナルアクティビティを指定します。
ワークフロー2内で使用するパラメーターとその関連値を定義します。

この場合、最初にAPI呼び出しで定義されたパラメーター（fileToTargetおよびdiscountDesc）と、定数値（「20%割引」）を持つ追加のsegmentCode パラメーターを渡す必要があります。

ワークフロー1が設定され、ワークフロー2を構築できるようになりました。詳しくは、この節を参照してください。

手順3：ワークフローの設定2 step-3--configuring-workflow-2

ワークフロー2は次のように構築されます。

External signal アクティビティ：ワークフロー内で使用するには、パラメーターを宣言する必要があります。
Read audience アクティビティ：ワークフロー1に保存されたオーディエンスを読み取ります。
Email delivery アクティビティ：パラメーターでパーソナライズされた、定期的なメッセージをターゲットオーディエンスに送信します。

ワークフローを設定するには、次の手順に従います。

ワークフロー1で定義されたパラメーターを宣言します。

これを行うには、External signal アクティビティを開き、ワークフロー1のEnd アクティビティで定義されている各パラメーターの名前とタイプを追加します。
ワークフロー1に保存されたオーディエンスを使用します。これを行うには、Read audience アクティビティをワークフローにドラッグ&ドロップしてから開きます。

Use a dynamic audience オプションを選択し、fileToTarget パラメーターを読み取るオーディエンスの名前として使用します。

code language-none
`$(vars/@fileToTarget)`

segmentCode パラメーターに従って、アウトバウンドトランジションに名前を付けます。

これをおこなうには、「Transition」タブを選択し、「Use a dynamic segment code」オプションを選択します。

アウトバウンドトランジションの名前としてsegmentCode パラメーターを使用します。

code language-none
`$(vars/@segmentCode)`

Email delivery アクティビティをドラッグ&ドロップして、オーディエンスにメッセージを送信します。
メッセージで使用するパラメーターを特定して、discountDesc パラメーターでパーソナライズします。これを行うには、アクティビティの詳細オプションを開き、パラメーター名と値を追加します。
メッセージを設定できるようになりました。アクティビティを開き、Recurring emailを選択します。
使用するテンプレートを選択し、ニーズに応じてメールプロパティを定義します。
discountDesc パラメーターをパーソナライゼーションフィールドとして使用します。これを行うには、パーソナライゼーションフィールドリストから選択します。
メッセージの設定を完了し、通常どおりに送信できるようになりました。