ライフサイクル追跡モジュール
既存の5.x実装のTealium for iOSにアプリのライフサイクル追跡イベントを提供します。
インストール
ライフサイクル追跡モジュールはあなたのアプリに追加する必要があります。Tealium for iOSライブラリと同様に、CocoaPodsまたは手動でモジュールをインストールします。
任意の抽象クラス(TealiumHelper.h
のような)で、@import TealiumIOS
を@import TealiumIOSLifecycle
に置き換えます。
CocoaPods
CocoaPodsでライフサイクル追跡モジュールをインストールするには、Podfileに以下を追加します:
pod 'TealiumIOSLifecycle'
手動
ライフサイクル追跡モジュールを手動でインストールするには、以下の手順を実行します:
-
ライフサイクル追跡モジュールをダウンロードします。
-
TealiumIOSLifecycle.framework
ファイルをプロジェクトに追加します(Embedded Binariesセクションに)。
トラッキング
モジュールは以下のライフサイクルイベントを追跡します:
ライフサイクルイベント | 説明 |
---|---|
launch |
アプリが起動されました |
sleep |
アプリがバックグラウンドに送られました |
wake |
アプリがフォアグラウンドに送られました |
none |
イベントに追加されたデータがライフサイクルイベントに関連付けられていない場合 |
これらの値はlifecycle_type
変数で示されます。
自動トラッキング
ライフサイクル追跡モジュールを構成して、標準のUIApplication
通知を自動的にリッスンし、launch
、wake
、sleep
イベントを自動的にトリガーします。
ライフサイクル追跡を削除するには、TealiumIOSLifecycle.framework
をプロジェクトからアンリンクまたは削除します。
起動イベント
UIApplicationDidFinishLaunchingNotification
の検出時に生成されます。
スリープイベント
UIApplicationWillResignActiveNotification
の検出時に生成されます。
ウェイクイベント
UIApplicationWillEnterForegroundNotification
の検出時に生成されます。
手動トラッキング
特定のライフサイクルパラダイムや非標準的なライフサイクル追跡に利用可能です。手動でライフサイクルイベントを追跡するには、setLifecycleAutotrackingIsEnabled
をNO
に構成してライフサイクルの自動追跡を無効にします。
起動イベント
launch
イベントを手動で追跡するには、以下を呼び出します:
[[Tealium instanceForKey:@"(uniqueInstanceId)"] launch];
スリープイベント
sleep
イベントを手動で追跡するには、以下を呼び出します:
[[Tealium instanceForKey:@"(uniqueInstanceId)"] sleep];
ウェイクイベント
wake
イベントを手動で追跡するには、以下を呼び出します:
[[Tealium instanceForKey:@"(uniqueInstanceId)"] wake];
データレイヤー
ライフサイクル追跡モジュールは以下のデータレイヤー変数を追加します:
変数 | タイプ | 説明 | 例 | イベント |
---|---|---|---|---|
lifecycle_ dayofweek_local |
Number |
コールが行われたローカルの曜日、例えば1=日曜日、2=月曜日 | 2 |
全て |
lifecycle_ dayssincelaunch |
Number |
最初の起動からの日数(整数で増加) | 23 |
全て |
lifecycle_ dayssinceupdate |
Number |
最後に検出されたアプリバージョンの更新からの日数(整数で増加) | 46 |
全て |
lifecycle_ dayssincelastwake |
Number |
最後に検出されたウェイクからの日数(整数で増加) | 1 |
全て |
lifecycle_ diddetectcrash |
Boolean |
前回のスリープイベントが欠落しているため、クラッシュが推測されます(ウェイクイベントの後に起動イベントがある場合のみ存在します) | [true , false ] |
起動 |
lifecycle_ firstlaunchdate |
String |
最初に検出された起動/ウェイクのGMTタイムスタンプ。Zulu時間からのISO8601形式 | "2013-07-11T17:55:04Z" |
全て |
lifecycle_ firstlaunchdate_ MMDDYYYY |
String |
MM/DD/YYYY形式でフォーマットされたGMTタイムスタンプ | "01/17/2012" |
全て |
lifecycle_ hourofday_local |
String |
コールが行われたローカルの時間(24時間形式) | "12" |
全て |
lifecycle_ isfirstlaunch |
Boolean |
コールが最初の起動コールである場合のみ存在します | [true , false ] |
起動 |
lifecycle_ isfirstlaunchupdate |
Boolean |
検出された更新後の最初の起動である場合のみ存在します | [true , false ] |
起動 |
lifecycle_ isfirstwakemonth |
Boolean |
コールが月の最初の起動/ウェイクである場合のみ存在します | [true , false ] |
起動, ウェイク |
lifecycle_ isfirstwaketoday |
Boolean |
コールが日の最初の起動/ウェイクである場合のみ存在します | [true , false ] |
起動, ウェイク |
lifecycle_ launchcount |
Number |
あなたのアプリのこのバージョンの起動の総数(最後の更新以降) | 3 |
全て |
lifecycle_ secondsawake |
Number |
アプリが最後のウェイク/起動以降にアクティブな状態にあった全秒数(lifecycle_type:sleep またはlifecycle_type:terminate コールでのみ送信) |
30 |
全て |
lifecycle_ priorsecondsawake |
Number |
最後の起動以降にアプリがアクティブな状態にあった全秒数 - すべての前のウェイクからの合計(lifecycle_type:launch コールでのみ送信) |
126 |
全て |
lifecycle_ sleepcount |
Number |
あなたのアプリがスリープに入った回数の総数(更新されるとリセット) | 5 |
全て |
lifecycle_ totalcrashcount |
Number |
インストール以降にカウントされたクラッシュの総数(アプリが削除されるとのみリセット) | 21 |
全て |
lifecycle_ totallaunchcount |
Number |
インストール以降の起動の総数(アプリが削除されるとのみリセット) | 3 |
全て |
lifecycle_ totalsecondsawake |
Number |
アプリがインストール以降にウェイク/アクティブ状態にあった秒数の総数(アプリが削除されるとのみリセット) | 36 |
全て |
lifecycle_ totalsleepcount |
Number |
アプリがインストール以降にバックグラウンドに入った回数の総数(アプリが削除されるとのみリセット) | "400" |
全て |
lifecycle_ totalwakecount |
Number |
インストール以降の起動 + ウェイクの総数(アプリが削除されるとのみリセット) | 563 |
全て |
lifecycle_type |
String |
ライフサイクルコールのタイプ | ["launch" , "wake" , "sleep" ] |
全て |
lifecycle_ updatelaunchdate |
String |
バージョン更新が検出された後の最初のウェイク/起動のGMTタイムスタンプ | "2014-09-08T18:10:01Z" |
全て |
lifecycle_ wakecount |
Number |
あなたのアプリのこのバージョンの起動 + ウェイクの総数(更新されるとリセット) | 29 |
全て |
最終更新日 :: 2018年November月7日