firstPartyParamsHashed (с возможностью самостоятельного хеширования данных)

Совет. Для работы с JavaScript API необходимы навыки работы с HTML и JavaScript. Если вы не обладаете такими навыками, обратитесь к разработчику или вебмастеру вашего сайта.

Метод доступен для сайтов, которые работают на протоколе HTTPS.

Отправка информации о посетителях сайта для улучшения работы рекламных алгоритмов и более точного анализа их поведения на сайте. Это поможет вам повышать эффективность рекламных кампаний и узнавать больше о поведении посетителей, даже если они используют браузеры с ограничением межсайтовых отслеживающих cookies (third-party cookies) — например, Safari или Mozilla Firefox.

После первой передачи данных с помощью метода в Метрике появится цель «Заполнение контактных данных» — для этого включите опцию Автоматические цели.

Внимание. Перед отправкой информации используйте хеширование данных.
ym(XXXXXX, 'firstPartyParamsHashed', parameters);

Параметр

Значение по умолчанию

 Тип

Описание
parameters * —

Object

Информация о посетителе, которую он оставил на сайте, например через форму обратной связи. В качестве значений передаются ранее захешированные данные, кроме yandex_cid. Пример:

ym(XXXXXX, 'firstPartyParamsHashed', {
    "email": '<SHA‑256 от mail@example.com>',
    "phone_number": '<SHA‑256 от 70123456789>',
    "first_name": '<SHA‑256 от Иван>',
    "last_name": '<SHA‑256 от Иванов>',
    "yandex_cid": '1000034426'
});
Поля объекта parameters

Параметр

 Значение по умолчанию Тип

Описание
email —

String

Электронный адрес определенного формата, хешированный по алгоритму SHA-256.

Для проверки хеширования вы можете использовать почту name@yandex.ru. Хеш от нее должен получиться: 41b86f44151924a940be6fa30d93f2471683ca74ac361d3b827a9b72c80a7623.

Если адрес электронной почты будет указан в нехешированном виде, Метрика не сможет его распознать.
phone_number — String

Номер телефона определенного формата, хешированный по алгоритму SHA-256.

Для проверки хеширования вы можете использовать телефон 70123456789. Хеш от него должен получиться: 8f0dd3d30a1ea4b739c6217c02604aee1556025da990212759efd877206a1948.

Если номер телефона будет указан в нехешированном виде, Метрика не сможет его распознать.
first_name — String Имя посетителя.
last_name — String Фамилия посетителя.
yandex_cid — Integer Уникальный идентификатор пользователя Яндекса (id). Передавайте, если на вашем сайте есть авторизация Яндекс ID.

Параметр

Значение по умолчанию

 Тип

Описание
parameters * —

Object

Информация о посетителе, которую он оставил на сайте, например через форму обратной связи. В качестве значений передаются ранее захешированные данные, кроме yandex_cid. Пример:

ym(XXXXXX, 'firstPartyParamsHashed', {
    "email": '<SHA‑256 от mail@example.com>',
    "phone_number": '<SHA‑256 от 70123456789>',
    "first_name": '<SHA‑256 от Иван>',
    "last_name": '<SHA‑256 от Иванов>',
    "yandex_cid": '1000034426'
});
Поля объекта parameters

Параметр

 Значение по умолчанию Тип

Описание
email —

String

Электронный адрес определенного формата, хешированный по алгоритму SHA-256.

Для проверки хеширования вы можете использовать почту name@yandex.ru. Хеш от нее должен получиться: 41b86f44151924a940be6fa30d93f2471683ca74ac361d3b827a9b72c80a7623.

Если адрес электронной почты будет указан в нехешированном виде, Метрика не сможет его распознать.
phone_number — String

Номер телефона определенного формата, хешированный по алгоритму SHA-256.

Для проверки хеширования вы можете использовать телефон 70123456789. Хеш от него должен получиться: 8f0dd3d30a1ea4b739c6217c02604aee1556025da990212759efd877206a1948.

Если номер телефона будет указан в нехешированном виде, Метрика не сможет его распознать.
first_name — String Имя посетителя.
last_name — String Фамилия посетителя.
yandex_cid — Integer Уникальный идентификатор пользователя Яндекса (id). Передавайте, если на вашем сайте есть авторизация Яндекс ID.

* Обязательный параметр.

Хеширование данных

Перед хешированием нормализуйте данные — убедитесь, что они указаны в нижнем регистре, без запятых и пробелов (в том числе двойных и более) в начале и конце, а также:
email
  • Для адресов на домене Google (вида <name>@gmail.com) в имени замените точки на пустые строки. Например, name.example@gmail.com замените на nameexample@gmail.com.
  • Для адресов на домене Yandex (вида <name>@yandex.ru) в имени замените точки на тире. Например, name.example@yandex.ru замените на name-example@yandex.ru.
  • Адреса на множестве доменов Yandex (@ya.ru, @yandex.com и пр.) замените на @yandex.ru. Например, example@yandex.ru.
  • Если в имени используется знак «+» (name+commercial@example.com), оставьте только имя — name@example.com.
phone_number
  • Значение может содержать только цифры.
  • В номере вместо кода 8 укажите код 7 без знака «+» в начале. Пример: 70123456789.

Хешировать необходимо все данные, кроме уникального идентификатора пользователя Яндекса (yandex_cid), по алгоритму SHA‑256.

Пример параметров с захешированными значениями:

...
"name@yandex.ru": '41b86f44151924a940be6fa30d93f2471683ca74ac361d3b827a9b72c80a7623',
"70123456789": '8f0dd3d30a1ea4b739c6217c02604aee1556025da990212759efd877206a1948'
...

Обратите внимание: служба поддержки не обзванивает пользователей. Не следуйте указаниям людей, которые вам звонят и представляются службой поддержки Яндекс Метрики.