Загрузка расходов как multipart/form-data
Выполняет загрузку расходов.
Важно
Данные Директа загружать не нужно — они передаются в Метрику автоматически. Если вы загрузите данные в файле, они будут дублироваться с переданными автоматически — отчет станет некорректным.
Данные передаются как multipart/form-data
в параметре file
, в формате CSV. В первой строке запроса необходимо передать названия колонок.
Обязательные колонки:
Date
— строка, дата в формате YYYY-MM-DD или диапазон дат в формате YYYY-MM-DD/YYYY-MM-DD.UTMSource
— строка, значение метки utm_source. Необязательна, если передаетсяTrafficSource
.TrafficSource
— источник трафика первого уровня. Доступные значения описаны в таблице.Expenses
— число, сумма расходов, десятичным разделителем является точка.
Необязательные колонки:
TrafficSourceDetail
— источник трафика второго уровня. Доступные значения описаны в таблице.UTMMedium
— строка, значение меткиutm_medium
.UTMCampaign
— строка, значение меткиutm_campaign
.UTMTerm
— строка, значение метки utm_term.UTMContent
— строка, значение метки utm_content.Currency
— строка, трехбуквенный код валюты по ISO 4217.Clicks
— число, количество кликов.
Примечание
Значения UTM-меток регистрозависимые. Это важно учесть при загрузке и удалении данных.
Request
POST
https://api-metrika.yandex.net/management/v1/counter/{counterId}/expense/upload
Path parameters
Name |
Description |
counterId* |
Type: integer<int32> Идентификатор счетчика, для которого вы хотите загрузить расходы. |
Query parameters
Name |
Description |
comment |
Type: string Комментарий. |
provider |
Type: string Сервис, который передает данные в Метрику (провайдер). Если не указано, используется значение |
Body
multipart/form-data
{
"file": null
}
Name |
Description |
file* |
Type: string<binary> |
Responses
200 OK
OK
Body
application/json
{
"uploading": {
"id": 0,
"create_time": "2022-12-29T18:02:01Z",
"source_quantity": 0,
"provider": "string",
"comment": "string",
"type": "string",
"status": "string"
}
}
Name |
Description |
uploading* |
Type: ExpenseUploading Информация о загрузке расходов. |
ExpenseUploading
Информация о загрузке расходов.
Name |
Description |
comment |
Type: string Комментарий. |
create_time |
Type: string<date-time> Время загрузки. |
id |
Type: integer<int64> Идентификатор загрузки. |
provider |
Type: string Имя провайдера данных. |
source_quantity |
Type: integer<int32> Количество строк в исходном файле. |
status |
Type: string Статус загрузки:
|
type |
Type: string Тип загрузки:
|
No longer supported, please use an alternative and newer version.