時間計測アクション

時間計測アクションを使用すると、アクションの開始から終了までのアプリ内時間と合計時間を測定できます。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
                                     }];