中文

ADJConfig 类

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

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

类方法

通过 ADJConfig 类设置 SDK

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

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

+ (nullable ADJConfig *) configWithAppToken: (nonnull NSString *) appToken
                                environment: (nonnull NSString *) environment
                      allowSuppressLogLevel: (BOOL) allowSuppressLogLevel 

Objective-C

Swift

Javascript

参数

返回值

实例方法

阻止与 SKAdNetwork 的通讯

默认状态下,Adjust SDK 将与 Apple 的 SKAdNetwork 分享信息。如果您不希望与 Apple 分享这些信息,可以禁用分享行为。

- (void) deactivateSKAdNetworkHandling

Objective-C

Swift

属性

启用/禁用 AdServices 框架数据读取

如果您在应用程序中添加了 AdServices.framework,Adjust SDK 就可以访问 AdServices 信息。要阻止该行为,请切换 allowAdServicesInfoReading 属性。

请注意:
默认状态下,该属性设为 true
- (BOOL) allowAdServicesInfoReading

Objective-C

Swift

启用/禁用 iAd 框架数据读取

默认状态下,Adjust SDK 将从 iAd 框架中读取信息用于 ASA 追踪。您可以切换 allowiAdInfoReading 属性禁用读取。

请注意:
默认状态下,该属性设为 true
- (BOOL) allowiAdInfoReading
Objective-C
Swift
[adjustConfig setAllowiAdInfoReading:NO];

启用/禁用 IDFA 读取

Adjust SDK 会读取设备的广告主 ID (IDFA),以提高归因的准确性。要禁用 IDFA 读取,请切换 allowIdfaReading 属性。

请注意:
默认状态下,该属性设为 true
- (BOOL) allowIdfaReading

Objective-C

Swift

针对自然安装设置默认跟踪链接

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

- (NSString *) defaultTracker

Objective-C

Swift

Javascript

参数

延迟 SDK 启动

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

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

Objective-C

Swift

Javascript

参数

设置委托 (delegate) 记录归因变更

Adjust SDK 可以通知您用户归因发生的变更。要启用通知,请注册一个委托 (delegate) 以记录归因变更。该信息将以 JSON 对象的方式供您访问。

请注意:
由于 Adjust 在归因时会考虑各种不同的来源,因此,该信息并不会实时提供。
- (NSObject< AdjustDelegate > *) delegate

Objective-C

Swift

Javascript

参数

启用事件缓冲

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

- (BOOL) eventBufferingEnabled

Objective-C

Swift

Javascript

变更日志级别

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

- (ADJLogLevel) logLevel

Objective-C

Swift

Javascript

参数

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

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

- (BOOL) needsCost

Objective-C

Swift

启用后台数据发送

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

- (BOOL) sendInBackground

Objective-C

Swift

Javascript

设置外部设备 ID

您可以添加自定义设备标识符,以在自己的 BI 系统中跟踪设备和用户。这是一种外部设备标识符,可以被设为您选择的任何值。

在获得标识符之前,您可能需要延迟 SDK 初始化

请注意:
externalDeviceId 的优先级低于广告 ID 等其他标识符,因此仅适用于新设备。现有设备将继续通过优先级更高的标识符进行归因。
- (NSString *) externalDeviceId

Objective-C

Swift

Javascript

设置 URL 策略

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

- (NSString *) urlStrategy

Objective-C

Swift

Javascript