Загрузка расходов как 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.