時間計測アクションを使用すると、アクションの開始から終了までのアプリ内時間と合計時間を測定できます。SDK は、各セッションの時間と、アクションが完了するまでにかかる、セッションをまたいだ合計時間を計算します。時間計測アクションを使用して、セグメントを定義し、購入までの時間、パスレベル、チェックアウトフローなどを比較することができます。
時間計測アクションでは、次の指標がレポートされます。
オプションのコールバックを使用すると、時間計測が完了した場合に、次の追加のアクションを実行できます。
ライブラリをプロジェクトに追加し、ライフサイクルを実装します。
詳しくは、コア実装とライフサイクルの「プロジェクトへの SDK と設定ファイルの追加」を参照してください。
ライブラリをインポートします。
#import "ADBMobile.h"
trackTimedActionStart
を呼び出し、時間計測アクション名とオプションのコンテキストデータを指定します。
[ADBMobile trackTimedActionStart:@"TimeUntilPurchase"
data:@{@"ExperienceName" : experience}];
(オプション)任意のタイミングでコンテキストデータを追加する場合は、時間計測アクション名を指定して trackTimedActionUpdate
を呼び出します。
[ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"
data:@{@"myapp.ImageLiked" : imageName}];
イベントが完了したら、trackTimedActionEnd
を呼び出し、時間計測アクション名と、すべてのデータを検索して時間を計算する TimedActionBlock
(コールバック)を渡します。
経過時間イベント指標は、自動レポート作成のためにモバイルソリューション変数に保存されます。
[ADBMobile trackTimedActionEnd:@"TimeUntilPurchase"
logic:nil];
時間計測アクション名に加え、アクション開始コールおよびアクション更新コールとともに追加のコンテキストデータを送信できます。
[ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"
data:@{@"myapp.ImageLiked" : imageName}];
コンテキストデータ値は、カスタム変数にマッピングする必要があります。
// Timed Action Start Example
[ADBMobile trackTimedActionStart:@"TimeUntilPurchase"
data:@{@"ExperienceName" : experience}];
// Timed Action Update Example
[ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"
data:@{@"ImageLiked" : imageName}];
// Timed Action End Example
[ADBMobile trackTimedActionEnd:@"TimeUntilPurchase"
logic:nil];
// Timed Action End Example with Callback
[ADBMobile trackTimedActionEnd:@"TimeUntilPurchase"
logic:^BOOL(NSTimeInterval inAppDuration,
NSTimeInterval totalDuration,
NSMutableDictionary *data) {
[data setObject:@"PurchaseItem" forKey:@"Item453"];
return YES; //return YES to send the hit, NO to cancel
}];