ANDROID KOTLIN

インストール

要件

サンプルアプリ

ライブラリ、トラッキング イベント、ベストプラクティスの実装の知識を増やすために、 のサンプル アプリ をご確認いただけるようになっています。

さらに、中央ヘルパー クラスですべての Tealium の機能を抽出することを推奨しています。サンプル ヘルパー クラスをご確認ください。

コードの取得

Tealium Android ライブラリをクローンします。ライブラリをダウンロードせずクローンすることで、今後のリリースに向けたアップデートがしやすくなります。

Android 向け Tealium クラスおよびメソッドの完全なリストについては、 Tealium API を参照してください。

インストール

Tealium Kotlin ライブラリはモジュールに分割されています。可能な限り最小のインストール サイズを維持するために、目的の機能の達成に必要なモジュールだけをインストールすることを推奨します。

Tealium Kotlin ライブラリを Maven によって、または手動でインストールします。

Maven

Tealium for AndroidライブラリをMavenによってインストールするには（推奨）：

  1. Tealium MavenのURLを、プロジェクトの最上位にあるbuild.gradleファイルに追加します。

    allprojects {
  repositories {
    jcenter()
    maven {
      url "https://maven.tealiumiq.com/android/releases/"
    }
  }
}

  2. プロジェクトモジュールのbuild.gradleファイルに、以下のようにMavenの依存関係を追加します。

    dependencies {
  implementation 'com.tealium:kotlin-core:1.3.0'
}

手動

Tealium for Androidライブラリを手動でインストールするには：

  1. flatDirをプロジェクトのルートにあるbuild.gradleファイルに追加します。

    allprojects {
  repositories {
     jcenter()
     flatDir {
         dirs 'libs'
     }
  }
}

  2. tealium-kotlin-1.2.x.aar を <PROJECT_ROOT>/<MODULE>/libsに追加します。

  3. Tealiumライブラリの依存関係をbuild.gradleファイルに追加します。

    dependencies {
  implementation(name:'tealium-kotlin-1.3.0', ext:'aar')
}

初期化

Tealium を初期化するには、 TealiumConfig インスタンスを設定して、これを Tealium インスタンスに渡します。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(Collect)
                    )
    tealium = Tealium.create("tealium_instance", tealiumConfig)
  }
}

ディスパッチャー

データを Tealium エコシステムに送信するには、以下のディスパッチャーから選択します:

  • Tag Management Tealium iQ Tag Management を使用して、そのタグ管理構成ロジックを活用するには、 TagManagement Dispatcher を追加します。
  • Collect Tealium Customer Data Hub のサーバーサイド ソリューションを用いるには、 Collect Dispatcher を追加します。

ログレベル

ログ レベルが TealiumConfig インスタンスからの環境に設定されます。

異なるログ レベルを用いるには、 logLevel プロパティを設定します:

config.logLevel = LogLevel.DEV // or LogLevel.QA, LogLevel.PROD

この機能は、ウェブビューではデフォルトで有効になっています。

イベントバッチ処理

イベントバッチ処理を有効にするには、モバイル公開設定に移動して、バッチサイズを1より大きい値に設定します。キュー内のイベントの数がバッチサイズと等しくなると、イベントがディスパッチされます。

Java からの移行

Java ライブラリから Kotlin ライブラリに移行すると、以下のものなど、保存されているデータが自動的に移行されます:

  • 同意設定
  • Lifecycle データ
  • 永続性データ
    • 永続性データ API を通じて追加されるカスタム永続性データ
    • Tealium 永続性データ: app_uuid, tealium_visitor_id

Kotlin ライブラリへの移行が完了した後、Java ライブラリからのレガシー データが削除されます。その後、Java ライブラリに戻ると、新たに tealium_visitor_id と app_uuid が生成され、カスタム持続性データが消滅します。

Android Wear

Android Wear アプリの場合は、データ収集には Collect モジュールを使用します。これは、Android Wear OS がウェブビュー サポートを提供していないことから、Tag Management モジュールがサポートされないためです。

Tealium for Android を用いて Android Wear アプリを開発する場合は、Google の推奨事項 は、スタンドアロン アプリを作成することです。

マルチプロセスアプリ

Android 9以降のマルチプロセスアプリケーション

Android 9では、マルチプロセスアプリケーションにおけるWebViewデータディレクトリに関する挙動が変更されました。この変更により、複数のWebViewがマルチプロセスで1つのデータディレクトリを共有しなくなりました。通常は、1つのWebViewを共通して使用するActivityはいずれも、同一のプロセスで実行されます。

Tag Management モジュールを使用し、 WebView の追加のインスタンスを実装する場合は、アプリがクラッシュしないよう、Tealium のインスタンスを作成する前に WebView.setDataDirectorySuffix() を呼び出すことを推奨しています。

Tag Management モジュールから Cookie とウェブデータにアクセスする必要がある場合は、 CookieManager.getCookie() と CookieManager.setCookie() メソッドを使用して、プロセス間でコピーします。

詳しく知るには、 プロセスで分けられたウェブベース データ ディレクトリ を参照してください。

次に
トラッキング
"トラッキング"