Installing and configuring a tag for AJAX and Flash sites

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.

Read these instructions if you have an AJAX or Flash site and wish to use Yandex Metrica:

  1. In order for Yandex Metrica to register important changes to a page, analyze the logic of your site and insert a hit function in the appropriate parts of AJAX and Flash code so it’s triggered each time you believe the page has changed.
ym(XXXXXX, 'hit', url[, options])

Parameter

Default value

Type

Description

url *

string

Current page URL

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

options.params 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.

ym(XXXXXX, 'hit', 'http://example.com#contacts', {title: 'Contacts', referer: 'http://example.com/#main'});

If you want to register a goal completion for a specific action on the page, use the reachGoal function.

If you were unable to independently check the tag, follow the recommendations below.

This might happen for the following reasons:

  • The tag is installed incorrectly. For example, the CMS modified the code snippet. Reinstall the tag or contact the support service for your CMS.
  • Broken scripts are preventing the Yandex Metrica tag from working on the site. You can check this in the browser console.

This means that information is being transmitted to Yandex Metrica. However, the data might not be shown in reports for any of the following reasons:

  • Data is sent to a tag with a different number.
  • The Filters tab in the tag settings has overly strict filters defined. Remove unneeded filters.
  • The Filters tab in the tag settings has the Don't count my sessions filter enabled. This means that the tag doesn't register your own sessions. Try accessing the site with your browser in “incognito” mode.