レガシーSDKからTealium Prismへのヘルパークラスの移行

// レガシー
let config = TealiumConfig(account: "ACCOUNT", profile: "PROFILE",
                           environment: "prod", dataSource: "DATASOURCE")
config.collectors = [Collectors.AppData, Collectors.Lifecycle]
config.dispatchers = [Dispatchers.Collect, Dispatchers.TagManagement]
tealium = Tealium(config: config) { _ in }

// Prism
let config = TealiumConfig(
    account: "ACCOUNT", profile: "PROFILE", environment: "prod",
    dataSource: "DATASOURCE",
    modules: [Modules.appData(), Modules.lifecycle(), Modules.collect()],
    settingsFile: "TealiumSettings",
    settingsUrl: "https://tags.tiqcdn.com/utag/ACCOUNT/PROFILE/prod/mobile_settings.json",
    forcingSettings: { $0.setMinLogLevel(.info) })
tealium = Tealium.create(config: config) { result in
    // Result<Tealium, Error>
}

// レガシー
val config = TealiumConfig(application, "ACCOUNT", "PROFILE", Environment.PROD,
    dataSourceId = "DATASOURCE",
    collectors = mutableSetOf(Collectors.App, Collectors.Device),
    dispatchers = mutableSetOf(Dispatchers.Collect, Dispatchers.TagManagement),
    modules = mutableSetOf(Modules.Lifecycle))
Tealium.create("main", config) { }

// Prism
val config = TealiumConfig.Builder(application, "ACCOUNT", "PROFILE", Environment.PROD,
        listOf(Modules.appData(), Modules.deviceData(), Modules.lifecycle(), Modules.collect()))
    .setDataSource("DATASOURCE")
    .setSettingsFile("tealium-settings.json")
    .setSettingsUrl("https://tags.tiqcdn.com/utag/ACCOUNT/PROFILE/prod/mobile_settings.json")
    .configureCoreSettings { it.setLogLevel(LogLevel.INFO) }
    .build()
tealium = Tealium.create(config) { result -> /* TealiumResult<Tealium> */ }

// レガシー
tealium.track(TealiumEvent("purchase", dataLayer: ["order_id": "123"]))
tealium.track(TealiumView("home"))

// Prism
tealium.track("purchase", data: ["order_id": "123"])
tealium.track("home", type: .view)

// レガシー
tealium.track(TealiumEvent("purchase", mapOf("order_id" to "123")))
tealium.track(TealiumView("home"))

// Prism
tealium.track("purchase", DataObject.create { put("order_id", "123") })
tealium.track("home", DispatchType.View, DataObject.EMPTY_OBJECT)

// レガシー
tealium.dataLayer.add(key: "user_tier", value: "gold", expiry: .forever)
tealium.dataLayer.delete(for: "user_tier")
let tier = tealium.dataLayer.all["user_tier"]

// Prism
tealium.dataLayer.put(key: "user_tier", value: "gold", expiry: .forever)
tealium.dataLayer.remove(key: "user_tier")
tealium.dataLayer.get(key: "user_tier", as: String.self).subscribe { result in
    // Result<String?, ModuleError<Error>>
}

// レガシー
tealium.dataLayer.putString("user_tier", "gold", Expiry.FOREVER)
tealium.dataLayer.remove("user_tier")
val tier = tealium.dataLayer.getString("user_tier")

// Prism
tealium.dataLayer.put("user_tier", "gold", Expiry.FOREVER)
tealium.dataLayer.remove("user_tier")
tealium.dataLayer.getString("user_tier").subscribe { result -> /* TealiumResult<String?> */ }

// レガシー
config.consentPolicy = .gdpr
tealium.consentManager?.userConsentStatus = .consented
tealium.consentManager?.userConsentCategories = [.analytics]

// Prism
final class MyCMPAdapter: CMPAdapter {
    let id = "my_cmp"
    let allPurposes: Set<String>? = ["analytics", "marketing"]
    let consentDecision: Observable<ConsentDecision?>   // emit on every user decision
}
config.enableConsentIntegration(with: MyCMPAdapter(), forcingConfiguration: {
    $0.addPurpose("analytics", dispatcherIds: ["Collect"])
})

// レガシー
config.consentManagerPolicy = ConsentPolicy.GDPR
tealium.consentManager.userConsentStatus = ConsentStatus.CONSENTED

// Prism
class MyCmpAdapter : CmpAdapter {
    override val id = "my_cmp"
    override val allPurposes: Set<String>? = set of("analytics", "marketing")
    override val consentDecision: Observable<ConsentDecision?> = TODO()
}
TealiumConfig.Builder(/* ... */)
    .enableConsentIntegration(MyCmpAdapter()) { it.addPurpose("analytics", listOf("Collect")) }

// レガシー
let id = tealium.visitorId
tealium.resetVisitorId()
config.visitorIdentityKey = "customer_id"

// プリズム
tealium.resetVisitorId()          // 新しいIDを結果として返す
tealium.clearStoredVisitorIds()
// アイデンティティの切り替え: forcingSettings: { $0.setVisitorIdentityKey("customer_id") }

// レガシー
val id = tealium.visitorId
tealium.resetVisitorId()
config.visitorIdentityKey = "customer_id"

// プリズム
tealium.resetVisitorId()          // SingleResult<String>
tealium.clearStoredVisitorIds()
// アイデンティティの切り替え: .configureCoreSettings { it.setVisitorIdentityKey("customer_id") }

// レガシー
let firebase = RemoteCommand(commandId: "firebase", description: "Firebase", type: .webview) { response in
    // Firebase SDKをレスポンスのペイロードで呼び出す
}
config.addRemoteCommand(firebase)

// プリズム: Dispatcherを実装し、そのModuleFactoryを `modules` に登録する
final class MyDispatcher: Dispatcher {
    let id = "my_vendor"
    let version = "1.0.0"
    func dispatch(_ data: [Dispatch], completion: @escaping ([Dispatch]) -> Void) -> any Disposable {
        // 各ディスパッチペイロードをベンダーSDKに送信し、成功したディスパッチで完了する
    }
    func updateConfiguration(_ configuration: DataObject) -> Self? { self }
    func shutdown() {}
}

// レガシー
tealium.remoteCommands?.add(FirebaseRemoteCommand(application))

// プリズム: 名前付きコマンドでCommandDispatcherを拡張し、そのModuleFactoryを `modules` に登録する
val commands = listOf(Command.synchronous("log_event") { payload -> /* ベンダーSDK呼び出し */ })

// レガシー
config.logLevel = .info            // info, debug, error, fault, silent

// プリズム
forcingSettings: { $0.setMinLogLevel(.debug) }   // trace, debug, info, warn, error, silent
config.loggerType = .custom(myLogHandler)        // オプション

// レガシー
config.logLevel = LogLevel.DEV     // DEV, QA, PROD, SILENT

// プリズム
.configureCoreSettings { it.setLogLevel(LogLevel.DEBUG) }  // TRACE, DEBUG, INFO, WARN, ERROR, SILENT
.setLogHandler(myLogHandler)                                // オプション

// レガシー
tealium.disable()

// プリズム
tealium.shutdown()   // 以降の呼び出しはTealiumError.instanceShutdownで失敗する

// レガシー
Tealium.destroy("main")

// プリズム
tealium.shutdown()   // または Tealium.shutdown("ACCOUNT-PROFILE")