Tealium(ティリウム)
Tealiumクラスは、すべてのモジュールのメインAPIエントリーポイントとして機能します。
クラス: Tealium
以下は、iOS(Swift)のTealium
クラスの一般的に使用されるメソッドの概要です。
メソッド/プロパティ | 説明 |
---|---|
cancelTimedEvent() |
タイマーをキャンセルします。 |
clearStoredVisitorIds() |
visitorIdsのキャッシュを削除し、resetVisitorId を呼び出します。 |
clearAllTimedEvents() |
以前に開始されたすべてのタイマーイベントをクリアします。 |
decorateUrl() |
URLにAdobe ECIDパラメータを追加します。 |
disable() |
Tealiumライブラリを無効にします。 |
flushQueue() |
キューに入れられたディスパッチをすぐに送信します。 |
gatherTrackData() |
カスタムデータレイヤーの値とコレクターモジュールのデータレイヤーの値をすべて返します。 |
getTagManagementWebView() |
TagManagement WebViewを返します。 |
joinTrace() |
指定したIDでトレースに参加します。 |
leaveTrace() |
以前に参加したトレースを終了し、訪問者セッションを終了します。 |
linkECIDToKnownIdentifier |
現在のECIDを既知のセカンダリID(電子メールアドレスなど)にリンクします。 |
onVisitorId |
visitorId の変更を通知します。 |
resetVisitor() |
次のトラッキングコールで新しいvisitor ECIDを取得してリセットします。 |
resetVisitorId() |
ユーザーの新しいvisitor IDを生成します。 |
startTimedEvent() |
指定した名前でタイマーイベントを開始します。 |
stopTimedEvent() |
タイマーを停止し、timed_event トラッキングコールをトリガーします。 |
Tealium() |
新しいTealium オブジェクトのコンストラクターです。 |
track() |
関連するデータを持つイベントをトラッキングし、必要に応じてコールバック関数をトリガーします。 |
visitor |
完全なAdobeVisitor インスタンスを返します。 |
visitorId |
ランダムに生成された一意の永続的なvisitor IDを返します。 |
cancelTimedEvent()
タイマーイベントのタイマーをキャンセルします。タイマーイベントはトラッキングされません。
tealium?.cancelTimedEvent(name: "TIMED_EVENT_NAME")
パラメーター | タイプ | 説明 |
---|---|---|
name |
String |
タイマーイベントの名前 |
clearAllTimedEvents()
以前に開始されたすべてのタイマーイベントをクリアします。タイマーイベントはトラッキングされません。
tealium?.clearAllTimedEvents()
clearStoredVisitorIds()
以前に保存されたすべてのvisitor IDとハッシュ化された顧客識別子をクリアします。
tealium?.clearStoredVisitorIds()
decorateUrl()
入力URLにAdobe ECIDクエリパラメータを追加します。
decorateUrl(_ url: URL, completion: ((URL) → Void)
パラメーター | タイプ | 説明 |
---|---|---|
url |
URL |
デコレートするURL |
completion |
URL -> Void |
デコレートされたURLで呼び出されるブロック。 |
例:
var tealium: Tealium?
...
let url = URL(string: "https://www.tealium.com")!
tealium?.adobeVisitorApi?.decorateUrl(url) { newUrl in
// 新しいURLを使用する
}
disable()
Tealiumライブラリを無効にし、すべてのモジュール参照を削除します。必要な場合は、新しいTealiumインスタンスを作成して再度有効にします。
tealium?.disable()
flushQueue()
キューに入れられたすべてのディスパッチをすぐに送信します。同意マネージャなどのDispatchValidator
によってリクエストがブロックされる場合があります。
tealium?.disable()
gatherTrackData()
現在のカスタムデータレイヤーの値とコレクターモジュールのデータレイヤーの値をすべて取得します。結果はキャッシュされ、非同期に返されます。最新の値を取得するには、retrieveCachedData
をfalse
に設定します。返された値を処理するために、完了ハンドラを使用します。カスタムデータレイヤーの値は、カスタムキーを使用して直接参照し、コレクターモジュールの値はTealiumDataKey.
を使用して参照します。
tealium?.gatherTrackData(retreiveCachedData: false, completion: { allData in
let lifecycleTotalWakeCount = allData[TealiumDataKey.totalWakeCount]
let visitorId = allData[TealiumDataKey.visitorId]
let userLanguage = allData["user_language"]
})
参照: Tealium.dataLayer.all
も参照してください。
getTagManagementWebView()
(v2.10.0で新規追加)
TagManagement WebViewを返します。クライアントはisInspectable
フラグを設定してXCode 14.3+でデバッグできます。
他のWebviewオブジェクトの使用(別のWebページの読み込みなど)は、予測不可能な動作を引き起こす可能性があるため、強く推奨されません。
tealium?.getTagManagementWebView { webView in
if #available(iOS 16.4, *) {
webView.isInspectable = true // XCode 14.3+およびiOS 16.4+でTagManagement Webviewを検査するために使用します。
}
}
joinTrace()
指定したIDでトレースに参加します。leaveTrace()
が呼び出されるまで、トレースはアプリのセッションの間有効です。Tealium Customer Data Hubのトレース機能について詳しくは、ドキュメントを参照してください。
joinTrace(traceId: String)
パラメーター | タイプ | 説明 | 例 |
---|---|---|---|
traceId |
String |
Traceツールから取得したトレースID | "12345" |
leaveTrace()
以前に参加したトレースを終了し、訪問者セッションを終了します。トレース訪問者セッションを保持する場合は、オプションのパラメーターを指定します。
tealium?.leaveTrace(killVisitorSession: false)
パラメーター | タイプ | 説明 | 例 |
---|---|---|---|
killVisitorSession |
Bool |
(オプション)パラメーターが指定されていない場合はtrue に設定します。訪問者セッションを終了したくない場合はfalse に設定します。デフォルトはtrue です。 |
false |
linkECIDToKnownIdentifier()
現在のECIDを既知のセカンダリID(電子メールアドレスなど)にリンクします。
linkECIDToKnownIdentifier(
_ knownID: String,
adobeDataProviderId: String,
authState: AdobeVisitorAuthState?,
completion: ((Result<AdobeVisitor, Error>) → Void)
パラメーター | タイプ | 説明 |
---|---|---|
knownId |
String |
既知の識別子。 |
adobeDataProviderId |
String |
Adobeデータプロバイダー識別子。 |
authState |
AdobeVisitorAuthState |
認証状態。 |
completion |
Result<AdobeVisitor, Error> |
Adobeのレスポンスリスナー。 |
例:
var tealium: Tealium?
...
tealium?.adobeVisitorApi?.linkECIDToKnownIdentifier(
"myidentifier", adobeDataProviderId: "123456", .unknown
)
onVisitorId
visitor IDの変更を通知します。
let subscription = tealium?.onVisitorId.subscribe { newVisitor in
// visitorの変更を処理する
}
resetVisitor()
次のトラッキングコールで新しいvisitor ECIDを取得してリセットします。
resetVisitor()
例:
var tealium: Tealium?
//...
tealium?.adobeVisitorApi?.resetVisitor()
resetVisitorId()
ユーザーの新しいvisitor IDを生成します。
tealium?.resetVisitorId()
startTimedEvent()
指定した名前でタイマーイベントを開始します。同じイベント名でこのメソッドが再度呼び出された場合、イベントが終了またはキャンセルされていない場合は無視されます。イベントの開始時刻は永続化されません。
イベント名と一緒にオプションのデータが渡された場合、タイマーがstopTimedEvent()
呼び出しで停止されると、トラックコールに追加されます。
tealium.startTimedEvent(name: "TIMED_EVENT_NAME", with: ["custom_key": "custom_value"])
パラメーター | タイプ | 説明 |
---|---|---|
name |
String |
タイマーイベントの名前 |
["custom_key": "custom_value"] (オプション) |
Map |
データレイヤーでトラッキングするキーと値のオブジェクト |
stopTimedEvent()
タイマーイベントのタイマーを停止し、timed_event
トラッキングコールをトリガーします。
tealium?.stopTimedEvent(name: "TIMED_EVENT_NAME")
パラメーター | タイプ | 説明 |
---|---|---|
name |
String |
タイマーイベントの名前 |
Tealium()
新しいTealium
オブジェクトのコンストラクターです。
Tealium(config: TealiumConfig, completion: Closure)
パラメーター | タイプ | 説明 |
---|---|---|
config |
TealiumConfig |
アカウントの詳細を含むTealiumConfig オブジェクトでTealiumオブジェクトを初期化します。 |
completion |
Closure |
(オプション)初期化が完了したときに呼び出される完了クロージャー()-> Void )? |
track()
TealiumView
またはTealiumEvent
タイプを使用して、スクリーンビューまたはイベントをトラッキングします。
let tealView = TealiumView("VIEW_NAME", dataLayer: ["key": "value"])
tealium?.track(tealView)
パラメーター | タイプ | 説明 | 例 |
---|---|---|---|
viewName |
String |
トラッキングするスクリーンの名前 | viewName: "Buy Now" |
dataLayer |
Dictionary |
トラッキングするイベントに関連するデータのキーと値のオブジェクト | data: data: ["product_id" : ["widget123"]] |
let tealEvent = TealiumEvent("EVENT_NAME", dataLayer: ["key": "value"])
tealium?.track(tealEvent)
viewName
に渡された値は、データレイヤーに変数tealium_event
として表示されます。
パラメーター | タイプ | 説明 | 例 |
---|---|---|---|
eventName |
String |
トラッキングするイベントの名前 | eventName: "Buy Now" |
dataLayer |
Dictionary |
トラッキングするイベントに関連するデータのキーと値のオブジェクト | data: data: ["product_id" : ["widget123"]] |
eventName
に渡された値は、データレイヤーに変数tealium_event
として表示されます。
visitor
完全なAdobeVisitor
インスタンスを返します。
var tealium: Tealium?
//...
let visitor = tealium?.adobeVisitorApi?.visitor
let id: String? = visitor?.experienceCloudId
let nextRefresh: Date? = visitor?.nextRefresh
let blob: String? = visitor?.blob
let region: String? = visitor?.dcsRegion
let ttl: String? = visitor?.idSyncTTL
visitorId
ランダムに生成された一意の永続的なvisitor IDを返します。
let visitorId: String? = tealium.visitorId
最終更新日 :: 2024年May月15日