Moments API（現在はContext API）

Moments APIはContext APIに名称が変更されました。製品の完全なドキュメントについては、Context APIについてをご覧ください。

Context APIは、モバイルアプリケーションに統合できるユニークなエンドポイントを提供し、パーソナライズされたユーザーエクスペリエンスを実現します。このガイドでは、Swift（iOS用）とKotlin（Android用）を使用してContext APIを実装する手順を説明します。

対応プラットフォーム

前提条件

開始する前に、以下のものを用意してください：

Context APIにアクセスできるTealiumアカウント。

動作原理

Context APIはAudienceStreamから訪問データを取得し、アプリ内パーソナライゼーションに使用できます。

ユースケース

アプリ内パーソナライゼーション

必要に応じて訪問情報を更新して取得し、アプリ内のパーソナライズされたコンテンツを提供します。

同意された訪問データを他のSDKに渡す

訪問プロファイルから特定の属性をアプリ内の他のSDKに渡し、パーソナライズされたメッセージングを有効にするか、特定のユーザーセグメントのA/Bテストを実行するのに使用できます。

初期化

ステップ1: Context APIモジュールでTealiumを初期化

import TealiumCore
import TealiumMomentsAPI

let config = TealiumConfig(account: "your_account",
                           profile: "your_profile",
                           environment: "dev",
                           modules: [Collectors.MomentsAPI])

let tealium = Tealium(config: config)

import com.tealium.core.Tealium
import com.tealium.core.TealiumConfig
import com.tealium.core.Environment
import com.tealium.core.modules

val config = TealiumConfig(application, 
                           "your_account",
                           "your_profile",
                           Environment.DEV, 
                           modules = mutableSetOf(Modules.MomentsApi))

val tealium = Tealium.create("your_instance_name", config)

ステップ2: Context APIリージョンを構成

momentsAPIRegionプロパティを構成して、AudienceStreamプロファイルが存在するリージョンを指定します。確実に一致させる必要があります。不明な場合はアカウントマネージャーに確認してください。

config.momentsAPIRegion = .us_east // 例：リージョン

config.momentsApiRegion = MomentsApiRegion.UsEast // 例：リージョン

Customオプションは将来の使用のためのものであり、Tealiumアカウントマネージャーから明確な指示がない限り使用しないでください。

config.momentsAPIRegion = .custom("custom_region_placeholder")

config.momentsApiRegion = MomentsApiRegion.Custom("custom_region_placeholder")

利用可能なリージョンの表は以下の通りです：

Swift	Kotlin	Underlying value
germany	MomentsApiRegion.Germany	eu-central-1
us_east	MomentsApiRegion.UsEast	us-east-1
sydney	MomentsApiRegion.Sydney	ap-southeast-2
oregon	MomentsApiRegion.Oregon	us-west-2
tokyo	MomentsApiRegion.Tokyo	ap-northeast-1
hong_kong	MomentsApiRegion.HongKong	ap-east-1
custom	MomentsApiRegion.Custom	Custom String

ステップ3: 追加のセキュリティのためにリファラーを構成

リファラーオプションは追加のセキュリティのために使用できます。Tealium UIの「ドメイン許可リスト」と一致する必要があります。

config.momentsAPIReferrer = "https://your.custom.referrer.url"

config.momentsApiReferrer = "https://your.custom.referrer.url"

ステップ4: エンジンレスポンスを取得

アプリユーザーに関する最新情報を取得するために、Context APIエンジンレスポンスを取得する関数を実装します。このメソッドを必要な時に呼び出します。

現在のアプリユーザーのTealium訪問IDは、Context APIリクエストの一部として自動的に送信されます。

import TealiumMomentsAPI

func fetchMoments(engineId: String, completion: @escaping (Result<EngineResponse, Error>) -> Void) {
    tealium?.momentsAPI?.fetchEngineResponse(
        engineID: engineId,
        completion: { engineResponse in
            switch engineResponse {
            case .success(let response):
                print("String attributes: \(response.strings ?? [])")
                print("Boolean attributes: \(response.booleans ?? [])")
                print("Audiences: \(response.audiences ?? [])")
                print("Date attributes: \(response.dates ?? [:])")
                print("Badges: \(response.badges ?? [])")
                print("Numbers: \(response.numbers ?? [:])")
            case .failure(let error):
                print("Error fetching moments: \(error.localizedDescription)")
            }
            completion(engineResponse)
        }
    )
}

import android.util.Log
import com.tealium.momentsapi.EngineResponse
import com.tealium.momentsapi.ErrorCode
import com.tealium.momentsapi.ResponseListener
import com.tealium.core.Tealium

fun fetchMoments(engineId: String, responseListener: ResponseListener<EngineResponse>) {
    val tealiumInstance = Tealium["your_instance_name"]
    tealiumInstance?.momentsApi?.fetchEngineResponse(engineId, object : ResponseListener<EngineResponse> {
        override fun success(data: EngineResponse) {
            Log.d("MomentsAPI", "String attributes: ${data.strings}")
            Log.d("MomentsAPI", "Boolean attributes: ${data.booleans}")
            Log.d("MomentsAPI", "Audiences: ${data.audiences}")
            Log.d("MomentsAPI", "Date attributes: ${data.dates}")
            Log.d("MomentsAPI", "Badges: ${data.badges}")
            Log.d("MomentsAPI", "Numbers: ${data.numbers}")

            responseListener.success(data)
        }

        override fun failure(errorCode: ErrorCode, message: String) {
            Log.e("MomentsAPI", "Error fetching moments: $errorCode - $message")
            responseListener.failure(errorCode, message)
        }
    })
}