1. Admitad
  2. Admitad Advertisers
  3. Техническая интеграция

Интеграция для игрового сегмента

  • Обновлено

Метод трекинга 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>

Была ли эта статья полезной?