---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/support/metrica/en/objects/first-party-params.md
  - https://yandex.com/support/metrica/es/objects/first-party-params.md
  - https://yandex.com/support/metrica/pt/objects/first-party-params.md
  - https://yandex.com/support/metrica/ru/objects/first-party-params.md
  - https://yandex.com/support/metrica/tr/objects/first-party-params.md
  - https://yandex.com/support/metrica/zh/objects/first-party-params.md
  - href: en/objects/first-party-params.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: firstPartyParams
description: Sends information about site users to improve the performance of advertising algorithms and more accurate analysis of their behavior on the site.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/en/llms.txt


# firstPartyParams

<!-- source: en/_includes/code/counter-initialize/id-counter-initialize/rest-js.md -->
{% note warning %}

Working with the JavaScript API requires knowledge of HTML and JavaScript. If you don’t know these languages, contact your website developer or webmaster.

{% endnote %}
<!-- endsource: en/_includes/code/counter-initialize/id-counter-initialize/rest-js.md -->

The method is available for HTTPS websites.

Sends information about site users to improve the performance of advertising algorithms and more accurate analysis of their behavior on the site. This helps you get better results from your ad campaigns and learn more about user behavior, even if your site visitors use browsers that limit cross-site tracking cookies (third-party cookies), such as Safari or Mozilla Firefox.

After the first data transfer using this method, the **Entering contact information** goal appears in Yandex Metrica. To enable this, select [Automatic goals](https://yandex.com/support/metrica/en/general/auto-goals.md).

{% note info %}

The data doesn’t need to be hashed. During transfer, the data is hashed automatically and sent to Yandex Metrica in anonymized format.

{% endnote %}

```javascript
ym(XXXXXXXX, 'firstPartyParams', parameters);
```

{% note alert %}

Specify the parameters in lowercase, without commas and spaces at the end.

{% endnote %}

#|
||
**Parameter**
|
**Default value**
|
**Type**
|
**Description**
||
||
`parameters` *
|
—
|
Object
|
Information that a user left about themselves on the site, such as through the feedback form.

```javascript
ym(XXXXXXXX, 'firstPartyParams', {
    "email": 'mail@example.com',
    "phone_number": '70123456789',
    "first_name": 'Ivan',
    "last_name": 'Ivanov',
    "yandex_cid": 1000034426
 });
```
||

||
**Fields for the parameters object**:
|
>
||
||
`email`
|
—
|
String
|
Email address.
||
||
`phone_number`
|
—
|
String
|
Phone number without spaces in the format 70123456789.
||
||
`first_name`
|
—
|
String
|
User's first name.
||
||
`last_name`
|
—
|
String
|
User's last name.
||
||
`yandex_cid`
|
—
|
Integer or String
|
[Unique ID](https://yandex.com/dev/id/doc/dg/api-id/reference/response.html) of Yandex user (`id`). Send it if your website uses Yandex ID authorization.
||
|#

<sup >*</sup> Required parameter.

## Learn more

- [Checking data transmission for advanced tracking settings](https://yandex.com/support/metrica/en/objects/check-first-party-params.md)

<!-- source: en/_includes/buttons/chat-button.md -->
[Chat with us](https://yandex.com/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}

<!-- source: en/_includes/styles/href-to-button.md -->

<!-- endsource: en/_includes/styles/href-to-button.md -->
<!-- endsource: en/_includes/buttons/chat-button.md -->

<!-- source: en/_includes/buttons/support-button.md -->
<div class="cut-button">

{% cut "Write an email" %}

<!-- source: en/_includes/popup/id-popup/wrong-sup.md -->
Please note: Our support team will never initiate a call to you. Do not follow any instructions of people who call you and introduce themselves as the Yandex Metrica support team.
<!-- endsource: en/_includes/popup/id-popup/wrong-sup.md -->

<div style="padding: 15px;
     margin: 10px 0;
     background: #FFFFFF;
     border-radius: 10px;
     border: 1px solid var(--g-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com/surveys/1706/?&iframe=1&lang=en">
  </iframe>
</div>

{% endcut %}

</div>

<!-- source: en/_includes/styles/cut-button.md -->

<!-- endsource: en/_includes/styles/cut-button.md -->
<!-- endsource: en/_includes/buttons/support-button.md -->

<!-- source: en/_includes/footer-links.md -->
- - -

<div class="borderless-table">

#|
||
Useful links

- [Demo tag](https://metrica.yandex.com/r/dashboard?)
- [Add a tag](https://metrica.yandex.com/add/)
- [Free tag setup](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1)
- [Yandex Metrica API](https://tech.yandex.com/metrika/)
- [Suggest your idea](https://yandex.com/support/metrica/troubleshooting/idea.html)
- [Discuss in Telegram](https://t.me/yandexmetrika)
|
Online training

- [Get a Yandex Metrica certificate](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)


- [Take a training course](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)

||
|#

</div>

<!-- source: en/_includes/styles/table-style.md -->

<!-- endsource: en/_includes/styles/table-style.md -->
<!-- endsource: en/_includes/footer-links.md -->