adjust-icon

隐私功能

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

发送删除请求

方法签名
public static void gdprForgetMe(final Context context)

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

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

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

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

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

实例化 AdjustThirdPartySharing 对象

方法签名
public AdjustThirdPartySharing(final Boolean isEnabled)

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

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

  • isEnabled (Boolean)：第三方数据分享是否启用。传送 true 可启用第三方分享；传送 false 可禁用第三方分享。

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

发送精细信息

方法签名
public void addGranularOption(final String partnerName,
                              final String key,
                              final String value)

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

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

管理 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: 康涅狄格州

要符合欧盟的《数字市场法案》(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 被用于归因相关目的。

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

密钥值描述
ad_user_data1 (是) | 0 (否)告知 Amazon Ads 用户是否同意分享个人数据用于监测目的。该许可适用于广告主在 Amazon Ads 用户界面中指定的所有核心平台服务 (CPS)。
ad_storage1 (是) | 0 (否)了解用户是否同意 Amazon Ads 使用营销相关数据存储

更新合作伙伴分享设置

方法签名
public void addPartnerSharingSetting(final String partnerName,
                                     final String key,
                                     final boolean value)

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

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

使用 partnerName 参数来选择要禁用或重新启用其指标共享设置的合作伙伴范围：

  • 传递 all 以更新所有合作伙伴（包括 SAN 合作伙伴、模块合作伙伴和动态回传）的共享设置。
  • 传递合作伙伴 ID，以更新特定合作伙伴的共享设置。SAN 和非 SAN 合作伙伴均支持使用合作伙伴 ID，建议使用。
  • 传递 dynamic_callbacks 以更新动态回传的共享设置。

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

  • ad_revenue
  • all
  • update
  • att_update
  • event
  • install
  • reattribution
  • reattribution_reinstall
  • reinstall
  • rejected_install
  • rejected_reattribution
  • sdk_click
  • sdk_info
  • session
  • subscription
  • uninstall

指标组

当您针对合作伙伴的指标设置 false 值时，Adjust 将停止与该合作伙伴分享该指标，以及指标组中的所有子级指标。这些嵌套组包括：

  • 会话

    • 安装

      • rejected_install

    • 重装

    • 再归因

    • rejected_reattribution

    • reattribution_reinstall

此处：

  • 如果禁用 session 分享，那么它的所有子级指标也将被禁用。
  • 如果您禁用 session 共享，但启用了 reattribution 共享，那么除 reattribution 外的所有对应子级指标都将被禁用。
  • 如果您禁用 session 共享，但启用了 install 共享，那么除 install 外的所有 session 子级指标都将被禁用。install 的子级指标将保持启用状态。
  • 如果您启用 session 共享，但禁用了 install 共享，那么除 install 外的所有 session 子级指标都将被启用。install 的子级指标将保持禁用状态。

示例

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

要重新启用针对特定合作伙伴的分享，请发送带有 true 值的 all 键。

如果您只想与 partner_id 分享数据，请进行下列传送：

  • all 键 (针对 all 合作伙伴)，值为 false，以禁用与全部合作伙伴分享所有信息。
  • all 键（针对 partner_id），值为 true，以明确启用与该合作伙伴共享全部信息。

如果您只想与 all 合作伙伴分享 session 数据，那么请进行下列传送：

  • all 键 (针对 all 合作伙伴)，值为 false，以禁用与全部合作伙伴分享所有信息。
  • session 键 (针对 all 合作伙伴)，值为 true，以启用与 all 合作伙伴的 session 数据及其全部相关“子级”指标。

如果您只想与 partner_id 分享 session 数据，那么请进行下列传送：

  • all 键 (针对 all 合作伙伴)，值为 false，以禁用与全部合作伙伴分享所有信息。
  • session 键（针对 partner_id），值为 true，以启用与该合作伙伴共享 session 数据及其全部相关“子级”指标。

如果您想禁用 dynamic_callbacks，请发送带有 false 值的 all 键。

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

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

设置 URL 策略

方法签名
public void setUrlStrategy(List<string> domains, boolean useSubdomains, boolean isDataResidency)

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

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

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

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

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

请查看下方映射列表。

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

示例

方法签名
public static void trackMeasurementConsent(final boolean consentMeasurement)

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

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

  • consentMeasurement (Boolean)：许可监测是 (true) 否 (false) 启用。

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

COPPA 合规

方法签名
public void enableCoppaCompliance()

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

  1. 禁用第三方数据分享。
  2. 防止 SDK 读取设备和广告 ID (例如gps_adid和android_id)。

Play 商店儿童应用

方法签名
public void enablePlayStoreKidsCompliance()

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

如需将应用标记为 Play 商店儿童应用，请在 SDK 初始化前在AdjustConfig实例上调用enablePlayStoreKidsCompliance方法。

获取当前第三方分享设置

向 Adjust 发送 AdjustThirdPartySharing 设置后，Adjust 后端的响应中会包含当前的总体设置。您可以通过调用 getter 方法或配置变更监听器来访问此信息。

第三方共享设置的获取器方法

调用 Adjust.getThirdPartySharingSettingsWithTimeout 方法返回具有当前第三方共享设置的 AdjustThirdPartySharingResult 对象。

方法签名
public void getThirdPartySharingSettingsWithTimeout(final Context context, final long timeoutInMilliSec, final OnThirdPartySharingSettingsReadListener listener)

要获取当前的第三方共享设置，请调用getThirdPartySharingSettingsWithTimeout方法，并传递以下参数 ：

  • context （Context）：应用程序的背景。
  • timeoutInMilliSec (long) ：超时时间（以毫秒计）。
  • listener (OnThirdPartySharingSettingsReadListener)：接收第三方分享设置的监听器。

如果 SDK 在指定的时限内检索到第三方共享设置，则会将其作为 AdjustThirdPartySharingResult 对象提供给您的监听器。否则会将 null 发送给您的监听器。

第三方分享设置发生变更时触发函数

方法签名
public void setOnThirdPartySharingSettingsChangedListener(OnThirdPartySharingSettingsChangedListener onThirdPartySharingSettingsChangedListener)

SDK 可以检测第三方分享设置变更并在检测到更新时调用函数。要配置您的回传函数，请使用 listener 作为参数调用 setOnThirdPartySharingSettingsChangedListener 方法。

禁用设备 ID 读取

SDK 提供多种方法，可限制读取和跟踪各种设备标识符。您可以使用这些方法来遵守隐私法规。

禁用 Google 广告 ID 读取

方法签名
public void disableGoogleAdIdReading()

默认情况下，Adjust SDK 会使用 Google Play 服务 API (如适用) 读取 Google 广告 ID。您可以配置 SDK，禁用 Google 广告 ID 的读取。要禁用 Google 广告 ID 读取，请在 AdjustConfig 实例上调用 disableGoogleAdIdReading 方法。

禁用 App Set ID 读取

方法签名
public void disableAppSetIdReading()

默认情况下，Adjust SDK 会使用 Google Play 服务 API (如适用) 读取 App Set ID。您可以配置 SDK，禁用 App Set ID 的读取。要禁用 App Set ID 读取，请在 AdjustConfig 实例上调用 disableAppSetIdReading 方法。

禁用安卓 ID 读取

方法签名
public void disableAndroidIdReading()

默认情况下，Adjust SDK 会在需要时读取安卓 ID。您可以配置 SDK，禁用安卓 ID 的读取。要禁用安卓 ID 的读取，请在您的 AdjustConfig 实例上调用 disableAndroidIdReading 方法。

禁用 Facebook ID 读取

方法签名
public void disableFbIdReading()

默认情况下，Adjust SDK 会读取 Facebook ID（如适用）。您可以配置 SDK，禁用 Facebook ID 的读取。要禁用 Facebook ID 读取，请在您的 AdjustConfig 实例上调用 disableFbIdReading 方法。

禁用 Fire 广告 ID 读取

方法签名
public void disableFireAdIdReading()

默认情况下，Adjust SDK 会读取 Fire 广告 ID（如适用）。您可以配置 SDK，禁用 Fire 广告 ID 的读取。要禁用 Fire 广告 ID 读取，请在 AdjustConfig 实例上调用 disableFireAdIdReading 方法。

禁用从插件读取设备 ID

方法签名
public void disableDeviceIdsFromPluginsReading()

默认情况下，Adjust SDK 会使用插件读取设备 ID（如适用）。您可以配置 SDK，禁用从插件读取设备 ID。要禁用从插件读取设备 ID，请在 AdjustConfig 实例上调用 disableDeviceIdsFromPluginsReading 方法。

禁用所有设备 ID 的读取

方法签名
public void disableDeviceIdsReading()

您还可以配置 SDK，一次性禁用所有设备 ID 的读取。要禁用所有设备 ID 的读取，请在AdjustConfig实例上调用disableDeviceIdsReading方法。