Документация
Справочник разработчика
API управления
Управление клиентами Директа
API отчетов v1
Группировки
Клики
Параметры посетителей

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

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

Данные передаются как multipart/form-data, в формате CSV, в первой строке необходимо передать названия колонок.

Обязательные колонки:

  • UserId — идентификатор посетителя сайта, назначенный владельцем сайта (только для client_id_type = USER_ID).
  • ClientId — идентификатор посетителя сайта, назначенный Яндекс.Метрикой (только для client_id_type = CLIENT_ID).
  • DateTime — дата и время конверсии в формате unix timestamp.

Необязательные колонки:

  • StaticCall — является ли звонок статическим (1 — статический, 0 — динамический).
  • Price — цена цели, десятичным разделителем является точка (.).
  • Currency — валюта в трехбуквенном формате ISO 4217.
  • PhoneNumber — номер телефона без пробелов (с указанием кода страны и города). Например, +79451234567.
  • TalkDuration — длительность звонка в секундах.
  • HoldDuration — длительность ожидания звонка в секундах.
  • CallMissed — пропущен ли звонок (1 — пропущенный, 0 — отвеченный).
  • Tag — произвольная метка. Может использоваться для отметки качества звонка или его итоге и т. д. Например, «клиента не устроила цена».
  • FirstTimeCaller — первичность (1 — первичный звонок, 0 — вторичный звонок).
  • URL — URL, с которого был звонок (ассоциированная с событием страница). Например, это может быть лэндинг для рекламной кампании, на котором указан номер телефона (PhoneNumber).
  • CallTrackerURL — URL перехода в интерфейс колл-трекера.

Краткое содержание

Синтаксис запроса

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

POST https://api-metrika.yandex.ru/management/v1/counter/{counterId}/offline_conversions/upload_calls ? 
client_id_type
[no-highlight[Тип идентификаторов посетителей.

Допустимые значения:

  • CLIENT_ID — идентификатор посетителя сайта, назначенный Яндекс.Метрикой.
  • USER_ID — идентификатор посетителя сайта, назначенный владельцем сайта.
]no-highlight]
=<offline_conversion_uploading_client_id_type> & [comment
[no-highlight[Комментарий.]no-highlight]
=<string>] & [new_goal_name
[no-highlight[Название новой цели для звонков в случае, если такой цели не существует. Если цель существует, этот параметр игнорируется.]no-highlight]
=<string>]
client_id_type
 Тип идентификаторов посетителей.

Допустимые значения:

  • CLIENT_ID — идентификатор посетителя сайта, назначенный Яндекс.Метрикой.
  • USER_ID — идентификатор посетителя сайта, назначенный владельцем сайта.
commentКомментарий.
new_goal_name
 Название новой цели для звонков в случае, если такой цели не существует. Если цель существует, этот параметр игнорируется.

В теле запроса


POST http://api-metrika.yandex.ru/management/v1/counter/{counterId}/offline_conversions/upload_calls
Content-Type: multipart/form-data; boundary=------------------------7zDUQOAIAE9hEWoV
Context-Length: 643

--------------------------7zDUQOAIAE9hEWoV
Content-Disposition: form-data; name="file"; filename="data.csv"
Content-Type: text/csv

ClientId,DateTime,Price,Currency,PhoneNumber,TalkDuration,HoldDuration,CallMissed,Tag,FirstTimeCaller,URL,CallTrackerURL
133591247640966458,1481714026,678.90,RUB,+71234567890,136,17,0,,1,https://test.com/,https://test.com/
579124169844706072,1481718066,123.45,RUB,+70987654321,17,23,0,,2,https://test.com/,https://test.com/
148059425477661429,1481718126,678.90,RUB,+71234509876,72,11,0,,0,https://test.com/,https://test.com/
--------------------------7zDUQOAIAE9hEWoV--

Пример запроса

POST https://api-metrika.yandex.ru/management/v1/counter/{counterId}/offline_conversions/upload_calls?client_id_type=USER_ID

Формат ответа


{
    "uploading
[no-highlight[

Описание

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

]no-highlight]
" : < uploading > }
ПараметрыОписание
uploading Информация о загрузке офлайн-конверсий.