「有限資料使用」資料處理選項讓您進一步控制 Meta 系統如何使用您的資料,以及更好地支援您的合規性工作,確保您遵守美國各州的私隱條例。若要使用這項功能,您必須主動啟用「有限資料使用」功能。當 Meta 在「有限資料使用」適用州份,接收到當地用戶所屬並已啟用「有限資料使用」功能的資料時,我們將以服務供應商或處理者(如適用)身分處理這些資料,並按照州份專屬條款規定限制使用這些資料的方式。
下列 Meta 產品提供「有限資料使用」。適用情況因州/省而異。詳情請參閱下表:
加州 | 科羅拉多州 | 康涅狄格州 | 佛羅里達州 | 德克薩斯州 | 俄勒岡州 | |
---|---|---|---|---|---|---|
| ✓ | ✓ 2023 年 6 月 1 日起生效 | ✓ 2023 年 6 月 1 日起生效 | ✓ 2024 年 6 月 24 日起生效 | ✓ 2024 年 6 月 24 日起生效 | ✓ 2024 年 6 月 24 日起生效 |
✓ | ✓ 2023 年 6 月 1 日起生效 | ✓ 2023 年 6 月 1 日起生效 | ✓ 2024 年 6 月 24 日起生效 | ✓ 2024 年 6 月 24 日起生效 | ✓ 2024 年 6 月 24 日起生效 | |
✓ 2023 年 6 月 1 日起生效 | ❌ | ❌ | ❌ | ❌ | ❌ |
「有限資料使用」會透過名為「資料處理選項」的參數傳送,而且能選擇與用戶的國家/地區和州/省資料一同傳送。如果不確定國家/地區和州/省為何,廣告客戶可以選擇讓 Meta 來確定事件或記錄是否來自適用的州/省。
如果透過商業工具和 Audience Network 操作,「有限資料使用」功能僅適用於加州、科羅拉多州、康涅狄格州、佛羅里達州、德克薩斯州或俄勒岡州的用戶。如果企業啟用了「有限資料使用」功能,但沒有將位置參數設定為美國和加州、科羅拉多州、康涅狄格州、佛羅里達州、德克薩斯州或俄勒岡州,我們會確定事件是否來自其中這些州分之一。如果為加州、科羅拉多州、康涅狄格州、佛羅里達州、德克薩斯州或俄勒岡州的事件啟用了「有限資料使用」功能,我們將以服務供應商或處理者身分處理這些資料,並按照州分專屬條款規定限制使用這些資料的方式。
企業可能會注意到啟用「有限資料使用」對宣傳活動的成效和有效性造成影響,同時再營銷和成效衡量功能也將受到限制。
如果透過顧客名單自訂廣告受眾操作,「有限資料使用」功能僅適用於加州的用戶。如果為加州的顧客名單記錄啟用了「有限資料使用」功能,我們將以服務供應商身分處理這些資料,並按照州分專屬條款規定限制使用這些資料的方式。如果企業啟用了「有限資料使用」功能,但沒有將位置參數設定為美國和加州,我們會確定記錄是否來自加州。
企業可能會注意到啟用「有限資料使用」對廣告受眾規模造成影響。
以下列出受支援的 API。
進一步了解資料處理選項:
欄位 | 說明 |
---|---|
資料處理選項 陣列 | 您要為特定事件或記錄啟用的處理選項。目前適用於「有限資料使用」的可接受值為 視乎您使用的 API 和執行方式,您可使用不同的方式來表示此欄位的名稱。舉例來說,如果使用 Meta 像素 JavaScript 呼叫,此欄位的名稱為 您可以傳送空白陣列,以清楚註明不應使用「有限資料使用」限制來處理此事件或記錄。 |
資料處理選項國家/地區 整數 | 對於大多數 API,此為選用項目。詳情請參閱以下備註。 您希望此資料處理選項所適用的國家/地區。目前適用於美國的可接受值為 |
資料處理選項州/省 整數 | 對於大多數 API,此為選用項目。詳情請參閱以下備註。 您希望此資料處理選項所適用的州份。目前適用於加州、科羅拉多州、康涅狄格州、佛羅里達州、俄勒岡州和德克薩斯州的可接受值分別為 備註:
|
執行 | 新增資料處理選項 |
---|---|
瀏覽器像素 | 更新像素初始化程式碼以指定 如要明確不啟用「有限資料使用」(LDU),請使用: fbq('dataProcessingOptions', []); fbq('init', '{pixel_id}'); fbq('track', 'PageView'); 如要啟用 LDU 並讓 Meta 執行地理定位,請使用: fbq('dataProcessingOptions', ['LDU'], 0, 0); 如要啟用 LDU 並指定位置(例如加州),請使用: fbq('dataProcessingOptions', ['LDU'], 1, 1000); |
圖像標籤 | 將以下項目新增至像素圖像標籤:
請參閱參考資料,了解可接受的值。 如要明確不啟用 LDU,請為 <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,可在事件資料參數的每個事件內加入 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
檔案手動上載事件的選項。在使用此選項時,請在您的檔案內加入「資料處理選項」欄、「資料處理國家/地區」欄和「資料處理州份」欄。詳情請參閱上載用戶介面。
HTTP
X-Forwarded-For 標題傳送用戶端 IP 地址,或明確指定地理位置。
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 }
安裝 | 新增數據處理選項 |
---|---|
iOS SDK (Objective C) | Objective C 請使用 要明確地不啟用有限數據使用 (LDU) 模式,請使用: [FBSDKSettings setDataProcessingOptions:@[]]; 要啟用帶有地理位置資訊的 LDU,請使用: [FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; 要為用戶啟用 LDU 並指定用戶地理位置,請使用: [FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; |
iOS SDK (Swift) | Swift 請使用 要明確地不啟用 LDU 模式,請使用: Settings.setDataProcessingOptions(modes: []) 要為帶有地理位置資訊的用戶啟用 LDU,請使用: Settings.setDataProcessingOptions(modes: ["LDU"], country: 0, state: 0) 要為用戶啟用 LDU 並指定用戶地理位置,請使用: Settings.setDataProcessingOptions(modes: ["LDU"], country: 1, state: 1000) |
Android SDK | 請使用 要明確地不啟用 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 5.10 版或更高版本,則必須設定受限數據使用旗幟,以便 Facebook 繼續為其分享的加州用戶個人資料套用限制。
安裝 | 新增數據處理選項 |
---|---|
iOS SDK(5.10 版或以上版本) | 請使用 如要明確地不啟用有限數據使用 (LDU) 模式,請使用: [FBAdSettings setDataProcessingOptions:@[]]; 如要為用戶啟用 LDU 並指定用戶地理位置,請使用:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; 如要為帶有地理位置資訊的用戶啟用 LDU,請使用:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; |
5.10 版或以上版本的 Android SDK | 請使用 如要明確地不啟用 LDU 模式,請使用: AdSettings.setDataProcessingOptions(new String[] {}) 如要為用戶啟用 LDU 並指定用戶地理位置,請使用:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000); 如要為帶有地理位置資訊的用戶啟用 LDU,請使用:
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 封裝程式,請使用以下 如要明確地不啟用 LDU 模式,請使用: AdSettings.SetDataProcessingOptions(new string[]{}) 如要為用戶啟用 LDU 並指定用戶地理位置,請使用:
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000); 如要為帶有地理位置資訊的用戶啟用 LDU,請使用:
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0); |
在初始化中介服務 SDK 之前,使用中介服務合作夥伴的發佈商必須在 Facebook Audience Network SDK 上設定數據處理選項(有限數據使用)旗幟,以便我們在出價要求中接收標示。
安裝 | 新增數據處理選項 |
---|---|
Android | 如要明確地不啟用 LDU 模式,請使用: AdSettings.setDataProcessingOptions(new String[] {}) 如要為用戶啟用 LDU 並指定用戶地理位置,請使用:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000); 如要為帶有地理位置資訊的用戶啟用 LDU,請使用:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); 設定 LDU 旗幟後,您可照常初始化中介服務合作夥伴 SDK。 |
iOS | 如要明確地不啟用有限數據使用 (LDU) 模式,請使用: FBAdSettings setDataProcessingOptions:@[]]; 如要為用戶啟用 LDU 並指定用戶地理位置,請使用:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; 如要為帶有地理位置資訊的用戶啟用 LDU,請使用:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; 設定 LDU 旗幟後,您可照常初始化中介服務合作夥伴 SDK。 |
若是透過出價套件和其他伺服器端出價工具與我們合作的發佈商,請採用以下安裝方法。
安裝 | 新增數據處理選項 |
---|---|
Android/出價套件 2.0 | 如要明確地不啟用 LDU 模式,請使用: AdSettings.setDataProcessingOptions(new String[] {}) 如要為用戶啟用 LDU 並指定用戶地理位置,請使用:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000); 如要為帶有地理位置資訊的用戶啟用 LDU,請使用:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); 設定 LDU 旗幟後,產生出價憑證: String token = BidderTokenProvider.getBidderToken(Context); |
iOS/出價套件 2.0 | 如要明確地不啟用有限數據使用 (LDU) 模式,請使用: [FBAdSettings setDataProcessingOptions:@[]]; 如要為用戶啟用 LDU 並指定用戶地理位置,請使用:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; 如要為帶有地理位置資訊的用戶啟用 LDU,請使用:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; 設定 LDU 旗幟後,產生出價憑證: NSString *token = [FBAdSettings bidderToken]; |
其他伺服器端出價工具 | 在提出伺服器端出價要求之前,先按照各個平台的下列相應指示設定 LDU 旗幟,並擷取出價憑證。 若為 Android 客戶端: 如要明確地不啟用 LDU 模式,請使用: AdSettings.setDataProcessingOptions(new String[] {}) 如要為用戶啟用 LDU 並指定用戶地理位置,請使用:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000); 如要為帶有地理位置資訊的用戶啟用 LDU,請使用:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); 設定 LDU 旗幟後,產生出價憑證: String token = BidderTokenProvider.getBidderToken(Context); 若為 iOS 用戶端: 如要明確地不啟用有限數據使用 (LDU) 模式,請使用: [FBAdSettings setDataProcessingOptions:@[]]; 如要為用戶啟用 LDU 並指定用戶地理位置,請使用:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; 如要為帶有地理位置資訊的用戶啟用 LDU,請使用:
[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 ] ] } }