Android(Java)向けTealium SDKのインストール方法について説明します。
要件
- Android Studio
- Android(KitKat/4.4以降/APIレベル19以降)
- タグ管理モバイルプロファイル
- Tealium Customer Data Hubアカウント
サンプルアプリ
Tealiumのライブラリ、トラッキングメソッド、および実装のベストプラクティスについて理解を深めるには、Tealium for Androidのサンプルアプリを参照してください。
コードの取得
Tealium Androidライブラリをクローンします。ダウンロードする代わりにライブラリをクローンすると、今後のリリースへの更新が容易になります。
Android向けTealiumのクラスとメソッドの完全な一覧については、Tealium APIを参照してください。
インストール
Mavenを使用するか、手動でAndroid向けTealium SDKをインストールします。
Maven
Mavenを使用してTealium for Androidライブラリをインストールするには(推奨):
プロジェクトの最上位の
build.gradleファイルにTealium Maven URLを追加します。allprojects { repositories { mavenCentral() maven { url "https://maven.tealiumiq.com/android/releases/" } } }プロジェクトモジュールの
build.gradleファイルに、次のMaven依存関係を追加します。dependencies { implementation 'com.tealium:library:5.8.0' }
手動
Tealium for Androidライブラリを手動でインストールするには:
プロジェクトルートの
build.gradleファイルにflatDirを追加します。allprojects { repositories { mavenCentral() flatDir { dirs 'libs' } } }tealium-5.x.x.aarを<PROJECT_ROOT>/<MODULE>/libsに追加します。build.gradleファイルにTealiumライブラリの依存関係を追加します。dependencies { implementation(name:'tealium-5.6.1', ext:'aar') }
初期化
初期化するには、アプリのonCreate()メソッドに次の変更を加えます。
Tealium.Configオブジェクトのインスタンスを作成します。Tealium.Config tealConfig = Tealium.Config.create( this, "ACCOUNT", "PROFILE", "ENVIRONMENT");setDatasourceId()など、必要な追加メソッドを呼び出して構成データを指定します。tealConfig.setDatasourceId("DATASOURCE_ID");setupInstance()メソッドを呼び出して、アプリのライフサイクルインスタンスを構成します。LifeCycle.setupInstance("INSTANCE_NAME", config, true);createInstance()メソッドを呼び出してTealiumインスタンスを作成し、構成インスタンスをコンストラクター引数として渡します。tealium = Tealium.createInstance("INSTANCE_NAME", tealConfig);
バージョン5.5.1以降でCollectが有効になっている場合、データはTealium.Configオブジェクトで指定されたプロファイルに送信されます。以前のバージョンでは、データはデフォルトプロファイル("main")に送信されます。
ログレベル
ログレベルはリモートパブリッシュ構成によって制御され、初期化時に構成した環境から推定されます。
バージョン5.3.1以降では、次の例のようにsetForceOverrideLogLevel()メソッドを使用して、ローカルでログレベルを上書きできます。
tealConfig.setForceOverrideLogLevel("LOG_LEVEL");
Cookie
モバイルプロファイルでタグ管理を有効にしている場合は、Cookieを有効にする必要があります。
Cookie管理を有効にするには、初期化ステートメントの後に次のコードを追加します。
config.getEventListeners().add(createCookieEnablerListener());
private static WebViewCreatedListener createCookieEnablerListener() {
return new WebViewCreatedListener() {
@Override
public void onWebViewCreated(WebView webView) {
final CookieManager mgr = CookieManager.getInstance();
// Accept all cookies
mgr.setAcceptCookie(true);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
mgr.setAcceptThirdPartyCookies(webView, true);
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB_MR1) {
CookieManager.setAcceptFileSchemeCookies(true);
}
Log.d(TAG, "WebView " + webView + " created and cookies enabled.");
}
};
}
このコードにより、タグ管理のWebviewがファーストパーティ、サードパーティ、およびファイルスキームのCookieを受け入れることができます。
バージョン5.1.0以降では、CookieManagerはデフォルトで有効です。バージョン5.0.4以前では、CookieManagerはデフォルトで無効です。
イベントのバッチ処理
イベントのバッチ処理を有効にするには、モバイルパブリッシュ構成に移動し、バッチサイズを1より大きい値に構成します。キュー内のイベント数がバッチサイズと等しくなると、イベントがディスパッチされます。
イベントのディスパッチは、_バッチタイムアウト_構成に基づいてトリガーすることもできます。この構成により、バッチサイズに達しなかった場合でも、一定時間が経過するとキューがディスパッチされます。setSecondsBeforeBatchTimeout()メソッドを呼び出して、バッチタイムアウトを構成します。
バッチサイズとバッチタイムアウトのチェックを上書きするには、requestFlush()メソッドを呼び出して、キューを直ちにフラッシュします。
デバイスがオフラインの場合、または同意マネージャーが有効になっている場合、フラッシュの上書きは機能しません。
マルチプロセスアプリ
Android 9以降のマルチプロセスアプリケーション
Android 9では、マルチプロセスアプリケーションにおけるWebViewのデータディレクトリに関する動作が変更されました。この変更により、WebViewは複数のプロセス間で単一のデータディレクトリを共有しなくなりました。通常、WebViewを使用するすべてのActivityは、同じプロセス内で実行することを推奨します。
タグ管理モジュールを使用し、追加のWebViewインスタンスを実装する場合は、アプリのクラッシュを防ぐため、Tealiumインスタンスを作成する前にWebView.setDataDirectorySuffix()を呼び出すことを推奨します。
タグ管理モジュールのCookieやWebデータにアクセスする必要がある場合は、CookieManager.getCookie()メソッドとCookieManager.setCookie()メソッドを使用して、プロセス間でコピーします。
詳しくは、プロセスごとに分離されたWebベースのデータディレクトリを参照してください。
最終更新日 :: 2026年November月18日