Кампании в системе Call-tracking.by имеют различные настройки: отслеживаемые сайты, активные номера, подмена номера только для мобильных, и т.д. Получить информацию об активных кампаниях пользователя можно следующим образом:

URL: GET /api/v3/stats/get_campaigns_info.json

Обязательные параметры:

  • agent_token - Персональный ключ агента.
  • user_uuid - Уникальный идентификатор пользователя.
  • start_date - Дата начала запрашиваемого периода. Формат день-месяц-год. Пример: '01-07-2015'.
  • end_date - Дата окончания запрашиваемого периода. Формат день-месяц-год. Пример: '31-07-2015'.

Необязательные параметры:

  • adv_group_ids - Если указан, то будет предоставлена только информация о кампаниях указанных групп. Формат - строка (идентификаторы групп через запятую).
  • adv_campaign_ids - Если указан, то будет предоставлена только информация о кампаниях указанных идентификаторов. Формат - строка (идентификаторы кампании через запятую).

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

/api/v3/stats/get_campaigns_info.json?agent_token=IQnFQDNe6TVsWpP0hvmxpQ&user_uuid=9b2d8c12-3ce8-4291-a470-4fc0c2d2e0bf &start_date=01-07-2015&end_date=03-07-2015&adv_group_ids=1,2,3

    
      var group_ids = [1,2,3];
      requestUrl = '/api/v3/stats/get_campaigns_info.json?agent_token=IQnFQDNe6TVsWpP0hvmxpQ&user_uuid=9b2d8c12-3ce8-4291-a470-4fc0c2d2e0bf
      &start_date=01-07-2015&end_date=03-07-2015&adv_group_ids=' + group_ids.join(',')
      $.get(requestUrl, function (data) {
        $('.response-example').removeClass('loading-data');
        $('.response-example').html(JSON.stringify(data, null, 4))
      })
    
 

Пример ответа:

Параметры ответа:

  • id - идентификатор кампании.
  • name - имя кампании.
  • start_date - дата начала кампании.
  • end_date - дата окончания кампании.
  • site_urls - сайты, на которые распространяется действия кампании (например, у клиента 2 сайта и на каждом из них настроена кампания Яндекс, но отслеживание должно вестись раздельно).
  • page_regexp - страницы сайта, на которые настроена кампания.
  • adv_campaign_group_id - идентификатор группы, к которой принадлежит кампания.
  • dynamic - настроена ли кампания динамической (обратитесь к менеджеру за разъяснением).
  • online - настроена ли кампания онлайн (обратитесь к менеджеру за разъяснением).
  • mobile - настроена ли кампания только для мобильных устройств (обратитесь к менеджеру за разъяснением).
  • phones - телефонные номера, которые используются в кампании.
  • status - текущий статус кампании (может быть подтвержденным и неподтвержденным).

Возможное практическое применение:

Для создания информационной страницы с настройками кампании. Например следующего вида: