ユースケース use-case

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

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

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

  1. 外部パラメーターを使用して、ワークフロー 1 をトリガーにする API 呼び出しを実行手順 1:API 呼び出しの設定を参照してください。
  2. ビルドワークフロー 1:ワークフローでファイルが転送され、データベースに読み込まれます。 次に、データが空かどうかをテストし、最終的にプロファイルをオーディエンスに保存します。 最後に、ワークフロー 2 がトリガーされます。 手順 2:ワークフローの設定 1 を参照してください。
  3. ビルドワークフロー 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 を呼び出します。

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

  1. API 呼び出しで定義されているパラメーターを宣言します。 それには、External signal アクティビティを開き、パラメーターの名前とタイプを追加します。

  2. データをデータベースにインポートするための Transfer file アクティビティを追加します。それには、アクティビティをドラッグ&ドロップして開き、「Protocol」タブを選択します。

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

    code language-none
    $(vars/@fileToTarget)
    

  4. ファイルからデータベースにデータを読み込みます。

    これを行うには、Load file アクティビティをワークフローにドラッグ&ドロップしたあと、必要に応じて設定します。

  5. 読み込んだファイルのデータでデータベースを挿入して更新します。

    これを行うには、Update data アクティビティをドラッグ&ドロップしたあと、「Identification」タブを選択して紐付け条件(この場合は メール フィールド)を追加します。

  6. Fields to update」タブを選択し、データベースで更新するフィールド(この場合は firstname および email フィールド)を指定します。

  7. データがファイルから取得されたかどうかを確認します。 これを行うには、Test アクティビティをワークフローにドラッグ&ドロップしたあと、「Add an element」ボタンをクリックして条件を追加します。

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

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

  9. データを取得したら、オーディエンスに保存します。 これを行うには、「Save audience」アクティビティを Target not empty トランジションに追加し、そのトランジションを開きます。

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

    code language-none
    $(vars/@fileToTarget)
    

  11. パラメーターを使用してワークフロー 2 を呼び出す End アクティビティをドラッグ&ドロップしてから開きます。

  12. External signal」タブを選択し、トリガーにするワークフローと関連するシグナルアクティビティを指定します。

  13. ワークフロー 2 内で使用するパラメーターと、それらに関連する値を定義します。

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

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

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

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

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

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

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

    それには、External signal アクティビティを開き、ワークフロー 1 の End アクティビティで定義された各パラメーターの名前とタイプを追加します。

  2. ワークフロー 1 で保存したオーディエンスを使用します。 これを行うには、Read audience アクティビティをワークフローにドラッグ&ドロップしてから開きます。

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

    code language-none
    $(vars/@fileToTarget)
    

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

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

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

    code language-none
    $(vars/@segmentCode)
    

  6. Email delivery アクティビティをドラッグ&ドロップして、メッセージをオーディエンスに送信します。

  7. discountDesc パラメーターを使用してメッセージをパーソナライズするために、メッセージで使用するパラメーターを特定します。 それには、アクティビティの詳細オプションを開き、パラメーターの名前と値を追加します。

  8. これで、メッセージを設定できます。 アクティビティを開き、「Recurring email」を選択します。

  9. 使用するテンプレートを選択し、必要に応じてメールプロパティを定義します。

  10. discountDesc パラメーターをパーソナライゼーションフィールドとして使用します。 これを行うには、パーソナライゼーションフィールド リストから選択します。

  11. これでメッセージの設定を完了し、通常どおり送信できます。

ワークフローの実行 executing-the-workflows

ワークフローが作成されたら、実行できます。 API 呼び出しを実行する前に、2 つのワークフローが開始されていることを確認します。

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff