params

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

Transmits custom session parameters.

Attention. Some field names are reserved for transmitting e-commerce data. Don't use these names to send session parameters. Don't send custom parameters with reserved ones.
ym(XXXXXX, 'params', parameters);

Parameter

Default value

 Type

Description
parameters * —

Object | Array

Session parameters. Example of sending an object:

var myParams = {test: {myParam: 123}};
ym(XXXXXX, 'params', {params: myParams});

Example of sending an array:

var myParamsArray = [{test: {myParam: 123}},
{test: {myParam: 456}}];
ym(XXXXXX, 'params', {params: myParamsArray});
parameters object fields:
order_price —

Double

Revenue by goal. You can set the cost in currency or Yandex units.
currency —

string

Use this field if you want to pass the goal cost in currency. Yandex.Metrica recognizes three-letter ISO 4217 currency codes

If a different currency is passed, null values will be sent instead of currencies and amounts.

Parameter

Default value

 Type

Description
parameters * —

Object | Array

Session parameters. Example of sending an object:

var myParams = {test: {myParam: 123}};
ym(XXXXXX, 'params', {params: myParams});

Example of sending an array:

var myParamsArray = [{test: {myParam: 123}},
{test: {myParam: 456}}];
ym(XXXXXX, 'params', {params: myParamsArray});
parameters object fields:
order_price —

Double

Revenue by goal. You can set the cost in currency or Yandex units.
currency —

string

Use this field if you want to pass the goal cost in currency. Yandex.Metrica recognizes three-letter ISO 4217 currency codes

If a different currency is passed, null values will be sent instead of currencies and amounts.

* Required parameter.

Revenue by goal

In addition to custom session parameters, you can transmit the revenue in the method parameters. Details about revenue by goal

Example:

var visitParams =
{
   test: {myParam: 123}
};
var goalParams =
{
   order_price: 1000.35,
   currency: "RUB"
};
ym(XXXXXX, 'params', visitParams, goalParams)