Tính năng Giới hạn mức sử dụng dữ liệu là tùy chọn xử lý dữ liệu giúp bạn tăng khả năng kiểm soát cách dữ liệu của mình được sử dụng trong các hệ thống của Meta, cũng như hỗ trợ bạn tốt hơn trong việc tuân thủ những quy định khác nhau về quyền riêng tư của các tiểu bang Hoa Kỳ. Để sử dụng tính năng này, bạn phải chủ động bật tính năng Giới hạn mức sử dụng dữ liệu. Khi Meta nhận được dữ liệu có bật tính năng Giới hạn mức sử dụng dữ liệu từ những người ở tiểu bang áp dụng tính năng Giới hạn mức sử dụng dữ liệu, chúng tôi sẽ xử lý dữ liệu đó theo vai trò của mình là nhà cung cấp dịch vụ hoặc bên xử lý và giới hạn việc sử dụng dữ liệu đó (nếu có) theo quy định tại Điều khoản dành riêng cho tiểu bang của chúng tôi.
Các sản phẩm sau đây của Meta cung cấp tính năng Giới hạn mức sử dụng dữ liệu. Khả năng sử dụng tính năng này sẽ khác nhau tùy theo tiểu bang. Hãy xem bảng bên dưới để biết chi tiết:
California | Colorado | Connecticut | Florida | Texas | Oregon | |
---|---|---|---|---|---|---|
| ✓ | ✓ Có hiệu lực từ ngày 01/06/2023 | ✓ Có hiệu lực từ ngày 01/06/2023 | ✓ Có hiệu lực từ ngày 24/06/2024 | ✓ Có hiệu lực từ ngày 24/06/2024 | ✓ Có hiệu lực từ ngày 24/06/2024 |
✓ | ✓ Có hiệu lực từ ngày 01/06/2023 | ✓ Có hiệu lực từ ngày 01/06/2023 | ✓ Có hiệu lực từ ngày 24/06/2024 | ✓ Có hiệu lực từ ngày 24/06/2024 | ✓ Có hiệu lực từ ngày 24/06/2024 | |
✓ Có hiệu lực từ ngày 01/06/2023 | ❌ | ❌ | ❌ | ❌ | ❌ |
Tính năng Giới hạn mức sử dụng dữ liệu được gửi qua thông số có tên là Tùy chọn xử lý dữ liệu. Ngoài ra, tính năng này có thể được gửi cùng với quốc gia và tiểu bang của người dùng nếu muốn. Nếu nhà quảng cáo không biết quốc gia hoặc tiểu bang, họ có thể yêu cầu Meta xác định liệu sự kiện hoặc hồ sơ có đến từ tiểu bang thích hợp hay không.
Đối với Công cụ kinh doanh và Audience Network, tính năng Giới hạn mức sử dụng dữ liệu chỉ áp dụng cho những người ở California, Colorado, Connecticut, Florida, Texas hoặc Oregon. Nếu một doanh nghiệp bật tính năng Giới hạn mức sử dụng dữ liệu nhưng không đặt thông số vị trí là Hoa Kỳ và California, Colorado, Connecticut, Florida, Texas hoặc Oregon, chúng tôi sẽ xác định xem sự kiện có đến từ một trong những tiểu bang đó hay không. Nếu tính năng Giới hạn mức sử dụng dữ liệu được bật cho một sự kiện ở California, Colorado, Connecticut, Florida, Texas hoặc Oregon, chúng tôi sẽ xử lý dữ liệu theo vai trò của mình là nhà cung cấp dịch vụ hoặc bên xử lý và giới hạn việc sử dụng dữ liệu đó theo Điều khoản dành riêng cho tiểu bang của chúng tôi.
Doanh nghiệp có thể nhận thấy hiệu suất và hiệu quả của chiến dịch bị ảnh hưởng, đồng thời tính năng nhắm mục tiêu lại và đo lường cũng bị hạn chế khi bật tính năng Giới hạn mức sử dụng dữ liệu.
Đối với Đối tượng tùy chỉnh từ danh sách khách hàng, tính năng Giới hạn mức sử dụng dữ liệu chỉ áp dụng cho những người ở California. Nếu tính năng Giới hạn mức sử dụng dữ liệu được bật cho một hồ sơ trong danh sách khách hàng ở California, chúng tôi sẽ xử lý dữ liệu theo vai trò của mình là nhà cung cấp dịch vụ và giới hạn việc sử dụng dữ liệu đó theo Điều khoản dành riêng cho tiểu bang của chúng tôi. Nếu một doanh nghiệp bật tính năng Giới hạn mức sử dụng dữ liệu nhưng không đặt thông số vị trí là Hoa Kỳ và California, chúng tôi sẽ xác định liệu hồ sơ có đến từ California hay không.
Doanh nghiệp có thể nhận thấy quy mô đối tượng bị ảnh hưởng khi tính năng Giới hạn mức sử dụng dữ liệu được bật.
Các API được hỗ trợ hiển thị ở bên dưới.
Tìm hiểu thêm về Tùy chọn xử lý dữ liệu:
Trường | Mô tả |
---|---|
Tùy chọn xử lý dữ liệu mảng | Tùy chọn xử lý mà bạn muốn bật cho sự kiện hoặc hồ sơ cụ thể. Giá trị hiện được chấp nhận là Tên của trường này có thể hiển thị khác, tùy thuộc vào API và cách triển khai bạn đang áp dụng. Ví dụ: Bạn có thể gửi một mảng trống để chỉ định rõ rằng sự kiện hoặc hồ sơ này không cần được xử lý với các hạn chế của tính năng Giới hạn mức sử dụng dữ liệu. |
Quốc gia của tùy chọn xử lý dữ liệu số nguyên | Không bắt buộc đối với hầu hết API. Hãy xem ghi chú dưới đây để biết chi tiết. Quốc gia mà bạn muốn liên kết với tùy chọn xử lý dữ liệu này. Các giá trị hiện được chấp nhận là |
Tiểu bang của tùy chọn xử lý dữ liệu số nguyên | Không bắt buộc đối với hầu hết API. Hãy xem ghi chú dưới đây để biết chi tiết. Tiểu bang mà bạn muốn liên kết với tùy chọn xử lý dữ liệu này. Giá trị hiện được chấp nhận là Lưu ý:
|
Triển khai | Thêm Tùy chọn xử lý dữ liệu |
---|---|
Pixel trình duyệt | Cập nhật mã khởi tạo Pixel để chỉ định phương thức Để rõ ràng không bật tính năng Giới hạn mức sử dụng dữ liệu (LDU): fbq('dataProcessingOptions', []); fbq('init', '{pixel_id}'); fbq('track', 'PageView'); Để bật tính năng LDU và yêu cầu Meta xác định vị trí địa lý: fbq('dataProcessingOptions', ['LDU'], 0, 0); Để bật tính năng LDU và chỉ định vị trí, chẳng hạn như cho California: fbq('dataProcessingOptions', ['LDU'], 1, 1000); |
Thẻ hình ảnh | Thêm thông số sau vào thẻ hình ảnh Pixel:
Xem Tài liệu tham khảo để biết các giá trị được chấp nhận. Để rõ ràng không bật tính năng LDU, hãy chuyển một giá trị trống cho thông số <img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&dpo=" /> Để bật tính năng LDU và yêu cầu Meta xác định vị trí địa lý: <img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&vdpo=LDU&dpoco=0&dpost=0" /> Để bật tính năng LDU và chỉ định vị trí theo cách thủ công, chẳng hạn như cho California: <img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&dpo=LDU&dpoco=1&dpost=1000" /> |
Đối với 2 API này, hãy triển khai tùy chọn xử lý dữ liệu bằng cách thêm data_processing_options
, data_processing_options_country
và data_processing_options_state
vào mỗi sự kiện trong thông số dữ liệu của sự kiện.
Lưu ý: API Sự kiện trong ứng dụng và API Chuyển đổi offline không còn được khuyến nghị cho tiện ích tích hợp mới nữa. Thay vào đó, bạn nên sử dụng API Chuyển đổi vì API này hỗ trợ sự kiện trên web, sự kiện trong ứng dụng và sự kiện offline. Hãy xem API Chuyển đổi cho Sự kiện trong ứng dụng và API Chuyển đổi cho Sự kiện offline để biết thêm thông tin.
Để rõ ràng không bật tính năng Giới hạn mức sử dụng dữ liệu (LDU), hãy chỉ định một mảng trống cho từng sự kiện hoặc chỉ cần gỡ trường này trong phần tải dữ liệu:
{ "data": [ { "event_name": "Purchase", "event_time": <EVENT_TIME>, "user_data": { "em": "<EMAIL>" }, "custom_data": { "currency": "<CURRENCY>", "value": "<VALUE>" }, "data_processing_options": [] } ] }
Để bật tính năng LDU và yêu cầu Meta xác định vị trí địa lý:
{ "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 } ] }
Để bật tính năng LDU và chỉ định vị trí theo cách thủ công, chẳng hạn như cho California:
{ "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 Chuyển đổi offline có tùy chọn tải lên thủ công các sự kiện từ file .csv
. Trong trường hợp này, hãy thêm các cột Tùy chọn xử lý dữ liệu, Quốc gia xử lý dữ liệu và Tiểu bang xử lý dữ liệu trong file của bạn. Bạn có thể tìm thêm thông tin về điều này trong giao diện người dùng tải lên.
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 }
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:
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.
Implementation | Adding Data Processing Options |
---|---|
Facebook SDK for iOS v7.1.1+ (Objective-C) | With Objective-C, use 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 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 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); |
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.
Implementation | Adding Data Processing Options |
---|---|
Facebook SDK for iOS, v5.10+ | Use To explicitly not enable Limited Data Use (LDU), use: [FBAdSettings setDataProcessingOptions:@[]]; To enable LDU and have Meta perform geolocation, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; |
Facebook SDK for Android, v5.10+ | Use the To explicitly not enable Limited Data Use (LDU), use: AdSettings.setDataProcessingOptions(new String[] {}) To enable LDU and have Meta perform geolocation, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
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 To explicitly not enable LDU, use: AdSettings.SetDataProcessingOptions(new string[]{}) To enable LDU and have Meta perform geolocation, use:
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
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.
Implementation | Adding 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:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
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:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[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.
Implementation | Adding 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:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
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:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[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:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
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:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; After setting the LDU for the event, generate the bidder token: NSString *token = [FBAdSettings bidderToken]; |
Nếu muốn bật tính năng Giới hạn mức sử dụng dữ liệu (LDU) cho những người ở California thông qua đối tượng tùy chỉnh từ danh sách khách hàng vào hoặc sau ngày 01/06/2023, bạn phải tải đối tượng mới lên hoặc cập nhật đối tượng hiện có với cờ Giới hạn mức sử dụng dữ liệu. Thường xuyên cập nhật và duy trì trạng thái Giới hạn mức sử dụng dữ liệu của đối tượng và mọi người khi cần.
Lưu ý rằng cờ Giới hạn mức sử dụng dữ liệu áp dụng cho người dùng trong một đối tượng sẽ không tự động chuyển sang các đối tượng khác. Tương tự, nhà quảng cáo phải quản lý từng đối tượng tùy chỉnh từ danh sách khách hàng hiện có một cách riêng biệt theo tiêu chí đã chọn, cờ Giới hạn mức sử dụng dữ liệu phải được áp dụng riêng cho từng đối tượng mà họ tận dụng cho quảng cáo.
Để rõ ràng KHÔNG bật LDU
cho hồ sơ, bạn có thể gửi một mảng data_processing_options
trống hoặc gỡ trường này trong phần tải dữ liệu. Ví dụ về một mảng trống:
{ "payload": { "schema": [ "EMAIL", "DATA_PROCESSING_OPTIONS" ], "data": [ [ "<HASHED_DATA> ", [] ] ] } }
Để rõ ràng bật LDU
và yêu cầu Meta xác định vị trí địa lý (bằng cách không thêm tiểu bang và quốc gia của hồ sơ cụ thể), hãy chỉ định một mảng chứa LDU
cho từng hồ sơ:
{ "payload": { "schema": [ "EMAIL", "DATA_PROCESSING_OPTIONS" ], "data": [ [ "<HASHED_DATA> ", ["LDU"] ] ] } }
Để bật tính năng LDU và chỉ định vị trí theo cách thủ công:
{ "customer_consent": true, "payload": { "schema": [ "EMAIL", "DATA_PROCESSING_OPTIONS", "DATA_PROCESSING_OPTIONS_COUNTRY", "DATA_PROCESSING_OPTIONS_STATE" ], "data": [ [ "<HASHED_DATA>", ["LDU"], 1, 1000 ] ] } }