Adjust 类

Adjust 类可用来向 Adjust 发送您应用程序和用户的相关信息。这些信息可用来进行归因，也可也来跟踪事件以进行数据分析。

功能

针对每次会话发送回传参数

您可以随 Adjust SDK 记录的每个会话同时发送回传参数。多次调用该方法可添加额外的参数。

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

Java

Javascript

移除会话回传参数

如果您添加了会话参数，可以晚些时候将其移除。为此，请将参数键传递至 removeSessionCallbackParameter 方法。

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

Java

Javascript

重置所有会话回传参数

如果您添加了会话回传参数，可以晚些时候将其全部移除。为此，请调用 resetSessionCallbackParameters 方法。

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

Java

Javascript

针对每次会话将回传参数发送至渠道合作伙伴

您可以随 Adjust SDK 记录的每个会话向合作伙伴同时发送回传参数。多次调用该方法可添加额外的参数。

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

Java

Javascript

移除发送给合作伙伴的回传参数

如果您添加了合作伙伴参数，可以晚些时候将其移除。为此，请将参数键传递至 removeSessionPartnerParameter 方法。

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

Java

Javascript

重置所有发送给合作伙伴的回传参数

如果您添加了合作伙伴参数，可以晚些时候将其全部移除。为此，请调用 resetSessionPartnerParameters 方法。

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

Java

Javascript

获取设备的 Adjust ID

您可以调用 adid 方法，返回用户设备的 Adjust ID (即 adid)。

请注意:

只有在安装成功被跟踪后 adid 才可用。

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

Java

Javascript

返回值

值	数据类型	描述
`adid`	字符串	设备的唯一 Adjust ID。

从 URL 中获取深度链接归因信息

如果您在使用深度链接，可以指示 Adjust SDK 搜索 URL，查找归因信息。如果 SDK 找到了有效信息，就会将其发送给 Adjust 后端。

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

Java

Javascript

获取当前归因数据

用户安装您的应用后，您可以向 Adjust SDK 查询设备归因信息。

请注意:

只有在 Adjust 后端跟踪到安装后，归因信息才可用。后端收到安装事件后会返回该信息。

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

Java

Javascript

变更第三方分享选项

您可以发送用户的第三方分享首选项。请通过第三方分享对象调用下列方法。使用用户首选项初始化对象。

您也可以传递用户首选项的精细信息，获取更多详情用于数据分析。

Java

// 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);var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
adjustThirdPartySharing.addPartnerSharingSetting('PartnerA', 'install', true);
adjustThirdPartySharing.addPartnerSharingSetting('PartnerA', 'events', true);
adjustThirdPartySharing.addPartnerSharingSetting('PartnerA', 'sessions', true);
//...
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

Javascript

// Disable third-party sharing for the user

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

// Enable third-party sharing for the user

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

// Gather granular details

let adjustThirdPartySharing = new AdjustThirdPartySharing(null);
adjustThirdPartySharing.addGranularOption("PartnerA", "foo", "bar");
Adjust.trackThirdPartySharing(adjustThirdPartySharing);var 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

在 SDK 中启用数据隐私设置

如果您正在使用 Adjust 的数据隐私设置，就需要在 Adjust SDK 中进行切换。请调用 trackMeasurementConsent 方法进行设置。

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

Java

Javascript

允许用户要求行使 GDPR 被遗忘权

您可以允许用户要求行使被遗忘权。在调用该方法时，Adjust 会将遗忘请求传递至 Adjust 后端，后端就会移除用户信息。

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

Java

Javascript

收集设备的 Google Play 广告 ID

如果您的应用面向 Google Play 商店，则可以使用 Adjust SDK 来获取设备的广告 ID。这对分析营销表现有所帮助。

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

Java

Javascript

收集设备的 Amazon 广告 ID

如果您的应用面向 Amazon App Store，则可以使用 Adjust SDK 来获取设备的广告 ID。这对分析营销表现有所帮助。

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

Java

Javascript

启用或禁用 Adjust SDK

您可以调用 setEnabled 方法，启用或禁用 Adjust SDK 跟踪。

请注意:

默认状态下 Adjust SDK 始终启用。您可以调用 checkEnabled 方法查看 SDK 状态。

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

Java

Javascript

检查 Adjust SDK 是否启用

您可以调用 isEnabled 方法，查看 Adjust SDK 是否已启用。

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

Java

Javascript

检查 Adjust SDK 版本

如果您希望验证设备当前运行的 Adjust SDK 版本，可以调用 sdkVersion 方法。

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

Java

Javascript

设置推送标签 (Push token)

如果您使用推送通知进行再归因，就需要将识别码添加至 Adjust SDK。

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

Java

Javascript

启用或禁用离线模式

用户设备离线时，您可以将 SDK 设为离线模式，将事件加入队列。在离线模式下，Adjust SDK 会存储所有事件，SDK 上线后会尝试发送事件。

重要提示:

离线模式设置在应用打开之间不被保存。即使在上一次应用打开时开启了离线模式，SDK 重新启动时也将始终处于在线模式。

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

Java

Javascript

跟踪特定来源的广告收入

Adjust SDK 支持从特定渠道合作伙伴接收广告收入信息。您可以将渠道合作伙伴 SDK 记录的信息以 JSON 对象的形式发送到 Adjust SDK。

请注意:

此功能只能用于特定广告收入来源。请查看受支持的来源列表。

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

Java

AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AdjustAdRevenueSourceAppLovinMAX);
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` 对象	您想跟踪的事件，应通过事件识别码进行初始化。

跟踪订阅

警告:

Adjust 已不再为新客户提供订阅记录服务。如果您已经设置了订阅记录，请联系您的专属技术客户经理或发送邮件至 support@adjust.com。

Adjust SDK 允许您跟踪应用内订阅事件相关的信息。为此，您可以创建订阅 (subscription) 对象，并将其传送给 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	长整型	包含币种符号的订阅价格。
currency	字符串	交易所使用货币的代码.
sku	字符串	产品 ID。
orderId	字符串	订单 ID。
signature	字符串	购买数据的数据签名。
purchaseToken	字符串	返回购买的唯一识别码。
purchaseTime	长整型	购买发生的时间。

要求 SDK 发送初始负载 (payload)

如果您延迟了 Adjust SDK 启动，SDK 就会在延迟计时器结束后才将信息发送给后端。您可以使用此方法要求 SDK 在延迟时间结束前发送包。

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