外部パラメーターを使用したワークフローのカスタマイズ

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

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

イベント変数の使用

イベント変数は、標準構文を順守する必要がある式内で使用されます。

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

$(vars/@parameterName)

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

  • $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 アクティビティ:イベント変数に基づいてターゲットへのオーディエンスを定義します。アクティビティの使い方の詳細については、このを参照してください。

Test アクティビティ:イベント変数に基づいて条件を作成します。アクティビティの使い方の詳細については、このを参照してください。

Transfer file アクティビティ:イベント変数に基づいて転送するファイルをカスタマイズします。アクティビティの使い方の詳細については、このを参照してください。

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

アクティビティの使い方の詳細については、このを参照してください。

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

メモ

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

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

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

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

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

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

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

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

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

    メモ

    この操作は、定期的な​配信でのみ実行できます。

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

    配信のパーソナライゼーションの詳細については、このセクションを参照してください。

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

メモ

この操作は、Query​や​Segmentation​アクティビティなどのセグメントコードを定義できる任意のアクティビティから実行できます。

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

このページ