Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.
Cập nhật bằng tiếng Anh: 9 tháng 5

Tùy chọn xử lý dữ liệu cho người dùng tại Hoa Kỳ

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.

Sản phẩm của Meta cung cấp tính năng Giới hạn mức sử dụng dữ liệu

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:

CaliforniaColoradoConnecticutFloridaTexasOregon

Công cụ kinh doanh trên Meta

  • Meta Pixel
  • Sự kiện trong ứng dụng qua Facebook SDK
  • API Sự kiện trong ứng dụng
  • API Chuyển đổi
  • API Chuyển đổi offline

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

Audience Network SDK


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

Đối tượng tùy chỉnh từ danh sách khách hàng


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 SDK

Đố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

Đố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:

Tài liệu tham khảo

TrườngMô 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à LDU cho tính năng Giới hạn mức sử dụng dữ liệu.


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ụ: dataProcessingOptions là cho lệnh gọi Meta Pixel JavaScript, còn data_processing_options là cho lệnh gọi API Chuyển đổi. Vui lòng xem các lệnh gọi mẫu ở bên dưới.


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à 1 đối với Hoa Kỳ hoặc 0 để yêu cầu Meta xác định vị trí địa 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à 1000 cho California, 1001 cho Colorado, 1002 cho Connecticut, 1003 cho Florida, 1004 cho Oregon, 1005 cho Texas hoặc 0 để yêu cầu chúng tôi xác định vị trí địa lý.


Lưu ý:

  • Nếu đặt quốc gia, bạn cũng phải đặt tiểu bang. Nếu không, chúng tôi sẽ xác định vị trí địa lý.

Công cụ và API được hỗ trợ

Meta Pixel

Triển khaiThê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 dataProcessingOptions trước khi bạn gọi fbq('init').


Để 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:

  • dpo: tùy chọn xử lý dữ liệu
  • dpoco: quốc gia của tùy chọn xử lý dữ liệu
  • dpost: tiểu bang của tùy chọn xử lý dữ liệu

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ố dpo:

<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" />

API Chuyển đổiAPI Chuyển đổi offline

Đố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_countrydata_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ụngAPI 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
        }
    ]
}

Giao diện người dùng tải lên thủ công

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.

API Sự kiện trong ứng dụng

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

Đối tượng tùy chỉnh từ danh sách khách hàng

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