WWW.INFO.Z-PDF.RU
БИБЛИОТЕКА  БЕСПЛАТНЫХ  МАТЕРИАЛОВ - Интернет документы
 

«1.0 Описание RestAPI (Verson1.0) 19/09/2013 1.1 Расширенный фильтр 22/05/2014 1.2 Карта посещений 20/07/2014 НАЗНАЧЕНИЕ API Statistics ...»

История документа

Версия Заголовок Дата

1.0 Описание RestAPI (Verson1.0) 19/09/2013

1.1 Расширенный фильтр 22/05/2014

1.2 Карта посещений 20/07/2014

НАЗНАЧЕНИЕ API

Statistics Report API (далее просто API) предназначен для получения данных о звонках клиентам CallTouch.

Данный API позволяет получить данные, которые могут быть проанализированы другими системами, и на основе которых клиенты сервиса могут сделать свои выводы и прогнозы, интегрировать данные в CRM, или другие сервисы.

ТЕРМИНЫ

API – Интерфейс для внешних программных продуктов

Статический сервис – call tracking сервис, работающий по принципу ИСТОЧНИК – НОМЕР, за одним источником привязывается один номер, который отображается посетителю.

Динамический сервис – call tracking сервис, работающий с динамическим проставлением номеров для пользовательских сессий

JSON – Открытый стандарт форматирования данных, используется для клиент – сервер транзакций

ФОРМАТ ЗАПРОСОВ

ДАННЫЕ О ЗВОНКАХ ПО ИСТОЧНИКАМ.

URL: http://api.calltouch.ru/calls-service/RestAPI/[id сайта]/calls-diary /calls?clientApiId=[Ваш ApiId]

Допустимые типы запроса: GET

Параметры:

Имя параметра Обязателен? Описание

clientApiIdДА Уникальный идентификатор, ключ для отправки запроса в CallTouch, выдается по запросу для каждого партнера. Обращаться за значением необходимо по заявке из личного кабинета.

dateFromНЕТ Дата начала просмотра. Формат: (dd/mm/yyyy).

dateToНЕТ Дата конца просмотра. Формат: (dd/mm/yyyy).

clientIdНЕТ clientId – уникальный идентификатор universal analytics.

Допустимо вводить несколько значений разделенные знаком «,».

Пример:...&clientId=123,124,125&…

source.value

source.filterModeНЕТ Значение источника.

Режим просмотра.

medium.value

medium.filterModeНЕТ Значение средства.

Режим просмотра.

utmSource.valueutmSource.filterModeНЕТ Значение метки utm_source.

Режим просмотра.

utmMedium.valueutmMedium.filterModeНЕТ Значение метки utm_medium.

Режим просмотра.

utmTerm.valueutmTerm.filterModeНЕТ Значение метки utm_term.

Режим просмотра.

utmContent.valueutmContent.filterModeНЕТ Значение метки utm_content.

Режим просмотра.

utmCampaign.valueutmCampaign.filterModeНЕТ Значение метки utm_campaign.

Режим просмотра.

keyword.valuekeyword.filterModeНЕТ Значение ключевого слова.

Режим просмотра.

ani.valueani.filterModeНЕТ Телефонный номер звонящегоphoneNumber.valuephoneNumber.filterModeНЕТ Виртуальный подменный номер

uniqueOnlyНЕТ Флаг уникальности звонков («true» - только первичные, «false» - только вторичные)

callIdНЕТ Список уникальных идентификаторов звонка в системе calltouch.

Допустимо вводить несколько значений разделенные знаком «,».

Пример: …&callId=123,124,125&…

withMapVisitsНЕТ Флаг карты посещений («true» - включить в ответ карту посещений, «false» или отсутствие параметра – не включать)

Режим просмотра – Позволяет ограничивать выборку данных статистики по вхождению параметра value в фильтруемое значение.

Допустимые режимы просмотра:

startwith – начинается с;

contains – содержит;

exact – полное соответствие.

ОТВЕТ: JSONMapObjectПример 1.

запрос:

http://api.calltouch.ru/calls-service/RestAPI/xxx/calls-diary/calls?clientApiId= xxxxxxxxxxxxxxxxxxxxx&source.value=yandex&callid=158580

ответ:

[{"callerNumber":"xxxxxxxxxx","utmContent":"","utmTerm":"","keyword":"колтач","utmCampaign":"","date":"28/08/2013 17:06:31","callId":158580,"medium":"organic","url":"http://www.calltouch.ru/","city":null,"ref":"http://yandex.ru/clck/jsredir?from=yandex.ru;yandsearch;web;;&text=колтач&state=XXX","duration":77,"phoneNumber":"xxxxxxxxxxxxx","source":"yandex organic","utmMedium":"organic","utmSource":""}

Пример 2.

запрос:

http://api.calltouch.ru/calls-service/RestAPI/xxx/calls-diary/calls?clientApiId= xxxxxxxxxxxxxxxxxxxxx&source.value=and&source.filterMode=Contains&uniqueOnly=true

ответ:

[{"callerNumber":"xxxxxxxxxx","utmContent":"","utmTerm":"","keyword":"колтач","utmCampaign":"","date":"15/05/2013 12:29:16","callId":57381,"medium":"organic","url":"http://www.calltouch.ru/","city":null,"ref":"http://yandex.ru/yandsearch?text=колтач&lr=213&redircnt=1368606231.1","duration":118,"phoneNumber":"xxxxxxxxxxxxx","source":"yandex organic","utmMedium":"organic","utmSource":""},…

Выходные параметры:

Имя параметра Описание

callIdУникальный идентификатор звонка в системе CallTouch.

callerNumberНомер звонившего.

date Дата звонка.

duration Длительность разговора.

phoneNumberНомер, на который звонили.

source Источник.

medium Тип источника.

keyword Ключевое слово.

city Город.

urlАдрес, по которому попали на сайт.

ref Адрес, с которого перешли на сайт.

utmSourceЗначение метки utm_source.

utmMediumЗначение метки utm_medium.

utmCampaignЗначение метки utm_campaign.

utmContentЗначение метки utm_content.

utmTermЗначение метки utm_term.

clientIdПараметр присутствует в случае, если настроена интеграция системы CallTouch с Universal Analytics.

callClientUniqueIdПараметр присутствует, если настроена интеграция системы CallTouch с Asterisk.

mapVisitsПараметр присутствует в случае, если включен флаг withMapVisits. Содержит список объектов:

-sessionDate-ip-city

-source

-medium

-keyword

-url-ref

-utmMedium-utmSource-utmTerm-utmContent-utmCampaign-guaClientId (если есть интеграция с Universal Analytics)

Похожие работы:

«Урок 7. "Песнь о Роланде" – вершина французского эпоса. Цели: дать представление о средневековом французском военном эпосе; раскрыть особенности, образы героев (систему образов), композицию, художественное мастерство автора; помочь учащимся понять основы историко-литературного анализа, описать историч...»

«Внеклассное мероприятие по истории Колесо историиЦели: обобщить и закрепить в форме игры знания учащихся исторических событий; воспитывать у старшеклассников чувства патриотизма, гордости за героическое прошлое нашей Родины; развивать творческие способности через разные виды внеурочной деятельности. По организации и пор...»

«1.Планируемые результаты освоения учебного предмета, курса. Программа обеспечивает достижение первоклассниками личностных, метапредметных и предметных результатов. Личностные результаты1. Формирование чувства гордости за свою Родину, российский народ и историю России; о...»

«Муниципальное бюджетное общеобразовательное учреждение "Средняя общеобразовательная школа №73" города Кирова "УТВЕРЖДЕНО" Директор МБОУ СОШ № 73 г. Кирова _/Быстрова Р.В./ Приказ №. от.08.2015 "Согласовано" Заместитель директора по УВР _/Сунцова Н.А./ " "августа 2015г. "Рассмотрено" Руководитель ШМО Перевозчикова Н.В. _ /...»

«МИНИСТЕРСТВО ОБРАЗОВАНИЯ И НАУКИРОССИЙСКОЙ ФЕДЕРАЦИИ Федеральное государственное автономное образовательное учреждение высшего образования"ТЮМЕНСКИЙ ГОСУДАРСТВЕННЫЙ УНИВЕРСИТЕТ" Ишимский педагогический институт им. П.П. Ершова (филиал) Тюменского государственн...»

«Международный фестиваль-конкурс детского и юношеского творчества "ОВАЦИЯ"Организаторы: Творческое объединение "Мир фестивалей". Молодежная общественная организация "Европейская молодёжная лига"; Цели и задачи конкурса. Международный фестиваль конкурс творческих коллективов "Овация" организуется и проводится с целью выявления н...»

«Содержание работы: Введение Глава 1. Английские фамилии и их лексическое значение.1.1 Происхождение английских фамилий1.2 Основные лексические группы фамилий Глава 2. Сопоставление английских и русских фамилий2.1 Анализ английских фамилий2.2 Анализ русских фамилий Выводы2.3 Анализ происхождения фамилий одноклассников Глава 3 Интересные факт...»

«Тема: Кризис империи и русско-японская война.Цели:1) ознакомить учащихся с причинами, ходом и результатами русско – японской войны; выявить причины и основные события (1905 г.) революции 1905...»

«Урок истории в 10 классе ТЕМА: ЖИВОПИСЬ к. XIX н. XX вв. Цель: дать понятие о передвижных выставках русских художников редины XIX века; познакомить с биографическими данными Репина и В. Перова; обратить внимание учащихся, как картины, написанные художник...»

















 
2018 www.info.z-pdf.ru - «Библиотека бесплатных материалов - интернет документы»

Материалы этого сайта размещены для ознакомления, все права принадлежат их авторам.
Если Вы не согласны с тем, что Ваш материал размещён на этом сайте, пожалуйста, напишите нам, мы в течении 2-3 рабочих дней удалим его.