设置回传 | Adjust Developer Hub

设置回传来在 SDK 向 Adjust 发送信息时触发函数。您可以针对会话和事件设置回传。

会话回传

设置会话回传来在 SDK 向 Adjust 发送会话信息时触发函数。您可以创建 success 回传和 failure 回传。SDK 向 Adjust 服务器发送信息时会触发 success 回传。SDK 向 Adjust 发送信息时出现问题会触发 failure 回传。

会话回传可访问响应数据对象。您可以在回传函数中使用其属性。

属性	数据类型	描述
`Message`	`string`	服务器信息或者 SDK 记录的错误信息。
`Timestamp`	`string`	来自 Adjust 服务器的时间戳。
`Adid`	`string`	由 Adjust 提供的设备唯一标识符。
`JsonResponse`	`object<string, object>`	带服务器响应的 JSON 对象。
`WillRetry`	`boolean`	指示包发送失败后是否再次尝试发送。

success 回传

public setSessionTrackingSucceededCallbackListener(
   callback: (sessionSuccess: AdjustSessionTrackingSuccess) => void
): void

设置 success 回传来在 SDK 记录到会话时触发函数。

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
//...
adjustConfig.setSessionTrackingSucceededCallbackListener(
   function (sessionSuccess) {
      // Printing all session success properties.
      console.log("Session recording succeeded!");
      console.log(sessionSuccess.message);
      console.log(sessionSuccess.timestamp);
      console.log(sessionSuccess.adid);
      console.log(sessionSuccess.jsonResponse);
   },
);
//...
Adjust.create(adjustConfig);

示例

该示例展示了如何创建回传函数 sessionSuccess，并将其注册为 success 回传。该函数会记录 SDK 记录到会话的时间戳。

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
//...
adjustConfig.setSessionTrackingSucceededCallbackListener(
   function (sessionSuccess) {
      console.log(sessionSuccess.timestamp);
   },
);
//...
Adjust.create(adjustConfig);

failure 回传

public setSessionTrackingFailedCallbackListener(
   callback: (sessionFailed: AdjustSessionTrackingFailure) => void
): void

设置 failure 回传来在 SDK 未能记录到会话时触发函数。

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
//...
adjustConfig.setSessionTrackingFailedCallbackListener(
   function (sessionFailure) {
      // Printing all session failure properties.
      console.log("Session recording failed!");
      console.log(sessionFailure.message);
      console.log(sessionFailure.timestamp);
      console.log(sessionFailure.adid);
      console.log(sessionFailure.willRetry);
      console.log(sessionFailure.jsonResponse);
   },
);
//...
Adjust.create(adjustConfig);

示例

该示例展示了如何创建回传函数 sessionFailure，并将其注册为 failure 回传。该函数会记录会话失败消息。

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
//...
adjustConfig.setSessionTrackingFailedCallbackListener(
   function (sessionFailure) {
      console.log(sessionFailure.message);
   },
);
//...
Adjust.create(adjustConfig);

事件回传

设置事件回传来在 SDK 向 Adjust 发送事件信息时触发函数。您可以创建 success 回传和 failure 回传。SDK 向 Adjust 服务器发送信息时会触发 success 回传。SDK 向 Adjust 发送信息时出现问题会触发 failure 回传。

事件回传可访问响应数据对象。您可以在回传函数中使用其属性。

属性	数据类型	描述
`Message`	`string`	服务器信息或者 SDK 记录的错误信息。
`Timestamp`	`string`	来自 Adjust 服务器的时间戳。
`Adid`	`string`	由 Adjust 提供的设备唯一标识符。
`EventToken`	`string`	事件识别码
`CallbackId`	`string`	事件对象上设置的自定义回传 ID
`JsonResponse`	`object<string, object>`	带服务器响应的 JSON 对象。
`WillRetry`	`boolean`	指示包发送失败后是否再次尝试发送。

success 回传

public setEventTrackingSucceededCallbackListener(
   callback: (eventSuccess: AdjustEventTrackingSuccess) => void
): void

设置 success 回传来在 SDK 记录到事件时触发函数。

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
//...
adjustConfig.setEventTrackingSucceededCallbackListener(function (eventSuccess) {
   // Printing all event success properties.
   console.log("Event recording succeeded!");
   console.log(eventSuccess.message);
   console.log(eventSuccess.timestamp);
   console.log(eventSuccess.eventToken);
   console.log(eventSuccess.callbackId);
   console.log(eventSuccess.adid);
   console.log(eventSuccess.jsonResponse);
});
//...
Adjust.create(adjustConfig);

示例

该示例展示了如何创建回传函数 eventSuccess，并将其注册为 success 回传。该函数会记录 SDK 记录到事件的时间戳。

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
//...
adjustConfig.setEventTrackingSucceededCallbackListener(function (eventSuccess) {
   console.log(eventSuccess.timestamp);
});
//...
Adjust.create(adjustConfig);

failure 回传

public setEventTrackingFailedCallbackListener(
   callback: (eventFailed: AdjustEventTrackingFailure) => void
): void

设置 failure 回传来在 SDK 未能记录到事件时触发函数。

const adjustConfig = new AdjustConfig(
   "{Your App Token}",
   AdjustConfig.EnvironmentSandbox,
);
adjustConfig.setLogLevel(AdjustLogLevel.Verbose);
adjustConfig.setEventTrackingFailedCallbackListener(function (eventFailure) {
   // Printing all event failure properties.
   console.log("Event recording failed!");
   console.log(eventFailure.message);
   console.log(eventFailure.timestamp);
   console.log(eventFailure.eventToken);
   console.log(eventFailure.callbackId);
   console.log(eventFailure.adid);
   console.log(eventFailure.willRetry);
   console.log(eventFailure.jsonResponse);
});
//...
Adjust.create(adjustConfig);

示例

该示例展示了如何创建回传函数 eventFailure，并将其注册为 failure 回传。该函数会记录事件失败消息。

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
//...
adjustConfig.setEventTrackingFailedCallbackListener(function (eventFailure) {
   console.log(eventFailure.message);
});
//...
Adjust.create(adjustConfig);