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": '<MD5 от mail@example.com>',
    "phone_number": '<MD5 от 70123456789>',
    "first_name": '<MD5 от Иван>',
    "last_name": '<MD5 от Иванов>',
    "yandex_cid": '1000034426'
    "home_address": {
        "street": '<MD5 от Льва толстого 16>',
        "city": '<MD5 от Москва>',
        "region": '<MD5 от Москва>',
        "postal_code": '<MD5 от 12345>', 
        "country": '<MD5 от Россия>'
    }
});
Поля объекта parameters

Параметр

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

Описание
email —

String

 Электронный адрес.
phone_number — String Номер телефона без пробелов в формате 70123456789.
first_name — String Имя посетителя.
last_name — String Фамилия посетителя.
home_address — String Адрес посетителя.
street — String Улица.
city — String Город.
region — String Регион.
postal_code — Integer Почтовый индекс.
country — String Страна.
yandex_cid — Integer Уникальный идентификатор пользователя Яндекса (id). Передавайте, если на вашем сайте есть авторизация Яндекс ID.

Параметр

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

 Тип

Описание
parameters * —

Object

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

ym(XXXXXX, 'firstPartyParamsHashed', {
    "email": '<MD5 от mail@example.com>',
    "phone_number": '<MD5 от 70123456789>',
    "first_name": '<MD5 от Иван>',
    "last_name": '<MD5 от Иванов>',
    "yandex_cid": '1000034426'
    "home_address": {
        "street": '<MD5 от Льва толстого 16>',
        "city": '<MD5 от Москва>',
        "region": '<MD5 от Москва>',
        "postal_code": '<MD5 от 12345>', 
        "country": '<MD5 от Россия>'
    }
});
Поля объекта parameters

Параметр

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

Описание
email —

String

 Электронный адрес.
phone_number — String Номер телефона без пробелов в формате 70123456789.
first_name — String Имя посетителя.
last_name — String Фамилия посетителя.
home_address — String Адрес посетителя.
street — String Улица.
city — String Город.
region — String Регион.
postal_code — Integer Почтовый индекс.
country — 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), по алгоритму MD5 или SHA-256.

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

...
"email": '78ee6d68f49d2c90397d9ff77fc3814d1',
"phone_number": 'a31259d185ad013e0a663437c605d056'
...

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