インストール

必要条件

Android Studio
Android SDK (Lollipop/5.0+ / API Level 21+)
Tealium iQ Mobile Profile
Tealium Customer Data Hub アカウント

サンプルアプリ

Android (Kotlin)のサンプルアプリを探索して、Tealiumライブラリ、イベントのトラッキング、およびベストプラクティスの実装についての知識を深めましょう。

さらに、Tealiumの機能を中央のヘルパークラスに抽象化することをお勧めします。私たちのサンプルヘルパークラスを探索してください。

コードの取得

Tealium Androidライブラリをクローンします。ライブラリをダウンロードするのではなく、クローンすることで将来のリリースに簡単に更新できます。

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

Tealium Kotlinライブラリはモジュールに分かれています。可能な限りインストールサイズを小さく保つために、必要な機能を実現するために必要なモジュールのみをインストールすることをお勧めします。

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

Maven

Android用TealiumライブラリをMavenでインストールするには（推奨）：

Tealium Maven URLをプロジェクトのトップレベルのbuild.gradleファイルに追加します：

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

プロジェクトモジュールのbuild.gradleファイルに次のMaven依存関係を追加します：
```
dependencies {
      implementation 'com.tealium:kotlin-core:1.6.0'
}
```

手動

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

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

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

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

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

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

初期化

Tealiumを初期化するには、TealiumConfigインスタンスを構成し、それをTealiumインスタンスに渡します。Tealium Kotlinライブラリは、アプリのグローバルアプリケーションクラスのonCreate()メソッド内で初期化することをお勧めします。

トラッキングヘルパークラスを使用して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。