adjust-icon

SDK v5移行ガイド

事前準備

SDK v5にアップデートする前に、以下を行ってください。

  1. SDK v5の最小サポート対象APIバージョンが更新されました。以前のバージョンをターゲットにしている場合は、まずアプリをアップデートする必要があります。

    • iOS： 12.0
    • Android: 21

SDKをインストールする

SDK v5の使用を開始するには、プロジェクトにdependencyとしてSDK v5を追加する必要があります。これを行うには、以下の手順に従ってください。

  1. GitHubからSDKアーカイブをダウンロードします。

  2. distディレクトリからC++ ファイルをコピーし、Cocos2d-x プロジェクトに追加します。

  3. （ Androidのみ ）：Android.mkファイルのLOCAL_SRC_FILESセクションにC++ファイルのパスを追加します。

    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustConfig2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustAttribution2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustProxy2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustEvent2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/Adjust2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustEventFailure2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustEventSuccess2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustSessionFailure2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustSessionSuccess2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustAppStoreSubscription2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustPlayStoreSubscription2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustThirdPartySharing2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustAdRevenue2dx.cpp
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustAppStorePurchase2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustPlayStorePurchase2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustDeeplink2dx.cpp \
    $(LOCAL_PATH)/../../../Classes/Adjust/AdjustPurchaseVerificationResult2dx.cpp \

    CMakeを使用している場合は、CMakeLists.txtファイルに以下のソースとヘッダーのリストを追加します。

    # add cross-platforms source files and header files
    list(APPEND GAME_SOURCE
        Classes/Adjust/AdjustConfig2dx.cpp
        Classes/Adjust/AdjustAttribution2dx.cpp
        Classes/Adjust/AdjustProxy2dx.cpp
        Classes/Adjust/AdjustEvent2dx.cpp
        Classes/Adjust/AdjustAdRevenue2dx.cpp
        Classes/Adjust/AdjustAppStoreSubscription2dx.cpp
        Classes/Adjust/AdjustPlayStoreSubscription2dx.cpp
        Classes/Adjust/AdjustAppStorePurchase2dx.cpp
        Classes/Adjust/AdjustPlayStorePurchase2dx.cpp
        Classes/Adjust/Adjust2dx.cpp
        Classes/Adjust/AdjustEventFailure2dx.cpp
        Classes/Adjust/AdjustEventSuccess2dx.cpp
        Classes/Adjust/AdjustSessionFailure2dx.cpp
        Classes/Adjust/AdjustSessionSuccess2dx.cpp
        Classes/Adjust/AdjustThirdPartySharing2dx.cpp
        Classes/Adjust/AdjustDeeplink2dx.cpp
        Classes/Adjust/AdjustPurchaseVerificationResult2dx.cpp
        )
    list(APPEND GAME_HEADER
        Classes/Adjust/AdjustConfig2dx.h
        Classes/Adjust/AdjustAttribution2dx.h
        Classes/Adjust/AdjustProxy2dx.h
        Classes/Adjust/AdjustEvent2dx.h
        Classes/Adjust/AdjustAdRevenue2dx.h
        Classes/Adjust/AdjustAppStoreSubscription2dx.h
        Classes/Adjust/AdjustPlayStoreSubscription2dx.h
        Classes/Adjust/AdjustAppStorePurchase2dx.h
        Classes/Adjust/AdjustPlayStorePurchase2dx.h
        Classes/Adjust/Adjust2dx.h
        Classes/Adjust/AdjustEventFailure2dx.h
        Classes/Adjust/AdjustEventSuccess2dx.h
        Classes/Adjust/AdjustSessionFailure2dx.h
        Classes/Adjust/AdjustSessionSuccess2dx.h
        Classes/Adjust/AdjustThirdPartySharing2dx.h
        Classes/Adjust/AdjustDeeplink2dx.h
        Classes/Adjust/AdjustPurchaseVerificationResult2dx.h
        )

  4. （ Androidのみ ）：GitHubのリリースページから最新のadjust-android.aarをダウンロードし、Android Studioプロジェクトにインポートします。

  5. （ iOSのみ ）：GitHubリリースページから最新のAdjustSdk.frameworkをダウンロードし、Xcodeプロジェクトにリンクします。

シグネチャーライブラリを設定

SDK v5は SDKシグネチャーライブラリを使用して、Adjust SDKからAdjustサーバーに送信される情報を暗号化します。SDK v5を使用するには、プロジェクトにシグネチャーライブラリを追加する必要があります。

Androidアプリ

  1. AdjustシグネチャーライブラリのGitHubリポジトリから、最新のadjust-android-signature.aarをダウンロードします。
  2. Android Studioプロジェクトに.aarを追加します。

iOSアプリ

  1. AdjustシグネチャーライブラリのGitHubリポジトリから、最新のAdjustSigSdk-iOS-Static.aをダウンロードします。
  2. Xcodeプロジェクトに.aをリンクします。

アプリのプライバシーマニフェストを更新（iOSのみ）

App StoreにAdjust SDKのプライバシー要件を通知するには、プライバシーマニフェストをAdjustのプライバシーマニフェストとマージする必要があります。

  1. アプリのプライバシーマニフェストにAdjust SDKプライバシーマニフェストのプロパティを追加します。
  2. アプリのプライバシーマニフェストに、シグネチャーライブラリのプライバシーマニフェストからプロパティを追加します。

初期化メソッドを更新

v5で変更

SDK v4では、初期化メソッドはAdjust2dx::start(adjustConfig)です。これはAdjust2dx::initSdk(adjustConfig)に変更されています。

#include "Adjust/Adjust2dx.h"


std::string appToken = "YourAppToken";
std::string environment = AdjustEnvironmentSandbox2dx;


AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);


 Adjust2dx::start(adjustConfig);


* Adjust2dx::initSdk(adjustConfig);

変更されたAPI

v5で変更

SDK v5では、以下のAPIが変更されました。

SDKを無効化および有効化する

SDK v4では、bool値でAdjust2dx::setEnabledを呼び出すことで、SDKを有効化・無効化することができます。

Adjust2dx::setEnabled(false); // disable SDK
Adjust2dx::setEnabled(true); // enable SDK

より明確にするため、SDK v5では、この機能は別々のコマンドに分割されています。

  • SDKを無効化するには、Adjust2dx::disable()を呼び出します。
  • SDKを有効化するには、Adjust2dx::enable()を呼び出します。
Adjust2dx::disable();
Adjust2dx::enable();

バックグラウンドで情報を送信する

SDK v4では、adjustConfigインスタンスのsendInBackgroundプロパティをtrueに設定し、アプリがバックグラウンドで動作している間にSDKがAdjustに情報を送信できるようにする必要があります。

adjustConfig.sendInBackground(true);

SDK v5では、adjustConfigインスタンスのenableSendingInBackgroundメソッドを呼び出し、アプリがバックグラウンドで動作している間にSDKがAdjustに情報を送信できるようにする必要があります。

adjustConfig.enableSendingInBackground();

プリインストールアプリ計測

SDK v4では、 adjustConfigインスタンスのsetPreinstallTrackingEnabledメソッドをtrue引数で呼び出し、プリインストールアプリの計測を有効化することができます。

adjustConfig.setPreinstallTrackingEnabled(true);

SDK v5でプリインストールアプリの計測を有効化するには、 adjustConfigインスタンスのenablePreinstallTrackingメソッドを呼び出す必要があります。

adjustConfig.enablePreinstallTracking();

AdServices情報の読み取りを無効化する

SDK v4では、adjustConfigのsetAllowAdServicesInfoReadingメソッドをfalseで呼び出すことで、Adjust SDKがAdServices情報を読み取らないようにすることができます。

adjustConfig.setAllowAdServicesInfoReading(false);

SDK v5でAdjust SDKがAdServices情報を読み取らないようにするには、 adjustConfigインスタンスのdisableAdServicesメソッドを呼び出す必要があります。デフォルトの状態はtrueです。

adjustConfig.disableAdServices();

IDFAの読み取りを無効化する

SDK v4では、adjustConfigのsetAllowIdfaReadingメソッドをfalse値で呼び出すことで、Adjust SDKがデバイスのIDFAを読み取らないようにすることができます。

adjustConfig.setAllowIdfaReading(false);

SDK v5でAdjust SDKがデバイスのIDFAを読み取らないようにするには、 adjustConfigインスタンスのdisableIdfaReadingメソッドを呼び出す必要があります。デフォルトの状態はtrueです。

adjustConfig.disableIdfaReading();

アトリビューションにコストデータを有効化する

SDK v4でデバイスのアトリビューション情報のコストデータを有効化するには、 adjustConfigインスタンスのsetNeedsCostメソッドをtrue値で呼び出す必要があります。

adjustConfig.setNeedsCost(true);

SDK v5でデバイスのアトリビューション情報のコストデータを有効化するには、adjustConfigインスタンスのenableCostDataInAttributionメソッドを呼び出す必要があります。デフォルトの状態はfalseです。

adjustConfig.enableCostDataInAttribution();

LinkMeを有効化する

SDK v4では、 adjustConfigインスタンスのsetLinkMeEnabledメソッドをtrue値で呼び出し、Adjust LinkMeを有効化することができます。

adjustConfig.setLinkMeEnabled(true);

SDK v5でAdjust LinkMeを有効化するには、 adjustConfigインスタンスのenableLinkMeメソッドを呼び出す必要があります。デフォルトの状態はfalseです。

adjustConfig.enableLinkMe();

デバイスIDを1回だけ読み取る

SDK v4では、adjustConfigのsetReadDeviceInfoOnceEnabledメソッドをtrue値で呼び出し、SDKがデバイスIDを1回だけ読み取るように指示することができます。

adjustConfig.setReadDeviceInfoOnceEnabled(true);

SDK v5では、adjustConfigのenableDeviceIdsReadingOnceメソッドを呼び出し、SDKがデバイスIDを1回だけ読み取るように指示することができます。デフォルトの状態はfalseです。

adjustConfig.enableDeviceIdsReadingOnce();

オフラインモード

SDK v4では、bool引数でAdjust2dx::setOfflineModeを呼び出すことで、SDKでオフラインモードを有効化・無効化することができます。

Adjust2dx::setOfflineMode(true);
Adjust2dx::setOfflineMode(false);

より明確にするため、SDK v5では、この機能は別々のコマンドに分割されています。

  • SDKをオフラインモードに設定するには、Adjust2dx::switchToOfflineModeを呼び出します。
  • SDKをオンラインモードに戻すには、Adjust2dx::switchBackToOnlineModeを呼び出します。
Adjust2dx::switchToOfflineMode(); // Put the SDK in offline mode
Adjust2dx::switchBackToOnlineMode(); // Put the SDK back in online mode

セッションコールバックパラメーター

SDK v4では、Adjust2dx::addSessionCallbackParameterメソッドにキーと値のペアを渡すことでセッションパラメーターを追加し、Adjust2dx::removeSessionCallbackParameterメソッドを使用して個々のパラメーターを削除することができます。

Adjust2dx::addSessionCallbackParameter("key", "value");
Adjust2dx::removeSessionCallbackParameter("key");
Adjust2dx::resetSessionCallbackParameters();

SDK v5では、セッションパラメーターはグローバルパラメーターに改名されています。

Adjust2dx::addGlobalCallbackParameter("key", "value");
Adjust2dx::removeGlobalCallbackParameter("key");
Adjust2dx::removeGlobalCallbackParameters();

セッションパートナーパラメーター

SDK v4では、Adjust2dx::addSessionPartnerParameterメソッドにキーと値のペアを渡すことでセッション パートナー パラメーターを追加し、Adjust2dx::removeSessionPartnerParameterメソッドを使用して個々のパラメーターを削除することができます。

Adjust2dx::addSessionPartnerParameter("key", "value");
Adjust2dx::removeSessionPartnerParameter("key");
Adjust2dx::resetSessionPartnerParameters();

SDK v5では、セッション パートナー パラメーターはグローバル パートナー パラメーターに改名されました。

Adjust2dx::addGlobalPartnerParameter("key", "value");
Adjust2dx::removeGlobalPartnerParameter("key");
Adjust2dx::removeGlobalPartnerParameters();

イベントの重複排除

SDK v4では、イベント重複排除はイベントtransaction IDと組み合わされ、最大10個のユニークIDに制限されています。

adjustEvent.setTransactionId("transaction-id");

SDK v5では、この機能はtransaction IDから分離されています。イベント重複排除のため、 deduplicationIdと呼ばれる新しいIDフィールドが追加されました。

adjustEvent.setDeduplicationId("deduplication-id");

重複したイベントを識別するために、リストに追加できるdeduplicationIdの数をカスタム制限することができます。デフォルトでは、制限は 10 に設定されています。

AdjustConfig2dx adjustConfig = AdjustConfig2dx("appToken", AdjustEnvironmentSandbox2dx);
adjustConfig.setEventDeduplicationIdsMaxSize(20);
Adjust2dx::initSdk(adjustConfig);

App Storeのサブスクリプション

SDK v4では、 AdjustAppStoreSubscription2dxオブジェクトを設定することで新しいサブスクリプションを設定できます。このオブジェクトは、 price 、 currency 、 transactionId 、 receiptの4つの引数で初期化されます。

AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(price, currency, transactionId, receipt);

SDK v5では、購入認証に receipt 引数が不要になったため、引数を渡す必要はありません。

AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(price, currency, transactionId);

SDK v4では、Adjust2dx::appWillOpenUrlメソッドにディープリンク情報を渡すことができます。

Adjust2dx::appWillOpenUrl("url");

SDK v5では、Adjust2dx::processDeeplinkに改名されています。ディープリンクを作成するための新しいAdjustDeeplink2dxクラスが追加されました。ディープリンクを処理するには、ディープリンクURLでAdjustDeeplink2dxオブジェクトをインスタンス化し、 Adjust2dx::processDeeplinkメソッドに渡してください。

AdjustDeeplink2dx deeplink = AdjustDeeplink2dx("url");
Adjust2dx::processDeeplink(deeplink);

SDK v4では、 urlをAdjust2dx::processDeeplinkメソッドに渡すことで、短縮されたディープリンクを解決できます。

Adjust2dx::processDeeplink("url", [](std::string resolvedLink) {
    std::cout << "Resolved link: " << resolvedLink;
});

SDK v5では、ディープリンクurlで初期化されたAdjustDeeplink2dxオブジェクトを送信する必要があります。これが、短縮されていない元のディープリンクを返します。

AdjustDeeplink2dx deeplink = AdjustDeeplink2dx("url");
Adjust2dx::processDeeplink(deeplink, [](std::string resolvedLink) {
    std::cout << "Resolved link: " << resolvedLink;
});

児童オンラインプライバシー保護法（COPPA）コンプライアンス

SDK v4では、adjustConfigインスタンスでcoppaCompliantEnabledメソッドを呼び出し、値にtrueを設定することで、COPPA準拠を有効化できます。

adjustConfig.setCoppaCompliantEnabled(true);

SDK v5でCOPPAコンプライアンスを有効化するには、 adjustConfigインスタンスのenableCoppaComplianceメソッドを呼び出す必要があります。デフォルトの状態はfalseです。

adjustConfig.enableCoppaCompliance();

Playストアの子供向けアプリ

SDK v4では、true値でadjustConfigインスタンスのsetPlayStoreKidsAppEnabledメソッドを呼び出すことで、アプリをPlayストアの子供向けアプリとしてマークできます。これはSDKの初期化中に読み込まれるため、SDKを初期化したら値を更新することはできません。

adjustConfig.setPlayStoreKidsAppEnabled(true);

SDK v5でコンプライアンスを有効化するには、 adjustConfigインスタンスのenablePlayStoreKidsComplianceメソッドを呼び出す必要があります。デフォルトの状態はfalseです。

adjustConfig.enablePlayStoreKidsCompliance();

データレジデンシーとURL戦略を設定する

SDK v4では、URL戦略とデータレジデンシーのドメインはAdjustConfigクラスの定数として定義されています。

adjustConfig.setUrlStrategy(AdjustDataResidencyEU);

SDK v5 では、指定するドメインを配列で渡す必要があります。さらに、以下の設定も行ってください。

  • useSubdomains （bool）：ドメインをAdjustドメインとして扱うかどうか。trueの場合、SDKはAdjust固有のサブドメインをドメインにプレフィックスとします。falseの場合、SDKはプレフィックスを追加せずに、指定されたドメインをそのまま使用します。
  • isDataResidency （bool）：ドメインをデータレジデンシーに使用するかどうか。
adjustConfig.setUrlStrategy({"eu.adjust.com"}, true, true);

SDK v5でURL戦略を設定する方法については、以下の表をご確認ください。

v4v5 - メインおよびフォールバックドメインv5 - サブドメインの使用v5 - データレジデンシー
AdjustDataResidencyEU"eu.adjust.com"truetrue
AdjustDataResidencyTR"tr.adjust.com"truetrue
AdjustDataResidencyUS"us.adjust.com"truetrue
AdjustUrlStrategyChina"adjust.world"、 "adjust.com"truefalse
AdjustUrlStrategyCn"adjust.cn"、 "adjust.com"truefalse
AdjustUrlStrategyCnOnly"adjust.cn"truefalse
AdjustUrlStrategyIndia"adjust.net.in"、 "adjust.com"truefalse

例

// India URL strategy
adjustConfig.setUrlStrategy({"adjust.net.in", "adjust.com"}, true, false);


// China URL strategy
adjustConfig.setUrlStrategy({"adjust.world", "adjust.com"}, true, false);


// China only URL strategy
adjustConfig.setUrlStrategy({"adjust.cn"}, true, false);


// EU URL strategy
adjustConfig.setUrlStrategy({"eu.adjust.com"}, true, true);


// Turkey URL strategy
adjustConfig.setUrlStrategy({"tr.adjust.com"}, true, true);


// US URL strategy
adjustConfig.setUrlStrategy({"us.adjust.com"}, true, true);

広告収益を記録する

SDK v4 では、広告収益を記録するために、広告収益ソースの定数を指定して AdjustAdRevenue2dx オブジェクトをインスタンス化する必要があります。

AdjustAdRevenue2dx adRevenue = AdjustAdRevenue2dx(AdjustAdRevenueSourceAppLovinMAX);

SDK v5では、文字列のsourceを指定してAdjustAdRevenueオブジェクトをインスタンス化する必要があります。

AdjustAdRevenue2dx adRevenue = AdjustAdRevenue2dx("applovin_max_sdk")
v4v5
AdjustAdRevenueSourceAppLovinMAX"applovin_max_sdk"
AdjustAdRevenueSourceAdMob"admob_sdk"
AdjustAdRevenueSourceIronSource"ironsource_sdk"
AdjustAdRevenueSourceAdMostSource"admost_sdk"
AdjustAdRevenueSourceUnity"unity_sdk"
AdjustAdRevenueSourceHeliumChartboost"helium_chartboost_sdk"
AdjustAdRevenueSourceAdx"adx_sdk"
AdjustAdRevenueSourcePublisher"publisher_sdk"
AdjustAdRevenueSourceTopOn"topon_sdk"
AdjustAdRevenueSourceMopubサポート終了

SKAdNetworkの通信を無効化する

SDK v4では、adjustConfig.deactivateSKAdNetworkHandlingメソッドを呼び出すことで、SDKがSKAdNetworkと通信しないようにすることができます。

adjustConfig.deactivateSKAdNetworkHandling();

SDK v5では、SKAdNetworkとの通信を無効にするには、adjustConfigインスタンスのdisableSkanAttributionメソッドを呼び出す必要があります。デフォルトの状態はtrueです。

adjustConfig.disableSkanAttribution();

Conversion valueのアップデートを受信する

SDK v4では、 adjustConfigでsetPostbackConversionValueUpdatedCallbackメソッドを呼び出してconversion valueの更新を受信できます。SKAN4より前は、 setConversionValueUpdatedCallbackメソッドを使用できました。

// pre-SKAN4 callback
adjustConfig.setConversionValueUpdatedCallback([](int conversionValue) {
    std::cout << "\nConversion value: " << conversionValue;
});
// SKAN4 callback
adjustConfig.setPostbackConversionValueUpdatedCallback([](
        int conversionValue,
        std::string coarseValue,
        bool lockWindow) {
    std::cout << "\nConversion value: " << conversionValue;
    std::cout << "\nCoarse value: " << coarseValue;
    std::cout << "\nLock window: " << lockWindow;
});

SDK v5では、 adjustConfigオブジェクトのsetSkanUpdatedCallbackメソッドにコールバック関数を割り当てる必要があります。

adjustConfig.setSkanUpdatedCallback([](
    std::unordered_map<std::string, std::string> data) {
    std::cout << "\nConversion value: " << data["conversionValue"];
    std::cout << "\nCoarse value: " << data["coarseValue"];
    std::cout << "\nLock window: " << data["lockWindow"];
    std::cout << "\nError: " << data["error"];
});

Conversion valueを更新する

SDK v4では、以下のいずれかのメソッドを使用して、更新されたconversion valueをAdjustに送信できます。

// pass just the conversion value (deprecated method)
Adjust2dx::updateConversionValue(6);


// pass the conversion value and a callback to receive a message about potential error
Adjust2dx::updatePostbackConversionValue(6, [](std::string error) {
    std::cout << "Error while updating conversion value: " << error;
});


// SKAN 4.0
// pass the conversion value, coarse value and a callback to receive a message about potential error
Adjust2dx::updatePostbackConversionValue(6, "low", [](std::string error) {
    std::cout << "Error while updating conversion value: " << error;
});


// SKAN 4.0
// pass the conversion value, coarse value, lock window and a callback to receive a message about potential error
Adjust2dx::updatePostbackConversionValue(6, "low", false, [](std::string error) {
    std::cout << "Error while updating conversion value: " << error;
});

SDK v5でconversion valueを更新するには、以下の引数でupdateSkanConversionValueメソッドを使用します。

  • conversionValue （int）：更新されたconversion value
  • coarseValue （std::string）：更新された粗いconversion value
  • lockWindow （bool）：コンバージョン期間が終了する前にポストバックを送信するかどうか
Adjust2dx::updateSkanConversionValue(6, "low", true, [](std::string error) {
    std::cout << "Error while updating conversion value: " << error;
});

App Tracking Transparency認証ラッパー

SDK v4では、Adjust2dx::requestTrackingAuthorizationWithCompletionHandlerメソッドを使用して、ユーザーのATT認証ステータスの変更を処理することができます。

Adjust2dx::requestTrackingAuthorizationWithCompletionHandler([] (int status) {
    switch (status) {
        case 0:
            // ATTrackingManagerAuthorizationStatusNotDetermined case
            break;
        case 1:
            // ATTrackingManagerAuthorizationStatusRestricted case
            break;
        case 2:
            // ATTrackingManagerAuthorizationStatusDenied case
            break;
        case 3:
            // ATTrackingManagerAuthorizationStatusAuthorized case
            break;
    }
});

より明確にするため、SDK v5ではAdjust2dx::requestAppTrackingAuthorizationに改名されました。

Adjust2dx::requestAppTrackingAuthorization([] (int status) {
    switch (status) {
        case 0:
            // ATTrackingManagerAuthorizationStatusNotDetermined case
            break;
        case 1:
            // ATTrackingManagerAuthorizationStatusRestricted case
            break;
        case 2:
            // ATTrackingManagerAuthorizationStatusDenied case
            break;
        case 3:
            // ATTrackingManagerAuthorizationStatusAuthorized case
            break;
    }
});

デバイス情報を取得する

SDK v4では、全てのデバイス情報ゲッターメソッドは同期的に実行されます。SDK v5では、これらのメソッドは非同期に実行されるように変更されまています。非同期処理の完了時に情報を処理するコールバック関数を追加することができます。

// IDFA getter
Adjust2dx::getIdfa([](std::string idfa) {
    std::cout << "\nIDFA = " << idfa;
});


// IDFV getter
Adjust2dx::getIdfv([](std::string idfv) {
    std::cout << "\nIDFV = " << idfa;
});


// ADID getter
Adjust2dx::getAdid([](std::string adid) {
    std::cout << "\nAdjust ID = " << adid;
});


// Attribution getter
Adjust2dx::getAttribution([](AdjustAttribution2dx attribution) {
   // process attribution
});


// Enabled status getter
Adjust2dx::isEnabled([](bool isEnabled) {
   // process isEnabled
});


// SDK version getter
Adjust2dx::getSdkVersion([](std::string sdkVersion) {
    std::cout << "\nSDK version = " << sdkVersion;
});


// Last deep link getter
Adjust2dx::getLastDeeplink([](std::string lastDeeplink) {
    std::cout << "\nLast deeplink = " << lastDeeplink;
});

削除されたAPI

v5で削除

SDK v5では、以下のAPIが削除されました。

イベントバッファリング

SDK v4はイベントのバッファリングをサポートしています。この機能は、リクエストイベント、広告収益、Pushトークン、その他の情報をローカルバッファに保存し、後日送信します。

adjustConfig.setEventBufferingEnabled(true);

SDK v5では、この設定はご利用いただけません。

カスタムユーザーエージェント文字列

SDK v4では、ユーザーエージェント文字列でadjustConfig.setUserAgentを呼び出すことによるカスタムユーザーエージェントの設定をサポートしています。

adjustConfig.setUserAgent("custom-user-agent");

SDK v5では、この設定はご利用いただけません。

既知のデバイスかどうかを通知する設定

SDK v4では、adjustConfig.setDeviceKnownメソッドを呼び出して、既知のデバイスかどうかをSDKに手動で通知することができます。

adjustConfig.setDeviceKnown(true);

SDK v5では、この設定はご利用いただけません。

SDKの起動開始を遅延させる

SDK v4では、adjustConfig.setDelayStartを最大 10秒 遅延させて呼び出すことで、SDKの開始を遅延させることができます。

adjustConfig.setDelayStart(10);

このメソッドはSDK v5では廃止されています。この遅延を中断させるAdjust2dx::sendFirstPackages()メソッドも削除されました。

サードパーティとの共有をグローバルに無効化する

SDK v4では、Adjust2dx::disableThirdPartySharingメソッドを呼び出すことで、サードパーティとの情報共有をグローバルに無効化することができます。

Adjust2dx::disableThirdPartySharing();

この機能はSDK v5では削除されました。SDK v5では、Adjust2dx::trackThirdPartySharingメソッドを使用してサードパーティとのデータ共有を有効化または無効化できます。

AdjustThirdPartySharing2dx thirdPartySharing = AdjustThirdPartySharing2dx(false);
Adjust2dx::trackThirdPartySharing(thirdPartySharing);