Transmitting data on offline conversions

Step 1. Preparing data

1. Prepare special identifiers: ClientID, UserID, or yclid.
2. Create a JavaScript event goal using the POST /management/v1/counter/{counterId}/goals method. For the goal ID, specify the event to be tracked (for example, for order confirmation: “order_confirmed”). You'll need this ID when creating a CSV file.

   You can use a previously created goal if a conversion for this goal happens both on and off the site and you want to get general statistics.

Step 2. Checking whether you can upload conversions to Yandex.Metrica.

Sessions tracked by Yandex.Metrica can be supplemented with information about conversions within 21 days. The conversion tracking period increases gradually once you enable the option. Therefore, you can transfer conversions for the number of days equal to the tracking period. You can upload conversions within about 24 hours of enabling the option.

To check whether you can upload data and for what period, use the GET /management/v1/counter/{counterId}/offline_conversions/visit_join_threshold method.

Step 3. Preparing the CSV file

Step 4. Transmitting data

Using the POST /management/v1/counter/{counterId}/offline_conversions/upload method. Specify the OAuth token, tag number, and user ID type in the input data.

$counter = "";            // Specify the tag number
$token = "";              // Specify the OAuth token
$client_id_type = "";     // Specify the user ID type: CLIENT_ID, USER_ID or YCLID

$curl = curl_init("https://api-metrika.yandex.ru/management/v1/counter/$counter/offline_conversions/upload?client_id_type=$client_id_type");

curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, array('file' => new CurlFile(realpath('file.csv'))));
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, array("Content-Type: multipart/form-data", "Authorization: OAuth $token"));

$result = curl_exec($curl);

echo $result;

curl_close($curl);

import requests

counter = 123456
token = "token"

file = open("offline-conversions.csv", "r").read()
id_type = "CLIENT_ID"

url = "https://api-metrika.yandex.net/management/v1/counter/{}/offline_conversions/upload?client_id_type={}".format(counter, id_type)
headers = {
	"Authorization": "OAuth {}".format(token)
}

req = requests.post(url, headers=headers, files={"file":file})

What's next?

Track the status of conversion uploads using the GET /management/v1/counter/{counterId}/offline_conversions/uploading/{id} method