操作前须知
在更新到 SDK v5 之前,您需要进行以下操作:
- SDK v5 支持SDK 签名验证。如果您当前正在使用 SDK 签名库,则需要先将其卸载。
- 如果您的应用针对的是低于21的 API 版本,则需要先更新应用才能使用 SDK v5。
安装 SDK
要开始使用 SDK v5,您需要将其添加为项目的依赖。为此请进行下列操作:
-
请移除build.gradle
文件中所有较旧版本的 SDK。
-
将以下依赖添加至您的build.gradle
文件:
更新初始化方法
在 SDK v4 中,初始化方法为Adjust.onCreate(AdjustConfig)
。在 SDK v5 中,该方法已变为Adjust.initSdk(AdjustConfig)
。
变更 API
SDK v5 中的以下 API 发生了变更。
禁用或启用 SDK
在 SDK v4 中,您可以通过调用带boolean
值的Adjust.setEnabled()
来启用和禁用 SDK。
- 调用
Adjust.setEnabled(false)
来禁用 SDK。
- 调用
Adjust.setEnabled(true)
来启用 SDK。
在 SDK v5 中,为清晰起见,此功能被分成单独的命令。
- 调用
Adjust.disable()
来禁用 SDK。
- 调用
Adjust.enable()
来启用 SDK。
离线模式
在 SDK v4 中,您可以通过调用带有boolean
值的Adjust.setOfflineMode()
来启用或禁用 SDK 中的离线模式。
在 SDK v5 中,为清晰起见,此功能被分成单独的命令。
- 调用
Adjust.switchToOfflineMode()
将 SDK 设为离线模式。
- 调用
Adjust.switchBackToOnlineMode()
将 SDK 重新设为在线模式。
预装记录
在 SDK v4 中,对于预安装应用,您可以使用 Adjust SDK,通过使用布尔参数调用AdjustConfig
实例的setPreinstallTrackingEnabled
方法向 Adjust 发送安装数据。
在 SDK v5 中,为清晰起见,该方法已被重命名为enabledPreinstallTracking
。这种新方法不带参数。
在归因中启用成本数据
在 SDK v4 中,您可以使用布尔参数调用AdjustConfig
实例的setNeedsCost
方法,使用 SDK 在用户归因数据中发送成本数据。
在 SDK v5 中,为清晰起见,该方法已被重命名为enableCostDataInAttribution
。这种新方法不带参数。
在 SDK v4 中,您可以使用 SDK,通过布尔参数调用AdjustConfig
实例的setSendInBackground
方法,在应用于后台运行时向 Adjust 发送信息。
在 SDK v5 中,该方法已重命名为enableSendingInBackground
。这种新方法不带参数。
只读取设备 ID 一次
在 SDK v4 中,您可以通过使用布尔值调用AdjustConfig
实例的setReadDeviceInfoOnceEnabled
方法,将 SDK 配置为在初始化时只读取设备 ID 一次。
在 SDK v5 中,为清晰起见,该方法已被重命名为enableDeviceIdsReadingOnce
。这种新方法不带参数。
会话回传参数
在SDK v5 中,会话回传参数已重命名为统一回传参数。
会话合作伙伴参数
在 SDK v5 中,会话合作伙伴参数已重命名为统一合作伙伴参数。
事件去重
在 SDK v4 中,事件去重与事件order ID
同时进行且唯一 ID 的数量上限为 10 个。
在 SDK v5 中,该功能与order ID
分离。事件去重添加了名为deduplicationId
的新 ID 字段。用户可以自定义deduplicationId
的数量限制,添加到用于识别重复事件的列表中。默认情况下,数量上限为 10 。
COPPA 合规
在 SDK v4 中,您可以通过布尔参数在 config 对象上调用setCoppaCompliantEnabled
方法来设置COPPA 合规性。
在 SDK v5 中,为清晰起见,该方法已被重命名为enableCoppaCompliance
。该新方法不接受任何参数。
Play Store 儿童应用
在 SDK v4 中,您可以通过布尔参数在 config 对象上调用setPlayStoreKidsAppEnabled
方法将应用标记为Play 商店儿童应用。
在 SDK v5 中,为清晰起见,该方法已被重命名为enablePlayStoreKidsCompliance
。该新方法不接受任何参数。
设置数据驻留和 URL 策略
在 SDK v4 中,URL 策略和数据驻留域名在AdjustConfig
类中被定义为常量。
在 SDK v5 中,您需要将选定的一个或多个域名以数组的形式发送。您还可以进行下列设置:
useSubdomains
( boolean
):来源是否为子域名作为前缀。
isDataResidency
( boolean
):域名是否用于数据驻留。
请查看下方表格,了解如何在 SDK v5 中配置 URL 策略。
v4 | v5 - 主要和后备域名 | v5 - 使用子域名 | v5 - 数据驻留 |
---|
AdjustConfig.DataResidencyEU | "eu.adjust.com" | true | true |
AdjustConfig.DataResidencyTR | "tr.adjust.com" | true | true |
AdjustConfig.DataResidencyUS | "us.adjust.com" | true | true |
AdjustConfig.UrlStrategyChina | "adjust.world" : "adjust.com" | true | false |
AdjustConfig.UrlStrategyCn | "adjust.cn" : "adjust.com" | true | false |
AdjustConfig.UrlStrategyCnOnly | "adjust.cn" | true | false |
AdjustConfig.UrlStrategyIndia | "adjust.net.in" : "adjust.com" | true | false |
示例
全局禁用第三方分享
在 SDK v4 中,您可以调用Adjust.disableThirdPartySharing()
方法来全面禁用第三方信息分享。
SDK v5 中已删除该功能。在 SDK v5 中,使用Adjust.trackThirdPartySharing()
方法来启用或禁用第三方共享。
设备 ID getter
在 SDK v4 中,所有设备 ID getter 方法都会同步运行。在 SDK v5 中,这些方法已改为异步运行。
移除 API
SDK v5 中移除了下列 API:
事件缓冲
SDK v4 支持事件缓冲。该功能可将请求事件、广告收入、推送标签 (Push token) 和其他信息存储在本地缓冲区中以便在之后发送。
SDK v5 中已删除该设置。
自定义用户代理字符串
SDK v4 支持使用用户代理字符串调用AdjustConfig
实例的setUserAgent
方法来设置自定义用户代理。
SDK v5 中已删除该设置。
设置设备是否已知
在 SDK v4 中,您可以调用AdjustConfig
实例的setDeviceKnown
方法,手动告知 SDK 设备是否为已知设备。
SDK v5 中已删除该设置。
延迟 SDK 启动
SDK v4 支持通过在AdjustConfig
实例上调用setDelayStart
方法来延迟 SDK 启动,最多延迟 120 秒 。如果应用在延迟结束前就绪,则可以通过调用Adjust.sendFirstPackages
立即发送信息。
在 SDK v5 中这两种方法都已被移除。
通过深度链接进行再归因
在 SDK v4 中,您可以在 Web bridge 中通过调用Adjust.appWillOpenUrl()
方法向 Adjust 发送深度链接 URL。
该方法在 SDK v5 中已被移除。
发送特定来源的广告收入
在SDK v4 中,您可以发送来源和负载至 Adjust.trackAdRevenue()
方法来发送特定来源的广告收入。
该方法在 SDK v5 中已被移除。
设置应用密钥
SDK v4 支持通过调用AdjustConfig
实例的setAppSecret
方法来设置应用密钥,以此对 SDK 流量进行签名。
SDK v5 中已删除该设置。