ユースケース

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

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

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

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

前提条件

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

手順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」タブを選択して紐付け条件(この場合は「email」フィールド)を追加します。

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

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

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

    $long(vars/@recCount)>0
    

  9. データが取得された場合は、そのデータをオーディエンスに保存します。 それには、Save audience​アクティビティを​Target not empty​トランジションに追加してから開きます。

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

    $(vars/@fileToTarget)
    

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

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

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

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

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

手順3:ワークフローの設定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​パラメーターを使用します。

    $(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つのワークフローが開始されていることを確認します。

このページ