firstPartyParamsHashed(具有数据自散列功能)

重要

使用 JavaScript API 需要了解 HTML 和 JavaScript。 如果您不了解这些语言,请联系您的网站开发人员或站长。

该方法适用于 HTTPS 网站。

发送有关网站用户的信息,以提高广告算法的性能并更准确地分析他们在网站上的行为。 这将帮助您提高广告系列的成效并详细了解用户行为,即使他们使用带有限跨站点跟踪 cookie(第三方 cookie)的浏览器,例如 Safari 和 Mozilla Firefox 亦可如此。

使用此方法完成首次数据传输后,“Filling in contact details”目标将出现在 Yandex Metrica 中。 为此,请启用 Automatic goals 选项。

注意

在发送数据之前,使用数据散列

ym(XXXXXX, 'firstPartyParamsHashed', parameters);

参数

默认值

类型

描述

参数*

Object

用户在网站上(例如,通过反馈表)留下的有关自己的信息。 先前散列的数据作为值传递,yandex_cid 除外。 示例:

     "email": '<SHA‑256 from mail@example.com>',
     "phone_number": '<SHA‑256 от 70123456789>',
     "first_name": '<SHA‑256 from John>',
     "last_name": '<SHA‑256 from Smith>',
     "yandex_cid": '1000034426'
 });

parameters 对象的字段

电子邮件

String

采用特定格式的电子邮件地址,使用 SHA-256 算法进行散列处理。

要测试散列处理,您可以使用电子邮件地址 name@yandex.ru。 散列应该是:41b86f44151924a940be6fa30d93f2471683ca74ac361d3b827a9b72c80a7623

如果提供的电子邮件地址未经过散列处理,Yandex Metrica 将无法识别该地址。

phone_number

String

采用特定格式的电话号码,使用 SHA-256 算法进行散列处理。

要测试散列处理,您可以使用电话号码 ‪‪‪‪70123456789‬‬‬‬。 散列应该是:8f0dd3d30a1ea4b739c6217c02604aee1556025da990212759efd877206a1948

如果提供的电话号码未经过散列处理,Yandex Metrica 将无法识别该号码。

first_name

String

用户的名字。

last_name

String

用户的姓氏。

yandex_cid

整数

唯一 ID (ID)。 如果您的网站使用 Yandex ID 授权,请发送它。

* 必需参数。

散列数据

在进行散列处理前,需对数据进行规范化处理:确保数据均为小写,且开头和结尾不含逗号及空格(包括连续两个及以上的空格),电子邮件数据也需作此处理。

  • 对于 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 用户唯一标识符外(yandex_cid),所有数据必须使用 SHA‑256 算法进行散列处理。

具有散列值的参数示例:

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

了解详情

与我们聊天

发送电子邮件

请注意:我们的支持团队永远不会主动给您打电话。 请勿按照自称为 Yandex Metrica 支持团队来电者的指示操作。