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

ユースケース use-case

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

中級
開発者

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

目的は、外部パラメーターを使用して、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 activity: インポートされたデータがあるかどうかを確認します。
Save audience クティビティ：ファイルにデータが含まれている場合、はプロファイルをオーディエンスに保存します。
アクティビティの End activity：使用するパラメーターを指定してワークフロー 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」アクティビティを Target not empty トランジションに追加し、そのトランジションを開きます。

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

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

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

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

ワークフロー 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 パラメーターをパーソナライゼーションフィールドとして使用します。これを行うには、パーソナライゼーションフィールドリストから選択します。
これでメッセージの設定を完了し、通常どおり送信できます。