モバイル用クイックスタートガイド

インストール

AndroidまたはiOS用のTealiumのインストールから始めましょう。

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

プロジェクトのトップレベルの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.X.X'
}
```

最新のリリースはGithubで確認し、1.X.Xを最新のリリース番号に置き換えてください。

Swift Package Managerを使用してiOSライブラリのTealiumをインストールするには：

XcodeプロジェクトでFile > Swift Packages > Add Package Dependencyを選択します
リポジトリURLを入力します：https://github.com/tealium/tealium-swift
バージョンルールを構成します。通常、Up to next majorが推奨されます。現在のTealium Swiftライブラリバージョンがリストに表示されない場合は、Swiftパッケージキャッシュをリセットしてください。
インストールするモジュールを選択し、XcodeプロジェクトのFrameworks > Libraries & Embedded Contentの各アプリターゲットにモジュールを追加します

初期化

AndroidまたはiOS用のTealiumの初期化から始めましょう。

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(TagManagement, Collect)
                    )
    tealium = Tealium.create("tealium_instance", tealiumConfig)
  }
}

Tealiumを初期化するには、TealiumConfigインスタンスをTealium()コンストラクタに渡します。

Tealiumインスタンスをトラッキングヘルパークラスを使用して管理し、Tealium iOSライブラリのシングルポイントエントリを提供し、将来のアップグレードを簡素化します。

class TealiumHelper {
    static let shared = TealiumHelper()
    let config = TealiumConfig(account: "ACCOUNT",
                               profile: "PROFILE",
                               environment: "ENVIRONMENT",
                               datasource: "DATASOURCE")
    var tealium: Tealium?

    private init() {

        // add necessary config options
        config.batchingEnabled = true
        config.logLevel = .debug

        // add the Collectors you want - no need to include if want all compiled collectors
        config.collectors = [Collectors.Lifecycle,
                             Collectors.Location,
                             Collectors.VisitorService]

        // add the Dispatchers you want - no need to include if want compiled dispatchers
        config.dispatchers = [Dispatchers.TagManagement,
                              Dispatchers.RemoteCommands]

        tealium = Tealium(config: config)

        // optional post init processing
        tealium?.dataLayer.add("mykey", "myvalue", expiry: .forever)

    }

    public func start() {
        _ = TealiumHelper.shared
    }

    class func trackView(title: String, data: [String: Any]?) {    
      let tealView = TealiumView(title, dataLayer: data)
      TealiumHelper.shared.tealium?.track(tealView)
    }

    class func trackEvent(title: String, data: [String: Any]?) {
      let tealEvent = TealiumEvent(title, dataLayer: data)
      TealiumHelper.shared.tealium?.track(tealEvent)
    }
}

モバイルパブリッシュ構成はデフォルトで有効になっており、使用しない場合は無効にする必要があります。iQタグ管理でモバイルパブリッシュ構成を構成するか、config.shouldUseRemotePublishSettings = falseを使用して無効にしてください。

トラッキング

AndroidまたはiOSのビューやイベントのトラッキングを始めましょう。

ビューのトラッキング

画面ビューをトラッキングするには、TealiumView(viewName:dataLayer:)のインスタンスをtrack()メソッドに渡します。TealiumViewは、データレイヤーにtealium_eventとして表示されるビュー名と、オプションのデータ辞書で構成されています。

ビューをトラッキングするには：

val tealView = TealiumView("screen_view", mutableMapOf("screen_name" to "Home"))
tealium.track(tealView);

ビューをトラッキングするには：

let tealView = TealiumView("screen_view", dataLayer: ["screen_name": "Home"])
tealium?.track(tealView)

イベントのトラッキング

ビュー以外のイベントをトラッキングするには、TealiumEvent(eventName:dataLayer:)のインスタンスをtrack()メソッドに渡します。TealiumEventは、データレイヤーにtealium_eventとして表示されるイベント名と、オプションのデータ辞書で構成されています。

イベントをトラッキングするには：

val tealEvent = TealiumEvent("user_login", mutableMapOf("customer_id" to "1234567890"))
tealium.track(tealEvent);

イベントをトラッキングするには：

let tealEvent = TealiumEvent("user_login", dataLayer: ["customer_id": "1234567890"])
tealium?.track(tealEvent)

track()メソッドは、イベント名とオプションのデータ辞書を含むTealiumDispatchタイプのTealiumEventを受け入れてイベントをトラッキングします。

データレイヤー

AndroidまたはiOSで、一般的なデータレイヤー値と各モジュールによって提供されるデータの管理を始めましょう。

データレイヤーにデータを追加するには：

String 値を構成するには、putString() メソッドを使用します：

tealium.dataLayer.putString("my_string", "my_string_value")

異なるデータタイプについても、メソッドは put で始まります。例えば、整数には putInt()、浮動小数点数の配列には putDoubleArray() を使用します。異なるデータタイプについてのメソッドをさらに学びましょう。

1日後に期限切れになる String 値を構成するには：

tealium.dataLayer.putString("my_string", "my_string_value", Expiry.afterTimeUnit(1, TimeUnit.DAYS))

有効期限のタイプについてさらに学びましょう。

任意のタイプの値を構成するには、add() メソッドを使用します：

tealium.dataLayer.add(key: "my_value", value: 123456)

1日後に期限切れになる任意のタイプの値を構成するには：

tealium?.dataLayer.add(key: "my_value", value: 123456, expiry: .afterCustom((.days, 1)))

アイデンティティ解決

Tealium の匿名 ID を使用し、独自のユーザー識別子を構成する方法を学びましょう。

匿名 ID

Tealium ライブラリは、アプリが初めて起動されたときに一意の永続的な匿名 ID を生成します。この値は visitorId に保存され、各トラッキングイベントに tealium_visitor_id 属性として含まれます。

訪問 ID を取得するには：

class TealiumHelper {
	lateinit var tealium: Tealium

    fun getVisitorId(): String {
        return tealium.visitorId
    }
}

訪問 ID を取得するには：

class TealiumHelper {
	var tealium: Tealium?

    var visitorId: String? {
		tealium?.visitorId
	}
}

Tealium AudienceStream を使用している場合、visitorId は訪問に関連付けられた匿名 ID です。AudienceStream での匿名 IDについてさらに学びましょう。

ユーザー識別子

既知のユーザーを識別する場合、永続的なデータ保存にユーザー識別子属性を追加します。

AudienceStream でのユーザー識別子についてさらに学びましょう。

ユーザー識別子を追加するには、例えば顧客 ID を：

fun setKnownVisitorId(id: String) {
    tealium.dataLayer.putString("customer_id", id, Expiry.FOREVER)
}

ユーザー識別子を追加するには、例えば顧客 ID を：

func setKnownVisitorId(_ id: String) {
	tealium?.dataLayer.add(key: "customer_id", value: id, expiry: .forever)
}

検証

ログファイルを検査し、トレースを実行し、ライブイベントを表示することでデータを検証します。

ログ

AndroidまたはiOSのログについて始めましょう。

ログレベルを構成するには、logLevel プロパティを構成します：

Logger.logLevel = LogLevel.DEV // または LogLevel.QA, LogLevel.PROD

ログレベルを構成するには、logLevel プロパティを構成します：

config.logLevel = .debug // または .info, .error, .fault, .silent

トレース

AndroidまたはiOSのトレースについて始めましょう。

トレースに参加するには、joinTrace() メソッドを呼び出します：

Tealium["INSTANCE_NAME"]?.joinTrace("TRACE_ID")

トレースを離れるには、leaveTrace() メソッドを呼び出します：

Tealium["INSTANCE_NAME"]?.leaveTrace()

トレースに参加するには、joinTrace() メソッドを呼び出します：

tealium?.joinTrace(id: "TRACE_ID")

トレースを離れるには、leaveTrace() メソッドを呼び出します：

tealium?.leaveTrace()

モバイルトレースツールは、デバイスでスキャン可能なQRコードを提供することでトレース機能をエンリッチメントし、TealiumモバイルSDKからのイベントを迅速に表示できます。

ライブイベント

Tealium EventStreamのライブイベント機能は、モバイルインストールのトラブルシューティングの目的で全てのTealium顧客に利用可能です。

ライブイベントの使用についてさらに学びましょう。