adjust-icon

SKAdNetworkとconversion valueの設定

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

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

SKAdNetworkの通信を無効化する

メソッドシグネチャー
void deactivateSkAdNetworkHandling();
v4.23.0に追加

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);
}