市场营销 API

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

“限制数据使用”是一种数据处理选项，可让您进一步掌控 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_options、data_processing_options_country 和 data_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

如果您要调用应用事件 API 而不是直接从用户设备发送数据，则必须使用 HTTP X-Forwarded-For 标头发送客户端 IP 地址，或明确指定地理位置。

图谱 API

要使用图谱 API 实施数据处理选项，请将 data_processing_options、data_processing_options_country 和 data_processing_options_state 添加到您的 API 调用。要明确不启用 LDU 模式，请发送一个空的 data_processing_options 数组：
{
  "event": "CUSTOM_APP_EVENTS",
  "application_tracking_enabled": "1",
  "advertiser_tracking_enabled": "1",
  "custom_events": ["fb_mobile_purchase"],
  "data_processing_options": []
}
要为带有地理位置的用户启用 LDU，您可使用以下代码发送事件：
{
  "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
}
要为用户启用 LDU 并指定用户地理位置，您可使用以下代码发送事件：
  {
  "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
}

移动 SDK

实施添加数据处理选项

iOS 版 SDK (Objective C)

对于 Objective C，请使用 FBSDKSettings setDataProcessingOptions。


要明确不启用受限数据使用 (LDU) 模式，请使用：

[FBSDKSettings setDataProcessingOptions:@[]];

要启用带有地理位置的 LDU，请使用：

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

要为用户启用 LDU 并指定用户地理位置，请使用：

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

iOS 版 SDK (Swift)

对于 Swift，请使用 setDataProcessingOptions。


要明确不启用 LDU 模式，请使用：

Settings.setDataProcessingOptions(modes: [])

要为带有地理位置的用户启用 LDU，请使用：

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

要为用户启用 LDU 并指定用户地理位置，请使用：

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

Android 版 SDK

请使用 setDataProcessingOptions 方法。


要明确不启用 LDU 模式，请使用：

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

要为带有地理位置的用户启用 LDU，请使用：

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

要为带有指定地理位置的用户启用 LDU，请使用：

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

Unity SDK

要明确不启用 LDU 模式，请使用以下代码发送事件：

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

要为带有地理位置的用户启用 LDU，请使用以下代码发送事件：

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

要为用户启用 LDU 并指定用户地理位置，请使用以下代码发送事件：

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

Audience Network SDK

升级到 Audience Network SDK 版本 5.10 或更高版本的发行商，必须设置“受限数据使用”标记，这样 Facebook 才能继续限制发行商分享的加利福尼亚州用户的个人信息。

实施添加数据处理选项

iOS 版 SDK，v5.10 及更高版本

使用 FBAdSettings setDataProcessingOptions。


要明确不启用受限数据使用 (LDU) 模式，请使用：

[FBAdSettings setDataProcessingOptions:@[]];

要为用户启用 LDU 并指定用户地理位置，请使用：

  • 国家/地区：1 表示美国
  • 州/省：1000 表示加利福尼亚州。
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

要为带有地理位置的用户启用 LDU，操作如下：

  • 国家/地区： 使用 0 以请求我们为此事件指定地理位置
  • 州/省： 使用 0 以请求我们为此事件指定地理位置。
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

Android 版 SDK，v5.10 及更高版本

请使用 setDataProcessingOptions 方法。


要明确不启用 LDU 模式，请使用：

AdSettings.setDataProcessingOptions(new String[] {})

要为用户启用 LDU 并指定用户地理位置，请使用：

  • 国家/地区：1 表示美国
  • 州/省：1000 表示加利福尼亚州。
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

要为带有地理位置的用户启用 LDU，操作如下：

  • 国家/地区： 使用 0 以请求我们为此事件指定地理位置
  • 州/省： 使用 0 以请求我们为此事件指定地理位置。
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

Unity 版 SDK，v5.10 及更高版本（未使用 Audience Network 提供的 Unity 封装程序）

如果您未使用 Audience Network 提供的 Unity 封装程序，请输入以下代码。


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

输入此代码后，您可以按照下面一行的 Unity 版 SDK 说明进行操作，就像使用 Unity 封装程序一样。

Unity 版 SDK，v5.10 及更高版本（使用 Audience Network 提供的 Unity 封装程序）

如果您正在使用 Audience Network 提供的 Unity 封装程序，请使用 SetDataProcessingOptions。


要明确不启用 LDU 模式，请使用：

AdSettings.SetDataProcessingOptions(new string[]{})

要为用户启用 LDU 并指定用户地理位置，请使用：

  • 国家/地区：1 表示美国
  • 州/省：1000 表示加利福尼亚州。
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000);

要为带有地理位置的用户启用 LDU，操作如下：

  • 国家/地区： 使用 0 以请求我们为此事件指定地理位置
  • 州/省： 使用 0 以请求我们为此事件指定地理位置。
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0);

在启动中介 SDK 之前，使用中介合作伙伴的发行商必须在 Facebook Audience Network SDK 上设置数据处理选项（受限数据使用）标记，以便我们在竞价请求中接收此 SDK。

实施添加数据处理选项

Android

要明确不启用 LDU 模式，请使用：

AdSettings.setDataProcessingOptions(new String[] {})

要为用户启用 LDU 并指定用户地理位置，请使用：

  • 国家/地区：1 表示美国
  • 州/省：1000 表示加利福尼亚州。
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

要为带有地理位置的用户启用 LDU，操作如下：

  • 国家/地区： 使用 0 以请求我们为此事件指定地理位置
  • 州/省： 使用 0 以请求我们为此事件指定地理位置。
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

设置 LDU 标记后，可照常初始化中介合作伙伴 SDK。

iOS

要明确不启用受限数据使用 (LDU) 模式，请使用：

FBAdSettings setDataProcessingOptions:@[]];

要为用户启用 LDU 并指定用户地理位置，请使用：

  • 国家/地区：1 表示美国
  • 州/省：1000 表示加利福尼亚州。
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

要为带有地理位置的用户启用 LDU，操作如下：

  • 国家/地区： 使用 0 以请求我们为此事件指定地理位置
  • 州/省： 使用 0 以请求我们为此事件指定地理位置。
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

设置 LDU 标记后，可照常初始化中介合作伙伴 SDK。

对于通过竞价工具包和其他服务器端竞价与我们合作的发行商，请遵循以下实施方法。

实施添加数据处理选项

Android/竞价工具包 2.0

要明确不启用 LDU 模式，请使用：

AdSettings.setDataProcessingOptions(new String[] {})

要为用户启用 LDU 并指定用户地理位置，请使用：

  • 国家/地区：1 表示美国
  • 州/省：1000 表示加利福尼亚州。
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

要为带有地理位置的用户启用 LDU，操作如下：

  • 国家/地区： 使用 0 以请求我们为此事件指定地理位置
  • 州/省： 使用 0 以请求我们为此事件指定地理位置。
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

设置 LDU 标记后，可生成竞价口令：

String token = BidderTokenProvider.getBidderToken(Context);

iOS/竞价工具包 2.0

要明确不启用受限数据使用 (LDU) 模式，请使用：

[FBAdSettings setDataProcessingOptions:@[]];

要为用户启用 LDU 并指定用户地理位置，请使用：

  • 国家/地区：1 表示美国
  • 州/省：1000 表示加利福尼亚州。
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

要为带有地理位置的用户启用 LDU，操作如下：

  • 国家/地区： 使用 0 以请求我们为此事件指定地理位置
  • 州/省： 使用 0 以请求我们为此事件指定地理位置。
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

设置 LDU 标记后，可生成竞价口令：

NSString *token = [FBAdSettings bidderToken];

其他服务器端竞价

对于每个平台，请在发出服务器端竞价请求之前按照下方说明设置 LDU 标记和检索竞价工具口令。


对于 Android 客户端：

要明确不启用 LDU 模式，请使用：

AdSettings.setDataProcessingOptions(new String[] {})

要为用户启用 LDU 并指定用户地理位置，请使用：

  • 国家/地区：1 表示美国
  • 州/省：1000 表示加利福尼亚州。
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

要为带有地理位置的用户启用 LDU，操作如下：

  • 国家/地区： 使用 0 以请求我们为此事件指定地理位置
  • 州/省： 使用 0 以请求我们为此事件指定地理位置。
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

设置 LDU 标记后，可生成竞价口令：

String token = BidderTokenProvider.getBidderToken(Context);

对于 iOS 客户端：

要明确不启用受限数据使用 (LDU) 模式，请使用：

[FBAdSettings setDataProcessingOptions:@[]];

要为用户启用 LDU 并指定用户地理位置，请使用：

  • 国家/地区：1 表示美国
  • 州/省：1000 表示加利福尼亚州。
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

要为带有地理位置的用户启用 LDU，操作如下：

  • 国家/地区： 使用 0 以请求我们为此事件指定地理位置
  • 州/省： 使用 0 以请求我们为此事件指定地理位置。
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

设置 LDU 标记后，可生成竞价口令：

NSString *token = [FBAdSettings bidderToken];

对于低于 5.10 版本的 AN SDK，企业可以通过在变现管理工具中进行设置，来覆盖受限数据使用限制期间的自动应用程序。请注意，此覆盖设置仅在加利福尼亚州用户的相关请求没有设置“受限数据使用”标记时（即请求来自低于 5.10 版本的 AN SDK）适用。

客户名单自定义受众

自 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
            ]
        ]
    }
}