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

「有限資料使用」資料處理選項讓您進一步控制 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

如果要調用應用程式事件 API,而不是直接從用戶裝置傳送數據,則必須使用 HTTP X-Forwarded-For 標題傳送用戶端 IP 地址,或明確指定地理位置。

Graph API

要使用 Graph API 安裝數據處理選項,請將 data_processing_optionsdata_processing_options_countrydata_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(5.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];

5.10 版或以上版本的 Android SDK

請使用 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);

5.10 版或以上版本的 Unity SDK(未有使用 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 封裝程式一樣。

5.10 版或以上版本的 Unity SDK(使用 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 上設定數據處理選項(有限數據使用)旗幟,以便我們在出價要求中接收標示。

安裝新增數據處理選項

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];

若是 SDK 5.10 版之前的版本,企業可以透過營利管理工具的設定,覆寫自動套用的有限數據使用限制時段。請注意,只有在與加州用戶相關的要求(即來自 SDK 5.10 版之前版本的所有要求)沒有「受限數據使用」旗幟時,才能套用此覆寫設定。

顧客名單自訂廣告受眾

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