Uploading offline conversions

Tip

Create a CSV data file and send it using this method. We recommend that you also automate your API queries using modules available in your programming language.

For more information on what data to send and what a sample request looks like, see Passing offline conversions.

Note

It can take up to 2 hours to process the data.
The file size limit is 1 GB.
The file encoding is UTF-8.

Request

POST

https://api-metrika.yandex.net/management/v1/counter/{counterId}/offline_conversions/upload

Path parameters

Name

Description

counterId*

Type: integer<int32>

ID of the counter for which you want to upload offline conversions.
Example: 2215573

Query parameters

Name

Description

comment

Type: string

Comment. Maximum 255 characters. You can use digits, Latin characters, and Cyrillic characters.

Body

multipart/form-data

{
    "file": null
}

Name

Description

file*

Type: string<binary>

Offline conversions to upload, which are passed as multipart/form-data. The file size limit is 1 GB. The file encoding is UTF-8.

Responses

200 OK

Body

application/json

{
    "uploading": {
        "id": 0,
        "create_time": "2022-12-29T18:02:01Z",
        "source_quantity": 0,
        "line_quantity": 0,
        "comment": "string",
        "client_id_type": "USER_ID",
        "status": "string"
    }
}

Name

Description

uploading*

Type: OfflineConversionUploading

Information about an upload of offline conversions.

OfflineConversionUploading

Information about an upload of offline conversions.

Name	Description
client_id_type	Type: string Type of user IDs. Possible values: `user_id`: Site user ID assigned by the site owner. `client_id`: Site user ID assigned by Yandex Metrica. `YCLID`: The ID of a click on a Yandex Direct ad assigned by Yandex Direct. Example: `USER_ID`
comment	Type: string Custom comment. The maximum number of characters is 255. Min length: `0` Max length: `255`
create_time	Type: string<date-time> Upload time.
id	Type: integer<int64> Upload ID.
line_quantity	Type: integer<int32> Number of rows that passed validation during upload.
source_quantity	Type: integer<int32> Number of rows in the source file.
status	Type: string Upload status: `PREPARED`: Upload prepared. `UPLOADED`: Upload complete. `EXPORTED`: Upload exported. `MATCHED`: Event IDs matched. `PROCESSED`: Upload processed. `LINKAGE_FAILURE`: Couldn't find a matching user ID. If you send data on static calls, they won't be attributed to sessions in Yandex Metrica, but they will appear in your call reports.

Was the article helpful?

Passing offline conversions

List of uploads of offline conversions