ユースケース use-case
以下の使用例は、ワークフロー内でパラメーターを使用してワークフローを呼び出す方法を示しています。
目的は、外部パラメーターを使用して API 呼び出しからトリガーーを作成することです。 このワークフローは、ファイルからデータベースにデータを読み込み、関連するオーディエンスを作成します。 オーディエンスが作成されると、2 つ目のワークフローがトリガーされ、API 呼び出しで定義された外部パラメーターを使用してパーソナライズされたメッセージを送信します。
この使用例を実行するには、次の操作を実行する必要があります。
- API 呼び出しを実行する 外部パラメーターを使用してトリガーワークフロー 1 に追加します。 詳しくは、 手順 1:API 呼び出しの設定.
- ワークフロー 1 を作成:ワークフローはファイルを転送し、データベースに読み込みます。 次に、データが空かどうかをテストし、最終的にプロファイルをオーディエンスに保存します。 最後に、トリガーWorkflow 2 です。 詳しくは、 手順 2:ワークフロー 1 の設定.
- ワークフローを作成 2:ワークフローは、Workflow 1 で作成されたオーディエンスを読み取り、パラメーターを使用してカスタマイズされたセグメントコードと共に、パーソナライズされたメッセージをプロファイルに送信します。 詳しくは、 手順 3:ワークフロー 2 の設定.
前提条件 prerequisites
ワークフローを設定する前に、 External signal 各アクティビティに含まれています。 これにより、ワークフローの呼び出し時に、これらのシグナルアクティビティをターゲットに設定できます。
手順 1:API 呼び出しの設定 step-1--configuring-the-api-call
パラメーターを指定して、トリガーワークフロー 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 の設定 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 」タブをクリックし、更新するフィールドをデータベース内で指定します ( この場合は 名 および 電子メール フィールド ) を参照してください。
-
データがファイルから取得されるかどうかを確認します。 これをおこなうには、 Test 「 」アクティビティをワークフローに追加し、「 Add an element ボタンを使用して条件を追加します。
-
条件に名前を付けて定義します。 この例では、アウトバウンドトランジションに次の構文のデータが含まれているかどうかをテストします。
code language-none $long(vars/@recCount)>0
-
データが取得された場合は、そのデータをオーディエンスに保存します。 これをおこなうには、 Save audience アクティビティの ターゲットが空ではありません トランジションを選択し、開きます。
-
を選択します。 Use a dynamic label オプションを選択した場合、 fileToTarget パラメーターをオーディエンスのラベルとして使用します。
code language-none $(vars/@fileToTarget)
-
ドラッグ&ドロップ End 「 」アクティビティを開きます。このアクティビティは、パラメーターを指定してワークフロー 2 を呼び出し、開きます。
-
を選択します。 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 「 」アクティビティを追加し、 End ワークフロー 1 の「 」アクティビティ
-
ワークフロー 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.
-
使用するテンプレートを選択し、必要に応じて E メールのプロパティを定義します。
-
以下を使用します。 discountDesc パーソナライゼーションフィールドとしてのパラメーター。 これをおこなうには、パーソナライゼーションフィールドリストから選択します。
-
これで、メッセージの設定を完了し、通常どおりに送信できます。
ワークフローの実行 executing-the-workflows
ワークフローを作成したら、ワークフローを実行できます。 API 呼び出しを実行する前に、2 つのワークフローが開始されていることを確認します。