SKAdNetworkとconversion valueの設定

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

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

SKAdNetworkの通信を無効化する

void deactivateSkAdNetworkHandling();

v4.23.0に追加

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

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

1
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment, false);
2
adjustConfig.deactivateSKAdNetworkHandling();
3
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を表す整数の引数を受け入れます。

1
Adjust2dx::updateConversionValue(6);

例

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

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
}

Conversion valueの変更を受信する

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

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

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

例

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

conversion valueのアップデートを確認するメッセージ
新しい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
}