クイックスタートガイド

インストール

Tealium for Android または Tealium for iOSのインストールを始めましょう。

Tealium for Android ライブラリを Maven によってインストールするには:

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

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

プロジェクトモジュールのbuild.gradleファイルに、以下のようにMavenの依存関係を追加します。
```
dependencies {
  implementation 'com.tealium:kotlin-core:1.X.X'
}
```

Github に関する最新リリースをチェックして、「1.X.X 」を最新リリース番号で置き換えます。

Tealium for iOS ライブラリを Swift Package Manager によってインストールするには:

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

初期化

Tealium for Android または Tealium for iOSの初期化を始めましょう。

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(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 desired Collectors - no need to include if want all compiled collectors
        config.collectors = [Collectors.Lifecycle,
                             Collectors.Location,
                             Collectors.VisitorService]

        // add desired Dispatchers - 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 Tag Management で設定するか、 config.shouldUseRemotePublishSettings = false を使用して無効化します。

トラッキング

Tealium for Android または Tealium for 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())を使って開始されます。さまざまなデータレイヤー変数用のメソッドの詳細は、こちらから参照してください。

日経過後に有効期限が切れるように String 値を設定するには:

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

有効期限のタイプの詳細は、こちらから参照してください。

型を問わず、値を設定するには、 add() メソッドを使用します。

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

日経過後に有効期限が切れるように、型を問わず、値を設定するには:
```
tealium?.dataLayer.add(key: "my_value", value: 123456, expiry: .afterCustom((.days, 1)))
```

特定

Android または Tealium for iOSでのカスタム訪問者 ID の追加を始めましょう。

訪問者ID

Tealium Android および Swift ライブラリは、 visitorIdにおいて初めて起動され保存されたときに、一意の永続的な訪問者 ID を生成します。この値は、トラッキングされる各イベントに属性 tealium_visitor_idとして含められるプライマリ訪問者 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
    }
}

トラッキングコールで変数として送信することにより、必要に応じて追加の訪問者 ID 属性をデータレイヤーに提供します。

Tealium AudienceStream を使用している場合、 visitorId は、この訪問者に関連付けられるプライマリ訪問者 ID になります。AudienceStream での訪問者 ID の設定の詳細は、こちらから参照してください。

セカンダリ訪問者 ID

永続性データストレージに追加することで、セカンダリ訪問者 ID 属性を必要に応じて含めます。

顧客 ID などの既知の訪問者 ID を追加するには:

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

顧客 ID などの既知の訪問者 ID を追加するには:

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

検証

データを検証するには、ログファイルの検査、トレースの実行、ライブイベントのビューを行います。

ログ

Android または iOSでのログ (記録) を始めましょう。

ログレベルを設定するには、 logLevel プロパティを設定します。

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

ログレベルを設定するには、 logLevel プロパティを設定します。

config.logLevel = .debug // or .info, .error, .fault, .silent

Trace

トレース (Android または iOS用) を始めましょう。

トレースに参加するには、 joinTrace() 呼び出します。

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

トレースから退出するには、 leaveTrace() メソッドを呼び出します。

Tealium["INSTANCE_NAME"]?.leaveTrace()

トレースに参加するには、 joinTrace() 呼び出します。

tealium?.joinTrace(id: "TRACE_ID")

トレースから退出するには、 leaveTrace() メソッドを呼び出します。

tealium?.leaveTrace()

Mobile Trace Tool は、お使いのデバイスでスキャン可能な QR コードを提供することでトレース機能を強化します。これにより、Tealium Mobile SDK から来るイベントをすばやくビューすることができるようになります。

Live Events

Tealium EventStream の Live Events 機能は、モバイルインストールのトラブルシューティングを目的として、すべての Tealium ユーザーに提供されています。

Live Eventsの使用の詳細は、こちらから参照してください。

次に

モバイルの概念

このページはお役にたちましたでしょうか？

最終更新日 :: 2022年August月29日