Загрузка информации о звонках

Выполняет загрузку информации о звонках.

Совет

Сформируйте CSV-файл с информацией и передайте его с помощью данного метода. Также рекомендуем генерировать запросы к API в автоматическом режиме с помощью модулей языка программирования.

О том, какие данные передавать, и пример запроса см. в разделе Передача данных о звонках.

Примечание

Обработка данных может занимать до двух часов после загрузки.

Request

POST

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

Path parameters

Name

Description

counterId

Type: integer

Идентификатор счетчика, для которого вы хотите загрузить информацию о звонках.

Query parameters

Name

Description

comment

Type: string

Комментарий.

Example: ``

new_goal_name

Type: string

Название новой цели для звонков в случае, если такой цели не существует. Если цель существует, этот параметр игнорируется.

Example: Звонок

Body

multipart/form-data

{
  "file": "example"
}

Name

Description

file

Type: string<binary>

Информация о звонках, которую вы хотите загрузить, передаваемая как multipart/form-data.

Example: example

Responses

200 OK

Body

application/json

{
  "uploading": {
    "id": 0,
    "create_time": "2025-01-01T00:00:00Z",
    "source_quantity": 0,
    "line_quantity": 0,
    "comment": "example",
    "type": "BASIC",
    "client_id_type": "USER_ID",
    "status": "example",
    "goal_not_found_quantity": 0,
    "user_not_found_quantity": 0,
    "static_calls_quantity": 0,
    "dynamic_calls_quantity": 0,
    "linked_quantity": 0
  }
}

Name

Description

uploading

Type: OfflineCallsUploading

Информация о загрузке звонков.

Example

{
  "id": 0,
  "create_time": "2025-01-01T00:00:00Z",
  "source_quantity": 0,
  "line_quantity": 0,
  "comment": "example",
  "type": "BASIC",
  "client_id_type": "USER_ID",
  "status": "example",
  "goal_not_found_quantity": 0,
  "user_not_found_quantity": 0,
  "static_calls_quantity": 0,
  "dynamic_calls_quantity": 0,
  "linked_quantity": 0
}

OfflineCallsUploading

Информация о загрузке звонков.

Name	Description
client_id_type	Type: string Тип идентификаторов посетителей. Возможные значения: `USER_ID` — идентификатор посетителя сайта, назначенный владельцем сайта. `CLIENT_ID` — идентификатор посетителя сайта, назначенный Яндекс Метрикой. `YCLID` — идентификатор клика по рекламному объявлению Яндекс Директа, назначенный Яндекс Директом. Example: `USER_ID`
comment	Type: string Произвольный комментарий. Количество символов не должно превышать 255. Min length: `0` Max length: `255` Example: `example`
create_time	Type: string<date-time> Время загрузки. Example: `2025-01-01T00:00:00Z`
dynamic_calls_quantity	Type: integer Количество динамических звонков.
id	Type: integer Идентификатор загрузки.
line_quantity	Type: integer Количество строк, прошедших валидацию при загрузке.
source_quantity	Type: integer Количество строк в исходном файле.
static_calls_quantity	Type: integer Количество статических звонков.
status	Type: string Статус загрузки: `PREPARED` — загрузка подготовлена. `UPLOADED` — загрузка завершена. `EXPORTED` — загрузка экспортирована. `MATCHED` — произведено сопоставление идентификаторов событий. `PROCESSED` — загрузка успешно обработана. `LINKAGE_FAILURE` — не удалось сопоставить ни один идентификатор посетителя. Если передана информация о статических звонках, они не будут привязаны к визитам в Метрике, но будут доступны в отчетах по звонкам. Example: `example`
type	Type: string Возможные значения: `BASIC` — тип по умолчанию; `CALLS` — звонки; `CHATS` — чаты. Example: `BASIC`

Example

{
  "id": 0,
  "create_time": "2025-01-01T00:00:00Z",
  "source_quantity": 0,
  "line_quantity": 0,
  "comment": "example",
  "type": "BASIC",
  "client_id_type": "USER_ID",
  "status": "example",
  "static_calls_quantity": 0,
  "dynamic_calls_quantity": 0
}

Была ли статья полезна?

Передача данных о звонках

Список загрузок информации о звонках