Customizing a workflow with external parameters

ワークフローがトリガーされると、パラメーターはイベント変数に取り込まれ、ワークフローのアクティビティをカスタマイズするために使用できます。

例えば、アクティビティで読み取るオーディエンス、 Read audience アクティビティで転送するファイルの名前などを定義するために使用でき Transfer file ます。 (see this page).

イベント変数の使用

イベント変数は、 標準構文を満たす式内で使用されます

イベント変数を使用する構文は、次の形式に従い、アクティビティで定義されているパラメータ名を使用する必要があります(外部シグナルアクティビティでのパラメータの External signal 宣言を参照 )。

$(vars/@parameterName)

この構文では、 $ 関数は ​文字列データ型を返します。 別の種類のデータを指定する場合は、次の関数を使用します。

  • $long:整数値。
  • $float:10進数。
  • $boolean:true/false。
  • $datetime:timestamp.

アクティビティで変数を使用する場合、インターフェイスから変数を呼び出すのに役立ちます。

  • :ワークフローで使用可能なすべての変数の中からイベント変数を選択します。

  • :変数と関数を組み合わせた式の編集( このページを参照)。

    このリストは、複雑なフィルタリングを実行できる関数を提供します。 これらの機能については、 この節で説明します

    また、次の関数を使用できます。これらの関数は、外部パラメーターを使用してワークフローを呼び出した後にイベント変数を使用できるすべてのアクティビティで使用できます( この節を参照)。

    名前 説明 構文
    EndWith 文字列(最初のパラメータ)が特定の文字列(2番目のパラメータ)で終わるかどうかを示します。 EndWith(<String>,<String>)
    startWith 特定の文字列(2番目のパラメータ)を持つ文字列(第1のパラメータ)開始かどうかを示します。 startWith(<String>,<String>)
    抽出 区切り文字を使用して、文字列の最初の文字を返します。 Extract(<文字列>,<区切り文字>)
    ExtractRight 区切り文字を使用して、文字列の最後の文字を返します。 ExtractRight(<文字列>,<区切り文字>)
    DateFormat 2番目のパラメーターで指定された形式を使用して日付を書式設定します(例: '%4Y%2M%2D') DateFormat(<日付>,<形式>)
    ファイル名 ファイルパスの名前を返します。 FileName(<文字列>)
    FileExt ファイルパスの拡張子を返します。 FileExt(<String>)
    IsNull 文字列または日付がnullかを示します。 IsNull(<文字列/日付>)
    UrlUtf8Encode URLをUTF8でエンコードします。 UrlUtf8Encode(<String>)

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

イベント変数は、次の節に示すように、複数のアクティビティをカスタマイズするために使用できます。 アクティビティから変数を呼び出す方法について詳しくは、 この節を参照してください

Read audience アクティビティ:イベント変数に基づいてターゲットへのオーディエンスを定義します。 For more on how to use the activity, refer to this section.

Test アクティビティ:イベント変数に基づいて条件を作成します。 For more on how to use the activity, refer to this section.

Transfer file アクティビティ:イベント変数に基づいて転送するファイルをカスタマイズします。 For more on how to use the activity, refer to this section.

Query アクティビティ:パラメーター変数と関数を組み合わせた式を使用して、クエリーでイベントーを参照できます。 これを行うには、ルールを追加し、リンクをクリックして式編集ウィンドウにアクセスします( Advanced mode 詳細式編集を参照 )。

For more on how to use the activity, refer to this section.

Channels アクティビティ:イベント変数に基づいて配信をパーソナライズします。

メモ

配信パラメータの値は、配信が準備されるたびに取得されます。

反復配信の準備は、配信 集計期間に基づいて行われます。 たとえば、集計期間が「日別」の場合、配信は1日に1回のみ再準備されます。 配信パラメーターの値がその日中に変更された場合、既に1回準備されているので、配信では更新されません。

ワークフローを1日に複数回呼び出す予定がある場合は、この No aggregation オプションを使用して、配信のパラメーターが毎回更新されるようにします。 定期的な配信の設定について詳しくは、 この節を参照してください

イベント変数に基づいて配信をパーソナライズするには、まず使用する変数を配信アクティビティに宣言する必要があります。

  1. アクティビティを選択し、ボタンをクリックして設定にアクセスし ます。

  2. タブを選択し、 General 配信でパーソナライゼーションフィールドとして使用できるイベント変数を追加します。

  3. Confirm」ボタンをクリックします。

宣言済みイベント変数は、パーソナライゼーションフィールドのリストから使用できるようになりました。 配信でこれらを使用して、次の操作を実行できます。

  • 配信に使用するテンプレートの名前を定義します。

    メモ

    このアクションは、 定期的な 配信でのみ使用できます。

  • 配信のパーソナライズ:パーソナライゼーションフィールドを選択して配信を設定する場合、イベント変数を Workflow parameters 要素で使用できます。 配信の件名や送信者などを定義する場合など、任意のパーソナライゼーションフィールドとして使用できます。

    Delivery personalization is detailed in this section.

セグメントコード:イベント変数に基づいてセグメントコードを定義します。

メモ

この操作は、セグメントコード(例えば、または QuerySegmentation アクティビティ)を定義できる任意のアクティビティから実行できます。

配信ラベル:イベント変数に基づいて配信ラベルを定義します。

このページ