设置隐私功能

Adjust SDK 包含处理应用用户隐私的功能。

发送删除请求

+ (void)gdprForgetMe;

在处理个人数据方面，欧盟的《通用数据保护条例》(GDPR) 和全球类似的隐私法律 (CCPA、LGPD 等) 授予数据主体完全权利，其中包括删除权 (参见 GDPR 第 17条)( 1 )。作为数据处理方，Adjust 有义务支持您 (数据控制方) 处理来自应用用户的此类请求。

您可以通过调用 gdprForgetMe 方法来将用户的删除请求发送至 Adjust 服务器。收到通知后：

我们将从内部系统和数据库中永久删除用户的所有历史个人数据；
此外，Adjust 将不再通过 Adjust SDK 接收来自该用户/设备的数据。 ( 2 )

Swift
Objective-C

1
Adjust.gdprForgetMe()

1
[Adjust gdprForgetMe];

您可以使用 Adjust SDK 来记录用户对第三方数据分享设置的变更。请使用 AdjustThirdPartySharing 类配置第三方数据分享设置。

实例化 AdjustThirdPartySharing 对象

- (nullable id)initWithIsEnabled:(nullable NSNumber *)isEnabled;

要启用或禁用 Adjust SDK 第三方数据分享，请实例化一个 AdjustThirdPartySharing 对象。该对象中包含的变量控制 Adjust 处理第三方数据分享的方式。

要实例化第三方数据分享对象，请创建新的 AdjustThirdPartySharing 实例，并传送下列参数：

isEnabled (NSNumber)：第三方数据分享是否启用。传送 1 可启用第三方分享；传送 0 可禁用第三方分享。

Swift
Objective-C

1
guard let adjustThirdPartySharing = ADJThirdPartySharing(isEnabled: 1) else { return }
2
Adjust.trackThirdPartySharing(adjustThirdPartySharing)

1
ADJThirdPartySharing *adjustThirdPartySharing = [[ADJThirdPartySharing alloc] initWithIsEnabled:@1];
2
[Adjust trackThirdPartySharing:adjustThirdPartySharing];

完成 AdjustThirdPartySharing 对象实例化后，您就能以参数形式使用 AdjustThirdPartySharing 实例调用 Adjust.trackThirdPartySharing 方法，以向 Adjust 发送信息。

Swift
Objective-C

1
guard let adjustThirdPartySharing = ADJThirdPartySharing(isEnabled: 0) else { return }
2
Adjust.trackThirdPartySharing(adjustThirdPartySharing)

1
ADJThirdPartySharing *adjustThirdPartySharing = [[ADJThirdPartySharing alloc] initWithIsEnabled:@0];
2
[Adjust trackThirdPartySharing:adjustThirdPartySharing];

发送精细信息

- (void)addGranularOption:(nonnull NSString *)partnerName
                      key:(nonnull NSString *)key
                    value:(nonnull NSString *)value;

当用户更新第三方数据分享设置时，您可以附加较精细的信息，以此发送用户决定的更多细节。为此，请使用下列参数调用addGranularOption方法：

partnerName (NSString)：使用精细设置的合作伙伴的名称。
key (NSString)：选项 key。
value (NSString)：选项值。

可用合作伙伴如下：

合作伙伴名称	字符串值
Apple Ads	`apple_ads`
Facebook	`facebook`
Google Ads	`adwords`
Google Marketing Platform	`google_marketing_platform`
Snapchat	`snapchat`
腾讯	`tencent`
TikTok SAN	`tiktok_san`
X (前 Twitter)	`twitter`
Yahoo Gemini	`yahoo_gemini`
Yahoo Japan Search	`yahoo_japan_search`

Swift
Objective-C

1
guard let adjustThirdPartySharing = ADJThirdPartySharing(isEnabled:nil) else { return }
2
adjustThirdPartySharing.addGranularOption("PartnerA", key: "foo", value: "bar")
3
Adjust.trackThirdPartySharing(adjustThirdPartySharing)

1
ADJThirdPartySharing *adjustThirdPartySharing = [[ADJThirdPartySharing alloc] initWithIsEnabled:nil];
2
[adjustThirdPartySharing addGranularOption:@"PartnerA" key:@"foo" value:@"bar"];
3
[Adjust trackThirdPartySharing:adjustThirdPartySharing];

管理 Facebook “限制数据使用” 功能

为遵守《加州消费者隐私法案》(CCPA) 的规定，Facebook 提供了 “限制数据使用” (LDU) 功能。借助该功能，在有位于美国加利福尼亚州的用户选择拒绝数据出售时，您就能向 Facebook 发送通知。如果您希望将所有用户的默认许可状态设为拒绝，也可以使用该功能。

您可以通过向 addGranularOption 方法传递下列参数来更新 Facebook LDU 状态。

参数	描述
`partner_name`	请使用`facebook`来开启或关闭 LDU。
`data_processing_options_country`	用户所在的国家/地区 `0`: 要求 Facebook 使用地理位置。 `1`: 美利坚合众国。
`data_processing_options_state`	通知 Facebook 用户所处的州。 `0`: 要求 Facebook 使用地理位置。 `1000`: 加利福尼亚州 `1001`: 科罗拉多州 `1002`: 康涅狄格州

Swift
Objective-C

1
guard let tps = ADJThirdPartySharing(isEnabled:nil) else { return }
2
tps.addGranularOption("facebook", key: "data_processing_options_country", value: "1")
3
tps.addGranularOption("facebook", key: "data_processing_options_state", value: "1000")
4
Adjust.trackThirdPartySharing(tps)

1
ADJThirdPartySharing *tps = [[ADJThirdPartySharing alloc] initWithIsEnabled:@1];
2
[tps addGranularOption:@"facebook" key:@"data_processing_options_country" value:@"1"];
3
[tps addGranularOption:@"facebook" key:@"data_processing_options_state" value:@"1000"];
4
[Adjust trackThirdPartySharing:tps];

要符合欧盟的《数字市场法案》(Digital Markets Act，简称 DMA)，Google Ads 和 Google Marketing Platform 需要获得明确的用户许可，才能接收 Adjust 向其 API 发送的归因请求。要发送该许可，您需要针对合作伙伴将以下精细选项添加至第三方分享实例google_dma。

密钥	值	描述
`eea`	`1` (是) \| `0` (否)	告知 Adjust 安装应用的用户是否位于欧洲经济区。欧洲经济区包括欧盟成员国、瑞士、挪威、冰岛和斯洛文尼亚。
`ad_personalization`	`1` (是) \| `0` (否)	告知 Adjust 用户是否同意通过 Google Ads 和/或 Google Marketing Platform 接收个性化广告。此参数还为针对 Google Marketing Platform 的`npa`参数提供信息。
`ad_user_data`	`1` (是) \| `0` (否)	告知 Adjust 用户是否允许其广告主 ID 被用于归因相关目的。

Swift
Objective-C

1
guard let adjustThirdPartySharing = ADJThirdPartySharing(isEnabled:nil) else { return }
2
adjustThirdPartySharing.addGranularOption("google_dma", key: "eea", value: "1")
3
adjustThirdPartySharing.addGranularOption("google_dma", key: "ad_personalization", value: "1")
4
adjustThirdPartySharing.addGranularOption("google_dma", key: "ad_user_data", value: "1")
5
Adjust.trackThirdPartySharing(adjustThirdPartySharing)

1
ADJThirdPartySharing *adjustThirdPartySharing = [[ADJThirdPartySharing alloc]
2
                                                     initWithIsEnabled:nil];
3
[adjustThirdPartySharing addGranularOption:@"google_dma" key:@"eea" value:@"1"];
4
[adjustThirdPartySharing addGranularOption:@"google_dma" key:@"ad_personalization" value:@"1"];
5
[adjustThirdPartySharing addGranularOption:@"google_dma" key:@"ad_user_data" value:@"1"];
6
[Adjust trackThirdPartySharing:adjustThirdPartySharing];

更新合作伙伴分享设置

- (void)addPartnerSharingSetting:(nonnull NSString *)partnerName
                             key:(nonnull NSString *)key
                           value:(BOOL)value;

默认情况下，Adjust 会与您在应用设置中配置的合作伙伴分享所有指标。您可以使用 Adjust SDK，为每个合作伙伴分别更新第三方数据分享设置。为此，请使用下列参数调用 addPartnerSharingSetting 方法：

参数	数据类型	描述
`partnerName`	`String`	合作伙伴名称。下载可用合作伙伴的完整列表
`key`	`String`	与合作伙伴分享的指标
`value`	`Boolean`	用户的选择

您可以使用key来指定要禁用或重新启用的指标。如果您想启用/禁用所有指标的分享，可以使用all键。可用指标的完整列表如下：

ad_revenue
all
attribution
update
att_update
cost_update
event
install
reattribution

reattribution_reinstall
reinstall
rejected_install
rejected_reattribution
sdk_click
sdk_info
session
subscription
uninstall

当您针对合作伙伴的指标设置false值时，Adjust 将停止与该合作伙伴分享该指标。

示例

如果您想停止与特定合作伙伴分享所有指标，请发送带有false值的all键。

Swift
Objective-C

1
guard let adjustThirdPartySharing = ADJThirdPartySharing(isEnabled:nil) else { return }
2
adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", key: "all", value: false)
3
Adjust.trackThirdPartySharing(adjustThirdPartySharing)

1
ADJThirdPartySharing *adjustThirdPartySharing = [[ADJThirdPartySharing alloc] initWithIsEnabled:nil];
2
[adjustThirdPartySharing addPartnerSharingSetting:@"PartnerA" key:@"all" value:@NO];
3
[Adjust trackThirdPartySharing:adjustThirdPartySharing];

要重新启用分享，请发送带有true值的all键。

Swift
Objective-C

1
guard let adjustThirdPartySharing = ADJThirdPartySharing(isEnabled:nil) else { return }
2
adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", key: "all", value: true)
3
Adjust.trackThirdPartySharing(adjustThirdPartySharing)

1
ADJThirdPartySharing *adjustThirdPartySharing = [[ADJThirdPartySharing alloc] initWithIsEnabled:nil];
2
[adjustThirdPartySharing addPartnerSharingSetting:@"PartnerA" key:@"all" value:@YES];
3
[Adjust trackThirdPartySharing:adjustThirdPartySharing];

您可以使用不同的键多次调用addPartnerSharingSetting方法来停止或开始共享特定指标。例如，如果您只想与合作伙伴分享事件信息，则可以传递：

all 值为false以禁用所有信息分享。
event 值为true以启用事件共享。

Swift
Objective-C

1
guard let adjustThirdPartySharing = ADJThirdPartySharing(isEnabled:nil) else { return }
2
adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", key: "all", value: false)
3
adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", key: "event", value: true)
4
Adjust.trackThirdPartySharing(adjustThirdPartySharing)

1
ADJThirdPartySharing *adjustThirdPartySharing = [[ADJThirdPartySharing alloc] initWithIsEnabled:nil];
2
[adjustThirdPartySharing addPartnerSharingSetting:@"PartnerA" key:@"all" value:@NO];
3
[adjustThirdPartySharing addPartnerSharingSetting:@"PartnerA" key:@"event" value:@YES];
4
[Adjust trackThirdPartySharing:adjustThirdPartySharing];

设置 URL 策略

- (void)setUrlStrategy:(nullable NSArray *)urlStrategyDomains
        useSubdomains:(BOOL)useSubdomains
        isDataResidency:(BOOL)isDataResidency;

通过 URL 策略功能，您可以进行下列设置之一：

Adjust 储存您数据的国家/地区 (即数据驻留)。
接收 Adjust SDK 所发送流量的终端 (即 URL 策略)。

当应用运营的国家拥有严格的隐私规定时，此功能会非常有用。在您设置 URL 策略时，Adjust 会将数据储存在指定数据驻留地区，或将流量发送至选定域名。

要设置数据驻留国家，请使用以下参数调用AdjustConfig.setUrlStrategy方法：

urlStrategyDomains (NSArray)：接收您所发送 SDK 流量的数据驻留国家/地区或终端。
useSubdomains ( BOOL )：来源是否为子域名作为前缀。
isDataResidency ( BOOL )：域名是否用于数据驻留。

请查看下方映射列表。

URL 策略	主要和后备域名	使用子域名	数据驻留
欧盟数据驻留	`"eu.adjust.com"`	`true`	`true`
土耳其数据驻留	`"tr.adjust.com"`	`true`	`true`
数据驻留	`"us.adjust.com"`	`true`	`true`
中国统一 URL 策略	`"adjust.world"`, `"adjust.com"`	`true`	`false`
中国 URL 策略	`"adjust.cn"`, `"adjust.com"`	`true`	`false`
仅限中国地区的 URL 策略	`"adjust.cn"`	`true`	`false`
印度 URL 策略	`"adjust.net.in"`, `"adjust.com"`	`true`	`false`

Swift
Objective-C

1
let domain = [] as [String]
2
adjustConfig.setUrlStrategy(domain, useSubdomains: true, isDataResidency: false)

1
NSArray *domain = [];
2
[adjustConfig setUrlStrategy:domain useSubdomains:YES
3
                     isDataResidency:YES];

let domain = ["adjust.net.in", "adjust.com"]
adjustConfig?.setUrlStrategy(domain, useSubdomains: true, isDataResidency: false)

let domain = ["adjust.world", "adjust.com"]
adjustConfig?.setUrlStrategy(domain, useSubdomains: true, isDataResidency: false)

let domain = ["adjust.cn"]
adjustConfig?.setUrlStrategy(domain, useSubdomains: true, isDataResidency: false)

let domain = ["eu.adjust.com"]
adjustConfig?.setUrlStrategy(domain, useSubdomains: true, isDataResidency: true)

let domain = ["tr.adjust.com"]
adjustConfig?.setUrlStrategy(domain, useSubdomains: true, isDataResidency: true)

let domain = ["us.adjust.com"]
adjustConfig?.setUrlStrategy(domain, useSubdomains: true, isDataResidency: true)

NSArray *domain = [[NSArray alloc]
                       initWithObjects:@"adjust.net.in", @"adjust.com", nil];
[adjustConfig setUrlStrategy:domain useSubdomains:YES isDataResidency:NO];

NSArray *domain = [[NSArray alloc]
                       initWithObjects:@"adjust.world", @"adjust.com", nil];
[adjustConfig setUrlStrategy:domain useSubdomains:YES isDataResidency:NO];

NSArray *domain = [[NSArray alloc]
                       initWithObjects:@"adjust.cn", nil];
[adjustConfig setUrlStrategy:domain useSubdomains:YES isDataResidency:NO];

NSArray *domain = [[NSArray alloc]
                       initWithObjects:@"eu.adjust.com", nil];
[adjustConfig setUrlStrategy:domain useSubdomains:YES isDataResidency:YES];

NSArray *domain = [[NSArray alloc]
                       initWithObjects:@"tr.adjust.com", nil];
[adjustConfig setUrlStrategy:domain useSubdomains:YES isDataResidency:YES];

NSArray *domain = [[NSArray alloc]
                       initWithObjects:@"us.adjust.com", nil];
[adjustConfig setUrlStrategy:domain useSubdomains:YES isDataResidency:YES];

+ (void)trackMeasurementConsent:(BOOL)enabled;

如果您正在 Adjust 控制面板中使用数据隐私设置，那么则需要对 Adjust SDK 做出相应设置。这包括设置许可有效期和用户数据留存期。

要开启或关闭该功能，请使用下列参数调用 trackMeasurementConsent 方法：

measurementConsent (BOOL)：许可监测是 (true) 否 (false) 启用。

开启后，SDK 会将数据隐私设置发送至 Adjust 服务器。Adjust 服务器随后会将您的数据隐私规则应用于用户，Adjust SDK 将会继续如常运行。

Swift
Objective-C

1
Adjust.trackMeasurementConsent(true)

1
[Adjust trackMeasurementConsent:YES];

COPPA 合规

+ (void)enableCoppaCompliance;

如果您的应用需要符合 COPPA (儿童在线隐私保护法) 规定，请在 SDK 初始化前在 ADJConfig实例上调用enableCoppaCompliance 方法。此方法会进行如下操作：

禁用第三方数据分享。
阻止 SDK 读取设备和广告 ID (例如idfa )。

Swift
Objective-C

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox as? String
3
let adjustConfig = ADJConfig(
4
      appToken: yourAppToken,
5
      environment: environment)
6
adjustConfig?.enableCoppaCompliance()
7
Adjust.initSdk(adjustConfig)

1
#import "Adjust.h"
2

3
NSString *yourAppToken = @"{YourAppToken}";
4
NSString *environment = ADJEnvironmentSandbox;
5
ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:yourAppToken
6
                                                  environment:environment];
7

8
[adjustConfig enableCoppaCompliance];
9
[Adjust initSdk:adjustConfig];

禁用 IDFV 读取

- (void)disableIdfvReading;

您可以通过在ADJConfig实例上调用disableIdfvReading方法来阻止 Adjust SDK 读取供应商 ID (IDFV)。调用此方法时，Adjust SDK将无法读取设备的 IDFV 或将其发送至 Adjust。

Swift
Objective-C

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox
3
let adjustConfig = ADJConfig(
4
    appToken: yourAppToken,
5
    environment: environment)
6

7
adjustConfig?.disableIdfvReading();

1
NSString *yourAppToken = @"{YourAppToken}";
2
NSString *environment = ADJEnvironmentSandbox;
3
ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:@"{YourAppToken}"
4
                                              environment:ADJEnvironmentSandbox];
5

6
[adjustConfig disableIdfvReading];