--- title: Logging custom conversions on your website related: - https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/tracking-contact-activities.md - https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/optimization-testing.md - https://docs.kentico.com/k10/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-web-analytics/configuring-logging-of-actions-as-custom-conversions.md --- > Agent instructions: > **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown. > > - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version. > - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt). > **Info:** **Kentico EMS required** > > Features described on this page require the **Kentico EMS** license. [Web analytics](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/web-analytics.md) provide a way to track actions performed by your website's visitors and record them as custom _conversions_. This is typically done for desired events that somehow benefit the website, such as registrations of new users, product orders, subscriptions to newsletters and similar. Once you define an action as a conversion the system logs a _conversion hit_ whenever the given action occurs. Additionally, conversions can log a numerical value along with each hit to indicate its importance. You can compare the recorded statistics with the values of other web analytics metrics, such as the total amount of visitors. This allows you to evaluate the website and adjust it as necessary. > **Info:** **Tracking specific contacts** > > Conversions only record the total statistics of an action and do not store information about the specific users who performed it, or any other details. You can achieve this type of advanced tracking by using [Contact management](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management.md), which allows you to log specific actions as [Activities](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/tracking-contact-activities.md), including various information about the context in which the actions occurred. While tracking all conversions that occur on the website can be useful, in many cases you may also require additional information about the context in which the given actions occurred. For this reason, conversion tracking is integrated with other web analytics and on‑line marketing features. You can use [A/B](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/optimization-testing/a-b-testing-website-pages.md) or [Multivariate testing](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/optimization-testing/multivariate-testing.md) to log conversions for visitors exposed to different variants of pages.These features allow you to accurately measure how changes made to the content or structure of your website's pages affect the behavior of visitors. > **Info:** **Important** > > In Kentico, there are currently two types of conversions. The first type, which is described on this page, provides you with the ability to log specific actions that you want to track by creating custom conversions. This type is also used for the mentioned A/B tests and MVT tests. > > The second type is used for on-line marketing campaigns, which enable you to track specific actions of your visitors thanks to promotional emails or social media messages. Those conversions are tracked only in the **Campaigns** application, and you can learn more information about campaigns in [Campaigns](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/campaigns.md). ## Managing conversions To work with conversion, open the **Conversions** application. The **Overview** tab contains a [web analytics report](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/web-analytics/viewing-web-analytics-reports.md) displaying the custom conversions that were logged on the website over the specified time period. ![Viewing the Conversions overview](https://docs.kentico.com/docsassets/k10/logging-custom-conversions-on-your-website/Conversions_Overview.png "Viewing the Conversions overview") > **Tip:** **Detailed reports** > > The overview report only provides a general overview of the website's custom conversion statistics. You can view additional data for conversions that were logged under special circumstances: > > - In the **Conversions** application on the **Conversions** tab, edit () a custom conversion and switch to the **Details** tab > - In the **A/B tests** application, edit () a test and switch to the **Overview** tab (see [A/B testing website pages](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/optimization-testing/a-b-testing-website-pages.md)) > - In the **MVT tests** application, edit () a test and switch to the **Reports** tab (see [Multivariate testing](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/optimization-testing/multivariate-testing.md)) If you switch to the **Conversions** tab, you can view a list of all conversions defined for the current site and manage them as necessary. ![Viewing the list of conversions](https://docs.kentico.com/docsassets/k10/logging-custom-conversions-on-your-website/Conversions_List.png "Viewing the list of conversions") To define a new custom conversion, click **New conversion** and fill in the following properties in the displayed dialog: - **Conversion display name** – the name of the custom conversion displayed in the administration interface and in reports. - **Conversion code name** – sets a code name that serves as a unique identifier for the custom conversion. - **Conversion description** – enter text describing the custom conversion's purpose. You can modify the properties of custom conversions by editing () the given conversion object on its **General** tab. The objects representing custom conversions are very simple and do not require any advanced configuration. However, you need to assign the custom conversions to the appropriate user actions to ensure that the system logs them correctly. > **Info:** Ask your administrator to configure the logging of actions as custom conversions. See [Configuring logging of actions as custom conversions](https://docs.kentico.com/k10/on-line-marketing-features/configuring-and-customizing-your-on-line-marketing-features/configuring-web-analytics/configuring-logging-of-actions-as-custom-conversions.md) for more information. ## Viewing conversion statistics To view a report displaying the statistics of a particular conversion: 1. Open the **Conversions** application. 2. Switch to the **Conversions** tab. 3. **Edit** () a conversion. 4. Switch to the **Details** tab. If you wish to view only data logged during a particular time period, you can specify the dates in the **From** and **To** fields. The reports includes the following details: - **Conversions** – the number of conversion hits that were performed by visitors. - **Conversions value** – the total sum of the conversion values recorded by the custom conversion.