Set up SKAdNetwork and conversion values

StoreKit Ad Network (SKAdNetwork) is Apple’s attribution framework for app install and reinstall attribution. The SKAdNetwork workflow goes like this:

1. Apple gathers attribution information and notifies the relevant ad network.
2. The network sends a postback with this information to Adjust.
3. Adjust displays SKAdNetwork data in Datascape and Data Canvas.

Disable SKAdNetwork communication

void deactivateSkAdNetworkHandling();

The Adjust SDK communicates with SKAdNetwork by default on v4.23.0 and above. The SDK registers for SKAdNetwork attribution upon initialization.

Your config object contains a boolean isSKAdNetworkHandlingActive property that controls this behavior. You can disable SKAdNetwork communication by calling the deactivateSKAdNetworkHandling method with no argument.

1
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment, false);
2
adjustConfig.deactivateSKAdNetworkHandling();
3
Adjust2dx::start(adjustConfig);

Update conversion values

static void updateConversionValue(int conversionValue);

Conversion values are a mechanism used to track user behavior in SKAdNetwork. You can map 64 conditions to values from 0 through 63 and send this integer value to SKAdNetwork on user install. This gives you insight into how your users interact with your app in the first few days.

If you manage your conversion values with Adjust, the servers update this value in the SDK. You can also update this value by using the updateConversionValue method. This method wraps Apple’s updateConversionValue method. It accepts an integer argument representing your updated conversion value.

1
Adjust2dx::updateConversionValue(6);

Example

This example shows how to update a conversion value to 10 in response to a user triggering an event.

1
bool HelloWorld::init() {
2
    auto position =
3
            Vec2(origin.x + visibleSize.width / 2,
4
                 origin.y + visibleSize.height - label->getContentSize().height
5
                 + offset
6
                 - divide * (++index));
7
    makeButton(mainmenu, "Update conversion value", position,
8
               CC_CALLBACK_1(HelloWorld::onUpdateCv, this));
9
}
10

11
void HelloWorld::onUpdateCv(cocos2d::Ref *pSender) {
12
    Adjust2dx::updateConversionValue(6);
13
}

Listen for changes to conversion values

void setConversionValueUpdatedCallback(void(*callbackMethod)(int conversionValue));

If you use Adjust to manage conversion values, the Adjust’s servers send conversion value updates to the SDK. You can set up a callback function to listen for these changes using the setConversionValueUpdatedCallback method. Pass your function as an argument.

1
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment, false);
2
adjustConfig.setConversionValueUpdatedCallback(conversionValueUpdatedCallbackMethod);
3
Adjust2dx::start(adjustConfig);

Example

This example shows how to log the following when the conversion value updates:

• A message confirming the conversion value update
• The new conversion value

1
#include "Adjust/Adjust2dx.h"
2

3
bool AppDelegate::applicationDidFinishLaunching() {
4
    std::string appToken = "{YourAppToken}";
5
    std::string environment = AdjustEnvironmentSandbox2dx;
6

7
    AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
8
    adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
9
    adjustConfig.setPostbackConversionValueUpdatedCallback([](int conversionValue) {
10
        std::cout << "\nConversion value updated. Callback received";
11
        std::cout << "\nConversion value: " << conversionValue;
12
    });
13
    Adjust2dx::start(adjustConfig);
14
}