tracingPoint

Получить список точек учета действия.

Формат запроса

Примечание

Доступна пагинация.

https://adfox.yandex.ru/api/v1
  ? object=account
  & action=list
  & actionObject=tracingPoint
  & [actionObjectID=<integer>]
  & [advertiserID=<integer>]
  & [categoryID=<integer>]
  & [templateTypeID=<integer>]
  & [userID=<integer>]
  & [referrer=<string>]
  & [campaignID=<integer>]

actionObjectID

Чтобы получить данные только по одному объекту, укажите его ID.

Если используется этот параметр, остальные необязательные параметры игнорируются.

advertiserID

ID рекламодателя.

Читайте также:

categoryID

ID категории, к которой будет размечена аудитория, контактирующая с точкой учета действия.

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

  • 0 — категория не задана;
  • N — где N — ID категории.

Значение по умолчанию: 0.

templateTypeID

Тип шаблонов страниц. Подробнее о типах шаблонов читайте в статье Шаблоны referer.

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

  • 0 — стандартный;
  • 1 — POSIX.2.

Значение по умолчанию: 0.

userID

Идентификатор.

referrer

Шаблон URL для сравнения с адресом страницы сайта, rjnjhsq получен из запроса. Если адрес не подходит под шаблон URL, загрузка точки не будет засчитана.

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

  • для стандартного типа шаблонов:

    ⃰site.ru/index.php
    
  • Для POSIX.2:

    homer-simpson-tv\.blog4ever\.com|forum\.rojadirecta\.org|^hidan\.eklablog\.com.٭|^aniworld\.spb\.ru\/.٭\/adfox\/.٭s$
    

Может содержать русские и латинские буквы, цифры и любые символы.

campaignID

ID кампании.

Читайте также:

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

<response>
  <status>
    <code>{integer}</code>
  </status>
  <data>
   <result>
    <row0>
     <objectID>{integer}</objectID>
     <advertiserID>{integer}</advertiserID>
     <userID>{integer}</userID>
     <objectName>{string}</objectName>
     <weight>{integer}</weight>
     <categoryID>{integer}</categoryID>
     <templateTypeID>{integer}</templateTypeID>
     <objectReferrer>{string}</objectReferrer>
     <objectDescription>{string}</objectDescription>
     <counterPostView>{integer}</counterPostView>
     <counterPostViewToday>{integer}</counterPostViewToday>
     <counterPostClick>{integer}</counterPostClick>
     <counterPostClickToday>{integer}</counterPostClickToday>
     <dateAdded>{date}</dateAdded>
    </row0>
</response>

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

code

Статус обработки запроса. Значение 0 — запрос выполнен успешно. Расшифровку смотрите в разделе Обработка ошибок.

rows

Количество элементов в дереве ответа.

rowN

Порядковый номер элемента в дереве ответа, где N — число от 0 до rows-1 (где rows — общее количество элементов в ответе).

objectID

ID точки учета действия.

advertiserID

ID рекламодателя.

userID

Пользовательский ID точки учета действия.

objectName

Название точки учета.

weight

Вес точки учета.

categoryID

ID категории.

templateTypeID

Тип шаблонов страниц. Подробнее о типах шаблонов читайте в статье Шаблоны referer.

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

  • 0 — стандартный;
  • 1 — POSIX.2.

objectReferrer

Шаблон URL для сравнения с адресом страницы сайта, полученным из запроса. Если адрес не подходит под шаблон URL, загрузка точки не будет засчитана.

counterPostView

Показания счетчика PostView за все время.

counterPostViewToday

Показания счетчика PostView за сегодня.

counterPostClick

Показания счетчика PostClick за все время.

counterPostClickToday

Показания счетчика PostClick за сегодня.

dateAdded

Дата добавления.

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

Запрос:

https://adfox.yandex.ru/api/v1?object=account&action=list&actionObject=tracingPoint

Ответ:

<response>
  <status>
    <code>0</code>
  </status>
  <data>
   <result>
    <row0>
     <objectID>8309</objectID>
     <advertiserID>226201</advertiserID>
     <userID>5</userID>
     <objectName>точка5</objectName>
     <weight>2</weight>
     <categoryID>11564</categoryID>
     <templateTypeID>0</templateTypeID>
     <objectReferrer/>
     <objectDescription/>
     <counterPostView>0</counterPostView>
     <counterPostViewToday>0</counterPostViewToday>
     <counterPostClick>0</counterPostClick>
     <counterPostClickToday>0</counterPostClickToday>
     <dateAdded>2021-07-15</dateAdded>
    </row0>
</response>

Другие действия с объектом

Читайте также о других действиях с объектом tracingPoint:

Чтобы получить данные только по одному объекту, укажите его ID.

Если используется этот параметр, остальные необязательные параметры игнорируются.

ID рекламодателя.

Читайте также:

ID категории, к которой будет размечена аудитория, контактирующая с точкой учета действия.

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

  • 0 — категория не задана;
  • N — где N — ID категории.

Значение по умолчанию: 0.

Тип шаблонов страниц. Подробнее о типах шаблонов читайте в статье Шаблоны referer.

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

  • 0 — стандартный;
  • 1 — POSIX.2.

Значение по умолчанию: 0.

Пользовательский ID точки учета действия.

Шаблон URL для сравнения с адресом страницы сайта, rjnjhsq получен из запроса. Если адрес не подходит под шаблон URL, загрузка точки не будет засчитана.

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

  • для стандартного типа шаблонов:

    ⃰site.ru/index.php
    
  • Для POSIX.2:

    homer-simpson-tv\.blog4ever\.com|forum\.rojadirecta\.org|^hidan\.eklablog\.com.٭|^aniworld\.spb\.ru\/.٭\/adfox\/.٭s$
    

Может содержать русские и латинские буквы, цифры и любые символы.

ID кампании.

Читайте также:

Предыдущая
Следующая