Show Menu
トピック×

使用例

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

前提条件

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

手順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 タブを選択して調整条件(この場合は 電子メール フィールド)を追加します。
  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. Workflow 2を呼び出すアクティビティをパラメーターと共にドラッグ&ドロップし、開きます。 End
  12. タブを選択し、トリガするワークフローとそれに関連する信号アクティビティを指定し External signal ます。
  13. ワークフロー2内で使用するパラメーターと、それに関連する値を定義します。
    この例では、最初にAPI呼び出しで定義されたパラメーター( fileToTarget discountDesc )と、追加の segmentCode パラメーター(「20% discount」)を一定値で渡します。
ワークフロー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パラメーターに従って、送信トランジションに 名前を付けます
    To do this, select the Transition tab, then the Use a dynamic segment code option.
  5. 外部トランジションの名前として segmentCode パラメーターを使用します。
    $(vars/@segmentCode)
    
    
  6. メッセージをオーディエンスに送信するには、 Email delivery アクティビティをドラッグ&ドロップします。
  7. メッセージで使用するパラメータを指定し、discountDesc ​パラメータを使用してパーソナライズします。 これを行うには、アクティビティの詳細オプションを開き、パラメータ名と値を追加します。
  8. これで、メッセージを設定できます。 アクティビティを開き、を選択し Recurring email ​ます。
  9. 使用するテンプレートを選択し、必要に応じて電子メールのプロパティを定義します。
  10. パーソナライゼーションフィールドとして discountDesc パラメータを使用します。 これを行うには、パーソナライゼーションフィールドリストから選択します。
  11. これで、メッセージの設定を完了し、通常どおり送信できます。

ワークフローの実行

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