ドキュメント Campaign Campaign Standard ドキュメント

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

最終更新日： 2024年7月19日

適用対象：
Campaign Standard

トピック：

作成対象：

中級
開発者

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

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

イベント変数の使用

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

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

$(vars/@parameterName)

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

$long：整数。
$float:10 進数です。
$boolean: true/false です。
$datetime: タイムスタンプ。

アクティビティで変数を使用する場合、インターフェイスにはそれを呼び出すためのヘルプが表示されます。

：ワークフローで使用可能なすべての変数の中からイベント変数を選択します。
：変数と関数を組み合わせて式を編集します（このページを参照）。

このリストには、複雑なフィルタリングを実行できる関数が表示されます。これらの関数について詳しくは、この節を参照してください。

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

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

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

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

Read audience アクティビティ：イベント変数に基づいて、ターゲットにするオーディエンスを定義します。アクティビティの使用方法について詳しくは、この節を参照してください。

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

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

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

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

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

NOTE

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

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

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

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

アクティビティを選択し、「」ボタンをクリックして設定にアクセスします。
「General」タブを選択し、配信のパーソナライゼーションフィールドとして使用できるイベント変数を追加します。
「Confirm」ボタンをクリックします。

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

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

NOTE
このアクションは、繰り返し 配信でのみ使用できます。
配信をパーソナライズします。パーソナライゼーションフィールドを選択して配信を設定する場合、イベント変数を Workflow parameters 要素で使用できます。パーソナライゼーションフィールドとして使用できます（例：配信の件名、送信者などを定義する）。

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