API Marketing

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:

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)
Audience Network SDKĐối tượng tùy chỉnh từ danh sách khách hàng
California

Có hiệu lực từ ngày 01/06/2023
Colorado

Có hiệu lực từ ngày 01/06/2023

Có hiệu lực từ ngày 01/06/2023
Connecticut

Có hiệu lực từ ngày 01/06/2023

Có hiệu lực từ ngày 01/06/2023
Delaware

Có hiệu lực từ ngày 18/12/2024

Có hiệu lực từ ngày 18/12/2024
Florida

Có hiệu lực từ ngày 24/06/2024

Có hiệu lực từ ngày 24/06/2024
Montana

Có hiệu lực từ ngày 23/09/2024

Có hiệu lực từ ngày 23/09/2024
Nebraska

Có hiệu lực từ ngày 18/12/2024

Có hiệu lực từ ngày 18/12/2024
New Hampshire

Có hiệu lực từ ngày 18/12/2024

Có hiệu lực từ ngày 18/12/2024
New Jersey

Có hiệu lực từ ngày 18/12/2024

Có hiệu lực từ ngày 18/12/2024
Oregon

Có hiệu lực từ ngày 24/06/2024

Có hiệu lực từ ngày 24/06/2024
Texas

Có hiệu lực từ ngày 24/06/2024

Có hiệu lực từ ngày 24/06/2024

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, Delaware, Florida, Montana, Nebraska, New Hampshrire, New Jersey, Oregon hoặc Texas. 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, Delaware, Florida, Montana, Nebraska, New Hampshrire, New Jersey, Oregon hoặc Texas, chúng tôi sẽ xác định liệu 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, Delaware, Florida, Montana, Nebraska, New Hampshrire, New Jersey, Oregon hoặc Texas, 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.

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

array

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

integer

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

integer

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, 1006 cho Montana, 1007 cho Delaware, 1008 cho Nebraska, 1009 cho New Hampshire, 1010 cho New Jersey 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 đổi và API 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_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
        }
    ]
}

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

Nếu đang gọi API Sự kiện trong ứng dụng và không gửi dữ liệu ngay từ thiết bị của người dùng, bạn phải gửi địa chỉ IP của máy khách bằng cách sử dụng tiêu đề HTTP X-Forwarded-For hoặc chỉ định rõ vị trí địa lý.

API Đồ thị

Để triển khai Tùy chọn xử lý dữ liệu bằng API Đồ thị, hãy thêm data_processing_options, data_processing_options_country và data_processing_options_state vào lệnh gọi API. Để rõ ràng không bật chế độ LDU, hãy gửi một mảng data_processing_options trống: 
{
  "event": "CUSTOM_APP_EVENTS",
  "application_tracking_enabled": "1",
  "advertiser_tracking_enabled": "1",
  "custom_events": ["fb_mobile_purchase"],
  "data_processing_options": []
}
Để bật chế độ LDU cho người dùng có vị trí địa lý, bạn có thể gửi một sự kiện kèm theo mã sau: 
{
  "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
}
Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, bạn có thể gửi một sự kiện kèm theo mã sau: 
  {
  "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 di động

Triển khaiThêm Tùy chọn xử lý dữ liệu

iOS SDK (Objective C)

Với Objective C, hãy sử dụng FBSDKSettings setDataProcessingOptions.


Để rõ ràng không bật chế độ Giới hạn sử dụng dữ liệu (LDU), hãy dùng:

[FBSDKSettings setDataProcessingOptions:@[]];

Để bật chế độ LDU có vị trí địa lý, hãy sử dụng:

[FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy sử dụng:

[FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

iOS SDK (Swift)

Với Swift, hãy sử dụng setDataProcessingOptions.


Để rõ ràng không bật chế độ LDU, hãy sử dụng:

Settings.setDataProcessingOptions(modes: [])

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy sử dụng:

Settings.setDataProcessingOptions(modes: ["LDU"], country: 0, state: 0)

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy sử dụng:

Settings.setDataProcessingOptions(modes: ["LDU"], country: 1, state: 1000)

Android SDK

Sử dụng phương thức setDataProcessingOptions.


Để rõ ràng không bật chế độ LDU, hãy sử dụng:

FacebookSdk.setDataProcessingOptions(new String[] {});

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy sử dụng:

FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

Để bật chế độ LDU cho người dùng có vị trí địa lý đã chỉ định, hãy sử dụng:

FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

Unity SDK

Để rõ ràng không bật chế độ LDU, hãy gửi một sự kiện kèm theo:

FB.Mobile.SetDataProcessingOptions(new string[] {});

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy gửi một sự kiện kèm theo:

FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0);

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy gửi một sự kiện kèm theo:

FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000);

Audience Network SDK

Những nhà phát hành nâng cấp lên SDK Audience Network phiên bản 5.10 trở lên phải đặt cờ Giới hạn sử dụng dữ liệu để Facebook tiếp tục áp dụng các hạn chế đối với thông tin cá nhân mà họ chia sẻ về những người ở California.

Triển khaiThêm Tùy chọn xử lý dữ liệu

iOS SDK, phiên bản 5.10 trở lên

Sử dụng FBAdSettings setDataProcessingOptions.


Để không bật chế độ Sử dụng dữ liệu hạn chế (LDU) một cách rõ ràng, hãy sử dụng:

[FBAdSettings setDataProcessingOptions:@[]];

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy sử dụng:

  • Quốc gia:1 để biểu thị Hoa Kỳ
  • Tiểu bang:1000 để biểu thị California.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy sử dụng:

  • Quốc gia:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
  • Tiểu bang:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

Android SDK, phiên bản 5.10 trở lên

Sử dụng phương thức setDataProcessingOptions.


Để không bật chế độ LDU một cách rõ ràng, hãy sử dụng:

AdSettings.setDataProcessingOptions(new String[] {})

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy sử dụng:

  • Quốc gia:1 để biểu thị Hoa Kỳ
  • Tiểu bang:1000 để biểu thị California.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy sử dụng:

  • Quốc gia:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
  • Tiểu bang:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

Unity SDK, phiên bản 5.10 trở lên (không dùng công cụ bao bọc Unity do Audience Network cung cấp)

Nếu bạn không dùng công cụ bao bọc Unity do Audience Network cung cấp, hãy nhập mã sau đây.


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

Sau khi nhập mã này, bạn có thể làm theo hướng dẫn Unity SDK ở hàng bên dưới như thể bạn đang dùng trình bao bọc Unity.

Unity SDK, phiên bản 5.10 trở lên (dùng công cụ bao bọc Unity do Audience Network cung cấp)

Nếu bạn đang dùng công cụ bao bọc Unity do Audience Network cung cấp, hãy sử dụng SetDataProcessingOptions sau đây.


Để không bật chế độ LDU một cách rõ ràng, hãy sử dụng:

AdSettings.SetDataProcessingOptions(new string[]{})

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy sử dụng:

  • Quốc gia:1 để biểu thị Hoa Kỳ
  • Tiểu bang:1000 để biểu thị California.
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000);

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy sử dụng:

  • Quốc gia:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
  • Tiểu bang:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0);

Những nhà phát hành sử dụng nền tảng Đối tác trung gian phải đặt cờ Lựa chọn xử lý dữ liệu (Giới hạn sử dụng dữ liệu) trên SDK Facebook Audience Network trước khi khởi tạo SDK Trung gian sao cho chúng tôi nhận được cờ trong yêu cầu đặt giá thầu.

Triển khaiThêm Tùy chọn xử lý dữ liệu

Android

Để không bật chế độ LDU một cách rõ ràng, hãy sử dụng:

AdSettings.setDataProcessingOptions(new String[] {})

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy sử dụng:

  • Quốc gia:1 để biểu thị Hoa Kỳ
  • Tiểu bang:1000 để biểu thị California.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy sử dụng:

  • Quốc gia:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
  • Tiểu bang:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

Sau khi đặt cờ LDU, hãy khởi tạo SDK Đối tác trung gian như bình thường.

iOS

Để không bật chế độ Sử dụng dữ liệu hạn chế (LDU) một cách rõ ràng, hãy sử dụng:

FBAdSettings setDataProcessingOptions:@[]];

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy sử dụng:

  • Quốc gia:1 để biểu thị Hoa Kỳ
  • Tiểu bang:1000 để biểu thị California.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy sử dụng:

  • Quốc gia:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
  • Tiểu bang:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

Sau khi đặt cờ LDU, hãy khởi tạo SDK Đối tác trung gian như bình thường.

Đối với những nhà phát hành đang hợp tác với chúng tôi thông qua Bộ công cụ đặt giá thầu và giải pháp Đặt giá thầu phía máy chủ khác, vui lòng làm theo phương thức triển khai sau đây.

Triển khaiThêm Tùy chọn xử lý dữ liệu

Android/Bộ công cụ đặt giá thầu 2.0

Để không bật chế độ LDU một cách rõ ràng, hãy sử dụng:

AdSettings.setDataProcessingOptions(new String[] {})

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy sử dụng:

  • Quốc gia:1 để biểu thị Hoa Kỳ
  • Tiểu bang:1000 để biểu thị California.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy sử dụng:

  • Quốc gia:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
  • Tiểu bang:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

Sau khi đặt cờ LDU, hãy tạo mã nhà thầu:

String token = BidderTokenProvider.getBidderToken(Context);

iOS/Bộ công cụ đặt giá thầu 2.0

Để không bật chế độ Sử dụng dữ liệu hạn chế (LDU) một cách rõ ràng, hãy sử dụng:

[FBAdSettings setDataProcessingOptions:@[]];

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy sử dụng:

  • Quốc gia:1 để biểu thị Hoa Kỳ
  • Tiểu bang:1000 để biểu thị California.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy sử dụng:

  • Quốc gia:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
  • Tiểu bang:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

Sau khi đặt cờ LDU, hãy tạo mã nhà thầu:

NSString *token = [FBAdSettings bidderToken];

Đặt giá thầu phía máy chủ khác

Đối với từng nền tảng, hãy làm theo hướng dẫn dưới đây để đặt cờ LDU và truy xuất mã nhà thầu trước khi đưa ra yêu cầu giá thầu phía máy chủ.


Dành cho ứng dụng Android:

Để không bật chế độ LDU một cách rõ ràng, hãy sử dụng:

AdSettings.setDataProcessingOptions(new String[] {})

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy sử dụng:

  • Quốc gia:1 để biểu thị Hoa Kỳ
  • Tiểu bang:1000 để biểu thị California.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy sử dụng:

  • Quốc gia:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
  • Tiểu bang:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

Sau khi đặt cờ LDU, hãy tạo mã nhà thầu:

String token = BidderTokenProvider.getBidderToken(Context);

Dành cho ứng dụng iOS:

Để không bật chế độ Sử dụng dữ liệu hạn chế (LDU) một cách rõ ràng, hãy sử dụng:

[FBAdSettings setDataProcessingOptions:@[]];

Để bật chế độ LDU cho người dùng và chỉ định vị trí địa lý của họ, hãy sử dụng:

  • Quốc gia:1 để biểu thị Hoa Kỳ
  • Tiểu bang:1000 để biểu thị California.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

Để bật chế độ LDU cho người dùng có vị trí địa lý, hãy sử dụng:

  • Quốc gia:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
  • Tiểu bang:0 để yêu cầu chúng tôi phải thêm vị trí địa lý cho sự kiện đó
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

Sau khi đặt cờ LDU, hãy tạo mã nhà thầu:

NSString *token = [FBAdSettings bidderToken];

Đối với SDK AN phiên bản thấp hơn 5.10, doanh nghiệp có thể ghi đè tùy chọn tự động áp dụng thời gian Giới hạn sử dụng dữ liệu thông qua một tùy chọn cài đặt trong Trình quản lý kiếm tiền. Lưu ý rằng tùy chọn cài đặt ghi đè này sẽ chỉ áp dụng khi yêu cầu liên quan đến một người ở California không có cờ "Giới hạn sử dụng dữ liệu" (tức là bất kỳ yêu cầu nào đến từ SDK AN phiên bản thấp hơn 5.10).

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