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

ユースケース use-case

Last update: Fri Dec 29 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Intermediate
  • Developer

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

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

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

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

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

  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 」タブをクリックし、更新するフィールドをデータベース内で指定します ( この場合は 名 および 電子メール フィールド ) を参照してください。

  7. データがファイルから取得されるかどうかを確認します。 これをおこなうには、 Test 「 」アクティビティをワークフローに追加し、「 Add an element ボタンを使用して条件を追加します。

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

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

  9. データが取得された場合は、そのデータをオーディエンスに保存します。 これをおこなうには、 Save audience アクティビティの ターゲットが空ではありません トランジションを選択し、開きます。

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

    code language-none 
    $(vars/@fileToTarget)

  11. ドラッグ&ドロップ End 「 」アクティビティを開きます。このアクティビティは、パラメーターを指定してワークフロー 2 を呼び出し、開きます。

  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 「 」アクティビティを追加し、 End ワークフロー 1 の「 」アクティビティ

  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. 使用するテンプレートを選択し、必要に応じて E メールのプロパティを定義します。

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

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

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

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

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