Этот документ обновлен.
Перевод (Русский) еще не готов.
Последнее обновление (английский): 6 мая

Параметры обработки данных для пользователей в США

Ограниченное использование данных — это параметр обработки данных, который позволяет лучше контролировать их использование в системах Meta и обеспечивать соответствие требованиям законов в отношении конфиденциальности, действующих в разных штатах США. Чтобы получить доступ к этой функции, вы должны включить режим ограниченного использования данных. Если Meta получает данные с включенным режимом ограниченного использования от людей, находящихся в штатах, где использование такого режима обязательно, эти данные будут обрабатываться в соответствии с нашей ролью поставщика услуг или обрабатывающей стороны, а их использование будет ограничено согласно нашим Условиям для конкретных штатов.

Продукты Meta, которые предлагают включить режим ограниченного использования данных

Ниже приведены Продукты Meta, позволяющие включать режим ограниченного использования данных. Доступность зависит от штата. Подробности см. в таблице ниже.

КалифорнияКолорадоКоннектикутФлоридаТехасОрегон

Инструменты Meta для бизнеса

  • Пиксель Meta
  • События в приложении, получаемые через Facebook SDK
  • App Events API
  • Conversions API
  • Offline Conversions API

Действует с 1 июня 2023 г.


Действует с 1 июня 2023 г.


Действует с 24 июня 2024 г.


Действует с 24 июня 2024 г.


Действует с 24 июня 2024 г.

Audience Network SDK


Действует с 1 июня 2023 г.


Действует с 1 июня 2023 г.


Действует с 24 июня 2024 г.


Действует с 24 июня 2024 г.


Действует с 24 июня 2024 г.

Пользовательские аудитории на основе списка клиентов


Действует с 1 июня 2023 г.

Режим ограниченного использования данных передается через параметр, который называется "Параметры обработки данных"; при необходимости он также может передаваться вместе с названием страны и штата пользователя. Если у рекламодателя имеются сомнения относительно названия страны или штата, он может предоставить Meta возможность определить, создано ли событие или запись в соответствующем штате.

Для инструментов для бизнеса и Audience Network SDK

Применительно к инструментам для бизнеса и Audience Network режим ограниченного использования данных доступен только людям в штатах Калифорния, Колорадо, Коннектикут, Орегон, Техас и Флорида. Если компания включит режим ограниченного использования данных, но не настроит параметры местоположения в США и штатах Калифорния, Колорадо, Коннектикут, Орегон, Техас или Флорида, мы определим, создано ли событие в одном из этих штатов. Если режим ограниченного использования данных включен для события в штате Калифорния, Колорадо, Коннектикут, Орегон, Техас или Флорида, данные будут обрабатываться в соответствии с нашей ролью поставщика услуг или обрабатывающей стороны, а их использование будет ограничено в соответствии с нашими Условиями для конкретных штатов.

При включении режима ограниченного использования данных результативность и эффективность компаний могут снизиться, а возможности ретаргетинга и измерений будут ограничены.

Для пользовательских аудиторий на основе списка клиентов

Для пользовательских аудиторий на основе списка клиентов режим ограниченного использования данных ��оступен только лицам в штате Калифорния. Если режим ограниченного использования данных включен для записи в списке клиентов из штата Калифорния, данные будут обрабатываться в соответствии с нашей ролью поставщика услуг, а их использование будет ограничено в соответствии с нашими Условиями для конкретных штатов. Если компания включит режим ограниченного использования данных, но не настроит параметры местоположения в США и штате Калифорния, мы определим, создана ли запись в Калифорнии.

После включения режима ограниченного использования данных компании могут заметить уменьшение размера аудитории.

Поддерживаемые API перечислены ниже.

Подробнее о параметрах обработки данных:

Справка

ПолеОписание

Параметры обработки данных

Массив

Параметры обработки, которые следует включить для определенного события или записи. Допустимое в настоящее время значение — LDU (ограниченное использование данных).


Это поле может называться по-разному в зависимости от API и используемой реализации. Например, в вызове пикселя Meta на JavaScript оно называется dataProcessingOptions, а в вызове Conversions API — data_processing_options. См. примеры вызовов ниже.


Чтобы явным образом указать, что событие или запись должны обрабатываться без режима ограниченного использования данных, передайте пустой массив.

Страна обработки данных

Целое число

Необязательно для большинства API. Подробную информацию см. в примечании ниже.


Страна, которую необходимо связать с параметром обработки данных. Допустимые в настоящее время значения: 1 (США) или 0 (Meta самостоятельно определяет местонахождение).

Штат обработки данных

Целое число

Необязательно для большинства API. Подробную информацию см. в примечании ниже.


Штат, связанный с параметром обработки данных. В настоящее время допускаются значения 1000 для штата Калифорния, 1001 для штата Колорадо, 1002 для штата Коннектикут, 1004 для штата Орегон, 1005 для штата Техас, 1003 для штата Флорида или 0, чтобы местоположение определили мы.


Примечание.

  • Если указана страна, необходимо также указать штат. В противном случае местоположение будет определено нами.

Поддерживаемые инструменты и API

Пиксель Meta

РеализацияДобавление параметров обработки данных

Пиксель в браузере

Добавьте в код инициализации пикселя метод dataProcessingOptions перед вызовом fbq('init').


Чтобы явным образом отключить режим ограниченного использования данных (LDU):

fbq('dataProcessingOptions', []);
fbq('init', '{pixel_id}');
fbq('track', 'PageView');

Чтобы включить режим LDU и разрешить Meta определить местоположение:

fbq('dataProcessingOptions', ['LDU'], 0, 0);

Чтобы включить режим LDU и указать местоположение, например, для штата Калифорния:

fbq('dataProcessingOptions', ['LDU'], 1, 1000);

Тег изображения

Добавьте в тег изображения пикселя следующие параметры:

  • dpo — параметры обработки данных;
  • dpoco — страна обработки данных;
  • dpost — штат обработки данных.

Допустимые значения приведены в разделе Справка.


Чтобы явным образом отключить режим LDU, передайте пустое значение для параметра dpo:

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

Conversions API и Offline Conversions API

Чтобы реализовать параметры обработки данных для этих двух 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 (Штат обработки данных). Дополнительные сведения см. в пользовательском интерфейсе загрузки.

App Events API

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

Пользовательские аудитории на основе списка клиентов

Если вы захотите включить режим ограниченного использования данных для пользовательских аудиторий на основе списков клиентов, охватывающих людей в Калифорнии, 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
            ]
        ]
    }
}