ユースケース

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

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

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

  1. API 呼び出しを実行する 外部パラメーターを使用してトリガーワークフロー 1 に追加します。 詳しくは、 手順 1:API 呼び出しの設定.
  2. ワークフロー 1 を作成:ワークフローはファイルを転送し、データベースに読み込みます。 次に、データが空かどうかをテストし、最終的にプロファイルをオーディエンスに保存します。 最後に、トリガーWorkflow 2 です。 詳しくは、 手順 2:ワークフロー 1 の設定.
  3. ワークフローを作成 2:ワークフローは、Workflow 1 で作成されたオーディエンスを読み取り、パラメーターを使用してカスタマイズされたセグメントコードと共に、パーソナライズされたメッセージをプロファイルに送信します。 詳しくは、 手順 3:ワークフロー 2 の設定.

前提条件

ワークフローを設定する前に、 External signal 各アクティビティに含まれています。 これにより、ワークフローの呼び出し時に、これらのシグナルアクティビティをターゲットに設定できます。

手順 1:API 呼び出しの設定

パラメーターを指定して、トリガーワークフロー 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 の設定

ワークフロー 1 は次のように構築されます。

  • External signal アクティビティ:ワークフロー内で使用するには、外部パラメーターを宣言する必要があります。
  • Transfer file アクティビティ:は、パラメーターで定義された名前でファイルをインポートします。
  • Load file アクティビティ:は、インポートしたファイルからデータベースにデータを読み込みます。
  • Update data アクティビティ:インポートしたファイルのデータを使用してデータベースを挿入または更新します。
  • Test アクティビティ:読み込まれたデータがあるかどうかを確認します。
  • Save audience アクティビティ:ファイルにデータが含まれている場合、はプロファイルをオーディエンスに保存します。
  • End activity アクティビティ:内で使用するパラメーターを指定して、ワークフロー 2 を呼び出します。

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

  1. API 呼び出しで定義されたパラメーターを宣言します。 これをおこなうには、 External signal 「 」アクティビティを開き、パラメーターの名前とタイプを追加します。

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

  3. を選択します。 Use a dynamic file path オプションを選択した場合、 fileToTarget パラメーターを次のように指定して転送します。

    $(vars/@fileToTarget)
    

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

    これをおこなうには、 Load file 「 」アクティビティをワークフローに追加し、必要に応じて設定します。

  5. データベースを挿入し、インポートしたファイルのデータで更新します。

    これをおこなうには、 Update data 「 」アクティビティで、 Identification タブをクリックして紐付け条件 ( 電子メール フィールド ) に書き込まれます。

  6. を選択します。 Fields to update 」タブをクリックし、更新するフィールドをデータベース内で指定します ( この場合は および 電子メール フィールド ) を参照してください。

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

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

    $long(vars/@recCount)>0
    

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

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

    $(vars/@fileToTarget)
    

  11. ドラッグ&ドロップ End 「 」アクティビティを開きます。

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

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

    ここでは、元々 API 呼び出し (fileToTarget および discountDesc)、および追加の segmentCode パラメーターに定数値(「20%割引」)を割り当てます。

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

手順 3:ワークフロー 2 の設定

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

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

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

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

    これをおこなうには、 External signal 「 」アクティビティを追加し、 End ワークフロー 1 の「 」アクティビティ

  2. ワークフロー 1 に保存されたオーディエンスを使用します。 これをおこなうには、 Read audience 「 」アクティビティをワークフローに追加し、開きます。

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

    $(vars/@fileToTarget)
    

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

    これをおこなうには、「 Transition タブ、 Use a dynamic segment code オプション。

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

    $(vars/@segmentCode)
    

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

  7. メッセージ内で使用するパラメーターを特定し、 discountDesc パラメーター。 これをおこなうには、アクティビティの詳細設定オプションを開き、パラメーター名と値を追加します。

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

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

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

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

ワークフローの実行

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

このページ