ユースケース

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

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

この使用例を実行するには、次の操作を実行する必要があります。

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

前提条件

ワークフローを設定する前に、 External signal 各アクティビティに含まれています。これにより、ワークフローの呼び出し時に、これらのシグナルアクティビティをターゲットに設定できます。

手順 1:API 呼び出しの設定

パラメーターを指定して、トリガーワークフロー 1 に対する API 呼び出しを実行します。 API 呼び出しの構文について詳しくは、 Campaign StandardREST 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 の設定

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

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

次の手順に従って、ワークフローを設定します。

API 呼び出しで定義されたパラメーターを宣言します。これをおこなうには、 External signal 「」アクティビティを開き、パラメーターの名前とタイプを追加します。
を追加します。 Transfer file 「」アクティビティを使用してデータをデータベースにインポートします。それには、「」アクティビティをドラッグ&ドロップして開き、 Protocol タブをクリックします。
を選択します。 Use a dynamic file path オプションを選択した場合、 fileToTarget パラメーターを次のように指定して転送します。
```
$(vars/@fileToTarget)
```
ファイルからデータベースにデータを読み込みます。

これをおこなうには、 Load file 「」アクティビティをワークフローに追加し、必要に応じて設定します。
データベースを挿入し、インポートしたファイルのデータで更新します。

これをおこなうには、 Update data 「」アクティビティで、 Identification タブをクリックして紐付け条件 ( 電子メール フィールド ) に書き込まれます。
を選択します。 Fields to update 」タブをクリックし、更新するフィールドをデータベース内で指定します ( この場合は名および 電子メール フィールド ) を参照してください。
データがファイルから取得されるかどうかを確認します。これをおこなうには、 Test 「」アクティビティをワークフローに追加し、 Add an element ボタンを使用して条件を追加します。
条件に名前を付けて定義します。この例では、アウトバウンドトランジションに次の構文のデータが含まれているかどうかをテストします。
```
$long(vars/@recCount)>0
```
データが取得された場合は、そのデータをオーディエンスに保存します。これをおこなうには、 Save audience アクティビティの ターゲットが空ではありません トランジションを選択し、開きます。
を選択します。 Use a dynamic label オプションを選択した場合、 fileToTarget パラメーターをオーディエンスのラベルとして使用します。
```
$(vars/@fileToTarget)
```
ドラッグ&ドロップ End 「」アクティビティを開きます。
を選択します。 External signal 「」タブをクリックし、ワークフローを指定して、「」トリガーとそれに関連するシグナルアクティビティを設定します。
ワークフロー 2 内で使用するパラメーターと、それに関連する値を定義します。

ここでは、元々 API 呼び出し (fileToTarget および discountDesc)、および追加の segmentCode パラメーターに定数値（「20%割引」）を割り当てます。

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

手順 3:ワークフロー 2 の設定

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

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

次の手順に従って、ワークフローを設定します。

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

これをおこなうには、 External signal 「」アクティビティを追加し、 End ワークフロー 1 の「」アクティビティ
ワークフロー 1 に保存されたオーディエンスを使用します。これをおこなうには、 Read audience 「」アクティビティをワークフローに追加し、開きます。
を選択します。 Use a dynamic audience オプションを選択した場合、 fileToTarget 読み取るオーディエンスの名前としてのパラメーター：
```
$(vars/@fileToTarget)
```
以下に従ってアウトバウンドトランジションに名前を付けます。 segmentCode パラメーター。

これをおこなうには、「 Transition タブ、 Use a dynamic segment code オプション。
以下を使用： segmentCode アウトバウンドトランジションの名前としてのパラメーター：
```
$(vars/@segmentCode)
```
ドラッグ&ドロップ Email delivery アクティビティを使用して、オーディエンスにメッセージを送信します。
メッセージ内で使用するパラメーターを特定し、 discountDesc パラメーター。これをおこなうには、アクティビティの詳細設定オプションを開き、パラメーター名と値を追加します。
これで、メッセージを設定できます。アクティビティを開き、「」を選択します。 Recurring email.
使用するテンプレートを選択し、必要に応じて E メールのプロパティを定義します。
以下を使用： discountDesc パーソナライゼーションフィールドとしてのパラメーター。これをおこなうには、パーソナライゼーションフィールドリストから選択します。
これで、メッセージの設定を完了し、通常どおりに送信できます。