Send callback information

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

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 Adjust’s servers. 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.

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

Success callbacks

void setSessionSuccessCallback(void(*sessionSuccessCallback)(AdjustSessionSuccess2dx sessionSuccess));

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

1
#include "Adjust/Adjust2dx.h"
2

3
static void sessionSuccessCallbackMethod(AdjustSessionSuccess2dx sessionSuccess) {
4
    //...
5
}
6

7
bool AppDelegate::applicationDidFinishLaunching() {
8
    std::string appToken = "{YourAppToken}";
9
    std::string environment = AdjustEnvironmentSandbox2dx;
10

11
    AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
12
    adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
13
    adjustConfig.setSessionSuccessCallback(sessionSuccessCallbackMethod);
14
    Adjust2dx::start(adjustConfig);
15
}

Example

This example shows how to create a callback function sessionSuccess and register it as a success callback. The function logs the timestamp at which the SDK recorded the session.

1
#include "Adjust/Adjust2dx.h"
2

3
static void sessionSuccess(AdjustSessionSuccess2dx sessionSuccess) {
4
    CCLOG("Session recorded at %s", sessionSuccess.getTimestamp().c_str());
5
}
6

7
bool AppDelegate::applicationDidFinishLaunching() {
8
    std::string appToken = "{YourAppToken}";
9
    std::string environment = AdjustEnvironmentSandbox2dx;
10

11
    AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
12
    adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
13
    adjustConfig.setSessionSuccessCallback(sessionSuccess);
14
    Adjust2dx::start(adjustConfig);
15
}

Failure callbacks

void setSessionFailureCallback(void(*sessionFailureCallback)(AdjustSessionFailure2dx sessionFailure));

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

1
#include "Adjust/Adjust2dx.h"
2

3
static void sessionFailureCallbackMethod(AdjustSessionFailure2dx sessionFailure) {
4
    //...
5
}
6

7
bool AppDelegate::applicationDidFinishLaunching() {
8
    std::string appToken = "{YourAppToken}";
9
    std::string environment = AdjustEnvironmentSandbox2dx;
10

11
    AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
12
    adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
13
    adjustConfig.setSessionFailureCallback(sessionFailureCallbackMethod);
14
    Adjust2dx::start(adjustConfig);
15
}

Example

This example shows how to create a callback function sessionFailure and register it as a failure callback. The function logs the session failure message.

1
#include "Adjust/Adjust2dx.h"
2

3
static void sessionFailure(AdjustSessionFailure2dx sessionFailure) {
4
    CCLOG("Session recording failed. Response: %s", sessionFailure.getMessage().c_str());
5
}
6

7
bool AppDelegate::applicationDidFinishLaunching() {
8
    std::string appToken = "{YourAppToken}";
9
    std::string environment = AdjustEnvironmentSandbox2dx;
10

11
    AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
12
    adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
13
    adjustConfig.setSessionFailureCallback(sessionFailure);
14
    Adjust2dx::start(adjustConfig);
15
}

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 Adjust’s servers. 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.

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

Success callbacks

void setEventSuccessCallback(void(*eventSuccessCallback)(AdjustEventSuccess2dx eventSuccess));

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

1
#include "Adjust/Adjust2dx.h"
2

3
static void eventSuccessCallbackMethod(AdjustEventSuccess2dx eventSuccess) {
4
    //...
5
}
6

7
bool AppDelegate::applicationDidFinishLaunching() {
8
    std::string appToken = "{YourAppToken}";
9
    std::string environment = AdjustEnvironmentSandbox2dx;
10

11
    AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
12
    adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
13
    adjustConfig.setEventSuccessCallback(eventSuccessCallbackMethod);
14
    Adjust2dx::start(adjustConfig);
15
}

Example

This example shows how to create a callback function eventSuccess and register it as a success callback. The function logs the timestamp at which the SDK recorded the event.

1
#include "Adjust/Adjust2dx.h"
2

3
static void eventSuccess(AdjustEventSuccess2dx eventSuccess) {
4
    CCLOG("Event recorded at %s", eventSuccess.getTimestamp().c_str());
5
}
6

7
bool AppDelegate::applicationDidFinishLaunching() {
8
    std::string appToken = "{YourAppToken}";
9
    std::string environment = AdjustEnvironmentSandbox2dx;
10

11
    AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
12
    adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
13
    adjustConfig.setEventSuccessCallback(eventSuccess);
14
    Adjust2dx::start(adjustConfig);
15
}

Failure callbacks

void setEventFailureCallback(void(*eventFailureCallback)(AdjustEventFailure2dx eventFailure));

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

1
#include "Adjust/Adjust2dx.h"
2

3
static void eventFailureCallbackMethod(AdjustEventFailure2dx eventFailure) {
4
    //...
5
}
6

7
bool AppDelegate::applicationDidFinishLaunching() {
8
    std::string appToken = "{YourAppToken}";
9
    std::string environment = AdjustEnvironmentSandbox2dx;
10

11
    AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
12
    adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
13
    adjustConfig.setEventFailureCallback(eventFailureCallbackMethod);
14
    Adjust2dx::start(adjustConfig);
15
}

Example

This example shows how to create a callback function eventFailure and register it as a failure callback. The function logs the event failure message.

1
#include "Adjust/Adjust2dx.h"
2

3
static void eventFailure(AdjustEventFailure2dx eventFailure) {
4
    CCLOG("Event recording failed. Response: %s", eventFailure.getMessage().c_str());
5
}
6

7
bool AppDelegate::applicationDidFinishLaunching() {
8
    std::string appToken = "{YourAppToken}";
9
    std::string environment = AdjustEnvironmentSandbox2dx;
10

11
    AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
12
    adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
13
    adjustConfig.setEventFailureCallback(eventFailure);
14
    Adjust2dx::start(adjustConfig);
15
}