ADFOX Sites Help

Выгрузка логов из системы ADFOX

Описание отчета

EventLog - это отчет в формате TSV или XML (формат устарел, рекомендуем использовать выгрузку в TSV), который содержит в себе информацию по всем прошедшим событиям показа баннера или баннера по умолчанию: показ, клик, вызов событий.

Получение EventLog является дополнительным платным модулем, подключаемым по запросу на accounts@adfox.ru.

После подключения модуля вам будет предоставляет доступ к ftp серверу для получения отчета. Срок хранения отчетов - 62 дня.

EventLog выгружается на ftp сервер ADFOX в архивированном виде с периодичностью 1 раз в час (в начале часа, следующего за отчетным).

Список основных полей для выгрузки в формате TSV

Поле Значения Расшифровка значений
view 0 | 1 Показ.
click 0 | 1 Клик.
load 0 | 1 Загрузка баннера.
event_id Идентификатор события.
ignore Флаг игнорирования записи для учета в статистике:
0 запись не игнорируется
1 запись игнорируется и не учитывается в отчетах
2 запись о клике игнорируется и не учитывается в отчетах
3 запись о событии игнорируется и не учитывается в отчетах
4 запись игнорируется и не учитывается в отчетах
uts Время запроса к системе.
ip Ip адрес клиента, пославшего запрос (устарело, см ipv4/ipv6).
ipv4/ipv6 Ip адрес клиента, пославшего запрос.
referrer Адрес страницы, с которой пришел запрос.
useragent Текстовая строка, являющаяся частью HTTP запроса, и обычно включающая такую информацию, как название и версию приложения, операционную систему компьютера и язык.
ya_geo_id Идентификатор региона.
owner_id Идентификатор аккаунта.
site_id Идентификатор сайта.
section_id Идентификатор раздела сайта.
place_id Идентификатор площадки.
supercampaign_id Идентификатор суперкампании.
campaign_id Идентификатор кампании/флайта.
banner_id Идентификатор баннера.
banner_template_id Идентификатор шаблона баннера.
bannertype_id Идентификатор типа баннера.
advertiser_id Идентификатор рекламодателя.
placecategory_id Идентификатор категории, присвоенной площадке.
adnetwork_id Идентификатор рекламной сети. Для продукта ADFOX.Nets.
sector_id Идентификатор отрасли, присвоенной рекламной кампании.
external.key Ключи параметров для сбора дополнительной статистики. Ключи заключены в одинарные кавычки и разделены запятой.
external.value Значения параметров для сбора дополнительной статистики. Значения заключены в одинарные кавычки и разделены запятой.
ocN Параметры пользовательского таргетинга, где N - номер характеристики от 1 до 5.
Параметры таргетинга с 6 по 63 относятся к дополнительным полям для выгрузки.
Если в аккаунте используется Характеристика №1, то в EventLog запись для этой характеристики попадет в поле oc1.
В логе отражены все значения, переданные к puid в виде массива. Разделитель значений - запятая.
Как получить список характеристик дополнительного таргетирования и их значений
0 неизвестное - в параметре puidN было передано значение, которого нет в справочнике;
M где M - ID значения, переданного в параметре puidN и присутствующее в справочнике данной характеристики (...puid2=man&...).
flag_virtual Признак типа рекламной кампании:
0 коммерческая рекламная кампания
1 промерочная рекламная кампания



Список дополнительных полей для выгрузки в формате TSV

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

Поле Значения Расшифровка значений
adf_os_id Идентификатор операционной системы.
adf_browser_id Идентификатор браузера.
adf_manufacturer_id Идентификатор производителя мобильного устройства.
adf_opsos_id Идентификатор оператора сотовой связи (устарело, см adf_cellular_id).
adf_cellular_id Идентификатор оператора сотовой связи по данным Яндекса.
ya_device_type Тип устройства:
0 неизвестное
1 компьютер
2 смартфон
3 планшет
4 телефон
5 смарт-тв
dimension_width Ширина экрана.
dimension_height Высота экрана.
tp_id Идентификатор точки учета действия.
tp_timestamp Время, когда пользователь контактировал с рекламой — для точек учета действия.
campaign_kind_id Числовое значение типа рекламной кампаниии.
adf_uid Идентификатор пользователя.
ocN Параметры пользовательского таргетинга, где N - номер характеристики от 6 до 63.
Параметры таргетинга с 1 по 5 относятся к основным полям для выгрузки.

Если в аккаунте используется Характеристика №6, то в EventLog запись для этой характеристики попадет в поле oc6.
В логе отражены все значения, переданные к puid в виде массива. Разделитель значений - запятая.
Как получить список характеристик дополнительного таргетирования и их значений
0 неизвестное - в параметре puidN было передано значение, которого нет в справочнике;
M где M - ID значения, переданного в параметре puidN и присутствующее в справочнике данной характеристики (...puid7=man&...).



Список полей для выгрузки в формате XML (устаревший формат)

  • Если у поля значение 0 или пусто, то в EventLog такое поле будет отсутствовать;
  • Все записи, в которых есть поле ignore со значением, не равным 0, нужно игнорировать. В статистику такие записи не попадают;

Служебное поле - такие поля содержат информацию, необходимую для построения расширенной отчетности в ADFOX.

Поле Значения Расшифровка значений
record запись о запросе к системе
recordtype тип события
1 показ (если методика подсчёта показов - по событию).
2 клик
13 загрузка кода баннера
14 событие
15 "загрузка и показ": если методика подсчёта показов - по загрузке кода.
"Показ (загрузка) по умолчанию": если в записи отсутствует bannerid.
17 точка учёта действия
cookieid id пользователя (устарело, см. поле lpdid)
   engineid id сегмента
   id id пользователя в сегменте
manufacturerid марка производителя мобильного телефона. Как получить справочник производителей
ip ip адрес клиента, пославшего запрос
flags служебное поле
value id="0" 1 кампания имеет тип "стандартная"
value id="1" 1 признак рекламной сети
value id="2" 1 включена отчетность по уникальным пользователям на уровне сайтов
value id="3" 1 промерочная рекламная кампания
value id="4" 1 разовое размещение баннера
value id="11" 1 включена отчетность по уникальным пользователям на уровне баннеров
value id="12" 1 ssp аукцион прошел по прямому договору
value id="20" 1
value id="21" 1 загрузка точки учета действий - postView
value id="22" 1 загрузка точки учета действий - postClick
value id="23" 1 загрузка точки учета действий
value id="24" 1 вызов события
timestamp Время запроса к системе
uts время в UTS формате
nsec нано-секунда
ownerid id аккаунта
siteid id сайта. Как получить список сайтов
sectionid id раздела сайта. Как получить список разделов
placeid id площадки. Как получить список площадок
supercampaignid id суперкампании
campaignid id кампании или id флайта (если используется иерархия кампания-флайт-баннер)
bannerid id баннера
bannertypeid id типа баннера. Как получить список типов баннеров
countryid id страны. Как получить географический справочник
stateid id региона. Как получить географический справочник
cityid id города. Как получить географический справочник
advertiserid id рекламодателя. Как получить список рекламодателей
userid пользовательский идентификатор точки учета действия или номер события
browserid id браузера. Как получить справочник браузеров
osid id операционной системы. Как получить справочник операционных систем
utscategoryid id категории, присвоенной точке учета действия. Как получить список категорий
placecategoryid id категории, присвоенной площадке. Как получить список категорий
dimensionwidth ширина экрана
dimensionheight высота экрана
lpdid id пользователя
segmentid id сегмента
id id пользователя в сегменте
referrer адрес страницы, с которой пришел запрос
useragent useragent
ignore флаг игнорирования записи
0 запись не игнорируется
1 запись игнорируется и не учитывается в отчетах
2 запись о клике игнорируется и не учитывается в отчетах
3 запись о событии игнорируется и не учитывается в отчетах
4 запись игнорируется и не учитывается в отчетах
uservalues параметры пользовательского таргетинга (если в аккаунте используется Характеристика №1, то в EventLog запись для этой характеристики попадет в поле value id="0"). Как получить список характеристик дополнительного таргетирования и их значений
value id="0" 4294967295 в параметре puid1 было передано пустое значением, или параметр не передавался вообще (...puid1=&...), т.е. не задано.
value id="1" 141137 в параметре puid2 было передано значение, присутствующее в справочнике характеристики. В логе запишется id этого значения (...puid2=man&...)
value id="2" 0 в параметре puid3 было передано значение, которого нет в справочнике, т.е. неизвестное.
value id="N" N-число от 0 до 62.
external параметры для сбора дополнительной статистики
value id="1" значение параметра eid1
value id="2" значение параметра eid2
tptimestamp время, когда пользователь контактировал с рекламой (для точек учета действия)
opsosid id оператора сотовой сети. Как получить справочник
sectorid id отрасли. Как получить справочник по отраслям
targetings служебное поле
value id="N" 1 блок с информацией о номере таргетинга (N), который был использован при показе кампании
pr служебное поле: число, которое было передано в запросе к системе в параметре pr
bannertemplateid id шаблона баннера
yadevicetype Тип устройства:
0 неизвестное
1 компьютер
2 смартфон
3 планшет
4 телефон
5 смарт-тв
yageoid id объекта по принадлежности к определенной географии



Пример отчета в формате XML

<?xml version="1.0">
    <record>  
        <recordtype>13</recordtype>
        <ip>130.193.68.242</ip>
        <flags>
            <value id="0">1</value>
            <value id="6">1</value>
            <value id="11">1</value>
        </flags>
        <timestamp>
            <uts>1403164817</uts>
            <nsec>898712292</nsec>
        </timestamp>
        <ownerid>226279</ownerid>
        <siteid>30706</siteid>
        <sectionid>62243</sectionid>
        <placeid>698488</placeid>
        <supercampaignid>27106</supercampaignid>
        <campaignid>364065</campaignid> 
        <bannerid>989858</bannerid>
        <bannertypeid>86755</bannertypeid>
        <countryid>1764410409</countryid>
        <stateid>54319288</stateid>
        <advertiserid>226312</advertiserid>
        <browserid>66</browserid>
        <osid>30</osid>
        <lpdid><segmentid>18</segmentid><id>14624325</id></lpdid>
        <referrer>http://Keyboard_site.ru/Main page/main?r=</referrer>
        <useragent>Mozilla/5.0 (Windows NT 6.1; rv:11.0) Gwcko/20100101 Firefox/11.0</useragent>
        <uservalues>
            <value id="1">4294967295</value>
            <value id="5">140350</value>
            <value id="6">4294967295</value>
            <value id="7">0</value>
        </uservalues>
        <external>
            <value id="1">497605001402923131852000000007607572</value>
            <value id="2">22</value>
        </external>
        <pr>547431</pr>
        <bannertemplateid>9441</bannertemplateid>
    </record>

Получение справочников по API ADFOX

1. Получение справочника по производителям

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=utility&actionObject=manufacturer

2. Список id сайтов

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=list&actionObject=website

3. Список id разделов

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=list&actionObject=zone

или с фильтром по id сайта:

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=list&actionObject=zone&actionObjectID2=[id сайта]

4. Список id площадок

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=list&actionObject=place

или с фильтром по id сайта:

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=list&actionObject=place&actionObjectID2=[id сайта]

5. Список типов баннеров

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=list&actionObject=bannerType

6. Получение справочника по географии (id страны или региона, наименование страны или региона)

 https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=utility&actionObject=geoTree

7. Список рекламодателей

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=list&actionObject=advertiser

8. Список id браузеров

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=utility&actionObject=browser

9. Список id операционных систем

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=utility&actionObject=os

11. Список временных категорий

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=list&actionObject=category&type=1

11. Список постоянных категорий

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=list&actionObject=category&type=0

12. Список характеристик дополнительного таргетирования и их значений

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=userCriteria&action=listValues

13. Список id операторов сотовой сети

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=utility&actionObject=opsosid

14. Список отраслей

https://login.adfox.ru/API.php?loginAccount=[логин]&loginPassword=[sha256 от пароля]&object=account&action=utility&actionObject=sector