Tealium

これはFlutter用Tealiumの以前のバージョン（2.x）です。最新バージョンについては、Flutter用Tealiumをご覧ください。

クラス: `Tealium`

以下は、FlutterのTealiumクラスで一般的に使用されるメソッドをまとめたものです。

メソッド	説明
`addCustomRemoteCommand()`	リモートコマンドマネージャーにリモートコマンドのコールバックを追加します。
`addRemoteCommand()`	リモートコマンドマネージャーにリモートコマンドを追加します
`addToDataLayer()`	永続的なデータレイヤーにデータを追加します
`clearStoredVisitorIds()`	訪問IDの保存されたキャッシュを削除し、`resetVisitorId`を呼び出します。
`gatherTrackData()`	すべてのコレクターとデータレイヤーからデータを収集します
`getFromDataLayer()`	永続的なデータレイヤーで指定されたキーの値を取得します
`getConsentCategories()`	ユーザーの同意したカテゴリを取得します
`getConsentStatus()`	ユーザーの同意状態を取得します
`getVisitorId()`	ユーザーの訪問IDを取得します
`initialize()`	構成パラメーターでTealiumを初期化します
`joinTrace()`	指定されたIDでトレースに参加します
`leaveTrace()`	以前に参加したトレースを離れ、訪問セッションを終了します
`removeFromDataLayer()`	以前に`addToDataLayer()`を使用して構成された永続的なデータキー値ペアのリストを削除します
`removeRemoteCommand()`	リモートコマンドマネージャーからリモートコマンドを削除します
`resetVisitorId()`	ユーザーの新しい訪問IDを生成します。
`setConsentCategories()`	ユーザーの同意カテゴリを構成します
`setConsentExpiryListener()`	同意期限が切れたときのリスナー/コールバックを構成します
`setConsentStatus()`	ユーザーの同意状態を構成します
`setVisitorIdListener()`	`visitorId`の変更に関するリスナーを追加します。
`setVisitorServiceListener()`	訪問サービスのリスナー/コールバックを構成します
`terminateInstance()`	Tealiumライブラリを無効にし、すべてのモジュール参照を削除することでTealiumインスタンスを終了します
`track()`	イベントまたは画面表示をトラックします

`addCustomRemoteCommand()`

Tealium iQタグ管理のタグに基づいてリモートコマンドマネージャーにカスタムリモートコマンドを追加します。

Tealium.addCustomRemoteCommand(id, callback);

パラメータ	タイプ	説明	例
`id`	`String`	タグ構成からのコマンドIDの名前	`"test_command"`
`callback`	`Function`	リモートコマンドからの応答を受け取った後に実行するコールバック関数。コールバックはタグマッピングからのキー値ペアのペイロードを返します。	(例を参照)

例:

Tealium.addCustomRemoteCommand('CUSTOM_COMMAND_ID', (payload) {
  print(JsonEncoder().convert(payload));
});

`addRemoteCommand()`

リモートコマンドマネージャーにリモートコマンドを追加します。

Tealium.addRemoteCommand(remoteCommand);

パラメータ	タイプ	説明	例
`remoteCommand`	`RemoteCommand`	パス、URL、またはWebView構成を持つ事前に構築されたリモートコマンド。	下記の例を参照。

例:

Tealium.addRemoteCommand(RemoteCommand(TealiumFirebase.commandName, path: "firebase.json")); // local
Tealium.addRemoteCommand(RemoteCommand(TealiumFirebase.commandName, url: "www.tealium.com/path_to_remote_command/firebase.json")); // remote
Tealium.addRemoteCommand(RemoteCommand(TealiumFirebase.commandName)); // webview

`addToDataLayer()`

指定された有効期限のために永続的なデータレイヤーにデータを追加します。

Tealium.addToDataLayer(data, expiry);

パラメータ	タイプ	説明	例
`data`	`Map<String, Object>`	文字列がキーであり、値が文字列または文字列の配列であるキー値ペアのJSONオブジェクト	`{'persistent_key' : 'persistent_val'}`
`expiry`	`Expiry`	データを永続させる時間の長さ	`Expiry.forever`

`clearStoredVisitorIds()`

以前に保存されたすべての訪問IDとハッシュ化された顧客識別子をクリアします。

Tealium.clearStoredVisitorIds();

`getFromDataLayer()`

永続的なデータレイヤーで指定されたキーの値をコールバック関数として取得します。

Tealium.getFromDataLayer(key);

パラメータ	タイプ	説明
`key`	`String`	データレイヤーから取得するキー
`N/A`	`Future<dynamic>`	`Tealium.dataLayer`から値が正常に取得された後にFutureが成功します

例:

Tealium.getFromDataLayer('key')
    .then((value) => print('データレイヤーからの値: $value'));

`getConsentCategories()`

ユーザーの同意したカテゴリを取得します。

Tealium.getConsentCategories();

パラメータ	タイプ	説明
`N/A`	`Future<List<dynamic>>`	`Tealium.ConsentManager`から同意カテゴリが正常に取得された後にFutureが完了します

例:

Tealium.getConsentCategories()
  .then((categories) =>
      print('同意カテゴリ: ' + categories.join(",")));

`getConsentStatus()`

ユーザーの同意状態をコールバック関数として取得します。

Tealium.getConsentStatus();

パラメータ	タイプ	説明
`N/A`	`Future<String>`	`Tealium.ConsentManager`から同意状態が正常に取得された後にFutureが完了します

例:

Tealium.getConsentStatus()
  .then((status) => print('同意状態: $status'));

`getVisitorId()`

ユーザーの訪問IDをコールバック関数として取得します。

Tealium.getVisitorId();

パラメータ	タイプ	説明
`N/A`	`Future<String>`	`Tealium.visitorId`が正常に取得された後にFutureが返されます

`initialize()`

他のメソッドを呼び出す前にTealiumを初期化します。

Tealium.initialize(config);

パラメータ	タイプ	説明
`config`	`TealiumConfig`	構成
`N/A`	`Future<bool>`	Tealiumの初期化が成功した後にFutureが完了します

例:

final config = TealiumConfig(
    'ACCOUNT',
    'PROFILE',
    TealiumEnvironment.dev,
    [
        Collectors.AppData,
        Collectors.DeviceData,
        Collectors.Lifecycle,
        Collectors.Connectivity,
    ],
    [
        Dispatchers.Collect,
        Dispatchers.TagManagement,
        Dispatchers.RemoteCommands,
    ],
    loglevel: LogLevel.DEV,
    consentLoggingEnabled: true,
    consentPolicy: ConsentPolicy.GDPR,
    visitorServiceEnabled: true);

Tealium.initialize(config).then((_) {
    print('Tealiumが初期化されました');
    Tealium.setConsentStatus(ConsentStatus.consented);
    Tealium.setConsentExpiryListener(() => print('同意が期限切れになりました'));
});

`joinTrace()`

指定されたIDでトレースに参加します。Traceについてもっと学びましょう。

Tealium.joinTrace(id);

パラメータ	タイプ	説明	例
`id`	`String`	CDHから取得したトレースID	`"abc123xy"`

`leaveTrace()`

以前に参加したトレースを離れ、訪問セッションを終了します。このメソッドが呼ばれるまでアプリセッションの間トレースはアクティブのままです。

Tealium.leaveTrace();

`removeFromDataLayer()`

addToDataLayer()を使用して以前に構成された永続的なデータを削除します。

Tealium.removeFromDataLayer(keys);

パラメータ	型	説明	例
`keys`	`List<String>`	キー名の配列	`["key1", "key2"]`

`removeRemoteCommand()`

リモートコマンドマネージャーからリモートコマンドを削除します。

Tealium.removeRemoteCommand(id);

パラメータ	型	説明	例
`id`	`String`	削除するコマンドIDの名前	`"test_command"`

例:

Tealium.removeRemoteCommand('test_command');

`resetVisitorId()`

ユーザーの新しい訪問IDを生成します。

Tealium.resetVisitorId();

`setConsentCategories()`

ユーザーの同意カテゴリを構成します。文字列の配列を渡してカテゴリを構成します。デフォルトは、ConsentStatusがConsentStatus.consentedに構成されるまで空の配列です。同意ステータスがConsentStatus.consentedでsetConsentCategories()メソッドでカテゴリが指定されていない場合、すべてのカテゴリが構成されます。

Tealium.setConsentCategories(categories);

パラメータ	型	説明	例
`categories`	`List<ConsentCategories>`	ユーザーの同意カテゴリの配列	`[ConsentCategories.email, ConsentCategories.personalization]`

例:

Tealium.setConsentCategories([ConsentCategories.analytics, ConsentCategories.email]);

同意カテゴリ

以下の同意カテゴリが利用可能です:

値	説明
`analytics`	アナリティクス
`affiliates`	アフィリエイト
`displayAds`	ディスプレイ広告
`email`	メール
`personalization`	パーソナライゼーション
`search`	検索
`social`	ソーシャル
`bigData`	ビッグデータ
`mobile`	モバイル
`engagement`	エンゲージメント
`monitoring`	モニタリング
`crm`	CRM
`cdp`	CDP
`cookieMatch`	クッキーマッチ
`misc`	その他

`setConsentExpiryListener()`

ユーザーの同意構成が期限切れになった後に実行するコールバックを構成します。

Tealium.setConsentExpiryListener(callback);

パラメータ	型	説明
`callback`	`Function`	同意が期限切れになった後に実行するコード

Tealium.setConsentExpiryListener(() {
    print('Consent Expired');
});

`setConsentStatus()`

ユーザーの同意ステータスを構成します。デフォルトはConsentStatus.unknownで、ステータスが更新されるまでです。

Tealium.setConsentStatus(status);

パラメータ	型	説明
`status`	`ConsentStatus`	同意ステータス

例:

Tealium.setConsentStatus(ConsentStatus.consented);

同意ステータス

以下の同意ステータスが利用可能です:

値	説明
`ConsentStatus.consented`	同意済み
`ConsentStatus.notConsented`	同意していない
`ConsentStatus.unknown`	不明

`setVisitorIdListener()`

訪問IDが変更されたときに実行するコールバックを構成します。

Tealium.setVisitorIdListener(callback);

パラメータ	型	説明
`callback`	`Function`	更新された`visitorId`で実行するコード

例:

Tealium.setVisitorIdListener((newVisitorId) {
    print(newVisitorId);
});

クラス: Tealium

addCustomRemoteCommand()

addRemoteCommand()

addToDataLayer()

clearStoredVisitorIds()

getFromDataLayer()

getConsentCategories()

getConsentStatus()

getVisitorId()

initialize()

joinTrace()

leaveTrace()

removeFromDataLayer()

removeRemoteCommand()

resetVisitorId()

setConsentCategories()