文档已更新。
中文(简体) 译文尚未完成。
英语更新时间:5月8日

适用于美国用户的数据处理选项

“限制数据使用”是一种数据处理选项,可让您进一步掌控 Meta 系统使用您数据的方式,并更好地支持您遵守各项美国州隐私法规。如要使用此功能,您必须主动启用“限制数据使用”。当 Meta 从“限制数据使用”适用的州的用户处收到启用了“限制数据使用”的数据时,我们将以服务提供方或处理方(如适用)身份处理这些数据,并按照特定州的条款规定,限制对这些数据的使用。

提供“限制数据使用”功能的 Meta 产品

以下 Meta 产品可提供“限制数据使用”功能。该功能的可用性视各州情况而异。详情请参阅以下表格:

加利福尼亚州科罗拉多州康涅狄格州佛罗里达州得克萨斯州俄勒冈州

Meta 业务工具

  • Meta Pixel 像素代码
  • 使用 Facebook SDK 的应用事件
  • 应用事件 API
  • 转化 API
  • 线下转化 API

2023 年 6 月 1 日起生效


2023 年 6 月 1 日起生效


2024 年 6 月 24 日起生效


2024 年 6 月 24 日起生效


2024 年 6 月 24 日起生效

Audience Network SDK


2023 年 6 月 1 日起生效


2023 年 6 月 1 日起生效


2024 年 6 月 24 日起生效


2024 年 6 月 24 日起生效


2024 年 6 月 24 日起生效

客户名单自定义受众


2023 年 6 月 1 日起生效

“限制数据使用”通过一个称为“数据处理选项”的参数发送,您可以选择在其中加入用户的国家/地区和州/省/自治区/直辖市数据。如果不确定用户的国家/地区和州/省/自治区/直辖市数据,广告主可以选择让 Meta 来确定事件或记录是否来自适用的州/省/自治区/直辖市。

对于业务工具和 Audience Network SDK

对于业务工具和 Audience Network,“限制数据使用”功能仅适用于加利福尼亚州、科罗拉多州、康涅狄格州、佛罗里达州、得克萨斯州或俄勒冈州的用户。如果企业启用了“限制数据使用”功能,但没有将位置参数设置为美国和加利福尼亚州、科罗拉多州、康涅狄格州、佛罗里达州、得克萨斯州或俄勒冈州,我们将确定事件是否来自其中某个州。如果企业为加利福尼亚州、科罗拉多州、康涅狄格州、佛罗里达州、得克萨斯州或俄勒冈州的事件启用了“限制数据使用”功能,我们将以服务提供方或处理方身份处理这些数据,并按照特定州的条款,限制对这些数据的使��。

企业可能会发现,启用“限制数据使用”功能后,广告表现和成效会受到影响,并且再营销和成效衡量功能会受到限制。

对于客户名单自定义受众

对于客户名单自定义受众,“限制数据使用”功能仅适用于加利福尼亚州的用户。如果企业针对来自加利福尼亚州的客户清单中的记录启用了“限制数据使用”,我们将以服务提供方身份处理数据,并按照特定州的条款,限制对这些数据的使用。如果企业启用了“限制数据使用”功能,但没有将位置参数设置为美国和加利福尼亚州,我们将确定记录是否来自加利福尼亚州。

企业可能会发现,启用“限制数据使用”功能后,受众规模会受到影响。

下文列出了受支持的 API。

如需详细了解数据处理选项,请参阅以下参考资料:

参考文档

字段描述

数据处理选项

数组

您想为特定事件或记录启用的处理选项。对于“限制数据使用”,当前可接受的值为 LDU


此字段的名称可以不同形式表示,具体取决于您使用的 API 和实现内容。例如,对于 Meta Pixel 像素代码 JavaScript 的调用,此字段名称为 dataProcessingOptions,而对于转化 API 的调用,则为 data_processing_options。如需了解调用示例,请参阅下文。


您可以发送一个空数组来明确指定,不得使用“限制数据使用”的限制来处理此事件或记录。

数据处理选项国家/地区

整数

对于大多数 API 是可选项。如需了解详细信息,请参阅下文备注。


您希望与此数据处理选项相关联的国家/地区。当前可接受的值为 1(代表美国),或者 0(请求 Meta 执行地理定位)。

数据处理选项州/省/自治区/直辖市

整数

对于大多数 API 是可选项。如需了解详细信息,请参阅以下说明。


您希望与此数据处理选项相关联的州/省/自治区/直辖市。当前可接受的值为 1000(表示加利福尼亚州)、1001(表示科罗拉多州)、1002(表示康涅狄格州)、1003(表示佛罗里达州)、1004(表示俄勒冈州)、1005(表示得克萨斯州),或者 0(请求我们执行地理定位)。


注意:

  • 如果您设置国家/地区,则必须同时设置州/省/自治区/直辖市。否则,我们将执行地理定位。

支持的工具和 API

Meta Pixel 像素代码

实现添加数据处理选项

浏览器 Pixel 像素代码

先更新 Pixel 像素代码初始化代码以指定 dataProcessingOptions 方法,然后再调用 fbq('init')


如要明确不启用“限制数据使用”(LDU),请使用以下代码:

fbq('dataProcessingOptions', []);
fbq('init', '{pixel_id}');
fbq('track', 'PageView');

如要启用 LDU 并让 Meta 执行地理定位,请使用以下代码:

fbq('dataProcessingOptions', ['LDU'], 0, 0);

如要启用 LDU 并指定位置(例如加利福尼亚州),请使用以下代码:

fbq('dataProcessingOptions', ['LDU'], 1, 1000);

图片标签

将以下内容添加至 Pixel 像素代码图片标签:

  • dpo:数据处理选项
  • dpoco:数据处理选项国家/地区
  • dpost:数据处理选项州/省/自治区/直辖市

请参阅参考资料,了解可接受的值。


如要明确不启用 LDU,请将 dpo 参数设为空值:

<img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&dpo=" />

如要启用 LDU 并让 Meta 执行地理定位,请使用以下代码:

<img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&vdpo=LDU&dpoco=0&dpost=0" />

如要启用 LDU 并手动指定位置(例如加利福尼亚州),请使用以下代码:

<img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&dpo=LDU&dpoco=1&dpost=1000" />

转化 API线下转化 API

对于应用事件 API 和线下转化 API,可在事件数据参数的每个事件内添加 data_processing_optionsdata_processing_options_countrydata_processing_options_state,借此实现数据处理选项。

注意:对于新的集成,我们不再推荐使用应用事件 API 和线下转化 API。我们推荐您改为使用转化 API,因为转化 API 现在支持网页事件、应用事件和线下事件。详情请参阅使用转化 API 传递应用事件使用转化 API 传递线下事件

如要明确不启用“限制数据使用”(LDU),请为每个事件指定空数组,或直接移除负载中的字段:

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": <EVENT_TIME>,
            "user_data": {
                "em": "<EMAIL>"
            },
            "custom_data": {
                "currency": "<CURRENCY>",
                "value": "<VALUE>"
            },
            "data_processing_options": []
        }
    ]
}

如要启用 LDU 并让 Meta 执行地理定位,请使用以下代码:

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": <EVENT_TIME>,
            "user_data": {
                "em": "<EMAIL>",
                "client_ip_address": "256.256.256.256"
            },
            "custom_data": {
                "currency": "<CURRENCY>",
                "value": "<VALUE>"
            },
            "data_processing_options": ["LDU"],
            "data_processing_options_country": 0,
            "data_processing_options_state": 0
        }
    ]
}

如要启用 LDU 并手动指定位置(例如加利福尼亚州),请使用以下代码:

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": <EVENT_TIME>,
            "user_data": {
                "em": "<EMAIL>"
            },
            "custom_data": {
                "currency": "<CURRENCY>",
                "value": "<VALUE>"
            },
            "data_processing_options": ["LDU"],
            "data_processing_options_country": 1,
            "data_processing_options_state": 1000
        }
    ]
}

手动上传用户界面

线下转化 API 提供手动上传选项,支持通过 .csv 文件上传事件。在这种情况下,请将“数据处理选项”、“数据处理国家/地区”和“数据处理州/省/自治区/直辖市”添加为文件中的列。如需有关该内容的更多信息,请前往上传用户界面。

应用事件 API

Graph API

To implement Data Processing Options using the Graph API, add data_processing_options, data_processing_options_country, and data_processing_options_state to your API call.

To explicitly not enable LDU, send an empty data_processing_options array:

{
  "event": "CUSTOM_APP_EVENTS",
  "application_tracking_enabled": "1",
  "advertiser_tracking_enabled": "1",
  "custom_events": ["fb_mobile_purchase"],
  "data_processing_options": []
}  

To enable LDU and have Meta perform geolocation, you can send an event with the following code:

{
  "event": "CUSTOM_APP_EVENTS",
  "application_tracking_enabled": "1",
  "advertiser_tracking_enabled": "1",
  "custom_events": ["fb_mobile_purchase"],
  "data_processing_options": ["LDU"],
  "data_processing_options_country": 0,
  "data_processing_options_state": 0
}  

To enable LDU and manually specify the location, e.g., for California, you can send an event with the following code:

  {
  "event": "CUSTOM_APP_EVENTS",
  "application_tracking_enabled": "1",
  "advertiser_tracking_enabled": "1",
  "custom_events": ["fb_mobile_purchase"],
  "data_processing_options": ["LDU"],
  "data_processing_options_country": 1,
  "data_processing_options_state": 1000
}  

Mobile SDKs

We recommend using our latest versions to ensure the functionality of Data Processing Options. The below implementation instructions are accurate for the following SDK versions:

  • iOS Facebook SDK v7.1.1 or higher
  • Android Facebook SDK v7.1.0 or higher
  • Unity SDK v7.21.0 or higher

Please update if you are using any versions below the ones listed above.

As of July 1, 2023, we are ending the Transition Period for older versions of App Events via the Facebook SDK, whereby we applied Limited Data Use to all personal information shared about people in California. The ability to enable default Limited Data Use will no longer be available for any versions below iOS Facebook SDK v7.1.1, Android Facebook SDK v7.1.0 and Unity SDK v7.21.0. If you choose to use Limited Data Use for a person in California, Colorado, Connecticut, Florida, Texas, or Oregon on or after July 1, 2023, you must update your SDK and implement Data Processing Options as set forth in this document.

ImplementationAdding Data Processing Options

Facebook SDK for iOS v7.1.1+ (Objective-C)

With Objective-C, use FBSDKSettings setDataProcessingOptions.


To explicitly not enable Limited Data Use (LDU), use:

[FBSDKSettings setDataProcessingOptions:@[]];

To enable LDU and have Meta perform geolocation, use:

[FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; 

To enable LDU and manually specify the location, e.g., for California, use:

[FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];   

Facebook SDK for iOS v7.1.1+ (Swift)

With Swift, use setDataProcessingOptions.


To explicitly not enable LDU, use:

Settings.setDataProcessingOptions(modes: [])   

To enable LDU and have Meta perform geolocation, use:

Settings.setDataProcessingOptions(modes: ["LDU"], country: 0, state: 0)

To enable LDU and manually specify the location, e.g., for California, use:

Settings.setDataProcessingOptions(modes: ["LDU"], country: 1, state: 1000)  

Facebook SDK for Android v7.1.0+

Use the setDataProcessingOptions method.


To explicitly not enable LDU, use:

FacebookSdk.setDataProcessingOptions(new String[] {});   

To enable LDU and have Meta perform geolocation, use:

FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);   

To enable LDU and manually specify the location, e.g., for California, use:

FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);  

Unity SDK v7.21.1+

To explicitly not enable LDU, send an event with:

FB.Mobile.SetDataProcessingOptions(new string[] {});

To enable LDU and have Meta perform geolocation, send an event with:

FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0); 

To enable LDU and manually specify the location, e.g., for California, send an event with:

FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000);  

Audience Network SDK

We recommend using our latest Audience Network SDK versions to ensure the functionality of Data Processing Options. The below implementation instructions are accurate for Audience Network SDK versions 5.10 and above.

As of July 1, 2023, we are ending the Transition Period for older versions of Audience Network SDK, whereby we limited the data for all personal information that businesses share about people in California and the ability to enable default Limited Data Use will not be available for Audience Network SDK versions below 5.10. If you choose to use Limited Data Use to indicate a person in California, Colorado, Connecticut, Florida, Texas, or Oregon or on or after July 1, 2023, you must update your SDK and implement Data Processing Options as set forth in this document.

ImplementationAdding Data Processing Options

Facebook SDK for iOS, v5.10+

Use FBAdSettings setDataProcessingOptions.


To explicitly not enable Limited Data Use (LDU), use:

[FBAdSettings setDataProcessingOptions:@[]];

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

Facebook SDK for Android, v5.10+

Use the setDataProcessingOptions method.


To explicitly not enable Limited Data Use (LDU), use:

AdSettings.setDataProcessingOptions(new String[] {}) 

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

Unity SDK, v5.10+ (not using the Audience Network-supplied Unity wrapper)

If you are not using the Audience Network-supplied Unity wrapper, enter the following code.


using UnityEngine;
using System.Runtime.InteropServices;

namespace AudienceNetwork
{
public static class AdSettings
{

public static void SetDataProcessingOptions(string[] dataProcessingOptions)
{
#if UNITY_ANDROID
AndroidJavaClass adSettings = new AndroidJavaClass("com.facebook.ads.AdSettings");
adSettings.CallStatic("setDataProcessingOptions", (object)dataProcessingOptions);
#endif

#if UNITY_IOS
FBAdSettingsBridgeSetDataProcessingOptions(dataProcessingOptions, dataProcessingOptions.Length);
#endif
}

public static void SetDataProcessingOptions(string[] dataProcessingOptions, int country, int state)
{
#if UNITY_ANDROID
AndroidJavaClass adSettings = new AndroidJavaClass("com.facebook.ads.AdSettings");
adSettings.CallStatic("setDataProcessingOptions", (object)dataProcessingOptions, country, state);
#endif

#if UNITY_IOS
FBAdSettingsBridgeSetDetailedDataProcessingOptions(dataProcessingOptions, dataProcessingOptions.Length, country, state);
#endif
}

#if UNITY_IOS
[DllImport("__Internal")]
private static extern void FBAdSettingsBridgeSetDataProcessingOptions(string[] dataProcessingOptions, int length);

[DllImport("__Internal")]
private static extern void FBAdSettingsBridgeSetDetailedDataProcessingOptions(string[] dataProcessingOptions, int length, int country, int state);
#endif
}
}

After entering this code, you can follow the Unity SDK instructions in the row below as if you are using the Unity wrapper.

Unity SDK, v5.10+ (using the Audience Network-supplied Unity wrapper)

If you are using the Audience Network-supplied Unity wrapper, use the following SetDataProcessingOptions.


To explicitly not enable LDU, use:

AdSettings.SetDataProcessingOptions(new string[]{})

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0);

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000);

Publishers using a Mediation Partner must set the Data Processing Options (Limited Data Use) on the Meta Audience Network SDK before initializing the Mediation SDK so that it is received by us in the bidding request.

ImplementationAdding Data Processing Options

Android

To explicitly not enable LDU for the event, use:

AdSettings.setDataProcessingOptions(new String[] {}) 

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

After setting LDU, initialize the Mediation Partner SDK as per usual.

iOS

To explicitly not enable Limited Data Use (LDU), use:

FBAdSettings setDataProcessingOptions:@[]];

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

After setting the LDU for the event, initialize the Mediation Partner SDK as per usual.

For publishers that are working with us through Bidding Kit and other Server-side Bidding, please follow the implementation methods below.

ImplementationAdding Data Processing Options

Android/Bidding Kit 2.0

To explicitly not enable LDU, use:

AdSettings.setDataProcessingOptions(new String[] {})

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

After setting the LDU for the event, generate the bidder token:

String token = BidderTokenProvider.getBidderToken(Context);

iOS/Bidding Kit 2.0

To explicitly not enable Limited Data Use (LDU), use:

[FBAdSettings setDataProcessingOptions:@[]];

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

After setting the LDU for the event, generate the bidder token:

NSString *token = [FBAdSettings bidderToken];

Other Server-Side Bidding

For each platform follow the instructions below to specify LDU for the event and retrieve the bidder token before making the server-side bid request.


For Android client:

To explicitly not enable LDU, use:

AdSettings.setDataProcessingOptions(new String[] {}) 

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

After setting the LDU for the event, generate the bidder token:

String token = BidderTokenProvider.getBidderToken(Context);

For iOS client:

To explicitly not enable Limited Data Use (LDU), use:

[FBAdSettings setDataProcessingOptions:@[]];

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

After setting the LDU for the event, generate the bidder token:

NSString *token = [FBAdSettings bidderToken];

客户名单自定义受众

自 2023 年 6 月 1 日起,如果您想在客户名单自定义受众中为加利福尼亚州用户启用“限制数据使用”功能,则必须上传新受众或更新现有受众,以在受众中加入“限制数据使用”标签。请视需要,定期更新和维护您的受众和用户的“限制数据使用”功能状态。

请注意,应用于某个受众中特定用户的“限制数据使用”标记不会自动转移到其���的受众。正如广告主必须根据自己选择的标准单独管理每个现有客户名单自定义受众,他们必须将“限制数据使用”标记单独应用于他们在广告中使用的每个受众。

如要为记录明确不启用 LDU,您可以发送空的 data_processing_options 数组,或将该字段从负载中移除。空数组示例:

{
   "payload": {
       "schema": [
           "EMAIL",
                    "DATA_PROCESSING_OPTIONS"
       ],
       "data": [
           [
               "<HASHED_DATA>
",
                           []
           ]
       ]
   }
}

如要明确启用 LDU 并让 Meta 执行地理定位(不提供特定记录的国家/地区和州/省/自治区/直辖市的数据),请指定一个数组,该数组中每项记录都包含 LDU

{
   "payload": {
       "schema": [
           "EMAIL",
                    "DATA_PROCESSING_OPTIONS"
       ],
       "data": [
           [
               "<HASHED_DATA>
",
                           ["LDU"]
           ]
       ]
   }
}

如要启用 LDU 并手动指定位置,请使用以下代码:

{
    "customer_consent": true,
    "payload": {
        "schema": [
            "EMAIL",
            "DATA_PROCESSING_OPTIONS",
            "DATA_PROCESSING_OPTIONS_COUNTRY",
            "DATA_PROCESSING_OPTIONS_STATE"
        ],
        "data": [
            [
                "<HASHED_DATA>",
                ["LDU"],
                1,
                1000
            ]
        ]
    }
}