请使用该文档中的方法配置 Adjust SDK 行为。
实例化 config 对象
public AdjustConfig(Context context, String appToken, String environment, boolean allowSuppressLogLevel) { init(context, appToken, environment, allowSuppressLogLevel);}
要配置 Adjust SDK,您需要实例化一个 AdjustConfig
对象。该对象包含 只读 配置选项。请将这些配置选项发送给 Adjust SDK。
要实例化您的 config 对象,请创建新的 AdjustConfig
实例,并传送下列参数:
context
(Context
):应用运行所在的 Android Context。传送this
,以获取当前应用 context。appToken
(String
):您的 Adjust 应用识别码。environment
(String
):SDK 运行的环境。传送AdjustConfig.ENVIRONMENT_SANDBOX
,可在 sandbox 模式下运行 SDK,方便进行测试;传送AdjustConfig.ENVIRONMENT_PRODUCTION
,可在生产模式下运行 SDK,方便发布。allowSuppressLogLevel
(Boolean
):是否禁用所有日志记录。设为true
可禁用日志记录;设为false
可启用日志记录。
val appToken = "{YourAppToken}"val environment = AdjustConfig.ENVIRONMENT_SANDBOXval config = AdjustConfig(this, appToken, environment, false)
String appToken = "{YourAppToken}";String environment = AdjustConfig.ENVIRONMENT_SANDBOX;AdjustConfig config = new AdjustConfig(this, appToken, environment, false);
只读配置
只读 配置选项需要在 SDK 初始化 之前 在 AdjustConfig
实例中设定。这些配置选项无法在 SDK 运行过程中变更。请务必在运行 Adjust.initSdk()
之前配置要使用的所有设置。
设置日志级别
public void setLogLevel(LogLevel logLevel)
通过 Adjust SDK,您可以配置不同日志级别,返回不同数量的信息。可用的日志级别包括:
logLevel | 描述 |
---|---|
LogLevel.VERBOSE | 启用完整日志 |
LogLevel.DEBUG | 启用调试记录 |
LogLevel.INFO | 仅显示信息层级日志 (默认选项) |
LogLevel.WARN | 禁用信息警告 |
LogLevel.ERROR | 禁用警告及更低级别日志 |
LogLevel.ASSERT | 禁用错误及更低级别日志 |
LogLevel.SUPPRESS | 禁止所有日志 |
您可以在 AdjustConfig
实例上使用下列参数调用 setLogLevel
方法,以设置日志级别:
logLevel
(LogLevel
):要使用的日志级别。
val appToken = "{YourAppToken}"val environment = AdjustConfig.ENVIRONMENT_SANDBOXval config = AdjustConfig(this, appToken, environment)config.setLogLevel(LogLevel.VERBOSE)//...Adjust.initSdk(config)
String appToken = "{YourAppToken}";String environment = AdjustConfig.ENVIRONMENT_SANDBOX;AdjustConfig config = new AdjustConfig(this, appToken, environment);config.setLogLevel(LogLevel.VERBOSE);//...Adjust.initSdk(config);
设置外部设备标识符
public void setExternalDeviceId(String externalDeviceId)
外部设备标识符是您为设备或用户自定义的一个值。您可以通过这个值在不同的会话和平台中识别用户。您也可以通过该值基于用户对安装进行去重,这样同一位用户就不会被记录为多次新安装了。请联系您的 Adjust 代表来开始使用外部设备 ID。
您还可以使用外部设备 ID 作为设备的自定义标识符。这可以确保您的数据与其他系统中的数据保持一致性。您可以使用下列参数调用 setExternalDeviceId
方法,以设置该属性:
externalDeviceId
(String
):您的外部设备标识符。需要 区分大小写 。如果您导入了外部设备 ID,则需要确保发送的值与已导入的值相匹配。
val appToken = "{YourAppToken}"val environment = AdjustConfig.ENVIRONMENT_SANDBOXval config = AdjustConfig(this, appToken, environment)config.externalDeviceId("{YourExternalDeviceId}")//...Adjust.initSdk(config)
String appToken = "{YourAppToken}";String environment = AdjustConfig.ENVIRONMENT_SANDBOX;AdjustConfig config = new AdjustConfig(this, appToken, environment);config.externalDeviceId("{YourExternalDeviceId}");//...Adjust.initSdk(config);
如果您想在商业分析中使用外部设备 ID,则可以将其作为会话回传参数发送。
您可以将已有外部设备 ID 导入到 Adjust。这能保证 Adjust 服务器将未来的数据与已有设备记录相匹配。请联系您的 Adjust 代表,了解更多信息。
设置默认链接识别码
public void setDefaultTracker(String defaultTracker)
如果您的应用已预安装在设备上,那么则可以配置一个默认链接识别码。当用户首次打开预安装应用时,安装就会被归因给默认链接识别码。要设置默认链接识别码,请使用下列参数调用 setDefaultTracker
方法:
defaultTracker
(String
):用于记录预安装应用安装的 Adjust 链接识别码。
val appToken = "{YourAppToken}"val environment = AdjustConfig.ENVIRONMENT_SANDBOXval config = AdjustConfig(this, appToken, environment)config.setDefaultTracker("{Token}")//...Adjust.initSdk(config)
String appToken = "{YourAppToken}";String environment = AdjustConfig.ENVIRONMENT_SANDBOX;AdjustConfig config = new AdjustConfig(this, appToken, environment);config.setDefaultTracker("{Token}");//...Adjust.initSdk(config);
启用成本数据发送
public void enableCostDataInAttribution()
默认情况下,Adjust 不会在用户归因信息中发送成本数据。您可以启用成本数据发送,使 SDK 发送成本数据。要启用成本数据发送,请调用enableCostDataInAttribution
方法。
您可以在用户的归因信息中访问成本数据。
val config = AdjustConfig(this, appToken, environment)config.enableCostDataInAttribution()Adjust.initSdk(config)
AdjustConfig config = new AdjustConfig(this, appToken, environment);config.enableCostDataInAttribution();Adjust.initSdk(config);
启用后台记录
public void enableSendingInBackground()
默认情况下,应用在后台运行时,Adjust SDK 会暂停发送请求。您可以通过启用后台记录功能来使 SDK 在应用位于后台时发送请求。要启用后台记录,请调用AdjustConfig.enableSendingInBackground
方法。
val appToken = "{YourAppToken}"val environment = AdjustConfig.ENVIRONMENT_SANDBOXval config = AdjustConfig(this, appToken, environment)config.enableSendingInBackground()//...Adjust.initSdk(config)
String appToken = "{YourAppToken}";String environment = AdjustConfig.ENVIRONMENT_SANDBOX;AdjustConfig config = new AdjustConfig(this, appToken, environment);config.enableSendingInBackground();//...Adjust.initSdk(config);
动态配置
为响应事件或用户进行的操作, 动态 配置选项可能在 SDK 的生命周期中发生变化。
激活离线模式
public static void switchToOfflineMode()
Adjust SDK 会实时向 Adjust 后端发送事件和会话数据。您可以通过将 SDK 设为离线状态来暂停信息的发送。在离线状态中,SDK 会在设备本地文件中存储所有数据。离线模式关闭后,SDK 会将此信息发送至 Adjust 服务器。
您可以随时调用Adjust.switchToOfflineMode
方法来开启和关闭离线模式。
Adjust.switchToOfflineMode()
Adjust.switchToOfflineMode();
Adjust.switchToOfflineMode();
禁用离线模式
public static void switchBackToOnlineMode()
您可以通过调用Adjust.switchBackToOnlineMode
方法来重新启用 SDK。这会提示 SDK 恢复发送信息。
Adjust.switchBackToOnlineMode()
Adjust.switchBackToOnlineMode();
Adjust.switchBackToOnlineMode();
设置推送标签 (Push token)
public static void setPushToken(final String token, final Context context)
推送标签 (Push token) 用于受众和客户回传。在卸载和重装跟踪中,推送标签也是必要的。
您的 config 对象包含一个pushToken
字符串属性,您可以通过该属性存储推送标签。您可以随时调用setPushToken
方法,并发送下列参数,以更新该属性:
token
(String
):您的推送标签 (Push token)。context
(Context
):应用运行所在的 Android Context。传送getApplicationContext()
,以获取当前应用 context。
Adjust.setPushToken("{YourPushToken}", getApplicationContext())
Adjust.setPushToken("{YourPushToken}", getApplicationContext());
Adjust.setPushToken("{YourPushToken}");
禁用 SDK
public static void disable()
应用打开时 Adjust SDK 会默认运行。您可以通过调用Adjust.disable
方法禁用 Adjust SDK,暂停向 Adjust 发送信息。禁用 Adjust SDK 时,SDK 不会向 Adjust 服务器发送任何数据。
Adjust.disable()
Adjust.disable();
启用 SDK
public static void enable()
如果您已经禁用了 SDK 并希望重新启用,请调用Adjust.enable
方法。启用后,SDK 会向 Adjust 服务器发送信息。
Adjust.enable()
Adjust.enable();
查看 SDK 启用状态
public static void isEnabled(final Context context, final OnIsEnabledListener isEnabledListener)
如果您想查看 Adjust SDK 当前是否启用,可以将回传函数传递至Adjust.isEnabled
方法来异步返回此信息。
Adjust.isEnabled(applicationContext) { isEnabled -> // Your callback function}
Adjust.isEnabled(getApplicationContext(), new OnIsEnabledListener() { @Override public void onIsEnabledRead(boolean isEnabled) { // Your callback function }});