Android(Kotlin)向けTealium SDKのインストール方法について説明します。
要件
- Android Studio
- Android SDK(Lollipop/5.0以降/APIレベル21以降)
- タグ管理モバイルプロファイル
- Tealium Customer Data Hubアカウント
サンプルアプリ
Tealiumライブラリ、イベントのトラッキング、ベストプラクティスに基づく実装について理解を深めるには、Android(Kotlin)のサンプルアプリを参照してください。
また、Tealiumのすべての機能を中央のヘルパークラスに抽象化することを推奨します。サンプルヘルパークラスを参照してください。
コードの取得
Tealium Androidライブラリをクローンします。ライブラリをダウンロードするのではなくクローンすると、今後のリリースへの更新が容易になります。
Android向けTealiumのクラスとメソッドの完全な一覧については、Tealium APIを参照してください。
インストール
Tealium Kotlinライブラリは複数のモジュールに分割されています。インストールサイズを可能な限り小さく保つため、必要な機能を実現するためのモジュールのみをインストールすることを推奨します。
Tealium Kotlinライブラリは、Mavenまたは手動でインストールできます。
Maven
Mavenを使用してTealium Androidライブラリをインストールするには(推奨):
プロジェクトの最上位にある
build.gradleファイルに、Tealium Maven URLを追加します。allprojects { repositories { mavenCentral() maven { url "https://maven.tealiumiq.com/android/releases/" } } }プロジェクトモジュールの
build.gradleファイルに、次のMaven依存関係を追加します。dependencies { implementation 'com.tealium:kotlin-core:1.6.0' }
手動
Tealium Androidライブラリを手動でインストールするには:
プロジェクトルートの
build.gradleファイルにflatDirを追加します。allprojects { repositories { mavenCentral() flatDir { dirs 'libs' } } }<PROJECT_ROOT>/<MODULE>/libsにtealium-kotlin-1.5.x.aarを追加します。build.gradleファイルにTealiumライブラリの依存関係を追加します。dependencies { implementation(name:'tealium-kotlin-1.6.0', ext:'aar') }
初期化
Tealiumを初期化するには、TealiumConfigインスタンスを構成し、それをTealiumインスタンスに渡します。アプリのグローバルApplicationクラス内のonCreate()メソッドでTealium Kotlinライブラリを初期化することを推奨します。
トラッキングヘルパークラスを使用してTealiumインスタンスを管理してください。これにより、Tealium Kotlinライブラリへの単一のエントリポイントが提供され、今後のアップグレードが容易になります。
object TealiumHelper {
lateinit var tealium: Tealium
fun init(application: Application) {
val tealiumConfig = TealiumConfig(
application,
"ACCOUNT",
"PROFILE",
Environment.DEV,
dataSourceId = "DATASOURCE_ID", //optional
modules = mutableSetOf(VisitorService),
dispatchers = mutableSetOf(Dispatchers.Collect)
)
tealium = Tealium.create("tealium_instance", tealiumConfig)
}
}
次の値を置き換えます。
ACCOUNT:ライブラリの初期化に使用するTealiumアカウント名(小文字)。PROFILE:ライブラリの初期化に使用するTealiumプロファイル名(小文字)。DATASOURCE_ID:TealiumデータソースID。
ディスパッチャー
データをTealiumエコシステムに送信するには、次のディスパッチャーから選択します。
- タグ管理
タグ管理を使用し、そのタグ管理構成ロジックを利用するには、TagManagementディスパッチャーを追加します。 - Collect
Tealium Customer Data Hubのサーバーサイドソリューションを使用するには、Collectディスパッチャーを追加します。
ログレベル
ログレベルは、TealiumConfigインスタンスの環境に基づいて構成されます。
別のログレベルを使用するには、logLevelプロパティを構成します。
config.logLevel = LogLevel.DEV // or LogLevel.QA, LogLevel.PROD
Cookie
WebViewでは、Cookieがデフォルトで有効になっています。
イベントのバッチ処理
イベントのバッチ処理は、TealiumConfigインスタンスでローカルに構成するか、モバイルパブリッシュ構成を使用してリモートで構成できます。バッチサイズを1より大きい値に構成すると、バッチ処理が有効になります。キュー内のイベント数がバッチサイズと等しくなると、イベントがディスパッチされます。
次の例は、バッチ処理をローカルで構成する場合に利用できるオプションを示しています。
object TealiumHelper {
private lateinit var tealium: Tealium
fun init(app: Application) {
config.overrideDefaultLibrarySettings = LibrarySettings(
batching = Batching(
batchSize = 10, // send in batches of 10 (default: 1)
maxQueueSize = 1000, // maximum of 1000 queued events (default: 100)
expiration = TimeUnit.DAYS // queue for a maxumum of 5 days (default: 86400)
.toSeconds(5).toInt()
)
)
}
}
Javaからの移行
JavaライブラリからKotlinライブラリに移行すると、次の保存済みデータが自動的に移行されます。
- 同意構成
- ライフサイクルデータ
- 永続データ
- 永続データAPIを使用して追加されたカスタム永続データ
- Tealium永続データ:
app_uuid、tealium_visitor_id
Kotlinライブラリへの移行が完了すると、Javaライブラリのレガシーデータは削除されます。その後Javaライブラリに戻すと、新しいtealium_visitor_idとapp_uuidが生成され、カスタム永続データは失われます。
Android Wear
Android Wear OSはWebViewをサポートしておらず、タグ管理モジュールはサポートされないため、Android Wearアプリでデータを収集するにはCollectモジュールを使用してください。
Tealium for Androidを使用してAndroid Wearアプリを開発している場合、スタンドアロンアプリを作成することをGoogleは推奨しています。
マルチプロセスアプリ
Android 9以降のマルチプロセスアプリケーション
Android 9では、マルチプロセスアプリケーションのWebViewデータディレクトリに関する動作が変更されました。この変更により、単一のデータディレクトリが複数のプロセス間でWebViewによって共有されなくなりました。通常、WebViewを使用するすべてのActivityを同じプロセス内に配置する必要があります。
タグ管理モジュールを使用し、追加のWebViewインスタンスを実装する場合、アプリのクラッシュを防ぐため、Tealiumインスタンスを作成する前にWebView.setDataDirectorySuffix()を呼び出すことを推奨します。
タグ管理モジュールからCookieとWebデータにアクセスする必要がある場合は、CookieManager.getCookie()メソッドとCookieManager.setCookie()メソッドを使用して、プロセス間でコピーしてください。
詳細については、プロセスごとに分離されたWebベースのデータディレクトリを参照してください。
最終更新日 :: 2026年November月18日