Marketing API

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

Ограниченное использование данных — это параметр обработки данных, который позволяет лучше контролировать их использование в системах 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

Если вы вызываете API App Events, но не передаете данные непосредственно с устройств пользователей, необходимо либо отправить IP-адрес клиента через заголовок HTTP X-Forwarded-For, либо явным образом указать местоположение.

API Graph

Чтобы реализовать параметры обработки данных с помощью API Graph, добавьте data_processing_options, data_processing_options_country и data_processing_options_state в вызов API. Чтобы явным образом отключить режим LDU, отправьте пустой массив data_processing_options: 
{
  "event": "CUSTOM_APP_EVENTS",
  "application_tracking_enabled": "1",
  "advertiser_tracking_enabled": "1",
  "custom_events": ["fb_mobile_purchase"],
  "data_processing_options": []
}
Чтобы включить LDU для пользователей с геолокацией, можно отправить событие со следующим кодом: 
{
  "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
}
Чтобы включить LDU и указать местоположение пользователей, можно отправить событие со следующим кодом: 
  {
  "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 для мобильных платформ

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

iOS SDK (Objective C)

В Objective C используйте FBSDKSettings setDataProcessingOptions.


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

[FBSDKSettings setDataProcessingOptions:@[]];

Чтобы включить режим LDU с геолокацией:

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

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

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

iOS SDK (Swift)

В Swift используйте setDataProcessingOptions.


Чтобы явным образом отключить режим LDU:

Settings.setDataProcessingOptions(modes: [])

Чтобы включить LDU для пользователей с геолокацией:

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

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

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

Android SDK

Используйте метод setDataProcessingOptions.


Чтобы явным образом отключить режим LDU:

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

Чтобы включить LDU для пользователей с геолокацией:

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

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

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

Unity SDK

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

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

Чтобы включить LDU для пользователей с геолокацией, отправьте событие так:

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

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

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

Audience Network SDK

Издатели, переходящие на SDK Audience Network версии 5.10 или более новой, должны установить флаг ограниченного использования данных, чтобы компания Facebook и далее применяла ограничения в отношении персональных данных жителей Калифорнии, которыми они делятся.

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

iOS SDK версии 5.10 или более поздней

Используйте FBAdSettings setDataProcessingOptions.


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

[FBAdSettings setDataProcessingOptions:@[]];

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

  • используйте Country:1, чтобы указать США;
  • используйте State:1000, чтобы указать Калифорнию.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

Чтобы включить LDU для пользователей с геолокацией:

  • используйте Country:0, чтобы запросить геолокацию этого события;
  • используйте State:0, чтобы запросить геолокацию этого события.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

Android SDK версии 5.10 или более поздней

Используйте метод setDataProcessingOptions.


Чтобы явным образом отключить режим LDU:

AdSettings.setDataProcessingOptions(new String[] {})

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

  • используйте Country:1, чтобы указать США;
  • используйте State:1000, чтобы указать Калифорнию.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

Чтобы включить LDU для пользователей с геолокацией:

  • используйте Country:0, чтобы запросить геолокацию этого события;
  • используйте State:0, чтобы запросить геолокацию этого события.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

Unity SDK версии 5.10 или более поздней (без использования оболочки Audience Network для Unity)

Если вы не используете оболочку Audience Network для Unity, введите следующий код:


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

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

Unity SDK версии 5.10 или более поздней (с использованием оболочки Audience Network для Unity)

Если вы используете оболочку Audience Network для Unity, используйте следующие параметры SetDataProcessingOptions.


Чтобы явным образом отключить режим LDU:

AdSettings.SetDataProcessingOptions(new string[]{})

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

  • используйте Country:1, чтобы указать США;
  • используйте State:1000, чтобы указать Калифорнию.
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000);

Чтобы включить LDU для пользователей с геолокацией:

  • используйте Country:0, чтобы запросить геолокацию этого события;
  • используйте State:0, чтобы запросить геолокацию этого события.
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0);

Издатели, использующие партнера по агрегации, должны установить флажок параметров обработки данных (ограниченного использования данных) в SDK Audience Network Facebook перед инициализацией SDK агрегации, чтобы мы получили соответствующие данные в запросе ставки.

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

Android

Чтобы явным образом отключить режим LDU:

AdSettings.setDataProcessingOptions(new String[] {})

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

  • используйте Country:1, чтобы указать США;
  • используйте State:1000, чтобы указать Калифорнию.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

Чтобы включить LDU для пользователей с геолокацией:

  • используйте Country:0, чтобы запросить геолокацию этого события;
  • используйте State:0, чтобы запросить геолокацию этого события.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

После установки флажка LDU инициализируйте SDK партнера по агрегации.

iOS

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

FBAdSettings setDataProcessingOptions:@[]];

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

  • используйте Country:1, чтобы указать США;
  • используйте State:1000, чтобы указать Калифорнию.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

Чтобы включить LDU для пользователей с геолокацией:

  • используйте Country:0, чтобы запросить геолокацию этого события;
  • используйте State:0, чтобы запросить геолокацию этого события.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

После установки флажка LDU инициализируйте SDK партнера по агрегации.

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

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

Пакет для проведения аукционов для Android версии 2.0

Чтобы явным образом отключить режим LDU:

AdSettings.setDataProcessingOptions(new String[] {})

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

  • используйте Country:1, чтобы указать США;
  • используйте State:1000, чтобы указать Калифорнию.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

Чтобы включить LDU для пользователей с геолокацией:

  • используйте Country:0, чтобы запросить геолокацию этого события;
  • используйте State:0, чтобы запросить геолокацию этого события.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

После установки флажка LDU сгенерируйте маркер участника аукциона:

String token = BidderTokenProvider.getBidderToken(Context);

Пакет для проведения аукционов для iOS версии 2.0

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

[FBAdSettings setDataProcessingOptions:@[]];

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

  • используйте Country:1, чтобы указать США;
  • используйте State:1000, чтобы указать Калифорнию.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

Чтобы включить LDU для пользователей с геолокацией:

  • используйте Country:0, чтобы запросить геолокацию этого события;
  • используйте State:0, чтобы запросить геолокацию этого события.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

После установки флажка LDU сгенерируйте маркер участника аукциона:

NSString *token = [FBAdSettings bidderToken];

Другие серверные инструменты для проведения аукционов

Прежде чем делать запрос ставки на стороне сервера, установите флажок LDU и получите маркер участника аукциона согласно инструкциям для соответствующих платформ ниже.


Для клиента Android

Чтобы явным образом отключить режим LDU:

AdSettings.setDataProcessingOptions(new String[] {})

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

  • используйте Country:1, чтобы указать США;
  • используйте State:1000, чтобы указать Калифорнию.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

Чтобы включить LDU для пользователей с геолокацией:

  • используйте Country:0, чтобы запросить геолокацию этого события;
  • используйте State:0, чтобы запросить геолокацию этого события.
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

После установки флажка LDU сгенерируйте маркер участника аукциона:

String token = BidderTokenProvider.getBidderToken(Context);

Для клиента iOS

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

[FBAdSettings setDataProcessingOptions:@[]];

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

  • используйте Country:1, чтобы указать США;
  • используйте State:1000, чтобы указать Калифорнию.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

Чтобы включить LDU для пользователей с геолокацией:

  • используйте Country:0, чтобы запросить геолокацию этого события;
  • используйте State:0, чтобы запросить геолокацию этого события.
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

После установки флажка LDU сгенерируйте маркер участника аукциона:

NSString *token = [FBAdSettings bidderToken];

В SDK AN версий до 5.10 компании могут переопределять автоматически применяемый период ограничений на использование данных с помощью настройки в Monetization Manager. Обратите внимание: эта настройка переопределения применяется только тогда, когда для запроса в отношении жителя Калифорнии не установлен флажок LDU (т. е. для любого запроса из SDK AN версий до 5.10).

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

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