這份文件已更新。
中文(香港) 的翻譯尚未完成。
英文更新時間:5月8日

適用於美國用戶的資料處理選項

「有限資料使用」資料處理選項讓您進一步控制 Meta 系統如何使用您的資料,以及更好地支援您的合規性工作,確保您遵守美國各州的私隱條例。若要使用這項功能,您必須主動啟用「有限資料使用」功能。當 Meta 在「有限資料使用」適用州份,接收到當地用戶所屬並已啟用「有限資料使用」功能的資料時,我們將以服務供應商或處理者(如適用)身分處理這些資料,並按照州份專屬條款規定限制使用這些資料的方式。

提供「有限資料使用」功能的 Meta 產品

下列 Meta 產品提供「有限資料使用」。適用情況因州/省而異。詳情請參閱下表:

加州科羅拉多州康涅狄格州佛羅里達州德克薩斯州俄勒岡州

Meta 商業工具

  • Meta 像素
  • 透過 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 像素 JavaScript 呼叫,此欄位的名稱為 dataProcessingOptions;但如果是轉換 API 呼叫,此名稱則為 data_processing_options。請查看下方的呼叫範例。


您可以傳送空白陣列,以清楚註明不應使用「有限資料使用」限制來處理此事件或記錄。

資料處理選項國家/地區

整數

對於大多數 API,此為選用項目。詳情請參閱以下備註。


您希望此資料處理選項所適用的國家/地區。目前適用於美國的可接受值為 1;或者,您也可以使用 0 以要求 Meta 執行地理定位。

資料處理選項州/省

整數

對於大多數 API,此為選用項目。詳情請參閱以下備註。


您希望此資料處理選項所適用的州份。目前適用於加州、科羅拉多州、康涅狄格州、佛羅里達州、俄勒岡州和德克薩斯州的可接受值分別為 100010011002100310041005;或者,您也可以使用 0 以要求我們執行地理定位。


備註:

  • 如果您已設定國家/地區,則必須同時設定州/省。否則,我們將執行地理定位。

受支援的工具和 API

Meta 像素

執行新增資料處理選項

瀏覽器像素

更新像素初始化程式碼以指定 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);

圖像標籤

將以下項目新增至像素圖像標籤:

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