hit

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.

Sends data about a pageview. Usually used on pages with AJAX or Flash implementation.

ym(XXXXXX, 'hit', [url[, options]])

Alert

The hit([url[, title[, referer[, params]]]]) signature is outdated. It’s supported for backward compatibility, but may be deprecated at any time. We strongly discourage its use.

Parameter

Default value

Type

Description

url*

:

String?

The URL of the page from which the view was made. If the URL isn't provided, the value from window.location.href is used.

options

:

Object

:

options fields

options.callback

:

Function

The callback function to call after sending pageview data

options.ctx

:

Object

Context accessed by the this keyword in the callback function

options.params

:

Object

Session parameters

options.referer

:

String

The URL that the user loaded the current page contents from

options.title

document.title

String

Title of the current page

Fields for the options.params object:

order_price

:

Double

Revenue by goal. You can set the cost in a currency or conventional units.

currency

:

String

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

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

* Required parameter.

With the url and options.referer parameters, you can use URL paths without a schema (protocol) and host.

In this case, if a path starts with a /, the URL is assumed to be set from the root of the host.

ym(XXXXXX, 'hit', '/contacts');

Otherwise, the path is assumed to be relative to the current page.

ym(XXXXXX, 'hit', 'contacts', {params:{'param': 'value'}});

Example

ym(XXXXXX, 'init', {});
//...
ym(XXXXXX, 'hit', '#contacts',{params:{
    'Page title': 'Contact information',
    'another_param': 'another_value'
}});

Revenue by goal

If pageview is one of the goals configured on your website, you can transmit the revenue in the method parameters. Details about revenue by goal

Example:

var goalParams =
{
   order_price: 1000.35,
   currency: "RUB"
};
ym(XXXXXX, 'hit', '/contacts', {params: goalParams})

Chat with us

Write an email

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.


* Required parameter.