SKAdNetworkとconversion valueの設定

StoreKit AdNetwork（SKAdNetwork）は、アプリのインストールおよび再インストールアトリビューションのための、Appleのフレームワークです。SKAdNetworkのワークフローは以下のようになります：

Appleがアトリビューション情報を収集し、関連するアドネットワークに通知します。
ネットワークがこの情報をAdjustにポストバックで送信します。
AdjustはSKAdNetworkデータをDatascapeおよびデータキャンバスに表示します。

SKAdNetworkの通信を無効化する

void deactivateSkAdNetworkHandling();

Adjust SDKはv4.23.0以降ではデフォルトでSKAdNetworkと通信を行います。SDKは初期化時にSKAdNetworkのアトリビューションを記録します。

Configオブジェクトにはブーリアン値のisSKAdNetworkHandlingActiveプロパティが含まれており、それが動作を制御します。SKAdNetworkとの通信を非有効化するには、引数なしでdeactivateSKAdNetworkHandlingメソッドを呼び出してください。

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

Conversion valueを更新する

static void updateConversionValue(int conversionValue);

Conversion valueは、SKAdNetworkでアプリ内のユーザー行動を計測するためのメカニズムです。64の条件を0～63の値に対応させ、ユーザーのインストール時にこの整数値をSKAdNetworkに送信することができます。これによって、はじめの3日間のユーザー行動に関するインサイトを取得することが可能です。

Adjustでconversion valueを管理している場合、AdjustのサーバーはSDKでこの値を更新します。また、updateConversionValueメソッドを使用して、この値を更新することが可能です。このメソッドはAppleのupdateConversionValueメソッドをラップしており、更新されたconversion valueを表す整数の引数を受け入れます。

Adjust2dx::updateConversionValue(6);

例

この例では、ユーザーがイベントをトリガーしたことに応じて、conversion valueを10に更新する方法を示しています。

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

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

Conversion valueの変更を受信する

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

Adjustを使用してconversion valueを管理している場合、Adjustのサーバーはconversion valueのアップデートをSDKに送信します。setConversionValueUpdatedCallbackメソッドを使用して、こうした変更を受信するコールバック関数を設定できます。関数を引数としてパスしてください。

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

例

この例は、conversion valueが更新されたときに以下を記録する方法です：

conversion valueのアップデートを確認するメッセージ
新しいconversion value

#include "Adjust/Adjust2dx.h"

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

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