Show Menu
トピック×

外部パラメーターを使用したワークフローの呼び出し

Campaign Standardでは、パラメーター(ターゲットとするオーディエンス名、インポートするファイル名、メッセージコンテンツの一部など)を使用してワークフローを呼び出すことができます。 これにより、キャンペーンの自動化を外部システムと簡単に統合できます。
次の例では、CMSから直接電子メールを送信する例を示します。 その場合は、オーディエンスを選択し、CMSに電子メールコンテンツを送信するようにシステムを設定できます。 「送信」をクリックすると、これらのパラメーターを使用してCampaignワークフローが呼び出され、配信で使用するオーディエンスとURLコンテンツを定義するためにワークフロー内で使用できます。
パラメーターを使用してワークフローを呼び出すプロセスは次のとおりです。
  1. アクティビティのパラメーターを宣言 External signal します。 Externalシグナル アクティビティでのパラメーターの宣言を参照してください
  2. アクティビティま End たはAPI呼び出しを設定して、パラメーターを定義し、ワークフローアクティビティをトリガ External signal ーします。
ワークフローがトリガーされると、パラメーターはワークフローのイベント変数に取り込まれ、ワークフロー内で使用できます。 詳しくは、外 部パラメーターを使用したワークフローのカスタマイズを参照してくださ い。

外部シグナルアクティビティでのパラメーターの宣言

パラメーターを使用してワークフローを呼び出す最初の手順は、アクティビティで宣言するこ External signal とです。
  1. アクティビティ External signal を開き、タブを選択 Parameters します。
  2. ボタンをク Create element リックし、各パラメーターの名前とタイプを指定します。
    パラメーターの名前と数が、ワークフローの呼び出し時に定義されたものと同じであることを確認します(ワークフ ローの呼び出し時のパラメーターの定義 )。 また、パラメーターの型は、期待される値と一致している必要があります。
  3. パラメーターが宣言されたら、ワークフローの設定を完了し、実行します。

ワークフロー呼び出し時のパラメーターの定義

この節では、ワークフローを呼び出す際のパラメーターの定義方法について詳しく説明します。 API呼び出しからこの操作を実行する方法について詳しくは、REST APIのドキュメントを参照 してください
パラメーターを定義する前に、次のことを確認します。
アクティビティを設 End 定するには、次の手順に従います。
  1. アクティビティ End を開き、タブを選択 External signal します。
  2. 呼び出すワークフローと外部シグナルアクティビティを選択します。
  3. ボタンをク Create element リックしてパラメータを追加し、名前と値を入力します。
    • Name :アクティビティで宣言された名前(Externalシグナルア External signal クティビティで のパラメーターの宣言を参照 )。
    • Value :パラメーターに割り当てる値。 この値は、この節で説明する Standardの構文に従う ​必要 があります
    アクティビティですべてのパラメーターが宣言されていることを確認し External signal ます。 それ以外の場合は、アクティビティの実行時にエラーが発生します。
  4. パラメーターを定義したら、アクティビティを確認し、ワークフローを保存します。

イベント変数の監視

宣言済みの外部パラメーターを含む、ワークフローで使用可能なイベント変数を監視できます。 これをおこなうには、以下の手順に従います。
  1. アクティビティの後に続くアクティビティ External signal を選択し、ボタンをクリック Log and tasks します。
  2. タブで、ボ Tasks タンをクリック します。
  3. タスクの実行コンテキスト(ID、ステータス、期間など)が表示されます。この中には、ワークフローで使用できるすべてのイベント変数が含まれています。

Customizing a workflow with external parameters

ワークフローがトリガーされると、パラメーターがイベント変数に取り込まれ、ワークフローのアクティビティをカスタマイズするために使用できます。
例えば、アクティビティで読み取るオーディエンスや、アクティビティで転送するフ Read audience ァイルの名前などを定義するために使 Transfer file 用できます。
イベント変数を使用してカスタマイズできるアクティビティについては、この節 で説明しま す。

イベント変数の使用

イベント変数は、標準構文を満たす式の中で使用 されます
イベント変数を使用する構文は、次の形式に従い、アクティビティで定義されたパラメーターの名前を使用する必要があります( External signal External signal activityでのパラメーターの宣言を参照 )。
$(vars/@parameterName)

この構文では、$関数は stringデータ を返します 。 別のタイプのデータを指定する場合は、次の関数を使用します。
  • $long :整数値。
  • $float :10進数
  • $boolean :true/false。
  • $datetime :タイムスタンプ。
アクティビティで変数を使用する場合、インターフェイスから呼び出すのに役立ちます。
  • :ワークフローで使用可能なすべての変数の中からevents変数を選択します(を参照)。
  • :変数と関数を組み合わせた式を編集します。 For more on the Expression editor, refer to this section .
関連トピック:

イベント変数を使用したアクティビティのカスタマイズ

イベント変数を使用して、以下の節に示す複数のアクティビティをカスタマイズできます。 アクティビティから変数を呼び出す方法について詳しくは、この節を参照し てください
Read audience アクティビティ:イベント変数に基づいてターゲットを定義するオーディエンスを定義します。
For more on how to use the activity, refer to the dedicated section .
Test アクティビティ:イベント変数に基づいて条件を作成します。
For more on how to use the activity, refer to the dedicated section .
Transfer file アクティビティ:イベント変数に基づいて転送するファイルをカスタマイズします。
For more on how to use the activity, refer to the dedicated section .
Query アクティビティ:パラメーターは、イベント変数と関数を組み合わせた式を使用して、クエリー内で参照できます。 これを行うには、ルールを追加し、リンクをクリックし Advanced mode て式の編集ウィンドウにアクセスします(詳 細式の編集 )。
For more on how to use the activity, refer to the dedicated section .
Channels アクティビティ:イベント変数に基づいて配信をパーソナライズします。
配信パラメーターの値は、配信が準備されるたびに取得されます。
定期的な配信の準備は、配信の集計期間に基 づいています 。 例えば、集計期間が「日別」の場合、配信は1日に1回のみ準備し直されます。 配信パラメータの値がその日中に変更された場合は、既に1回の準備が済んでいるので、配信内で更新されません。
ワークフローを1日に複数回呼び出す場合は、このオプションを使用し No aggregation て、配信パラメーターが毎回更新されるようにします。 繰り返し配信の設定について詳しくは、この節を参 照してください
イベント変数に基づいて配信をパーソナライズするには、まず使用する変数を配信アクティビティに宣言する必要があります。
  1. アクティビティを選択し、ボタンをクリ ックして設定にアクセスします。
  2. タブを選択 General し、配信のパーソナライゼーションフィールドとして使用できるイベント変数を追加します。
  3. Click the Confirm button.
宣言済みイベント変数が、パーソナライゼーションフィールドのリストから使用できるようになりました。 配信でこれらを使用して、次のアクションを実行できます。
  • 配信に使用するテンプレートの名前を定義します。
    このアクションは、定期的な配信 でのみ 使用できます。
  • 配信のパーソナライズ:パーソナライゼーションフィールドを選択して配信を設定する場合、要素でイベント変数を使用で Workflow parameters きます。 これらを任意のパーソナライゼーションフィールドとして使用できます。例えば、配信の件名や送信者などを定義できます。
    配信のパーソナライゼーションについ ては、この節
セグメントコード :イベント変数に基づいてセグメントコードを定義します。
このアクションは、アクティビティなど、セグメントコードを定義できる任意のアクティビティから実行で Query Segmentation ます。
配信ラベル :イベント変数に基づいて配信ラベルを定義します。

使用例

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

前提条件

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

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

API呼び出しを行い、パラメーターを使用してワークフロー1をトリガーします。 API呼び出しの構文について詳しくは、『キャンペーン標準REST 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内で使用するパラメーターを使用して、ワークフロー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. ワークフロー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. 使用するテンプレートを選択し、必要に応じて電子メールのプロパティを定義します。
  10. パーソナライゼー ションフィールドとして 、discountDescパラメーターを使用します。 これを行うには、パーソナライゼーションフィールドリストから選択します。
  11. これで、メッセージの設定を完了し、通常どおりに送信できます。

ワークフローの実行

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