adjust-icon

设置隐私功能

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

发送删除请求

方法签名
gdprForgetMe: () => void

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

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

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

针对特定用户的第三方分享

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

实例化 AdjustThirdPartySharing 对象

方法签名
constructor(isEnabled: boolean)

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

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

  • isEnabled (boolean):第三方数据分享是否启用。传送 true 可启用第三方分享;传送 false 可禁用第三方分享。
var adjustThirdPartySharing = new AdjustThirdPartySharing(true);
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

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

var adjustThirdPartySharing = new AdjustThirdPartySharing(false);
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

发送精细信息

方法签名
public addGranularOption(partnerName: string, key: string, value: string): void

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

  • partnerName (string):适用精细设置的合作伙伴的名称。
  • key (string):选项 key。
  • value (string):选项值。
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
adjustThirdPartySharing.addGranularOption("PartnerA", "key", "value");
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: 康涅狄格州
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
adjustThirdPartySharing.addGranularOption(
"facebook",
"data_processing_options_country",
"1",
);
adjustThirdPartySharing.addGranularOption(
"facebook",
"data_processing_options_state",
"1000",
);
Adjust.trackThirdPartySharing(adjustThirdPartySharing);
于 v4.26.0 中添加

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

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

禁用第三方分享

方法签名
disableThirdPartySharing: () => void

要为所有用户禁用第三方数据分享,请调用 disableThirdPartySharing 方法。Adjust 服务器收到此信息后,会停止向第三方分享该用户的数据,而 Adjust SDK 将会继续如常运行。

Adjust.disableThirdPartySharing();

更新合作伙伴分享设置

方法签名
public addPartnerSharingSetting(partnerName: string, key: string, value: boolean): void

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

参数数据类型描述
partnerNameString合作伙伴名称。下载可用合作伙伴的完整列表
keyString与合作伙伴分享的指标
valueBoolean用户的选择

您可以使用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键。

var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", "all", false);
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

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

var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", "all", true);
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

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

  • all 值为false以禁用所有信息分享。
  • event 值为true以启用事件共享。
var adjustThirdPartySharing = new AdjustThirdPartySharing(null);
adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", "all", false);
adjustThirdPartySharing.addPartnerSharingSetting("PartnerA", "event", true);
Adjust.trackThirdPartySharing(adjustThirdPartySharing);

数据驻留

方法签名
public setUrlStrategy(urlStrategy: UrlStrategy): void

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

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

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

要设置数据驻留国家,请在 AdjustConfig 实例上使用下列参数调用 setUrlStrategy 方法:

  • urlStrategy (string):接收您所发送 SDK 流量的数据驻留国家/地区或终端。
描述
AdjustConfig.DataResidencyEU将数据驻留地区设为欧盟
AdjustConfig.DataResidencyTR将数据驻留地区设为土耳其
AdjustConfig.DataResidencyUS将数据驻留地区设为美利坚合众国
AdjustConfig.UrlStrategyChina将 URL 策略指定到 app.adjust.world
AdjustConfig.UrlStrategyCn将 URL 策略指定到 app.adjust.cn
AdjustConfig.UrlStrategyCnOnly将 URL 策略指向app.adjust.cn域名,但请求失败时,不会使用其他域名作为后备。
AdjustConfig.UrlStrategyIndia将 URL 策略指定到 app.adjust.net.in
const adjustConfig = new AdjustConfig(
"{YourAppToken}",
AdjustConfig.EnvironmentSandbox,
);
adjustConfig.setUrlStrategy(AdjustConfig.DataResidencyEU);
Adjust.create(adjustConfig);
方法签名
trackMeasurementConsent: (measurementConsent: boolean) => void

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

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

  • consentMeasurement (boolean):许可监测是 (true) 否 (false) 启用。

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

Adjust.trackMeasurementConsent(true);

COPPA 合规

方法签名
public setCoppaCompliantEnabled(coppaCompliantEnabled: boolean): void

要让您的应用符合 COPPA (儿童在线隐私保护法) 规定,请调用 setCoppaCompliantEnabled 方法。此方法会进行如下操作:

  1. 禁止应用在用户首次 session 与第三方分享数据。
  2. 防止 SDK 读取设备和广告 ID (例如gps_adidandroid_id)。
const adjustConfig = new AdjustConfig(
"{YourAppToken}",
AdjustConfig.EnvironmentSandbox,
);
adjustConfig.setCoppaCompliantEnabled(true);
Adjust.create(adjustConfig);

您可以通过false参数调用方法,对其进行禁用。

Play 商店儿童应用 (仅限安卓)

方法签名
public setPlayStoreKidsAppEnabled(playStoreKidsAppEnabled: boolean): void

如果您的应用会定向到不满 13 周岁的儿童,且安装地区 位于美国,则需要将其标记为儿童应用 (Kids App)。这可以防止 SDK 读取设备和广告 ID (例如gps_adidandroid_id)。

要将应用标记为 “儿童应用”,请使用下列参数调用 setPlayStoreKidsAppEnabled 方法:

  • playStoreKidsAppEnabled (boolean):设为 true,可将应用标记为儿童应用;设为 false,可将应用标记为非儿童应用。
const adjustConfig = new AdjustConfig(
"{YourAppToken}",
AdjustConfig.EnvironmentSandbox,
);
adjustConfig.setPlayStoreKidsAppEnabled(true);
Adjust.create(adjustConfig);