使用例

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

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

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

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

前提条件

ワークフローを設定する前に、それぞれに​External signal​アクティビティを含むWorkflow 1と2を作成する必要があります。 これにより、ワークフローの呼び出し時にこれらのシグナルアクティビティをターゲットできます。

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

API呼び出しを行い、パラメーターを使用してワークフロー1をトリガーします。 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」タブを選択して調整条件を追加します(この例では、email​フィールド)。

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

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

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

    $long(vars/@recCount)>0
    

  9. データが取得された場合は、オーディエンスに保存します。 これを行うには、Save audience​アクティビティを​ターゲットに追加し、空ではない​トランジションを開きます。

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

    $(vars/@fileToTarget)
    

  11. End​アクティビティをドラッグ&ドロップし、パラメーターを指定してWorkflow 2を呼び出してから開きます。

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

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

    この場合、API呼び出しで元々定義されていたパラメーター(fileToTarget​と​discountDesc)と、定数値("20% discount")を持つ追加の​segmentCode​パラメーターを渡します。

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

手順3:ワークフロー2の構成

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

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

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

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

    これを行うには、External signal​アクティビティを開き、Workflow 1の​End​アクティビティで定義されている各パラメーターの名前とタイプを追加します。

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

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

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

ワークフローの実行

ワークフローを構築したら、それらを実行できます。 API呼び出しを実行する前に、2つのワークフローが起動していることを確認します。

このページ