Метод трекинга Admitad Affiliate
Суть метода в том, что при переходе пользователя по партнерской ссылке, Admitad Affiliate генерирует уникальный идентификатор, который затем передается на страницу вашего сайта через редирект. Идентификатор сохраняется в базу данных своей системы, или в cookie. В случае, если пользователь совершает целевое действие, идентификатор передается из вашей системы в базу данных Admitad Affiliate.
Алгоритм работы трекинга Admitad Affiliate
1. Посетитель переходит по партнерской ссылке веб-мастера, которая ведет на наш сервер (например, https://ad.admitad.com/g/e8f129b05eb7e16523946213826a88/)
2. В этот момент на нашем сервере генерируется UID (уникальный идентификатор, в котором хранится информация о веб-мастере, времени и источнике клика), и вставляется как значение в соответствующий GET-параметр входящей ссылки на ваш сайт. Помимо UID, также передаем и другие параметры, такие как ID веб-мастера, а также статичные параметры, например, UTM-метки для Google Analytics.
Пример
Входящая ссылка может выглядеть так:
http://yoursite.ru/?utm_source=admitad&utm_medium=cpa&admwm={{publisher_id}}
&admitad_uid=0123456789abcdef0123456789abcdef
где utm_source и utm_medium — параметры со статичными значениями для Google Analytics, admwm — параметр для передачи ID веб-мастера, а admitad_uid — параметр для передачи уникального идентификатора клика (UID).
Admitad Affiliate дает возможность получения дополнительной информации по трафику каждого веб-мастера. Например, веб-мастера используют в работе параметр subid, чтобы помечать трафик с разных источников в рамках одной и той же площадки.
Таким образом, вы сможете не только идентифицировать трафик конкретного веб-мастера с помощью publisher_id, но и оценивать качество каждого его источника благодаря subid. Это позволит вам гибко и эффективно управлять трафиком веб-мастера, не прибегая при этом к его отключению.
Назначение, наименование и настройка параметров и их переменных производится на стороне Admitad Affiliate и требует согласования с отделом технической интеграции.
1. После формирования ссылки со всеми необходимыми параметрами и их значениями, происходит редирект с нашего сервера на ваш сайт. Ваша задача — отслеживать каждый переход с соответствующими GET-параметрами в соответствии с моделью атрибуции Last Paid Click.
2. После перехода с GET-параметрами на ваш сайт, вы должны сохранить значение параметра с уникальным идентификатором клика (admitad_uid) в базу данных или в cookie, время жизни которой необходимо установить на срок, указанный в вашем договоре.
3. Теперь данный пользователь будет ассоциироваться с Admitad Affiliate, все дальнейшие действия (вход в игру, достижение уровня) должны передаваться тем же способом и с тем же идентификатором admitad_uid.
Интеграция через трекинг-код
Ссылка перехода Admitad Affiliate
Для начала работы с Admitad Affiliate предоставьте ссылку перехода на ваш сайт, включающую все необходимые вам GET-параметры и UTM-метки.
Пример ссылки для перехода
https://site.ru/?utm_source=admitad&utm_medium=cpa
На основании ссылки перехода будут сгенерированы партнерские ссылки для наших веб-мастеров. В дальнейшем веб-мастера будут размещать партнерские ссылки на своих ресурсах для привлечения трафика на ваш сайт.
Ссылок перехода может быть и несколько, но только одна из них будет основной ссылкой перехода в программе (по умолчанию).
Установка трекинг-кода
Подключайте трекинг-код в теге <head> до всех остальных скриптов. Иначе пользователь может уйти со страницы раньше, чем сработает скрипт.
Не рекомендуется устанавливать скрипт в контейнере Google Tag Manager (GTM), так как GTM будет блокироваться популярными блокировщиками рекламы. Это может привеcти к потере заказов, расхождениям в статистике и проблемам при сверке.
При обновлении сайта необходимо убедиться, что код не был удален и продолжает работать.
Если у вас имеется мобильная версия сайта или мобильное приложение, формы быстрого заказа или заказа в 1 клик, они также должны быть проинтегрированы.
1. Для установки трекинг-кода подключите скрипт на все страницы сайта.
В процессе интеграции мы отправим вам значение {your_campaign_code}
<script src="https://www.artfut.com/static/tagtag.min.js?campaign_code={your_campaign_code}" async onerror='var self = this;window.ADMITAD=window.ADMITAD||{},ADMITAD.Helpers=ADMITAD.Helpers||{},ADMITAD.Helpers.generateDomains=function(){for(var e=new Date,n=Math.floor(new Date(2020,e.getMonth(),e.getDate()).setUTCHours(0,0,0,0)/1e3),t=parseInt(1e12*(Math.sin(n)+1)).toString(30),i=["de"],o=[],a=0;a<i.length;++a)o.push({domain:t+"."+i[a],name:t});return o},ADMITAD.Helpers.findTodaysDomain=function(e){function n(){var o=new XMLHttpRequest,a=i[t].domain,D="https://"+a+"/";o.open("HEAD",D,!0),o.onload=function(){setTimeout(e,0,i[t])},o.onerror=function(){++t<i.length?setTimeout(n,0):setTimeout(e,0,void 0)},o.send()}var t=0,i=ADMITAD.Helpers.generateDomains();n()},window.ADMITAD=window.ADMITAD||{},ADMITAD.Helpers.findTodaysDomain(function(e){if(window.ADMITAD.dynamic=e,window.ADMITAD.dynamic){var n=function(){return function(){return self.src?self:""}}(),t=n(),i=(/campaign_code=([^&]+)/.exec(t.src)||[])[1]||"";t.parentNode.removeChild(t);var o=document.getElementsByTagName("head")[0],a=document.createElement("script");a.src="https://www."+window.ADMITAD.dynamic.domain+"/static/"+window.ADMITAD.dynamic.name.slice(1)+window.ADMITAD.dynamic.name.slice(0,1)+".min.js?campaign_code="+i,o.appendChild(a)}});'></script>
Код, размещенный в атрибуте onerror, предотвращает ошибочное блокирование загрузки скрипта блокировщиками рекламы и антивирусами.
2. После того как вы подключите скрипт на все страницы, настройте передачу данных. Для этого на странице «Спасибо за регистрацию» добавьте код из примера ниже.
{{value}} — место для подстановки реального значения переменной.
Пример кода для действия «Регистрация»:
-
<script type="text/javascript"> ADMITAD = window.ADMITAD || {}; ADMITAD.Invoice = ADMITAD.Invoice || {}; ADMITAD.Invoice.broker = "adm"; // параметр дедупликации (по умолчанию для Admitad) ADMITAD.Invoice.category = "1"; // код целевого действия (action_code) var orderedItem = []; // временный массив для передачи информации orderedItem.push({ Product: { category: '1', // код тарифа (определяется при интеграции) }, additionalType: "lead" }); ADMITAD.Invoice.referencesOrder = ADMITAD.Invoice.referencesOrder || []; ADMITAD.Invoice.referencesOrder.push({ orderNumber: "Reg_{{order number}}", // внутренний номер регистрации (не более 100 символов) orderedItem: orderedItem }); // Важно! Если данные по заказу Admitad подгружаются через AJAX, раскомментируйте следующую строку. // ADMITAD.Tracking.processPositions(); </script>
Интеграция через postback
Постбек (post back, post-back, postback) иногда встречается под названиями: пингбек (pingback), server to server pixel (s2s pixel), s2s postback или server tracking post back.
Используется для отслеживания действий пользователя, запрос в таком случае отправляется от сервера к серверу при определенном событии, с использованием секретного ключа — postback_key/pk.
Пример постбека:
-
Для игры, которая работает за регистрации, вход в игру и достижение уровня (активный игрок)
Регистрация:
https://ad.admitad.com/r?campaign_code=123123cbde&pb=1&pk=5583743172688F1f069dCaF21F142c16&ac=1&tc=1&uid={{admitad_uid}}&oid=reg_{{id}}
Эффективная регистрация (вход в игру):
https://ad.admitad.com/r?campaign_code=123123cbde&pb=1&pk=5583743172688F1f069dCaF21F142c16&ac=2&tc=1&uid={{admitad_uid}}&oid=eff_{{id}}
Активный игрок (достижение уровня):
https://ad.admitad.com/r?campaign_code=123123cbde&pb=1&pk=5583743172688F1f069dCaF21F142c16&ac=3&tc=1&uid={{admitad_uid}}&oid=ap_{{id}}
Обязательные параметры
Имя параметра |
Название | Тип | Примечание |
uid | уникальный идентификатор клика | строка, 32 символа | значение генерируемое, приходит на входе пользователя на сайт в параметре admitad_uid |
campaign_code | код программы | строка, 10 символов | константа, значение определено в postback-запросе, отправленном вам в начале интеграции |
oid |
ID игрока / транзакции | произвольное строковое или числовое значение |
Используется для идентификации действия, генерируется со стороны рекламодателя. |
action_code, ac, product, product_code |
код целевого действия | целое число | переменная, значение сообщает специалист отдела трекинга в начале интеграции |
tariff_code, tc | код тарифа | целое число | переменная, значение сообщает специалист отдела трекинга в начале интеграции |
postback, pb | ключ для авторизации postback-запроса | строка, 1 символ | константа, значение 1 |
postback_key, postback_hash, pk | ключ идентификации postback-запроса | строка, 32 символа | константа, значение определено в postback-запросе, отправленном вам в начале интеграции |
Для oid используются префиксы, так как система принимает только уникальные значения. Например, регистрация - reg_123; эффективная регистрация: eff_123; активный игрок: ap_123; покупка набора: pay_123
где 123 — ID игрока рекламодателя.
Интеграция через XML
Эта информация поможет вам правильно создать и настроить XML-выгрузку с заказами для передачи данных в Admitad Affiliate.
От корректной и своевременно обновляемой XML-выгрузки напрямую зависит стабильность работы вашей партнерской программы и эффективность действий веб-мастеров, генерирующих для вас продажи.
1. Располагайте XML-выгрузку на надежном сервере, который будет всегда доступен и поддерживает загрузку файла по прямой ссылке.
2. Поддерживается загрузка XML с FTP-сервера, защита XML-выгрузки при помощи basic HTTP-авторизации, а также использование GET-параметров в ссылке.
3. Допускается защита XML-выгрузки при помощи фильтрации IP-адресов (IP-адреса нашего сервера можно узнать у технического специалиста Admitad Affiliate).
4. После настройки XML-выгрузки, ее работа обязательно тестируется техническим специалистом Admitad Affiliate.
5. Если у вас есть пожелания к оформлению тестового заказа (специальный тестовый аккаунт, особый номер телефона и/или комментарий к заказу), обязательно сообщите сотруднику Admitad Affiliate до начала тестирования установленных кодов.
6. Кроме того, обязательно сообщите сотруднику Admitad Affiliate название cookie, которая идентифицирует веб-мастера и источник перехода.
Обязательные параметры для передачи
Имя параметра |
Описание | Тип | Примечание |
uid, key | идентификатор Admitad Affiliate | строка, 32 символа | значение генерируемое, приходит на входе пользователя на сайт в параметре admitad_uid |
order_id, oid | ваш внутренний id заказа | строка, 1-100 символов |
ваш внутренний id заказа |
action_code, ac, product, product_code | код целевого действия | целое число | переменная, значение сообщает специалист отдела трекинга в начале интеграции |
tariff_code, tc | код тарифа | целое число | переменная, значение сообщает специалист отдела трекинга в начале интеграции |
datetime_action, now | время действия | дата и время | |
price | стоимость одной позиции товара в корзине | целое или дробное число | |
comment | комментарий | произвольное значение |
Не допускаются дробные числовые значения, кроме цены.
Пример XML-выгрузки
<payment_list> <payment> <key>fc49ebe81383f4df15f62e96439ecd3a</key> <oid>reg_2000412116922</oid> <product_code>1</product_code> <comment>lead</comment> </payment> <payment> <key>fc49ebe81383f4df15f62e96439ecd3a</key> <oid>reg_2000410857716</oid> <product_code>1</product_code> <comment>lead</comment> </payment> <payment> <key>f657d55c840b0743f5c6b856611f0a1a</key> <oid>eff_2000412458735</oid> <product_code>2</product_code> <comment>sale</comment> </payment> </payment_list>