Tracking conversions
Using the Yandex Metrica API, you can track on-site conversions and integrate offline conversion data, such as call information, for a more complete overview.
Examples of conversion reports:
Offline conversions and calls
When a user visits your website, Yandex Metrica collects information about the user's characteristics, behavior on the website, and goals completed. But your business might have other important information that it collects offline about payments, calls, and so on. You can transmit this data to Yandex Metrica and link the behavior of your customers on the website to their actions offline.
Passing offline data can help you to:
- Link users' online and offline history to get a better picture of the conversion funnel.
- Use offline data for advertising by creating segments for Yandex Direct, including look-alike audiences powered by Yandex Audience technology.
You can transmit the following types of offline data:
-
Offline conversions. For instance, information about orders that were created on the site and paid for in the office. This data can be transmitted by the site owner via the Yandex Metrica web interface or the API.
-
Information about calls. This information is usually available from the call tracking service your company uses. It passes the data to Yandex Metrica over the API.
Data is passed in a CSV file.
How offline conversion attribution works
To link offline data to site users and their sessions, Yandex Metrica has a 21-day conversion tracking period. This means that data about an offline conversion is added to a session if 21 days or less have passed since the user's last session on the site when the file with conversion data is processed.
A conversion won't be attributed to a session if it occurred or was passed by you more than 21 days after the site session.
If you use different IDs, conversion attribution methods will differ:
ClientIDandUserID. Offline conversions and calls are added to the user’s session that directly preceded them. For example, the user had three sessions: March 1, March 5, and March 11. On March 10, this user paid for an order at a retail store, and this date was registered in the CRM. On March 20, the manager sent the data to Yandex Metrica. The order paid for on March 10 was added to the customer's site session from March 5.yclid. Conversions will be added to a session initiated through the ad linked to the transmittedyclid.PurchaseId. Conversions will be added to the session that included an E-commerce purchase with the specified ID.
- Special IDs
-
ClientIDUserIDyclidPurchaseId
This is the ID of a unique site user that Yandex Metrica creates automatically.
Used for tracking offline conversions and calls and transmitting user parameters.
Transmit data using the ClientID if, for example, your website doesn't have a system of user identifiers, or you don't need the identifiers that are used.
In this case, you should:
- Get the IDs using the getClientID JavaScript API method.
- Send them with the other data in the CSV file.
The website user ID assigned by the website owner.
Used for tracking offline conversions and calls and transmitting user parameters.
Transmit data using UserID if your website already has a system for identifying users (for example, by username), and you are actively using this data.
In this case, you should:
- Set up ID transmission to Yandex Metrica using the setUserID JavaScript API method to associate a UserID with a ClientID.
- Send the UserIDs with the other data in the CSV file.
Your site user ID is associated with the ClientID of a particular user only if the
setUserIDmethod was called during the user's session. To get more complete statistics, we recommend waiting some time until a larger volume of data is transmitted to Yandex Metrica.
The ID of a click on a Yandex Direct ad assigned by Yandex Direct. It's used to link conversions to ads in Yandex Direct. With this ID, you can track conversions both on your site and offline.
This is the E-commerce purchase ID assigned by the site owner. It's used to link conversions to sessions in which the purchase with the specified
idoccurred.
How to pass data
For information on how to pass data, see the following sections: