以下の使用例は、ワークフロー内でパラメーターを使用してワークフローを呼び出す方法を示しています。
目的は、外部パラメーターを使用して API 呼び出しからトリガーーを作成することです。 このワークフローは、ファイルからデータベースにデータを読み込み、関連するオーディエンスを作成します。 オーディエンスが作成されると、2 つ目のワークフローがトリガーされ、API 呼び出しで定義された外部パラメーターを使用してパーソナライズされたメッセージを送信します。
この使用例を実行するには、次の操作を実行する必要があります。
ワークフローを設定する前に、 External signal 各アクティビティに含まれています。 これにより、ワークフローの呼び出し時に、これらのシグナルアクティビティをターゲットに設定できます。
パラメーターを指定して、トリガーワークフロー 1 に対する API 呼び出しを実行します。 API 呼び出しの構文について詳しくは、 Campaign StandardREST API のドキュメント.
この場合、次のパラメーターを使用してワークフローを呼び出します。
-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 }
ワークフロー 1 は次のように構築されます。
次の手順に従って、ワークフローを設定します。
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 「 」アクティビティを開きます。このアクティビティは、パラメーターを指定してワークフロー 2 を呼び出し、開きます。
を選択します。 External signal 「 」タブをクリックし、ワークフローを指定して、「 」トリガーとそれに関連するシグナルアクティビティを設定します。
ワークフロー 2 内で使用するパラメーターと、それに関連する値を定義します。
ここでは、元々 API 呼び出し (fileToTarget および discountDesc)、および追加の segmentCode パラメーターに定数値(「20%割引」)を割り当てます。
ワークフロー 1 が設定され、ワークフロー 2 を作成できるようになりました。 詳しくは、この節を参照してください。
ワークフロー 2 は、次のように構築されます。
次の手順に従って、ワークフローを設定します。
ワークフロー 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 パーソナライゼーションフィールドとしてのパラメーター。 これをおこなうには、パーソナライゼーションフィールドリストから選択します。
これで、メッセージの設定を完了し、通常どおりに送信できます。
ワークフローを作成したら、ワークフローを実行できます。 API 呼び出しを実行する前に、2 つのワークフローが開始されていることを確認します。