Latest revision as of 14:22, 10 August 2023

Важно:

во все запросы по Кадаму надо обязательно добавлять фильтр sub8 = 2, 13, иначе в выборку попадут данные и по транзиткам;
не забывайте при сравнении статы из Кадама и Kaminari проставлять одинаковые таймзоны.

Типы кликов

Боты

BV — bot visits. Под ботами имеется в виду программы или автоматизированные скрипты, которые запрашивают веб-контент (включая цифровую рекламу) без участия пользователя.

Название	Описание
Crawlers	Это легитимные боты, которые честно объявляют себя через user agent. Они ходят по страницам и собирают контент для различных технических целей. Например, это могут быть боты поисковых систем, индексирующие интернет; боты соц. сетей, кеширующие страницы для показа в превью, или делающие скриншоты; скрапперы, собирающие веб-страницы для каких-то своих целей и пр. То есть это не злонамеренные боты, которые однако не могут совершить конверсию и потому мы должны их игнорировать.
Spoofing	Это боты у которых информация, заявленная в user agent не соответствует реальной. В норме браузер не врёт о себе. Его заставляют врать злоумышленники, которые вынуждают заражённые браузеры ходить по ссылкам и представляться чужими user agent. Чаще всего тут речь идёт о заражённых компьютерах, являющихся частью ботнета.
Automated	Это специальные браузеры, которые управляются извне скриптами. Такие браузеры изначально были созданы для автоматизированного тестирования програмного обеспечения, но потом оказалось, что они отлично подходят для генерации фродового трафика. Это могут быть как связки виртуальных машин, на которые установлены Headless Chrome или Phantom JS, так и огромные клик-фермы, где реальные смартфоны без участия пользователя генерят клики.
iFrame	Для увеличения показов реклама располагается на сайте в маленьких или незаметных элементах (iframe).

Подозрительные клики

SV — suspicios visits. Мы видим в данных, собранных по клику что-то подозрительное, но этого не хватает чтобы со всей уверенностью утверждать, что это бот. Рекомендуется в каждом конкретном случае смотреть конверсии и решать отдельно.

Название	Описание
Proxy	Пользователи, изменяюшие своё местоположение с помощью IP-адреса (VPN, прокси, Tor). Это живые клики, они даже могут совершить конверсию, но они идут с нецелевых гео. Если для вашей рекламы важен гео, нужно обращать внимание на эту метрику.
Suspition of spoofing	У нас нет чёткой уверенности, что речь идёт о боте, но есть подозрение. Возможные причины — у пользователя установлено безобидное расширение, афектящее наши проверки; некоторые браузеры и приложения для Андроида имеют захардкоженный (вшитый, неизменный) user agent.
Suspition of automated	У нас тоже нет чёткой уверенности, что речь идёт о боте, но есть подозрение. Возможные причины — опять-таки некие безобидные расширения, которые заставляют наш подозревать, что браузер управляется извне.
Suspition of fraud	Есть подозрение, что реклама располагается на сайте за границами экрана.

Технические потери

Tech losses. Это клики, которые мы не смогли проверить. Возможные причины — браузеры с отключённым JS; устаревшие браузеры; клик по какой-то причине дошёл до Кадама, но не дошёл до Kaminari.

Хорошие клики

Это клики, которые мы проверили и на 100% уверены, что они не были совершены ботами. То есть это общее количество кликов минус технические потери минус ботовые клики минус подозрительные клики. Плюс мы уникализируем эти клики по clickID (удаляем дубли, потому что дубли — плохой признак). Формула: uniqIf(clickID, total - TL - BV - SV).

Уникализация кликов

Предполагается, что по кликовой ссылке можно зайти только один раз. Поэтому первый заход является уникальным, а последующие — дублями. Дубли — это либо технические артефакты (например, ссылка закешировалась в браузере), либо фрод (например, попытка скликивания) и нам не следует учитывать их в статистике.

Вся статистика считается только по уникальным кликам. Если нужно посмотреть что-то с учётом дублей, это можно сделать, выбрав во всплывающем окне Настройки пункт Учитывать дубли.

Traffic back reasons

Reason	Название по-русски	Название по-английски
0	нормальный клик	ok
20	двойной клик в рамках одного аукциона	double click per one auction
80	более трёх кликов от одного юзера, на одной площадке за 30 мин	more than three clicks from one user on one macros in 30 minutes
90	user agent заблокирован	user agent is blocked
120	ошибка в записи уникального кэша	error recording unique cache
130	ошибка в получении уникального кликмаркера	error getting unique clickmarker
150	отсутствует user agent	user agent is empty
160	IP заблокирован	IP is blacklisted
170	клик с utm меткой «adv»	click from advancets
220	быстрый клик (менее 3 сек)	too fast click (less than 3 seconds)
240	клик с другого региона	click from different region
250	клик с другого IP адреса	click from different IP
260	клик пришёл спустя два дня после показа	click received two days after the view
270	клик с другого браузера	click from different browser
280	клик с другой платформы	click from different platform
290	клик с другого интернет-провайдера	click from different ISP
300	клик с другой организации интернет-провайдера	click from different ISP organization
310	клик пришёл с недоступного SSP	click from SSP which is not available
320	клик с другим user agent (отличным от user agent аукциона)	click with different user agent
330	клик пришёл после того как закончилось время жизни кликовой ссылки	click timed-out (more than lifetime of the clicked link)
340	клик пришёл после того как закончилось время жизни кликовой ссылки	click timed-out (more than 2 hours)
350	клик пришёл в течение 30 мин после аукциона и нет notice	click without nurl
360	Kaminari маркировал клик как фрод	Kaminari-detected fraud
370	кликовая ссылка повреждена	damaged clicked link
380	срез забанен (добавлен в blockedSites и не имеет blockedSitesGroupId ИЛИ добавлен в blockedSites и имеет blockedSitesGroupId, но у кампании не стоит флаг на выкуп этой группы)	Banned click
390	SSP отключена	SSP not enabled

Sub-метки

Название	Аналог в Кадаме	Пояснение
sub1	-	Источник трафика (в рамках интеграции Кадама всегда равен kdm)
sub2	sourceID	ID источника трафика—SSP (если utmCampaign in ('1', '2') — это прямые вебы Кадама, если другие цифры, то это внешние SSP).
sub3	blockTypeID	ID формата рекламного блока: utmMedium in ('0','10') — тизер/баннер, utmMedium in ('20') — он-сайт и классик пуш, utmMedium in ('30') — кликандер, utmMedium in ('60') — видео, utmMedium in ('90') — кэтфиш.
sub4	dspID	ID DSP, то есть кому мы этот трафик продаем (utmTerm='1' — это наши прямые реклы, если другие ID, то это внешние DSP).
sub5	macrosID	ID рекламного блока на определенном домене, используется для взаимодействия с рекламодателями, прокидывается к ним в статистики.
sub6	adID	ID рекламного креатива.
sub7	userlong	Хэш от куки пользователя, предназначен для уникализации пользователя.
sub8	eventType	eventType из KadamProd.Clicks: 2 — платный клик, 13 — бесплатный клик, 18 — показ транзитки, 19 — клик по транзитке, -1 — клик, который пришёл в Kaminari, но не пришёл в Кадам. Например, прямые обращения на URL Kaminari из кеша браузера и пр. технический спам.
sub9	susReason или tbReason	susReason или tbReason (выбирается то, что непустое) из KadamProd.Clicks (заполняется для event=ping и event=complete) (см. таблицу выше).
sub10	Example	fraud если клик не прошёл проверку, пустая строка — если прошёл.

Остальные метки

Название	Аналог в Кадаме	Пояснение
clickID	clickID	ID клика
Placement ID	placementID	ID страницы/места, где располагается рекламный блок.
PID	extBlockID	pid (publisher id), его мы получаем от внешних SSP и отделяем потоки через него. То есть это ID определенного денежного потока паблишера.
Click link	-	Кликовая ссылка (URL страницы, на которой выполняется скрипт Антифрода).
SSP name	-	Метка sub2 в виде текста.
Domain name	~domainID	Название домена, которое нам передаёт SSP.
Adv discrep	-	Технический потери, уникализированные по clickID.
Paid clicks	-	Количество платных кликов (тех, у которых sub8='2').

@@ Line 1: / Line 1: @@
-==== Типы ботов ====
+[[Kadam FAQ en|English version]]
-==== Traffic back reasons ====
+=== Важно: ===
+* во все запросы по Кадаму надо обязательно добавлять фильтр <code>sub8 = 2, 13</code>, иначе в выборку попадут данные и по ''транзиткам'';
+* не забывайте при сравнении статы из Кадама и Kaminari проставлять одинаковые таймзоны.
+= Типы кликов =
+=== Боты ===
+'''BV''' — bot visits. Под ботами имеется в виду программы или автоматизированные скрипты, которые запрашивают веб-контент (включая цифровую рекламу) без участия пользователя.
+{| class="wikitable"
+|-
+! Название !! Описание
+|-
+| Crawlers || Это легитимные боты, которые честно объявляют себя через user agent. Они ходят по страницам и собирают контент для различных технических целей. Например, это могут быть боты поисковых систем, индексирующие интернет; боты соц. сетей, кеширующие страницы для показа в превью, или делающие скриншоты; скрапперы, собирающие веб-страницы для каких-то своих целей и пр. То есть это не злонамеренные боты, которые однако не могут совершить конверсию и потому мы должны их игнорировать.
+|-
+| Spoofing || Это боты у которых информация, заявленная в user agent не соответствует реальной. В норме браузер не врёт о себе. Его заставляют врать злоумышленники, которые вынуждают заражённые браузеры ходить по ссылкам и представляться чужими user agent. Чаще всего тут речь идёт о заражённых компьютерах, являющихся частью ботнета.
+|-
+| Automated || Это специальные браузеры, которые управляются извне скриптами. Такие браузеры изначально были созданы для автоматизированного тестирования програмного обеспечения, но потом оказалось, что они отлично подходят для генерации фродового трафика. Это могут быть как связки виртуальных машин, на которые установлены Headless Chrome или Phantom JS, так и огромные клик-фермы, где реальные смартфоны без участия пользователя генерят клики.
+|-
+| iFrame || Для увеличения показов реклама располагается на сайте в маленьких или незаметных элементах (iframe).
+|}
+=== Подозрительные клики ===
+'''SV''' — suspicios visits. Мы видим в данных, собранных по клику что-то подозрительное, но этого не хватает чтобы со всей уверенностью утверждать, что это бот. Рекомендуется в каждом конкретном случае смотреть конверсии и решать отдельно.
+{| class="wikitable"
+|-
+! Название !! Описание
+|-
+| Proxy || Пользователи, изменяюшие своё местоположение с помощью IP-адреса (VPN, прокси, Tor). Это живые клики, они даже могут совершить конверсию, но они идут с нецелевых гео. Если для вашей рекламы важен гео, нужно обращать внимание на эту метрику.
+|-
+| Suspition of spoofing || У нас нет чёткой уверенности, что речь идёт о боте, но есть подозрение. Возможные причины — у пользователя установлено безобидное расширение, афектящее наши проверки; некоторые браузеры и приложения для Андроида имеют захардкоженный (вшитый, неизменный) user agent.
+|-
+| Suspition of automated || У нас тоже нет чёткой уверенности, что речь идёт о боте, но есть подозрение. Возможные причины — опять-таки некие безобидные расширения, которые заставляют наш подозревать, что браузер управляется извне.
+|-
+| Suspition of fraud || Есть подозрение, что реклама располагается на сайте за границами экрана.
+|}
+=== Технические потери ===
+Tech losses. Это клики, которые мы не смогли проверить. Возможные причины — браузеры с отключённым JS; устаревшие браузеры; клик по какой-то причине дошёл до Кадама, но не дошёл до Kaminari.
+=== Хорошие клики ===
+Это клики, которые мы проверили и на 100% уверены, что они не были совершены ботами. То есть это общее количество кликов минус технические потери минус ботовые клики минус подозрительные клики. Плюс мы уникализируем эти клики по clickID (удаляем дубли, потому что дубли — плохой признак). Формула: <code>uniqIf(clickID, total - TL - BV - SV)</code>.
+= Уникализация кликов =
+Предполагается, что по кликовой ссылке можно зайти только один раз. Поэтому первый заход является уникальным, а последующие — дублями. Дубли — это либо технические артефакты (например, ссылка закешировалась в браузере), либо фрод (например, попытка скликивания) и нам не следует учитывать их в статистике.
+Вся статистика считается только по уникальным кликам. Если нужно посмотреть что-то с учётом дублей, это можно сделать, выбрав во всплывающем окне '''Настройки''' пункт '''Учитывать дубли'''.
+[[File:CustomParams 1.png]]
+[[File:CustomParams 2.png]]
+= Traffic back reasons =
 {| class="wikitable"
 |-
@@ Line 29: / Line 83: @@
 | 250 || клик с другого IP адреса || click from different IP
 |-
-| ''260'' || ''не используется'' || ''depricated''
+| 260 || клик пришёл спустя два дня после показа || click received two days after the view
 |-
 | 270 || клик с другого браузера || click from different browser
@@ Line 39: / Line 93: @@
 | 300 || клик с другой организации интернет-провайдера || click from different ISP organization
 |-
-| 310 || клик пришедший с недоступного SSP || click from SSP which is not available
+| 310 || клик пришёл с недоступного SSP || click from SSP which is not available
 |-
 | 320 || клик с другим user agent (отличным от user agent аукциона) || click with different user agent
@@ Line 45: / Line 99: @@
 | 330 || клик пришёл после того как закончилось время жизни кликовой ссылки || click timed-out (more than lifetime of the clicked link)
 |-
-| ''340'' || ''не используется'' || ''depricated''
+| 340 || клик пришёл после того как закончилось время жизни кликовой ссылки || click timed-out (more than 2 hours)
 |-
-| 350 || клик пришел в течение 30 мин после аукциона и нет notice || click without nurl
+| 350 || клик пришёл в течение 30 мин после аукциона и нет notice || click without nurl
 |-
-| 360 || клик маркирован как фрод от Kaminari || Kaminari-detected fraud
+| 360 || Kaminari маркировал клик как фрод || Kaminari-detected fraud
 |-
-| 370 || поврежденная кликовая ссылка || damaged clicked link
+| 370 || кликовая ссылка повреждена || damaged clicked link
 |-
 | 380 || срез забанен (добавлен в blockedSites и не имеет blockedSitesGroupId ИЛИ добавлен в blockedSites и имеет blockedSitesGroupId, но у кампании не стоит флаг на выкуп этой группы) || Banned click
@@ Line 58: / Line 112: @@
 |}
-==== Sub-метки ====
+= Sub-метки =
 {| class="wikitable"
 |-
@@ Line 82: / Line 136: @@
 | sub7 || userlong || Хэш от куки пользователя, предназначен для уникализации пользователя.
 |-
-| sub8 || eventType || eventType из KadamProd.Clicks (заполняется для event=ping и event=complete):
+| sub8 || eventType || eventType из KadamProd.Clicks:
 * 2 — платный клик,
 * 13 — бесплатный клик,
 * 18 — показ транзитки,
-* 19 — клик по транзитке.
+* 19 — клик по транзитке,
+* -1 — клик, который пришёл в Kaminari, но не пришёл в Кадам. Например, прямые обращения на URL Kaminari из кеша браузера и пр. технический спам.
 |-
 | sub9 || susReason или tbReason || susReason или tbReason (выбирается то, что непустое) из KadamProd.Clicks (заполняется для event=ping и event=complete) (см. таблицу выше).
@@ Line 93: / Line 148: @@
 |}
-==== Остальные метки ====
+= Остальные метки =
 {| class="wikitable"
 |-
@@ Line 103: / Line 158: @@
 |-
 | PID || extBlockID || pid (publisher id), его мы получаем от внешних SSP и отделяем потоки через него. То есть это ID определенного денежного потока паблишера.
+|-
+| Click link || - || Кликовая ссылка (URL страницы, на которой выполняется скрипт Антифрода).
 |-
 | SSP name || - || Метка sub2 в виде текста.
+|-
+| Domain name || ~domainID || Название домена, которое нам передаёт SSP.
+|-
+| Adv discrep || - || Технический потери, уникализированные по clickID.
+|-
+| Paid clicks || - || Количество платных кликов (тех, у которых sub8='2').
 |}