中文

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

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

You can set a default tracker for your app. The Adjust SDK will use this tracker when there is no other tracker information to read.

- (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

参数

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

The Adjust SDK enables you to specify if you need to send cost data as part of attribution.

- (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 策略

The Adjust SDK can use the url strategy setting to prioritise regional endpoints. You can use this if you are making use of the data residency feature.

- (NSString *) urlStrategy

Objective-C

Swift

Javascript