emЭл. почта Строка или список строк <string> | Хэширование обязательно.
Удаляйте начальные и конечные пробелы. Преобразуйте все символы в нижний регистр.
Пример Ввод: John_Smith@gmail.com
Нормализованный формат: john_smith@gmail.com
Ожидаемый вывод с хэшированием по алгоритму SHA256: 62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f |
phНомер телефона Строка или список строк <string> | Хэширование обязательно.
Удаляйте символы, буквы и начальные нули. Для правильного сопоставления телефонный номер должен содержать код страны (например, номера телефонов в России должны начинаться с цифры 7). Всегда добавляйте в телефонные номера своих клиентов код страны, даже если все ваши данные из одной страны.
Пример Ввод: номер телефона в США (650)555-1212
Нормализованный формат: 16505551212
Ожидаемый вывод с хэшированием по алгоритму SHA256: e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176 |
fnИмя Строка или список строк <string> | Хэширование обязательно.
Рекомендуется использовать символы латинского алфавита a–z в нижнем регистре без знаков препинания. Если используются специальные символы, текст должен быть закодирован в формате UTF-8.
Пример
Ввод: Mary
Нормализованный формат: mary
Ожидаемый вывод с хэшированием по алгоритму SHA256: 6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec
Ввод: 정
Нормализованный формат: Символ UTF-8 "정"
Ожидаемый вывод с хэшированием по алгоритму SHA256: 8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14
Ввод: Valéry
Нормализованный формат: valéry
Ожидаемый вывод с хэшированием по алгоритму SHA256: 08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c |
lnФамилия Строка или список строк <string> | Хэширование обязательно.
Рекомендуется использовать символы латинского алфавита a–z в нижнем регистре без знаков препинания. Если используются специальные символы, текст должен быть закодирован в формате UTF-8.
Примеры см. в описании параметра имени (fn). |
dbДата рождения Строка или список строк <string> | Хэширование обязательно.
Мы поддерживаем формат YYYYMMDD с различными комбинациями месяца, дня и года (как с разделителями, так и без). Год: указывается в формате YYYY (от 1900 до текущего года). Месяц: указывается в формате MM (от 01 до 12). День: указывается в формате DD (от 01 до 31).
Пример Ввод: 2/16/1997
Нормализованный формат: 19970216
Ожидаемый вывод с хэшированием по алгоритму SHA256: 01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c |
geПол Строка или список строк <string> | Хэширование обязательно.
Мы принимаем параметр пола в виде одной буквы в нижнем регистре.
Пример f — женский (female); m — мужской (male).
|
ctГород Строка или список строк <string> | Хэширование обязательно.
Рекомендуется использовать символы латинского алфавита a–z. в нижнем регистре, без знаков препинания, специальных символов и пробелов. Если используются специальные символы, текст должен быть закодирован в формате UTF-8.
Пример
paris
london
newyork |
stРегион Строка или список строк <string> | Хэширование обязательно.
Используйте двухбуквенный код ANSI в нижнем регистре. Нормализуйте названия административно-территориальных единиц других стран: они должны быть в нижнем регистре, без знаков препинания, специальных символов и пробелов.
Пример
az
ca |
zpПочтовый индекс Строка или список строк <string> | Хэширование обязательно.
Указывайте значения в нижнем регистре без пробелов и дефисов. Для почтовых индексов США используйте только первые 5 знаков, Для почтовых индексов Великобритании указывайте область, район и сектор.
Примеры
ZIP-код в США: 94035
Почтовый индекс в Австралии: 1987
Почтовый индекс во Франции: 75018
Почтовый индекс в Великобритании: m11ae |
countryСтрана Строка или список строк <string> | Хэширование обязательно.
Используйте двухбуквенные коды стран в нижнем регистре согласно стандарту ISO 3166-1 alpha-2.
Важное примечание. Всегда указывайте страну своего клиента, даже если код страны у всех ваших клиентов одинаковый. Мы ищем совпадения по всем странам, и это простое действие поможет нам сопоставить как можно больше аккаунтов из Центра аккаунтов.
Пример
Ввод: США
Нормализованный формат: us
Ожидаемый вывод с хэшированием по алгоритму SHA256: 79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621 |
external_idВнешний ID Строка или список строк <string> | Хэширование рекомендовано.
Это могут быть любые уникальные идентификаторы, регистрируемые рекламодателем: ID участников программы лояльности, ID пользователей, ID внешних файлов cookie и т. д. Для каждого события можно отправить один или несколько внешних ID.
Если внешний ID отправляется по другим каналам, он должен иметь тот же формат, что и значение, отправляемое через API Conversions. |
client_ip_addressIP-адрес клиента Строка | Не хэшируется.
IP-адрес браузера, соответствующий событию, должен представлять собой действительный IPv4- или IPv6-адрес. Для пользователей, у которых поддерживается стандарт IPv6, рекомендуется использовать формат IPv6 вместо IPv4. Параметр данных пользователя client_ip_address не должен хэшироваться.
Значение не должно содержать пробелов. Для точной регистрации событий всегда указывайте реальный IP-адрес.
Примечание. Эта информация автоматически добавляется в события, отправляемые через браузер, но для событий, отправляемых через сервер, ее необходимо настраивать вручную.
Пример
IPV4: 168.212.226.204
IPV6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334 |
client_user_agentПользовательский агент клиента Строка | Не хэшируется.
Агент пользователя для браузера, соответствующий этому событию. Поле client_user_agent обязательно для событий на сайте, передаваемых через API Conversions. Отправка обоих параметров client_ip_address и client_user_agent для всех событий, отправляемых через API Conversion, часто помогает улучшить сопоставление событий. Эти параметры также могут повысить эффективность показа рекламы для рекламных кампаний, оптимизируемых для событий, которые отправляются через API Conversions.
Примечание. Эта информация автоматически добавляется в события, отправляемые через браузер, но для событий, отправляемых через сервер, ее необходимо настраивать вручную.
Пример:
Mozilla/5.0 (Windows NT 10.0; Win64, x64);
AppleWebKit/537.36 (KHTML, like Gecko);
Chrome/87.0.4280.141;
Safari/537.36. |
fbcID клика Строка | Не хэшируется.
Значение ID клика на Facebook хранится в файле cookie _fbc браузера в вашем домене. Сведения о том, как получить это значение или создать его на основе параметра запроса fbclid, см. в статье об управлении параметрами fbc и fbp. Формат: fb.${subdomain_index}.${creation_time}.${fbclid}.
Пример
fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890 |
fbpID браузера Строка | Не хэшируется.
Значение ID браузера Facebook хранится в файле cookie _fbp браузера в вашем домене. Сведения о том, как получить это значение, см. в статье об управлении параметрами fbc и fbp. Формат: fb.${subdomain_index}.${creation_time}.${random_number}.
Пример
fb.1.1596403881668.1116446470 |
subscription_idID подписки Строка | Не хэшируется.
ID подписки для пользователя в этой транзакции; аналогичен ID заказа для отдельного продукта. |
fb_login_idID входа через Facebook Целое число | Не хэшируется.
ID, создаваемый Meta, когда человек впервые входит в экземпляр приложения. Также называется ID внутри приложения. |
lead_idID лида Целое число | Не хэшируется.
ID, связанный с лидом, сгенерированным рекламой для лидов Meta. |
anon_idСтрока | Не хэшируется.
ID установки. В этом поле указаны уникальные экземпляры установки приложения.
Примечание. Этот параметр относится только к событиям в приложении. |
madidСтрока | Ваш ID рекламодателя на мобильном устройстве и рекламный ID устройства Android или рекламный идентификатор устройства Apple (IDFA). |
page_idСтрока | Не хэшируется.
ID вашей Cтраницы. ID Страницы, связанной с событием. Используйте ID Страницы Facebook, связанной с ботом. |
page_scoped_user_idСтрока | Не хэшируется.
ID пользователя в пределах страницы, связанного с ботом Messenger, который занес событие в журнал. Укажите ID пользователя в пределах страницы, предоставленный вашему Webhook. |
ctwa_clidСтрока | Не хэшируется.
ID клика, генерируемый Meta для рекламы с переходом в WhatsApp. |
ig_account_idСтрока | Не хэшируется.
ID аккаунта Instagram, связанного с компанией. |
ig_sidСтрока | Не хэшируется.
Пользователей, взаимодействующих с Instagram, идентифицируют по ID пользователя в пределах Instagram (IGSID). IGSID можно получить через этот Webhooks. |
