Context APIモジュール(現Context API)
Flutter向けTealium Context APIモジュールのインストール方法について説明します。
これはTealium for Flutterの旧バージョン(2.x)です。最新バージョンについては、Tealium for Flutterを参照してください。
Moments APIはContext APIに名称変更されました。製品ドキュメント全体については、Context APIについてを参照してください。
Tealium for Flutterでは、Tealiumのモバイルライブラリ(iOS、Android)を使用して、Tealium Flutterプラグイン用のContext APIモジュールをインストールできます。
仕組み
Tealiumモバイルライブラリは、次のいずれかの方法でFlutterアプリケーションに統合できます。
- Dartパッケージ(推奨)
- GitHubを使用した手動統合
要件
- Flutterアプリケーション開発フレームワーク
- Android StudioやVS CodeなどのIDE
- IDEにインストールされたFlutterプラグイン
インストール
Flutter用Tealiumライブラリをインストールするには、次の手順を実行します。
- Flutterアプリプロジェクトで、次のコマンドを実行します。
dart pub add tealium_moments_api - 次のDartコードをプロジェクトにインポートします。
import 'package:tealium_moments_api/common.dart'; import 'package:tealium_moments_api/tealium_moments_api.dart';
初期化
メインのTealium Flutter統合を初期化する前に、Context APIモジュールを構成します。
Context APIインターフェイスで指定されているContext APIリージョンを構成します。次のリージョンを使用できます。
GERMANYUS_EASTSYDNEYOREGONTOKYOHONG_KONG
ドメイン許可リストを使用している場合は、リファラーを許可されたドメインに構成します。
次のサンプルコードでは、許可されたドメインと一致させるため、US_EASTリージョンとexample.comをリファラーとして使用しています。
final config = MomentsApiConfig(
MomentsApiRegion.US_EAST, // required
"https://example.com"); // optional
// Configure the module
TealiumMomentsApi.configure(config);
// ... Initialize main Tealium plugin
クラス:TealiumMomentsApi
Context APIモジュールとメインのTealium Flutter統合の両方を初期化すると、IDを使用してエンジンデータを取得できます。
fetchEngineResponse
指定したエンジンIDに対するエンジンレスポンスを取得します。
TealiumMomentsApi.fetchEngineResponse(
engineId: "ENGINEID",
callback: (response) {
if (response is EngineResponse) {
// handle success
final audiences = response.audiences;
// do something
} else if (response is String) {
// handle error
}
}
);
パラメータ
| パラメータ | 型 | 説明 |
|---|---|---|
engineId | String | 確認するエンジンのID |
callback | Function(dynamic) | 成功時にはEngineResponseを、失敗時にはString型のエラーメッセージを受け取るコールバック |
EngineResponse
EngineResponseクラスには、Context APIエンジンから返された訪問データが含まれます。
| プロパティ | 型 | 説明 |
|---|---|---|
audiences | List<String>? | 訪問が属するオーディエンスのID |
badges | List<String>? | 訪問に割り当てられたバッジ |
strings | Map<String, String>? | 文字列属性 |
booleans | Map<String, bool>? | ブール属性 |
dates | Map<String, int>? | 日付属性(タイムスタンプ形式) |
numbers | Map<String, double>? | 数値属性 |
最終更新日 :: 2026年November月3日