AdjustConfig 类

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

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

功能

通过 AdjustConfig 类设置 SDK

重要提示:
您需要调用该方法设置 SDK。

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

AdjustConfig (Context context, String appToken, String environment, boolean allowSuppressLogLevel)
Java
Javascript
String appToken = "{YourAppToken}";
String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
AdjustConfig config = new AdjustConfig(this, appToken, environment, true);

参数

启用事件缓冲

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

void setEventBufferingEnabled (Boolean eventBufferingEnabled)
Java
Javascript
adjustConfig.setEventBufferingEnabled(true);

启用后台数据发送

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

void setSendInBackground (boolean sendInBackground)
Java
Javascript
adjustConfig.setSendInBackground(true);

变更日志级别

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

void setLogLevel (LogLevel logLevel)
Java
Javascript
adjustConfig.setLogLevel(LogLevel.WARN);

参数

设置自定义进程名称

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

void setProcessName (String processName)
Java
AdjustConfig.setProcessName("com.example.myapp:YourMainProcessName");

设置默认跟踪链接

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

void setDefaultTracker (String defaultTracker)
Java
Javascript
adjustConfig.setDefaultTracker("{LinkToken}");

参数

设置归因监听器 (listener)

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

void setOnAttributionChangedListener (OnAttributionChangedListener onAttributionChangedListener)
Java
Javascript
config.setOnAttributionChangedListener(new OnAttributionChangedListener() {
    @Override
    public void onAttributionChanged(AdjustAttribution attribution) {}
});

设置设备是否已知

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

void setDeviceKnown (boolean deviceKnown)
Java
Javascript
AdjustConfig.setDeviceKnown(true);

设置事件跟踪成功委托

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

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

设置事件跟踪失败委托

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

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

设置会话跟踪成功委托

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

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

设置会话跟踪失败委托

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

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

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

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

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

延迟 SDK 启动

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

重要提示:
SDK 延迟仅适用于用户首次打开应用后的会话。此后,SDK 会在应用激活时立刻初始化,不会再延迟。
void setDelayStart (double delayStart)
Java
Javascript
adjustConfig.setDelayStart(5.5);

参数

设置外部设备 ID

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

void setExternalDeviceId (String externalDeviceId)
Java
Javascript
adjustConfig.setExternalDeviceId("{YourExternalDeviceId}")

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

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

void setPreinstallTrackingEnabled (boolean preinstallTrackingEnabled)
Java
Javascript
adjustConfig.setPreinstallTrackingEnabled(true);

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

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

void setNeedsCost (boolean needsCost)
Java
Javascript
adjustConfig.setNeedsCost(true);

设置数据驻留

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

void setUrlStrategy (String urlStrategy)
Java
Javascript
adjustConfig.setUrlStrategy(AdjustConfig.DATA_RESIDENCY_EU);

参数