Ограниченное использование данных — это параметр обработки данных, который позволяет лучше контролировать их использование в системах Meta и обеспечивать соответствие требованиям законов в отношении конфиденциальности, действующих в разных штатах США. Чтобы получить доступ к этой функции, вы должны включить режим ограниченного использования данных. Если Meta получает данные с включенным режимом ограниченного использования от людей, находящихся в штатах, где использование такого режима обязательно, эти данные будут обрабатываться в соответствии с нашей ролью поставщика услуг или обрабатывающей стороны, а их использование будет ограничено согласно нашим Условиям для конкретных штатов.
Ниже приведены Продукты Meta, позволяющие включать режим ограниченного использования данных. Доступность зависит от штата. Подробности см. в таблице ниже.
Калифорния | Колорадо | Коннектикут | Флорида | Техас | Орегон | |
---|---|---|---|---|---|---|
| ✓ | ✓ Действует с 1 июня 2023 г. | ✓ Действует с 1 июня 2023 г. | ✓ Действует с 24 июня 2024 г. | ✓ Действует с 24 июня 2024 г. | ✓ Действует с 24 июня 2024 г. |
✓ | ✓ Действует с 1 июня 2023 г. | ✓ Действует с 1 июня 2023 г. | ✓ Действует с 24 июня 2024 г. | ✓ Действует с 24 июня 2024 г. | ✓ Действует с 24 июня 2024 г. | |
✓ Действует с 1 июня 2023 г. | ❌ | ❌ | ❌ | ❌ | ❌ |
Режим ограниченного использования данных передается через параметр, который называется "Параметры обработки данных"; при необходимости он также может передаваться вместе с названием страны и штата пользователя. Если у рекламодателя имеются сомнения относительно названия страны или штата, он может предоставить 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, добавьте data_processing_options
, data_processing_options_country
и data_processing_options_state
в каждый элемент в параметре data своих событий.
Примечание. App Events API и Offline Conversions API более не следует использовать для новых интеграций. Вместо этого рекомендуем использовать Conversions API, поскольку теперь он поддерживает веб- и офлайн-события, а также события в приложении. Подробнее см. в разделах API Conversions для событий в приложении и API Conversions для офлайн-событий.
Чтобы явным образом отключить режим ограниченного использования данных (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 Offline Conversions позволяет загружать события вручную из файла .csv
. В этом случае в файл нужно добавить столбцы Data Processing Options (Параметры обработки данных), Data Processing Country (Страна обработки данных) и Data Processing State (Штат обработки данных). Дополнительные сведения см. в пользовательском интерфейсе загрузки.
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]; |
Если вы захотите включить режим ограниченного использования данных для пользовательских аудиторий на основе списков клиентов, охватывающих людей в Калифорнии, 1 июня 2023 г. или позже, вам потребуется загрузить новые аудитории или обновить существующие, установив соответствующий флаг. Регулярно обновляйте статусы ограниченного использования данных для аудиторий и отдельных людей, учитывая свои потребности.
Обратите внимание, что установка флажка режима ограниченного использования данных для пользователя в одной аудитории не будет означать его автоматическое применение в разных аудиториях. Аналогичным способом рекламодатели должны индивидуально настраивать каждую из своих пользовательских аудиторий на основе списка клиентов в соответствии с критериями, которые они выберут, а флажок режима ограниченного использования данных должен устанавливаться отдельно для каждой аудитории, используемой для рекламы.
Чтобы явным образом НЕ включать 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 ] ] } }