コールバックの設定

SDKがAdjustに情報を送信する時に関数をトリガーするコールバックを設定します。コールバックはセッションとイベントに対して設定できます。

セッションコールバック

SDKがセッション情報を送信した時に関数をトリガーする、セッションコールバックを設定します。 Success コールバックと failure コールバックが作成できます。 Success コールバックは、SDKが情報をAdjustのサーバーに送信する時にトリガーします。 Failure コールバックは、SDKが情報を送信している間に問題が発生した際にトリガーします。

セッションコールバックは、レスポンスデータオブジェクトにアクセスできます。そのプロパティをコールバック関数内で使用することが可能です。

プロパティ	データタイプ	説明
`Message`	`String`	サーバーからのメッセージまたはSDKのエラーログ
`Timestamp`	`String`	Adjustのサーバーからのタイムスタンプ
`Adid`	`String`	Adjustから提供されるユニークデバイスID
`JsonResponse`	`Map<String, Object>`	サーバーからのレスポンスを含むJSONオブジェクト
`WillRetry`	`bool`	失敗したパッケージの再送を試みるかどうかを示します。

Successコールバック

typedef void SessionSuccessCallback(AdjustSessionSuccess successData);
SessionSuccessCallback? sessionSuccessCallback;

SDKがセッションを記録した時に関数をトリガーする、successコールバックを設定します。

1
AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
2

3
config.sessionSuccessCallback = (AdjustSessionSuccess sessionSuccessData) {
4
   print('[Adjust]: Session recording success!');
5

6
   if (sessionSuccessData.message != null) {
7
      print('[Adjust]: Message: ' + sessionSuccessData.message);
8
   }
9
   if (sessionSuccessData.timestamp != null) {
10
      print('[Adjust]: Timestamp: ' + sessionSuccessData.timestamp);
11
   }
12
   if (sessionSuccessData.adid != null) {
13
      print('[Adjust]: Adid: ' + sessionSuccessData.adid);
14
   }
15
   if (sessionSuccessData.jsonResponse != null) {
16
      print('[Adjust]: JSON response: ' + sessionSuccessData.jsonResponse);
17
   }
18
};
19

20
Adjust.start(adjustConfig);

例

この例では、SDKがAdjustにセッションデータを送信した時刻のタイムスタンプを表示するsessionSuccessCallbackを登録する方法を示しています。

1
AdjustConfig myConfig = new AdjustConfig('{Your App Token}', AdjustEnvironment.sandbox);
2
//...
3
myConfig.sessionSuccessCallback = (AdjustSessionSuccess sessionSuccessData) {
4
   print('Session measured at ' + sessionSuccessData.timestamp);
5
}
6
//...
7
Adjust.start(myConfig);

Failureコールバック

typedef void SessionFailureCallback(AdjustSessionFailure failureData);
SessionFailureCallback? sessionFailureCallback;

SDKがセッションの記録に失敗した時に関数をトリガーする、failureコールバックを設定します。

1
AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
2

3
config.sessionFailureCallback = (AdjustSessionFailure sessionFailureData) {
4
   print('[Adjust]: Session recording failure!');
5

6
   if (sessionFailureData.message != null) {
7
      print('[Adjust]: Message: ' + sessionFailureData.message);
8
   }
9
   if (sessionFailureData.timestamp != null) {
10
      print('[Adjust]: Timestamp: ' + sessionFailureData.timestamp);
11
   }
12
   if (sessionFailureData.adid != null) {
13
      print('[Adjust]: Adid: ' + sessionFailureData.adid);
14
   }
15
   if (sessionFailureData.willRetry != null) {
16
      print('[Adjust]: Will retry: ' + sessionFailureData.willRetry.toString());
17
   }
18
   if (sessionFailureData.jsonResponse != null) {
19
      print('[Adjust]: JSON response: ' + sessionFailureData.jsonResponse);
20
   }
21
};
22

23
Adjust.start(adjustConfig);

例

この例では、SDKがセッションデータの送信に失敗した理由を表示するsessionFailureCallbackを登録する方法を示しています。

1
AdjustConfig myConfig = new AdjustConfig('{Your App Token}', AdjustEnvironment.sandbox);
2
//...
3
myConfig.sessionFailureCallback = (AdjustSessionFailure sessionFailureData) {
4
   print('Session failure due to ' + sessionFailureData.message);
5
}
6
//...
7
Adjust.start(myConfig);

イベントコールバック

SDKがイベント情報を送信した時に関数をトリガーする、イベントコールバックを設定します。 Success コールバックと failure コールバックが作成できます。 Success コールバックは、SDKが情報をAdjustのサーバーに送信する時にトリガーします。 Failure コールバックは、SDKが情報を送信している間に問題が発生した際にトリガーします。

イベントコールバックは、レスポンスデータオブジェクトにアクセスできます。そのプロパティをコールバック関数内で使用することが可能です。

プロパティ	データタイプ	説明
`Message`	`String`	サーバーからのメッセージまたはSDKのエラーログ
`Timestamp`	`String`	Adjustのサーバーからのタイムスタンプ
`Adid`	`String`	Adjustから提供されるユニークデバイスID
`JsonResponse`	`Map<String, Object>`	サーバーからのレスポンスを含むJSONオブジェクト
`EventToken`	`String`	イベントトークン
`CallbackId`	`String`	イベントオブジェクトに設定されたカスタムコールバックID
`WillRetry`	`bool`	失敗したパッケージの再送を試みるかどうかを示します。

Successコールバック

typedef void EventSuccessCallback(AdjustEventSuccess successData);
EventSuccessCallback? eventSuccessCallback;

SDKがイベントを記録した時に関数をトリガーする、successコールバックを設定します。

1
AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
2

3
config.eventSuccessCallback = (AdjustEventSuccess eventSuccessData) {
4
   print('[Adjust]: Event recording success!');
5

6
   if (eventSuccessData.eventToken != null) {
7
      print('[Adjust]: Event token: ' + eventSuccessData.eventToken);
8
   }
9
   if (eventSuccessData.message != null) {
10
      print('[Adjust]: Message: ' + eventSuccessData.message);
11
   }
12
   if (eventSuccessData.timestamp != null) {
13
      print('[Adjust]: Timestamp: ' + eventSuccessData.timestamp);
14
   }
15
   if (eventSuccessData.adid != null) {
16
      print('[Adjust]: Adid: ' + eventSuccessData.adid);
17
   }
18
   if (eventSuccessData.callbackId != null) {
19
      print('[Adjust]: Callback ID: ' + eventSuccessData.callbackId);
20
   }
21
   if (eventSuccessData.jsonResponse != null) {
22
      print('[Adjust]: JSON response: ' + eventSuccessData.jsonResponse);
23
   }
24
};
25

26
Adjust.start(adjustConfig);

例

この例では、SDKがAdjustにセッションデータを送信した時刻のタイムスタンプを表示するeventSuccessCallbackを登録する方法を示しています。

1
AdjustConfig myConfig = new AdjustConfig('{Your App Token}', AdjustEnvironment.sandbox);
2
//...
3
myConfig.eventSuccessCallback = (AdjustEventSuccess eventSuccessData) {
4
   print('Session measured at ' + eventSuccessData.timestamp);
5
}
6
//...
7
Adjust.start(myConfig);

Failureコールバック

typedef void EventFailureCallback(AdjustEventFailure failureData);
EventFailureCallback? eventFailureCallback;

SDKがセッションの記録に失敗した時に関数をトリガーする、failureコールバックを設定します。

1
AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
2

3
config.eventFailureCallback = (AdjustEventFailure eventFailureData) {
4
   print('[Adjust]: Event recording failure!');
5

6
   if (eventFailureData.eventToken != null) {
7
      print('[Adjust]: Event token: ' + eventFailureData.eventToken);
8
   }
9
   if (eventFailureData.message != null) {
10
      print('[Adjust]: Message: ' + eventFailureData.message);
11
   }
12
   if (eventFailureData.timestamp != null) {
13
      print('[Adjust]: Timestamp: ' + eventFailureData.timestamp);
14
   }
15
   if (eventFailureData.adid != null) {
16
      print('[Adjust]: Adid: ' + eventFailureData.adid);
17
   }
18
   if (eventFailureData.callbackId != null) {
19
      print('[Adjust]: Callback ID: ' + eventFailureData.callbackId);
20
   }
21
   if (eventFailureData.willRetry != null) {
22
      print('[Adjust]: Will retry: ' + eventFailureData.willRetry.toString());
23
   }
24
   if (eventFailureData.jsonResponse != null) {
25
      print('[Adjust]: JSON response: ' + eventFailureData.jsonResponse);
26
   }
27
};
28

29
Adjust.start(adjustConfig);

例

この例では、SDKがセッションデータの送信に失敗した理由を表示するeventFailureCallbackを登録する方法を示しています。

1
AdjustConfig myConfig = new AdjustConfig('{Your App Token}', AdjustEnvironment.sandbox);
2
//...
3
myConfig.eventFailureCallback = (AdjustEventFailure eventFailureData) {
4
   print('Session failure due to ' + eventFailureData.message);
5
}
6
//...
7
Adjust.start(myConfig);