adjust-icon

コールバックの設定

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

セッションコールバック

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

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

プロパティデータタイプ説明
messageStringサーバーからのメッセージまたはSDKのエラーログ
timestampStringAdjustのサーバーからのタイムスタンプ
jsonResponseStringサーバーからのレスポンスを含むJSONオブジェクト
willRetrybool失敗したパッケージの再送を試みるかどうかを示します。

Successコールバック

プロパティ宣言
typedef void SessionSuccessCallback(AdjustSessionSuccess successData);
SessionSuccessCallback? sessionSuccessCallback;

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

AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
config.sessionSuccessCallback = (AdjustSessionSuccess sessionSuccessData) {
print('[Adjust]: Session recording success!');
if (sessionSuccessData.message != null) {
print('[Adjust]: Message: ' + sessionSuccessData.message);
}
if (sessionSuccessData.timestamp != null) {
print('[Adjust]: Timestamp: ' + sessionSuccessData.timestamp);
}
if (sessionSuccessData.adid != null) {
print('[Adjust]: Adid: ' + sessionSuccessData.adid);
}
if (sessionSuccessData.jsonResponse != null) {
print('[Adjust]: JSON response: ' + sessionSuccessData.jsonResponse);
}
};
Adjust.initSdk(adjustConfig);

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

AdjustConfig myConfig = new AdjustConfig('{Your App Token}', AdjustEnvironment.sandbox);
//...
myConfig.sessionSuccessCallback = (AdjustSessionSuccess sessionSuccessData) {
print('Session measured at ' + sessionSuccessData.timestamp);
}
//...
Adjust.initSdk(myConfig);

Failureコールバック

プロパティ宣言
typedef void SessionFailureCallback(AdjustSessionFailure failureData);
SessionFailureCallback? sessionFailureCallback;

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

AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
config.sessionFailureCallback = (AdjustSessionFailure sessionFailureData) {
print('[Adjust]: Session recording failure!');
if (sessionFailureData.message != null) {
print('[Adjust]: Message: ' + sessionFailureData.message);
}
if (sessionFailureData.timestamp != null) {
print('[Adjust]: Timestamp: ' + sessionFailureData.timestamp);
}
if (sessionFailureData.adid != null) {
print('[Adjust]: Adid: ' + sessionFailureData.adid);
}
if (sessionFailureData.willRetry != null) {
print('[Adjust]: Will retry: ' + sessionFailureData.willRetry.toString());
}
if (sessionFailureData.jsonResponse != null) {
print('[Adjust]: JSON response: ' + sessionFailureData.jsonResponse);
}
};
Adjust.initSdk(adjustConfig);

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

AdjustConfig myConfig = new AdjustConfig('{Your App Token}', AdjustEnvironment.sandbox);
//...
myConfig.sessionFailureCallback = (AdjustSessionFailure sessionFailureData) {
print('Session failure due to ' + sessionFailureData.message);
}
//...
Adjust.initSdk(myConfig);

イベントコールバック

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

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

プロパティデータタイプ説明
messageStringサーバーからのメッセージまたはSDKのエラーログ
timestampStringAdjustのサーバーからのタイムスタンプ
jsonResponseStringサーバーからのレスポンスを含むJSONオブジェクト
eventTokenStringイベントトークン
callbackIdStringイベントオブジェクトに設定されたカスタムコールバックID
willRetrybool失敗したパッケージの再送を試みるかどうかを示します。

Successコールバック

プロパティ宣言
typedef void EventSuccessCallback(AdjustEventSuccess successData);
EventSuccessCallback? eventSuccessCallback;

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

AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
config.eventSuccessCallback = (AdjustEventSuccess eventSuccessData) {
print('[Adjust]: Event recording success!');
if (eventSuccessData.eventToken != null) {
print('[Adjust]: Event token: ' + eventSuccessData.eventToken);
}
if (eventSuccessData.message != null) {
print('[Adjust]: Message: ' + eventSuccessData.message);
}
if (eventSuccessData.timestamp != null) {
print('[Adjust]: Timestamp: ' + eventSuccessData.timestamp);
}
if (eventSuccessData.adid != null) {
print('[Adjust]: Adid: ' + eventSuccessData.adid);
}
if (eventSuccessData.callbackId != null) {
print('[Adjust]: Callback ID: ' + eventSuccessData.callbackId);
}
if (eventSuccessData.jsonResponse != null) {
print('[Adjust]: JSON response: ' + eventSuccessData.jsonResponse);
}
};
Adjust.initSdk(adjustConfig);

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

AdjustConfig myConfig = new AdjustConfig('{Your App Token}', AdjustEnvironment.sandbox);
//...
myConfig.eventSuccessCallback = (AdjustEventSuccess eventSuccessData) {
print('Session measured at ' + eventSuccessData.timestamp);
}
//...
Adjust.initSdk(myConfig);

Failureコールバック

プロパティ宣言
typedef void EventFailureCallback(AdjustEventFailure failureData);
EventFailureCallback? eventFailureCallback;

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

AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
config.eventFailureCallback = (AdjustEventFailure eventFailureData) {
print('[Adjust]: Event recording failure!');
if (eventFailureData.eventToken != null) {
print('[Adjust]: Event token: ' + eventFailureData.eventToken);
}
if (eventFailureData.message != null) {
print('[Adjust]: Message: ' + eventFailureData.message);
}
if (eventFailureData.timestamp != null) {
print('[Adjust]: Timestamp: ' + eventFailureData.timestamp);
}
if (eventFailureData.adid != null) {
print('[Adjust]: Adid: ' + eventFailureData.adid);
}
if (eventFailureData.callbackId != null) {
print('[Adjust]: Callback ID: ' + eventFailureData.callbackId);
}
if (eventFailureData.willRetry != null) {
print('[Adjust]: Will retry: ' + eventFailureData.willRetry.toString());
}
if (eventFailureData.jsonResponse != null) {
print('[Adjust]: JSON response: ' + eventFailureData.jsonResponse);
}
};
Adjust.initSdk(adjustConfig);

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

AdjustConfig myConfig = new AdjustConfig('{Your App Token}', AdjustEnvironment.sandbox);
//...
myConfig.eventFailureCallback = (AdjustEventFailure eventFailureData) {
print('Session failure due to ' + eventFailureData.message);
}
//...
Adjust.initSdk(myConfig);