{"id":2754,"date":"2025-01-15T12:20:10","date_gmt":"2025-01-15T09:20:10","guid":{"rendered":"https:\/\/help.testbh.ru\/?p=2754"},"modified":"2026-03-24T11:51:05","modified_gmt":"2026-03-24T08:51:05","slug":"peredacha-oflajn-konversii-v-yandeks-metriku","status":"publish","type":"post","link":"https:\/\/help.bothelp.io\/en\/peredacha-oflajn-konversii-v-yandeks-metriku\/","title":{"rendered":"Sending offline conversions to Yandex Metrika"},"content":{"rendered":"

Offline conversions are customer actions that occur in environments that are not available for automatic tracking by Yandex, such as messengers or some browsers.<\/p>\n

Transferring offline conversions from BotHelp flows to Yandex Metrika helps you improve your ad performance and increase your return on investment thanks to accurate optimization in Yandex Direct.<\/p>\n

Setting up a mechanism for manually and automatically transmitting an offline conversion to Yandex Metrika
\n<\/strong>
\n1. Creating a Yandex Metrika tag
\n<\/strong>
\n1. Log in to your Yandex Metrika account<\/a> and click “Add Tag”.
\n<\/p>\n

2. Enter the tag name, enter the address of any website, and accept the terms of the user agreement.
\nYou can add other settings at will.<\/p>\n

3. Click the “Create Tag” button.<\/p>\n

<\/p>\n

4. On the second step, click “Start using”.<\/p>\n

For further setup, you will need the tag number. You can find it in the list of available tags.<\/p>\n

<\/p>\n

2. Enabling the function of uploading offline conversions in Yandex MetriKa
\n<\/strong>
\n1. In the required tag, click “Settings” in the side menu.<\/p>\n

2. Select “Upload data”.<\/p>\n

<\/p>\n

3. Among the settings, find “Offline conversions” and click “Enable offline conversion tracking”.
\nUploading offline conversions will become available within 24 hours.<\/p>\n

3. Activation of collecting Yandex Client ID in the person’s card via the mini-landing page
\n<\/strong>
\n1. In the “Growth Tools” section, add a new mini-landing page.<\/p>\n

2. Add at least one button to the mini-landing page (Yandex Client ID collection is available for the “Facebook”, “Telegram”, “Viber”, and “Whatsapp” buttons).<\/p>\n

3. Activate the “Track subscription via analytics” setting.<\/p>\n

4. In the Yandex Metrics field enter the number of the tag created earlier.<\/p>\n

<\/p>\n

5. Fill in the other necessary settings for the mini-landing page and save it.<\/p>\n

After saving the mini-landing page, Yandex Client ID collection for landing page users will be activated. The Yandex Client ID system field with the filled-in value will appear in the card of each person who clicked the button on this mini-landing page.<\/p>\n

<\/p>\n

4. Creating a goal in Yandex Metrika
\n<\/strong>
\n1. Go to the tag in Yandex Metrika. Open the “Goals” tab.<\/p>\n

2. Click the “Add Goal” button.<\/p>\n

3. In the window that opens, enter the name of the goal, in the “Goal ID” field, select “matches” and enter an arbitrary value (for example, “order_confirmed”).<\/p>\n

<\/p>\n

4. Click “Add Goal”. For further setup, we’ll need the value of the goal ID.
\n<\/p>\n

Automatic transmission of offline – conversions to Yandex Metrika
\n<\/strong>
\nAutomatic transmission is available via the “Send event to Yandex Metrika” action via the flow constructor.
\nThis feature is available for Telegram, Facebook, Viber, and Whatsapp flows.<\/p>\n

For the conversion transfer function to work correctly, you need to prepare a tag and a goal in Yandex Metrika, and a Yandex authorization token.<\/p>\n

1. Getting an authorization token via registering a Yandex app
\n<\/strong> 
\nTo work with the API from the browser, you have to use the authorization token. To get the token:<\/p>\n

1. Create an app<\/a> and fill in the fields:<\/p>\n

– Name (you can enter a random one).<\/p>\n

– Service icon (optional).<\/p>\n

– Application platforms (select web services).<\/p>\n

– In the “redirect URI” field, enter https:\/\/oauth.yandex.ru\/verification_code.<\/p>\n

– In the “Data access” section, enter metrika:read<\/code> and metrika:write<\/code>.<\/p>\n

– In the “Contact Mail” section, enter your email address to receive notifications about changes in Yandex external authorization.<\/p>\n

<\/p>\n

 – Click “Create App”.<\/p>\n

2. On the page that opens, copy the value of the ClientID <\/strong>field. <\/p>\n

<\/p>\n

3. Add the copied ClientID to the link in this format https:\/\/oauth.yandex.ru\/authorize?response_type=token&client_id=<app id><\/code><\/p>\n

4. Follow the link and copy your authorization token on the page that opens. Save the token in your notes. You will need it to set up automatic transmission of offline conversions.
\n
\nImportant!<\/strong> Token lifetime is 1 year. After a year, you will have to follow the same link again and save the new authorization token for a year. If you enable other services for the app or add settings, it can significantly reduce the life of the authorization token (even up to 7 days).<\/p>\n

2. Setting up automatic transmission of offline conversions
\n<\/strong>
\n1. In the flow constructor (Telegram, Facebook, Viber, Whatsapp), add a new step of the “Action” type or open an existing one in the editing format.<\/p>\n

2. Click the “Add action” button and select the action “Send event data to Yandex Metrika”.<\/p>\n

3. Fill in the fields “Tag number” (Yandex Metrika tag number), “Token” (Yandex app authorization token), “Goal ID” (goal ID in Yandex Metrika has to match the one in the constructor).<\/p>\n

You can learn how to get the data to fill in in the article above.<\/p>\n

<\/p>\n

4. Save your changes in the step.<\/p>\n

The conversion file will be sent once an hour at XX:08 (e.g., at 13:08, 14:08, etc.) to Yandex Metrika. Each file sent will contain the conversions collected over the past hour. After sending the conversion file, the corresponding entry in the “Processing” status will appear at the bottom of the “Uploading data” page in the “Settings” section in Yandex Metrika.<\/p>\n

<\/p>\n

Upon successful upload, the status will be updated to”Completed”.<\/p>\n

In the “Conversions” section in Yandex Metrika, you will see data about added conversions.<\/p>\n

Important!<\/strong> The conversion time in the “Conversions” section will correspond to the time when the person visited the mini-landing page.<\/p>\n

<\/p>\n

Manual transmission of offline conversions to Yandex Metrika
\n<\/strong>
\nCreating a file for uploading an offline conversion to Yandex Metrika
\n<\/strong>
\nIn order for Yandex Metrika to process and accept conversions after uploading, the csv file has to be generated correctly. The file has to consist of three mandatory parameters for each transmitted conversion: ClientID (unique user ID), Target (goal ID in Yandex Metrika), and DateTime (conversion completion time).<\/p>\n

To create a csv file:<\/p>\n

1. Export the list of people from BotHelp “With all custom fields” and download the file.<\/p>\n

2. Open the file and filter the list by the Yandex Client ID column and leave the rows that have any value in this column, delete the rest. Change the column name to ClientID.<\/p>\n

3. Add the Target column. For each conversion, you have to fill in the goal ID. The goal ID can be found in the “Goals” section in Yandex Metrika.<\/p>\n

4. Add a DateTime column to fill in for each conversion. To fill it in, you can use the values of the “Date and Time” columns from the upload or fill in manually.<\/p>\n

As a result, you should get a similar spreadsheet.<\/a><\/p>\n

5. Upload the file to Yandex Metrika in “Settings” – “Uploading data” – “Offline – conversions”.
\n_________________________________<\/p>\n

If you haven’t found the answer to your question, contact us in the chat in your profile or email hello@bothelp.io<\/a> \ud83d\ude03<\/p>\n

Get 14 days of full functionality of BotHelp, a platform for creating broadcasting, autofunnels, and chatbots.<\/p>\n

Get 14 days for free<\/strong><\/a><\/p>\n\r\n\t\t\t

\r\n\r\n\t\t\t\t
\r\n\t\t\t\t\t
\r\n\t\t\t\t\t\t

\u0411\u044b\u043b\u0430 \u043b\u0438 \u0441\u0442\u0430\u0442\u044c\u044f \u043f\u043e\u043b\u0435\u0437\u043d\u0430?<\/h3>\r\n\t\t\t\t\t<\/div>\r\n\t\t\t\t\t
\r\n\t\t\t\t\t\t
\r\n\t\t\t\t\t\t\t\r\n\t\t\t
\r\n\t\t\t\t\r\n \r\n \r\n
\r\n\t\t\t\t\r\n \r\n \r\n
\r\n\t\t\t\t\t
\r\n\t\t\t\t\t\t