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>]
|
Получить список только из одного объекта с указанным ID. Если используется этот параметр, остальные необязательные параметры игнорируются. |
|
ID рекламодателя. Читайте также: |
|
ID категории, к которой будет размечена аудитория, контактирующая с точкой учета действия. Допустимые значения:
Значение по умолчанию: |
|
ID типа шаблона. Подробнее о типах шаблонов читайте в статье Шаблоны referer. Допустимые значения:
Значение по умолчанию: |
|
Идентификатор. |
|
Шаблон URL для сравнения с адресом страницы сайта, полученным из запроса. Если адрес не подходит под шаблон URL, загрузка точки не будет засчитана. Пример записи:
Может содержать русские и латинские буквы, цифры и любые символы. |
|
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>
Параметры ответа
|
Статус обработки запроса. Значение |
|
Количество элементов в дереве ответа. |
|
Порядковый номер элемента в дереве ответа, где N — число от 0 до rows-1 (где rows — общее количество элементов в ответе). |
|
Уникальный идентификатор точки учета действия. |
|
ID рекламодателя. |
|
Идентификатор. |
|
Название точки учета. |
|
Вес точки учета. |
|
ID категории. |
|
ID типа шаблона. Возможные значения:
|
|
Шаблон URL для сравнения с адресом страницы сайта, полученным из запроса. Если адрес не подходит под шаблон URL, загрузка точки не будет засчитана. |
|
Показания счетчика PostView за все время. |
|
Показания счетчика PostView за сегодня. |
|
Показания счетчика PostClick за все время. |
|
Показания счетчика PostClick за сегодня. |
|
Дата добавления. |
Пример запроса и ответа
Запрос:
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
ID типа шаблона. Подробнее о типах шаблонов читайте в статье Шаблоны referer.
Допустимые значения:
-
0
— стандартный; -
1
— POSIX.2.
Значение по умолчанию: 0
.
Идентификатор.
Шаблон URL для сравнения с адресом страницы сайта, полученным из запроса. Если адрес не подходит под шаблон URL, загрузка точки не будет засчитана.
Пример записи:
-
для стандартного типа шаблонов:
⃰site.ru/index.php
-
Для POSIX.2:
homer-simpson-tv\.blog4ever\.com|forum\.rojadirecta\.org|^hidan\.eklablog\.com.٭|^aniworld\.spb\.ru\/.٭\/adfox\/.٭s$
Может содержать русские и латинские буквы, цифры и любые символы.
ID кампании.
Читайте также:
Обязательный параметр