ADFOX Nets Help

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

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

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

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

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

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

Поля отчета

Список полей:

Если у поля значение 0 или пусто, то в EventLog такое поле будет отсутствовать.

Поле Значения Расшифровка значений
record запись о запросе к системе
recordtype тип события
1 показ
2 клик
13 загрузка кода баннера
14 событие
15 загрузка и показ
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="21" 1 загрузка точки учета действий - postView
value id="22" 1 загрузка точки учета действий - postClick
value id="23" 1 загрузка точки учета действий
timestamp Время запроса к системе
uts время в UTS формате
nsec нано-секунда
ownerid id аккаунта
siteid id сайта. Как получить список сайтов
sectionid id раздела сайта. Как получить список разделов
placeid id площадки. Как получить список площадок
supercampaignid id суперкампании
campaignid id кампании или id флайта (если используется иерархия кампания-флайт-баннер)
bannerid id баннера
bannertypeid id типа баннера. Как получить список типов баннеров
adnetworkid id рекламной сети (для аккаунтов, использующих продукт ADFOX Nets)
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 запись игнорируется и не учитывается в отчетах
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 шаблона баннера

Пример отчета

<?xml version="1.0">
    <record>  
        <recordtype>13</recordtype>
        <cookieid>
            <engineid>18</engineid>
            <id>14624325</id>
        </cookieid>
        <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

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