adjust-icon

配置

请使用该文档中的方法配置 Adjust SDK 行为。

实例化 config 对象

方法签名
ADJConfig2dx(std::string appToken, std::string environment, bool allowSuppressLogLevel, std::string sdkPrefix) {
initConfig(appToken, environment, allowSuppressLogLevel, sdkPrefix);
}

要配置 Adjust SDK,您需要实例化一个 AdjustConfig2dx 对象。该对象包含 只读 配置选项。请将这些配置选项发送给 Adjust SDK。

要实例化您的 config 对象,请创建新的 AdjustConfig2dx 实例,并传送下列参数:

  • appToken ( 字符串 ):您的 Adjust 应用识别码
  • environment ( 字符串 ):SDK 运行的环境。传送 AdjustEnvironmentSandbox2dx,可在 sandbox 模式下运行 SDK,方便进行测试;传送 AdjustEnvironmentProduction2dx,可在生产模式下运行 SDK,方便发布。
  • allowSuppressLogLevel ( 布尔 ):是否禁用所有日志记录。设为 true 可禁用日志记录;设为 false 可启用日志记录。
#include "Adjust/Adjust2dx.h"
// ...
std::string appToken = "{YourAppToken}";
std::string environment = AdjustEnvironmentSandbox2dx;
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment, false);
Adjust2dx::start(adjustConfig);

只读配置

只读 配置选项需要在 SDK 初始化 之前AdjustConfig2dx 实例中设定。这些配置选项无法在 SDK 运行过程中变更。请务必在运行 Adjust2dx::start() 之前配置要使用的所有设置。

设置日志级别

方法签名
void setLogLevel(ADJLogLevel2dx logLevel);

通过 Adjust SDK,您可以配置不同日志级别,返回不同数量的信息。可用的日志级别包括:

logLevel描述
AdjustLogLevel2dxVerbose启用完整日志
AdjustLogLevel2dxDebug启用调试记录
AdjustLogLevel2dxInfo仅显示信息级别日志 (默认选项)
AdjustLogLevel2dxWarn禁用信息日志
AdjustLogLevel2dxError禁用警告及更低级别日志
AdjustLogLevel2dxAssert禁用错误及更低级别日志
AdjustLogLevel2dxSuppress禁止所有日志

您可以在 AdjustConfig2dx 实例上使用下列参数调用 setLogLevel 方法,以设置日志级别:

  • logLevel ( ADJLogLevel2dx ):要使用的日志级别。
std::string appToken = "{YourAppToken}";
std::string environment = AdjustEnvironmentSandbox2dx;
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment, false);
adjustConfig.setLogLevel(AdjustLogLevel2dxSuppress);
Adjust2dx::start(adjustConfig);

设置外部设备标识符

方法签名
void setExternalDeviceId(std::string externalDeviceId);

外部设备标识符是您为设备或用户自定义的一个值。您可以通过这个值在不同的会话和平台中识别用户。您也可以通过该值基于用户对安装进行去重,这样同一位用户就不会被记录为多次新安装了。请联系您的 Adjust 代表来开始使用外部设备 ID。

您可以使用外部设备 ID 作为设备的自定义标识符。这可以确保您的数据与其他系统中的数据保持一致性。您可以使用下列参数调用 setExternalDeviceId 方法,以设置该属性:

  • externalDeviceId ( 字符串 ):您的外部设备标识符,需要 区分大小写 。如果您导入了外部设备 ID,则需要确保发送的值与已导入的值相匹配。
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
adjustConfig.setExternalDeviceId("{Your-External-Device-Id}");
Adjust2dx::start(adjustConfig);

如果您想在商业分析中使用外部设备 ID,则可以将其作为会话回传参数发送。

您可以将已有外部设备 ID 导入到 Adjust。这能保证 Adjust 服务器将未来的数据与已有设备记录相匹配。请联系您的 Adjust 代表,了解更多信息。

设置默认链接识别码

方法签名
void setDefaultTracker(std::string defaultTracker);

如果您的应用已预安装在设备上,那么则可以配置一个默认链接识别码。当用户首次打开预安装应用时,安装就会被归因给默认链接识别码。要设置默认链接识别码,请使用下列参数调用 setDefaultTracker 方法:

AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
adjustConfig.setDefaultTracker("{TrackerToken}");
Adjust2dx::adjustConfig(config);

启用成本数据发送

方法签名
void setNeedsCost(bool needsCost);

默认情况下,Adjust 不会在用户归因信息中发送成本数据。您可以启用成本数据发送,使 SDK 发送成本数据。要启用成本数据发送,请使用下列参数在 config 实例中调用 setNeedsCost 方法:

  • needsCost ( 布尔 ):设为 true 可启用成本数据发送;设为 false 可禁用成本数据发送。

您可以在用户的归因信息中访问成本数据。

AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
adjustConfig.setNeedsCost(true);
Adjust2dx::adjustConfig(config);

启用后台记录

方法签名
void setSendInBackground(bool isEnabled);

默认情况下,应用在后台运行时,Adjust SDK 会暂停发送请求。您可以通过启用后台记录功能来使 SDK 在应用位于后台时发送请求。要启用后台记录,请使用下列参数在 config 实例中调用 setSendInBackground 方法:

  • isEnabled ( 布尔 ):设为 true 可启用后台请求发送;设为 false 可禁用后台请求发送。
std::string appToken = "{YourAppToken}";
std::string environment = AdjustEnvironmentSandbox2dx;
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
adjustConfig.setSendInBackground(true);
Adjust2dx::start(adjustConfig);

启用事件缓冲

方法签名
void setEventBufferingEnabled(bool isEnabled);

用户在应用中触发事件后,Adjust SDK 会立即发送事件信息。您可以通过设置事件缓冲来按指定时间发送事件信息。事件缓冲会将事件存储在设备本地缓冲中,每分钟发送一批请求。

您的 config 对象包含一个eventBufferingEnabled 布尔属性,该属性控制此行为。要启用事件缓冲,请为 config 实例 eventBufferingEnabled 属性指定 布尔 值。

  • isEnabled ( 布尔 ):设为 true 可启用事件;设为 false 可禁用事件缓冲。
std::string appToken = "{YourAppToken}";
std::string environment = AdjustEnvironmentSandbox2dx;
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
adjustConfig.setEventBufferingEnabled(true);
Adjust2dx::start(adjustConfig);

延迟 SDK 启动

方法签名
void setDelayStart(double delayStart);

默认情况下,Adjust SDK 会在应用打开时启动。如果您想通过会话参数发送的数据在应用打开时不可用,那么则可以延迟 SDK 启动。当您想发送唯一标识符等信息时,这一方法尤其有效。

要配置启动延迟,请使用下列参数调用 setDelayStart 方法:

  • delayStart ( Double ):SDK 启动延迟事件 (以秒计)。您最多可以将 SDK 的启动时间延迟 10 秒。
std::string appToken = "{YourAppToken}";
std::string environment = AdjustEnvironmentSandbox2dx;
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
adjustConfig.setDelayStart(5.5);
Adjust2dx::start(adjustConfig);

动态配置

为响应事件或用户进行的操作, 动态 配置选项可能在 SDK 的生命周期中发生变化。

开启和关闭离线模式

方法签名
static void setOfflineMode(bool isOffline);

Adjust SDK 会实时向 Adjust 后端发送事件和会话数据。您可以通过将 SDK 设为离线状态来暂停信息的发送。在离线状态中,SDK 会在设备本地文件中存储所有数据。离线模式关闭后,SDK 会将此信息发送至 Adjust 服务器。

您可以随时使用下列参数调用 setOfflineMode 方法,以开启和关闭离线模式:

  • isOffline ( 布尔 ):设为 true 可启用离线模式;设为 false 可禁用离线模式。
Adjust2dx::setOfflineMode(true);

设置推送标签 (Push token)

方法签名
static void setDeviceToken(std::string deviceToken);

推送标签 (Push token) 用于受众和客户回传。在卸载和重装跟踪中,推送标签也是必要的。

您的 config 对象包含一个deviceToken字符串属性,您可以通过该属性存储推送标签。您可以随时调用setDeviceToken方法,并发送下列参数,以更新该属性:

  • deviceToken (字符串) :您的推送标签 (Push token)。
Adjust2dx::setDeviceToken("YourPushNotificationToken");

禁用或启用 SDK

方法签名
static void setEnabled(bool isEnabled);

应用打开时 Adjust SDK 会默认运行。您可以通过禁用和启用 Adjust SDK 来暂停或恢复记录。禁用 Adjust SDK 时,SDK 不会向 Adjust 服务器发送任何数据。

您可以随时使用下列参数调用 setEnabled 方法,以启用或禁用 SDK:

  • isEnabled ( 布尔 ):设为 true 可启用 SDK;设为 false 可禁用 SDK。
Adjust2dx::setEnabled(false);

查看启用状态

方法签名
static bool isEnabled();

您可以随时调用 isEnabled 方法,查看 Adjust SDK 是否已启用。该方法会返回 布尔 值来指示 SDK 是处于 启用 (true) 还是 禁用 (false) 状态。

Adjust2dx::isEnabled();