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(XXXXXXXX, '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(XXXXXXXX, 'hit', '/contacts');

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

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

Example

ym(XXXXXXXX, 'init', {});
//...
ym(XXXXXXXX, '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.

Example:

var goalParams =
{
   order_price: 1000.35,
   currency: "RUB"
};
ym(XXXXXXXX, '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.

Useful links

Online training

Was the article helpful?

getClientID

notBounce