Set up callbacks

Set up callbacks to trigger functions when the SDK sends information to Adjust. You can set up callbacks for sessions and events.

Important:

You must register your callbacks before initializing the SDK.

Session callbacks

Set up session callbacks to trigger functions when the SDK sends session information. You can create success callbacks and failure callbacks. Success callbacks trigger when the SDK sends information to the Adjust backend. Failure callbacks trigger when the SDK encounters a problem while sending the information.

Session callbacks have access to a response data object. You can use its properties in your callback function.

Session data object

Property	Data type	Description
`Message`	String	The message from the server or the error logged by the SDK.
`Timestamp`	String	The timestamp from the Adjust backend.
`Adid`	String	A unique device identifier provided by Adjust.
`JsonResponse`	Dictionary <string, object>	The JSON object with the response from the server.
`WillRetry`	Boolean	Returned if the session object failed. Indicates whether there will be an attempt to resend the package at a later time.

Success callbacks

Set up success callbacks to trigger functions when the SDK measures a session.

AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.setLogLevel(AdjustLogLevel.Verbose);
adjustConfig.setSessionSuccessDelegate(SessionSuccessCallback);
//...
Adjust.start(adjustConfig);
//...
public void SessionSuccessCallback (AdjustSessionSuccess sessionSuccessData) {
    //...
}

Example

In this example, we set up a callback function sessionSuccess and register it as a success callback. The function logs the timestamp at which the SDK measured the session.

AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.setLogLevel(AdjustLogLevel.Verbose);
adjustConfig.setSessionSuccessDelegate(sessionSuccess);
// ...
Adjust.start(adjustConfig);
// ...
public void sessionSuccess (AdjustSessionSuccess sessionSuccessData) {
    Debug.Log("Session measured at " + sessionSuccessData.Timestamp);
}

Failure callbacks

Set up failure callbacks to trigger functions when the SDK fails to measure a session.

AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.setLogLevel(AdjustLogLevel.Verbose);
adjustConfig.setSessionFailureDelegate(SessionFailureCallback);
//...
Adjust.start(adjustConfig);
//...
public void SessionFailureCallback (AdjustSessionFailure sessionFailureData) {
    //...
}

Example

In this example, we set up a callback function sessionFailure and register it as a failure callback. The function logs the session failure message.

AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.setLogLevel(AdjustLogLevel.Verbose);
adjustConfig.setSessionFailureDelegate(sessionFailure);
// ...
Adjust.start(adjustConfig);
// ...
public void sessionFailure (AdjustSessionFailure sessionFailureData) {
    Debug.Log("Session measuring failed. Response: " + sessionFailureData.Message);
}

Event callbacks

Set up event callbacks to trigger functions when the SDK sends event information. You can create success callbacks and failure callbacks. Success callbacks trigger when the SDK sends information to the Adjust backend. Failure callbacks trigger when the SDK encounters a problem while sending the information.

Event callbacks have access to a response data object. You can use its properties in your callback function.

Event data object

Property	Data type	Description
`Message`	String	The message from the server or the error logged by the SDK.
`Timestamp`	String	The timestamp from the Adjust backend.
`Adid`	String	A unique device identifier provided by Adjust.
`JsonResponse`	Dictionary <string, object>	The JSON object with the response from the server.
`EventToken`	String	The event token.
`CallbackId`	String	The custom defined callback ID set on event object.
`WillRetry`	Boolean	Returned if the event object failed. Indicates whether there will be an attempt to resend the package at a later time.

Success callbacks

Set up success callbacks to trigger functions when the SDK measures an event.

AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.setLogLevel(AdjustLogLevel.Verbose);
adjustConfig.setEventSuccessDelegate(EventSuccessCallback);
//...
Adjust.start(adjustConfig);
//...
public void EventSuccessCallback(AdjustEventSuccess eventSuccessData) {
    //...
}

Example

In this example, we set up a callback function eventSuccess and register it as a success callback. The function logs the timestamp at which the SDK measured the event.

AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.setLogLevel(AdjustLogLevel.Verbose);
adjustConfig.setEventSuccessDelegate(eventSuccess);
// ...
Adjust.start(adjustConfig);
// ...
public void eventSuccess (AdjustEventSuccess eventSuccessData) {
    Debug.Log("Event measured at " + sessionSuccessData.Timestamp);
}

Failure callbacks

Set up failure callbacks to trigger functions when the SDK fails to measure an event.

AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.setLogLevel(AdjustLogLevel.Verbose);
adjustConfig.setEventFailureDelegate(EventFailureCallback);
//...
Adjust.start(adjustConfig);
//...
public void EventFailureCallback(AdjustEventFailure eventFailureData) {
    //...
}

Example

In this example, we set up a callback function eventFailure and register it as a failure callback. The function logs the event failure message.

AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.setLogLevel(AdjustLogLevel.Verbose);
adjustConfig.setEventFailureDelegate(eventFailure);
// ...
Adjust.start(adjustConfig);
// ...
public void eventFailure (AdjustEventFailure eventFailureData) {
    Debug.Log("Event measuring failed. Response: " + eventFailureData.Message);
}