データ変換機能について
この記事では、データ変換機能の概要を説明します。
データ変換機能は、データがTealiumシステムに入力された時点で実行されますが、データが処理される前に行われます。変換機能は、以下を含むさまざまな目的に役立ちます:
- 関数に渡されたイベントオブジェクトをフラット化する。
- 電話番号やメールアドレスなどの機密データを削除する。
- イベントオブジェクト内の変数を変更する(例:変数を小文字に変更する)。
- 他の値に基づいてイベントオブジェクト内の変数を構成する。
- 変数の名前を変更し、値を別の変数に割り当てて元の変数を削除する。
ファイルインポートイベントはデータ変換機能ではサポートされていません。
データ変換機能への入力
データ変換機能は、データのソースに応じて以下の入力パラメータのいずれかを持ちます:
event: Tealium Collectからのイベントデータオブジェクト。詳細については、イベントパラメータを参照してください。dataRecord: クラウドデータソースからのデータレコード。詳細については、データレコードオブジェクトを参照してください。
Tealiumモジュールは、データ変換機能用にflatten()ユーティリティをエクスポートしており、ネストされたオブジェクトをネストなしの新しいオブジェクトに変換します。
カスタムトリガー
データ変換機能は、関数のカスタムトリガーに基づいて呼び出されます。カスタムトリガーは、関数を実行するタイミングを指定するために作成するルールです。カスタムトリガールールはロードルールに似ており、ルール内の条件を組み合わせるためにブール論理を使用します。
例えば、以下のルールでは、特定のデータソース(r2rbm8)からのpurchaseイベントが来たときに関数がトリガーされます。
条件は、入力データオブジェクトのプロパティセレクタ、比較演算子、および比較値に基づいています。セレクタはJSONPath式です(JSONPathを参照)し、オブジェクト内の任意のプロパティを参照できます。
データ変換機能とカスタムトリガーの作成についての情報は、関数の作成を参照してください。
イベントまたはデータレコードは1つの関数のみをトリガーできます。入力データが複数のトリガールールに一致する場合、最も古い変更日の関数がトリガーされます。
イベント用
Tealium Collectからのイベントの場合、カスタムトリガー条件はeventパラメータの任意のプロパティに基づくことができますが、通常はデータソースキー、データソースプラットフォーム、およびtealium_event属性に基づいています。
eventパラメータについての詳細は、イベントパラメータを参照してください。
データレコード用
クラウドデータソースからのイベントの場合、カスタムトリガー条件はdataRecordパラメータの任意のプロパティに基づくことができますが、データソースキー($.dataSourceId)に基づく条件を含める必要があります。
dataRecordパラメータについての詳細は、データレコードオブジェクトを参照してください。
ルールの制限
- セレクタおよび値フィールドは128文字に制限されます。
- 正規表現演算子は使用できません。
- ルールのサイズは10 KBに制限されます。
- ORブロックの数は10に制限されます。
- ANDブロック内の条件数は10に制限されます。
デフォルト関数コード
データ変換機能を作成すると、コードタブにデフォルトコードが表示されます。デフォルトコードはflattenライブラリをインポートし、transform(event)を呼び出します。ここでeventパラメータは入力イベントのメタデータオブジェクトであり、入力されたeventオブジェクトをフラット化します。必要に応じてデフォルトのtransform()コードを変更して、event.data.udoオブジェクト内のイベント属性を変更します。
import flatten from "tealium/util/flatten";
// "transform" function lets you access event and apply changes
transform((event) => {
// changes are applied through the mutation of the original event
event.data.udo = flatten(event.data.udo);
console.log(JSON.stringify(event, null, 2));
})
データ変換機能の例については、例コードを参照してください。
既存の関数をカスタムトリガーに変換
カスタムトリガーは、データ変換機能の初期リリース後に導入されました。カスタムトリガーが導入される前に存在していたデータ変換機能については、以下のような条件が自動的に作成されます:
この新しい条件は、関数に関連付けられたデータソースのIDに構成されたデータソースIDを指定します。データソースからのすべてのイベントに対して関数がトリガーされます。この条件を編集して、より具体的なイベントに対して関数をトリガーすることができます。
最終更新日 :: 2026年May月1日