要配置 Adjust SDK 的行为,请指定 Adjust.initSdk
方法中的各属性。
必要配置
要配置 Adjust SDK,请使用下列参数调用 Adjust.initSdk
方法:
appToken
(string
):您的 Adjust 应用识别码。environment
(string
):SDK 运行的环境。传送sandbox
,可在 sandbox 模式下运行 SDK,方便进行测试;传送production
,可在生产模式下运行 SDK,方便发布。
日志选项
通过 Adjust SDK,您可以配置不同日志级别,返回不同数量的信息。可用的日志级别包括:
值 | 描述 |
---|---|
verbose | 启用完整日志 |
info | 返回信息、警告和错误日志 |
warning | 返回警告和错误日志 |
error | 只返回错误日志 |
none | 禁用所有日志 |
您可以通过在 initSdk
方法中指定 logLevel
参数来设置日志级别。若未传递值,则 SDK 默认使用 error
级别。
设置日志输出
您可以在网页应用中委派日志输出位置来直接在屏幕中显示日志。为此,请在 initSdk
方法中的 logOutput
参数中指定一个 HTML 选择器。SDK 日志会打印至此容器。
初始化选项
设置外部设备标识符
外部设备标识符是您为设备或用户自定义的一个值。您可以通过这个值在不同的会话和平台中识别用户。您也可以通过该值基于用户对安装进行去重,这样同一位用户就不会被记录为多次新安装了。请联系您的 Adjust 代表来开始使用外部设备 ID。
您还可以使用外部设备 ID 作为设备的自定义标识符。这可以确保您的数据与其他系统中的数据保持一致性。请在 Adjust.initSdk
调用中以 externalDeviceId
形式传送外部设备 ID。
如果您想在商业分析中使用外部设备 ID,则可以将其作为会话回传参数发送。
您可以将已有外部设备 ID 导入到 Adjust。这能保证 Adjust 服务器将未来的数据与已有设备记录相匹配。请联系您的 Adjust 代表,了解更多信息。
设置默认链接识别码
如果您的应用已预安装在设备上,那么则可以配置一个默认链接识别码。当用户首次打开预安装应用时,安装就会被归因给默认链接识别码。请在 Adjust.initSdk
调用的 defaultTracker
属性中传送您的识别码。
设置存储命名空间
Adjust SDK 默认创建一个用于存储数据的存储命名空间。您可以改写此设置并指定一个自定义命名空间来控制数据存储位置。
设置后,所有 SDK 存储在默认命名空间中的数据都会被转移到自定义命名空间。
您可以在 initSdk
方法中指定一个 namespace
属性,来设置自定义命名空间。
动态配置
为响应事件或用户进行的操作, 动态 配置选项可能在 SDK 的生命周期中发生变化。
开启和关闭离线模式
Adjust SDK 会实时向 Adjust 后端发送事件和会话数据。您可以通过将 SDK 设为离线状态来暂停信息的发送。在离线状态,SDK 会在浏览器的 IndexedDB 中存储所有数据,如不支持 IndexedDB,则会将数据存储在 localStorage。
您可以随时使用下列参数调用 switchToOfflineMode
方法,以开启和关闭离线模式:
事件缓冲
离线模式关闭后,SDK 会将所有已储存的信息发送至 Adjust 服务器。为此,请调用 switchBackToOnlineMode
方法。
禁用 SDK
应用打开时 Adjust SDK 会默认运行。您可以通过禁用和启用 Adjust SDK 来暂停或恢复记录。禁用 Adjust SDK 时,SDK 不会向 Adjust 服务器发送任何数据。
您可以调用 stop
方法来随时停用 SDK。
重新启用 SDK
您可以调用 restart
方法来随时重启 SDK。