インストール

要件

Android Studio
Android SDK（Lollipop/5.0+ / APIレベル21+）
Tealium iQモバイルプロファイル
Tealiumアカウント

Xcode 14.0+
iOS 12.0+, macOS 10.14+, tvOS 12.0+, watchOS 4.0+
Tealium iQモバイルプロファイル
Tealiumアカウント

インストール

Tealium Prismライブラリはモジュールに分かれています。リソースフットプリントを小さく保つために必要なモジュールのみをインストールしてください。利用可能なモジュールのリストについては、モジュールを参照してください。

Maven

Mavenを使用してTealium Prism Kotlinライブラリをインストールするには：

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

dependencyResolutionManagement {
    repositories {
        // .. 他のリポジトリ
        maven {
            url = URI("https://maven.tealiumiq.com/android/releases/")
        }
    }
}

プロジェクトモジュールのbuild.gradleファイルに以下の依存関係を追加します。platform()エントリーにのみバージョン番号を指定する必要があります：

implementation(platform("com.tealium.prism:prism-bom:0.4.0"))
implementation("com.tealium.prism:prism-core")
implementation("com.tealium.prism:prism-lifecycle")
implementation("com.tealium.prism:prism-moments-api")

Swiftパッケージマネージャー（推奨）

Swift Package Managerを使用してTealium Prism Swiftをインストールするには：

XcodeプロジェクトでFile > Add Package Dependenciesを選択します。
リポジトリURLを入力します：https://github.com/tealium/tealium-prism-swift。
バージョンルールを構成します。Up to next majorを使用することをお勧めします。現在のTealium Prismライブラリバージョンがリストに表示されない場合は、Swiftパッケージキャッシュをリセットしてください。
インストールするモジュールを選択し、モジュールをインストールするアプリターゲットを選択します。

CocoaPods

CocoaPodsでインストールするには、Podfileに次の行を追加します：

pod 'tealium-prism'

Carthage

Carthageでインストールするには：

Cartfileに次の内容を追加します：
```
github "tealium/tealium-prism-swift"
```
iOS、macOS、tvOS、およびwatchOS用のフレームワークを生成するには、次のコマンドを実行します：
```
carthage update --use-xcframeworks
```
必要なフレームワークをXcodeプロジェクトのGeneral > Embedded Binariesセクションにドラッグします。

初期化

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

import com.tealium.prism.core.api.Tealium
import com.tealium.prism.core.api.TealiumConfig

val config = TealiumConfig.Builder(
   accountName = "my_account",
   profileName = "my_profile",
   environment = Environment.PROD,
   modules = listOf(
        Modules.appData(),
        Modules.collect(),
        Modules.connectivityData(),
        Modules.deepLink(),
        Modules.deviceData(),
        Modules.lifecycle(),
        Modules.timeData(),
        Modules.trace(),
       )
).build()
val tealium = Tealium.create(config)

コード内の次のプレースホルダーを置き換えてください：

my_account: Tealiumアカウント名（小文字）。
my_profile: Tealiumプロファイル名（小文字）。
Environment.PROD: Tealiumを初期化する環境（DEV, QA, PROD）。

Tealiumを初期化するには、TealiumConfigインスタンスをTealium.create()静的メソッドに渡します。

Tealiumインスタンスをトラッキングヘルパークラスで管理することをお勧めします。これにより、Tealium iOSライブラリの単一のエントリポイントが提供され、将来のアップグレードが簡素化されます。

#if COCOAPODS
import TealiumPrism
#else
import TealiumPrismCore
import TealiumPrismLifecycle
import TealiumPrismMomentsAPI
#endif

let config = TealiumConfig(account: "my_account",
                           profile: "my_profile",
                           environment: "prod",
                           modules: [
                            Modules.appData(),
                            Modules.collect(),
                            Modules.connectivityData(),
                            Modules.deepLink(),
                            Modules.deviceData(),
                            Modules.lifecycle(),
                            Modules.momentsAPI(),
                            Modules.timeData(),
                            Modules.trace(),
                           ],
                           settingsFile: "my_settings",
                           settingsUrl: "https://tags.tiqcdn.com/dle/my_account/my_profile/settings.json")
let tealium = Tealium.create(config: config)

コード内の次のプレースホルダーを置き換えてください：

my_account: Tealiumアカウント名（小文字）。
my_profile: Tealiumプロファイル名（小文字）。
prod: Tealiumを初期化する環境（dev, qa, prod）。

構成

Prismは3層の構成優先順位システムを使用します。構成は次の優先順位でマージされます：

層	優先順位	説明
プログラム	1（最高）	セキュリティクリティカルなIDおよび環境ロック。上書きできません。
リモートJSON	2	バッチサイズやサンプリングなどの運用構成のリアルタイム更新。
ローカルJSON	3（最低）	アプリにバンドルされたデフォルトのフォールバック構成。

この優先順位順序は、重要またはセキュリティに敏感な構成が低優先順位のソースによって誤って上書きされることがないようにします。

リモートおよびローカル構成

TealiumConfig.Builderを使用してリモートおよびローカル構成を構成します：

val config = TealiumConfig.Builder(
   accountName = "my_account",
   profileName = "my_profile",
   environment = Environment.PROD,
   modules = listOf(Modules.collect())
).build()

リモート構成は、アカウント、プロファイル、および環境に基づいて自動的にフェッチされます。Kotlin SDKはこれらの値から構成URLを解決します。

リモート構成URLを指定するにはsettingsUrlパラメータを使用し、ローカルのフォールバックとしてsettingsFileパラメータを使用します：

let config = TealiumConfig(account: "my_account",
                           profile: "my_profile",
                           environment: "prod",
                           settingsFile: "my_settings",
                           settingsUrl: "https://tags.tiqcdn.com/dle/my_account/my_profile/prod/settings.json")
let tealium = Tealium.create(config: config)

リモート構成を使用しない場合、またはそれらの構成のローカルコピーを異なるデフォルトで提供する場合は、settingsFileを指定し、settingsUrlを省略します。

ログレベル

ログレベルを構成するには、TealiumConfig ビルダーの構成で setLogLevel() を呼び出します：

val config = TealiumConfig.Builder(...)
  .configureSettings { settings ->
    settings.setLogLevel(LogLevel.WARN)
  }

詳細については、LogLevelを参照してください。

ログレベルを構成するには、TealiumConfigの強制構成ビルダーで setMinLogLevel() を呼び出します：

var config = TealiumConfig(account: "your_account",
                           profile: "your_profile",
                           environment: "dev",
                           modules: [],
                           settingsFile: nil,
                           settingsUrl: nil,
                           forcingSettings: { builder in
    builder.setMinLogLevel(.trace)
})

利用可能なログレベル：.trace, .debug, .info, .warn, .error, .silent。

モジュール固有の強制構成

TealiumConfig.Builderでモジュール固有の構成を構成します：

val config = TealiumConfig.Builder(
   accountName = "my_account",
   profileName = "my_profile",
   environment = Environment.PROD,
   modules = listOf(
        Modules.collect(),
        Modules.lifecycle(),
       )
).configureSettings { settings ->
    settings.setLogLevel(LogLevel.DEBUG)
}.build()

各モジュールは Modules.collect { } クロージャパターンを使用して追加のプログラム構成を指定できます。これにより、ローカルおよびリモートの構成が上書きされ、リモートで変更することはできません。

次の例は、Collectモジュールの構成を指定しています。プログラムで構成されていない他の構成はリモートで更新できます。

Modules.collect { enforcedSettings in
    enforcedSettings.setEnabled(true)
        .setOrder(5)
        .setOverrideProfile("custom_profile")
        .setOverrideDomain("custom_domain")
}