AdjustConfig 类

您可以使用 AdjustConfig 类存储 Adjust SDK 的使用设置。

重要提示:

在初始化 Adjust SDK 之前，您需要设置 AdjustConfig 类。这是因为 SDK 会在运行时从该类中复制属性。

功能

通过 AdjustConfig 类设置 SDK

重要提示:

您需要调用该方法设置 SDK。

要设置 SDK，您需要将应用相关信息传递至 config 对象。请指定您的应用识别码、环境和日志级别。

AdjustConfig (Context context, String appToken, String environment, boolean allowSuppressLogLevel)

Java

Javascript

参数

参数	数据类型	描述	必要参数
`context`	字符串	应用程序环境相关全局信息接口。	是 (仅限标准 SDK)
`appToken`	字符串	应用的应用识别码。唯一标识符，可以在您的控制面板中找到，长度始终为 12 字符。	是 (仅限标准和 Web View SDK)
`environment`	字符串	应用的当前环境。我们利用该环境来区分真实流量和测试流量。请务必始终让该值保持有意义。这一点在进行收入跟踪时尤为重要。	是 (仅限标准和 Web View SDK)
`allowSuppressLogLevel`	布尔	如果设置为 `true` ，就允许使用 `LogLevel.SUPPRESS`，并替换 production 环境的默认值。	否

值

参数	标准值	Web View 值	描述
`environment`	`AdjustConfig.ENVIRONMENT_SANDBOX`	`AdjustConfig.EnvironmentSandbox`	指示应用程序正在测试中，在控制面板中不会显示为实时数据。
`environment`	`AdjustConfig.ENVIRONMENT_PRODUCTION`	`AdjustConfig.EnvironmentProduction`	指示应用程序正处于生产环境。数据为实时数据。

启用事件缓冲

若要在应用中触发大量事件，请考虑启用事件缓冲，以降低事件发送频率。启用事件缓冲后，Adjust SDK 不再实时发送事件，而是每分钟发送一次。缓冲会先保存事件，直至 Adjust SDK 将事件发送给 Adjust 后端。

void setEventBufferingEnabled (Boolean eventBufferingEnabled)

Java

Javascript

启用后台数据发送

默认状态下，只有应用在前台打开时，Adjust SDK 才会发送事件信息。不过，您可以进行设置，让 SDK 在应用后台运行时发送事件。

void setSendInBackground (boolean sendInBackground)

Java

Javascript

变更日志级别

您可以变更 logLevel 属性，调整从 Adjust SDK 收到的日志级别。部分日志级别仅在应用程序处于 sandbox 环境中运行时才可用。

void setLogLevel (LogLevel logLevel)

Java

Javascript

参数

参数	数据类型	描述
`logLevel`	字符串	要返回的日志级别。

值

标准值	Web View 值	描述
`LogLevel.VERBOSE`	`AdjustConfig.LogLevelVerbose`	启用完整日志。
`LogLevel.DEBUG`	`AdjustConfig.LogLevelDebug`	启用更详细的日志以进行问题调试。
`LogLevel.INFO`	`AdjustConfig.LogLevelInfo`	返回信息、警告、错误和断言日志。
`LogLevel.WARN`	`AdjustConfig.LogLevelWarn`	返回警告、错误和断言日志。
`LogLevel.ERROR`	`AdjustConfig.LogLevelError`	只返回错误和断言日志。
`LogLevel.ASSERT`	`AdjustConfig.LogLevelAssert`	只返回断言日志。
`LogLevel.SUPPRESS`	`AdjustConfig.LogLevelSuppress`	禁用所有日志。

设置自定义进程名称

如果您研发的是多进程应用，就需要在 config 对象中设置主进程名称。

void setProcessName (String processName)

Java

设置默认跟踪链接

您可以为应用设置默认跟踪链接。如果没有其他可读取的跟踪链接信息，Adjust SDK 就会使用该跟踪链接。

void setDefaultTracker (String defaultTracker)

Java

Javascript

参数

参数	数据类型	描述
`defaultTracker`	字符串	您希望设置的默认跟踪链接的跟踪码。

设置归因监听器 (listener)

您可以注册一个委托回传，以获取跟踪链接归因变化的通知。Adjust SDK 无法同步提供此信息。这是因为归因时需要考虑不同的来源。

void setOnAttributionChangedListener (OnAttributionChangedListener onAttributionChangedListener)

Java

Javascript

设置设备是否已知

您可以在 config 实例中指定设备是否已知。

void setDeviceKnown (boolean deviceKnown)

Java

Javascript

设置事件跟踪成功委托

您可以注册一个委托回传，在事件被成功跟踪时获得通知。

void setOnEventTrackingSucceededListener (OnEventTrackingSucceededListener onEventTrackingSucceededListener)

Java

config.setOnEventTrackingSucceededListener(newOnEventTrackingSucceededListener() {
    @Override
    public void onFinishedEventTrackingSucceeded(AdjustEventSuccess eventSuccessResponseData) {
        // ...
    }
});

Javascript

设置事件跟踪失败委托

您可以注册一个委托回传，在事件被跟踪失败时获得通知。

void setOnEventTrackingFailedListener (OnEventTrackingFailedListener onEventTrackingFailedListener)

Java

config.setOnEventTrackingFailedListener(newOnEventTrackingFailedListener() {
    @Override
    public void onFinishedEventTrackingFailed(AdjustEventFailure eventFailureResponseData) {
        // ...
    }
});

Javascript

设置会话跟踪成功委托

您可以注册一个委托回传，在会话被成功跟踪时获得通知。

void setOnSessionTrackingSucceededListener (OnSessionTrackingSucceededListener onSessionTrackingSucceededListener)

Java

config.setOnSessionTrackingSucceededListener(newOnSessionTrackingSucceededListener() {
    @Override
    public void onFinishedSessionTrackingSucceeded(AdjustSessionSuccess sessionSuccessResponseData) {
        // ...
    }
});

Javascript

设置会话跟踪失败委托

您可以注册一个委托回传，在会话被跟踪失败时获得通知。

void setOnSessionTrackingFailedListener (OnSessionTrackingFailedListener onSessionTrackingFailedListener)

Java

config.setOnSessionTrackingFailedListener(newOnSessionTrackingFailedListener() {
    @Override
    public void onFinishedSessionTrackingFailed(AdjustSessionFailure sessionFailureResponseData) {
        // ...
    }
});

Javascript

设置深度链接响应监听器 (listener)

您可以设置监听器 (listener) 来回应深度链接信息。监听器应当返回布尔值，指明您是否想在用户打开深度链接时启动活动。请查看深度链接指南了解更多信息。

void setOnDeeplinkResponseListener (OnDeeplinkResponseListener onDeeplinkResponseListener)

Java

config.setOnDeeplinkResponseListener(newOnDeeplinkResponseListener() {
    @Override
    public boolean launchReceivedDeeplink(Uri deeplink) {
        // ...
        if (shouldAdjustSdkLaunchTheDeeplink(deeplink)) {
            return true;
        } else {
            return false;
        }
    }
});

Javascript

延迟 SDK 启动

在应用激活之前，某些信息可能不可用。如果您需要等待数据，则可以延迟 SDK 首次启动。您可以指定 SDK 初始化的延迟时间 (以秒计)。

重要提示:

SDK 延迟仅适用于用户首次打开应用后的会话。此后，SDK 会在应用激活时立刻初始化，不会再延迟。

void setDelayStart (double delayStart)

Java

Javascript

参数

参数	数据类型	描述
`delayStart`	数字 (双精度浮点数)	您希望的延迟时间 (以秒计)。最大值为 10 秒。

设置外部设备 ID

外部设备标识符是您为设备或用户自定义的一个值。借助您自定义的外部设备标识符，即便设备标识符在多个会话和安装间发生变更，您也能识别用户。

void setExternalDeviceId (String externalDeviceId)

Java

Javascript

设置启用或禁用预安装跟踪

您可以通过 Adjust SDK 查看您的应用是否被预安装在了用户设备上。这么做的最好方式是使用系统 payload。为此，请在 config 对象中启用该功能。

void setPreinstallTrackingEnabled (boolean preinstallTrackingEnabled)

Java

Javascript

请求同时发送归因和成本数据

SDK 允许您指定是否同归因信息一起发送成本数据。

void setNeedsCost (boolean needsCost)

Java

Javascript

设置数据驻留

Adjust SDK 可以使用 URL 策略设置来优先选择地区终端。如果您正在使用数据驻留功能，可以利用该设置。

void setUrlStrategy (String urlStrategy)

Java

Javascript

参数

标准值	Web View 值	描述
`AdjustConfig.DATA_RESIDENCY_EU`	`AdjustConfig.DataResidencyEU`	将 GDPR 数据驻留地区设为欧盟 (EU)。
`AdjustConfig.DATA_RESIDENCY_TR`	`AdjustConfig.DataResidencyTR`	将数据驻留国设为土耳其。
`AdjustConfig.DATA_RESIDENCY_US`	`AdjustConfig.DataResidencyUS`	将数据驻留国设为美国。
`AdjustConfig.URL_STRATEGY_CHINA`	`AdjustConfig.UrlStrategyChina`	将 URL 策略指向 `app.adjust.world` 域
`AdjustConfig.URL_STRATEGY_CN`	`AdjustConfig.UrlStrategyCn`	将 URL 策略指向 `app.adjust.cn` 域
`AdjustConfig.URL_STRATEGY_CN_ONLY`	`AdjustConfig.UrlStrategyCnOnly`	将 URL 策略指向 `app.adjust.cn` 域名，但请求失败时，不会使用其他域名作为后备。
`AdjustConfig.URL_STRATEGY_INDIA`	`AdjustConfig.UrlStrategyIndia`	将 URL 策略指向 `app.adjust.net.in` 域