Adjustのクラス

Adjustのクラスを使用して、アプリケーションとユーザーに関する情報をAdjustに送信できます。アトリビューションやアナリティクスのためのイベント計測にも使用可能です。

機能

セッションごとにコールバックパラメーターを送信する

Adjust SDKで記録されるセッションごとにコールバックパラメーターを送信できます。このメソッドを複数回呼び出すと、さらにパラメーターを追加できます。

static void com.adjust.sdk.Adjust.addSessionCallbackParameter( String key,
                                                                String value 
                                                              )

Java

Javascript

adjustEvent.addCallbackParameter("foo", "bar");

セッションコールバックパラメーターを削除する

セッションパラメーターを追加している場合は、後で削除できます。これを行うには、パラメーターキーをremoveSessionCallbackParameterメソッドに渡します。

static void com.adjust.sdk.Adjust.removeSessionCallbackParameter( String key )

Java

Javascript

AdjustEvent.addCallbackParameter("foo", "bar");

全てのセッションコールバックパラメーターをリセットする

セッションコールバックパラメーターを追加している場合は、後で全て削除できます。これを行うには、resetSessionCallbackParametersメソッドを呼び出します。

static void com.adjust.sdk.Adjust.resetSessionCallbackParameters()

Java

Javascript

Adjust.resetSessionCallbackParameters();

セッションごとのコールバックパラメーターをネットワークパートナーに送信する

Adjust SDKで記録されるセッションごとにコールバックパラメーターをパートナーに送信できます。このメソッドを複数回呼び出すと、さらにパラメーターを追加できます。

static void com.adjust.sdk.Adjust.addSessionPartnerParameter( String key,
                                                                String value 
                                                              )

Java

Javascript

adjustEvent.addCallbackParameter("foo", "bar");

パートナーのコールバックパラメーターを削除する

パートナーパラメーターを追加している場合は、後で削除できます。これを行うには、パラメーターキーをremoveSessionPartnerParameterメソッドに渡します。

static void com.adjust.sdk.Adjust.removeSessionPartnerParameter( String key )

Java

Javascript

Adjust.removeSessionPartnerParameter("foo");

パートナーの全てのコールバックパラメーターをリセットする

パートナーパラメーターを追加している場合は、後で全て削除できます。これを行うには、resetSessionPartnerParametersメソッドを呼び出します。

static void com.adjust.sdk.Adjust.resetSessionPartnerParameters()

Java

Javascript

Adjust.resetSessionPartnerParameters();

デバイスのAdjust IDを取得する

adidメソッドを呼び出すと、ユーザーのデバイスのAdjust ID（adid）を返すことができます。

注意:

adidは、インストールが正常に計測された後でのみ利用できます。

static String com.adjust.sdk.Adjust.getAdid ()

Java

Javascript

String adid = Adjust.getAdid();

戻り値

値	データタイプ	説明
`adid`	文字列	デバイスの一意Adjust ID。

URLからディープリンクのアトリビューション情報を取得する

ディープリンクを使用する場合は、そのURLでアトリビューション情報を検索するようAdjust SDKに指示できます。SDKは、有効な情報を見つけるとその情報をAdjustバックエンドに送信します。

static void com.adjust.sdk.Adjust.appWillOpenUrl( Uri     url,
                                                   Context context 
                                                 )

Java

Javascript

Adjust.appWillOpenUrl(url, getApplicationContext());

現在のアトリビューションデータを取得する

ユーザーがアプリをインストールした後、Adjust SDKにデバイスアトリビューション情報をクエリすることができます。

注意:

アトリビューション情報は、Adjustバックエンドがインストールを計測した後でのみ利用できます。バックエンドは、インストールイベントを受信すると、情報を返します。

static AdjustAttribution com.adjust.sdk.Adjust.getAttribution()

Java

Javascript

AdjustAttribution attribution = Adjust.getAttribution();

サードパーティーとの共有に関するオプションを変更する

サードパーティーとの共有に関するユーザーの設定を伝達できます。サードパーティーの共有オブジェクトで、次のメソッドを呼び出します。その後、ユーザーの希望設定を持つオブジェクトを初期化してください。

また、ユーザーの希望する設定に関する詳細なオプションを渡すことで、アナリティクスのためのよりきめ細かい情報を収集することもできます。

Java

Javascript

// Disable third-party sharing for the user

AdjustThirdPartySharing adjustThirdPartySharing = new AdjustThirdPartySharing(false);
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

// Enable third-party sharing for the user

AdjustThirdPartySharing adjustThirdPartySharing = new AdjustThirdPartySharing(true);
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

// Gather granular details

AdjustThirdPartySharing adjustThirdPartySharing = new AdjustThirdPartySharing(null);
adjustThirdPartySharing.addGranularOption("PartnerA", "foo", "bar");
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

// Partner-specific third-party sharing

AdjustThirdPartySharing adjustThirdPartySharing = new AdjustThirdPartySharing(null);
adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", "install", true);
adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", "events", true);
adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", "sessions", true);
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

サードパーティーとの共有を無効化する

disableThirdPartySharingメソッドを呼び出すと、サードパーティーとの情報共有を防止できます。デフォルトでfalseに設定されています。

static void com.adjust.sdk.Adjust.disableThirdPartySharing(final Context context)

Java

Javascript

Adjust.disableThirdPartySharing(getApplicationContext());

SDKでデータプライバシー設定を有効化する

Adjustのデータプライバシー設定を使用している場合は、Adjust SDKでこの設定を切り替える必要があります。設定するには、trackMeasurementConsentメソッドを呼び出します。

static void com.adjust.sdk.Adjust.trackMeasurementConsent(final boolean consentMeasurement)

Java

Javascript

Adjust.trackMeasurementConsent(true);

GDPRの忘れられる権利に関するユーザーからのリクエストを有効化する

ユーザーが忘れられる権利をリクエストできるようにすることができます。このメソッドを呼び出すと、Adjust SDKからAdjustバックエンドにリクエストが伝えられます。Adjustバックエンドによってユーザーの情報が消去されます。

static void com.adjust.sdk.Adjust.gdprForgetMe(final Context context)

Java

Javascript

Adjust.gdprForgetMe(context);

デバイスのGoogle Play広告IDを収集する

Google Play ストアを対象にしている場合、Adjust SDKを使用してデバイスの広告IDを取得し、アナリティクスに活用することができます。

static void com.adjust.sdk.Adjust.getGoogleAdId(Context         context,
                                                 OnDeviceIdsRead onDeviceIdRead
                                                )

Java

Javascript

Adjust.getGoogleAdId(this, new OnDeviceIdsRead() {
    @Override
    public void onGoogleAdIdRead(String googleAdId) {}
});

デバイスのAmazon広告IDを収集する

Amazonのアプリストアを対象にしている場合、Adjust SDKを使用してデバイスの広告IDを取得し、アナリティクスに活用することができます。

static String com.adjust.sdk.Adjust.getAmazonAdId(final Context context)

Java

Javascript

String amazonAdId = Adjust.getAmazonAdId(context);

Adjust SDKを有効化あるいは無効化する

setEnabledメソッドを使用すると、Adjust SDKによる計測を有効化/無効化することができます。

注意:

Adjust SDKは、デフォルトで常に有効化されています。 checkEnabled メソッドを使用して、ステータスを確認できます。

static void com.adjust.sdk.Adjust.setEnabled (boolean enabled)

Java

Javascript

Adjust.setEnabled(false);

Adjust SDKが有効化されていることを確認する

isEnabledメソッドを呼び出すと、Adjust SDKが有効であるかどうかを確認できます。

static boolean com.adjust.sdk.Adjust.isEnabled ()

Java

Javascript

Adjust.isEnabled();

Adjust SDKのバージョンを確認する

デバイスで実行しているAdjust SDKのバージョンを確認する場合は、sdkVersionメソッドを呼び出すことができます。

static String com.adjust.sdk.Adjust.getSdkVersion()

Java

Javascript

Adjust.getSdkVersion();

Pushトークンを設定する

リアトリビューションにPush通知を利用する場合は、トークンをAdjust SDKに追加する必要があります。

static void com.adjust.sdk.Adjust.setPushToken(final String  token,
                                                final Context context
                                               )

Java

Javascript

// Send the token with context (recommended)
Adjust.setPushToken(pushNotificationsToken,context);

// Send the token without context (not recommended)
Adjust.setPushToken(pushNotificationsToken);

オフラインモードの有効化と無効化を確認する

ユーザーのデバイスがオフラインのときに、SDKをオフラインモードにすることでイベントをキューに追加できます。このモードでは、オンラインに戻るまで全てのイベントが保管されます。Adjust SDKがオンラインに戻ると、イベントの送信を試みます。

重要:

このオフラインモード設定はアプリの起動時に記憶されません。アプリを最後に開いたときにオフラインモードが有効であっても、Adjust SDKは常にオンラインモードで起動します。

static void com.adjust.sdk.Adjust.setOfflineMode(boolean enabled)

Java

Javascript

Adjust.setOfflineMode(true); // Enables offline mode
Adjust.setOfflineMode(false); // Disables offline mode

特定のソースの広告収益を計測する

Adjust SDKにより、特定のネットワークパートナーからの収益情報を受信することができます。JSONオブジェクトとしてAdjust SDKにパスすることで、広告収益に関する情報のトラッキングを可能にします。

注意:

この機能は特定の広告収益ソースにのみ利用可能です。サポートされているソースの一覧については、値テーブルを確認してください。

static void com.adjust.sdk.Adjust.trackAdRevenue(final AdjustAdRevenue adjustAdRevenue)

Java

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX);
adjustAdRevenue.setRevenue(1.00, "EUR");
adjustAdRevenue.setAdImpressionsCount(10);
adjustAdRevenue.setAdRevenueNetwork("network1");
adjustAdRevenue.setAdRevenueUnit("unit1");
adjustAdRevenue.setAdRevenuePlacement("banner");
adjustAdRevenue.addCallbackParameter("key1", "value1");
adjustAdRevenue.addPartnerParameter("key2", "value2");
Adjust.trackAdRevenue(adjustAdRevenue);

値

値	説明
`AdjustConfig.AD_REVENUE_APPLOVIN_MAX`	Applovin MAXで広告収益のトラッキングを有効化します。
`AdjustConfig.AD_REVENUE_ADMOB`	AdMobで広告収益のトラッキングを有効化します。
`AdjustConfig.AD_REVENUE_IRONSOURCE`	ironSourceで広告収益のトラッキングを有効化します。
`AdjustConfig.AD_REVENUE_ADMOST`	Admostで広告収益のトラッキングを有効化します。
`AdjustConfig.AD_REVENUE_UNITY`	Unityで広告収益のトラッキングを有効化します。
`AdjustConfig.AD_REVENUE_HELIUM_CHARTBOOST`	Helium Chartboostで広告収益のトラッキングを有効化します。
`AdjustConfig.AD_REVENUE_SOURCE_PUBLISHER`	汎用ソースとの広告収益のトラッキングを有効化します。

イベントを計測する

Adjust SDKを使用して、イベント情報をAdjustバックエンドに返すことができます。これは、ローデータのエクスポートを調べてみるとわかります。

static void com.adjust.sdk.Adjust.trackEvent (AdjustEvent event)

Java

Javascript

AdjustEvent adjustEvent = new AdjustEvent("abc123");
Adjust.trackEvent(adjustEvent);

パラメーター

パラメーター	データタイプ	説明
`event`	`AdjustEvent` オブジェクト	トラッキングしたいイベント。イベントトークンを使って初期化する必要があります。

サブスクリプションを計測する

警告:

Adjustは新規顧客のサブスクリプションの記録を終了しました。すでにサブスクリプションの記録を設定している場合は、専任のアカウントマネージャーまたは support@adjust.comまでお問い合わせください。

Adjust SDKでは、アプリ内サブスクリプションイベントに関する情報を計測できます。これを行うには、サブスクリプションオブジェクトを形成して SDK に渡します。

static void com.adjust.sdk.Adjust.trackPlayStoreSubscription(final AdjustPlayStoreSubscription subscription)

Java

AdjustPlayStoreSubscription subscription = new AdjustPlayStoreSubscription(
price,
currency,
sku,
orderId,
signature,
purchaseToken);
subscription.setPurchaseTime(purchaseTime);

Adjust.trackPlayStoreSubscription(subscription);

パラメーター

パラメーター	データタイプ	説明
price	Long	通貨記号を含むサブスクリプションの価格
currency	文字列	トランザクションに使用される通貨のコード。
sku	文字列	プロダクトID
orderId	文字列	オーダーID
signature	文字列	購入データのデータ署名
purchaseToken	文字列	購入時に一意のトークンを返す
purchaseTime	Long	購入された時間

SDKで初回のペイロードを送信する

Adjust SDKの起動を遅らせる場合、遅延タイマーが切れた後に情報をバックエンドに送信します。このメソッドを使用すると、遅延時間が経過する前にSDKにパッケージの送信を促すことができます。

static void com.adjust.sdk.Adjust.sendFirstPackages()

Java

Javascript

Adjust.sendFirstPackages();