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

  • Обновлено

Метод трекинга Admitad Partner Network

Суть метода в том, что при переходе пользователя по партнерской ссылке, Admitad Partner Network генерирует уникальный идентификатор, который затем передается на страницу вашего сайта через редирект. Идентификатор сохраняется в базу данных своей системы, или в cookie. В случае, если пользователь совершает целевое действие, идентификатор передается из вашей системы в базу данных Admitad Partner Network.

Алгоритм работы трекинга Admitad Partner Network

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 Partner Network дает возможность получения дополнительной информации по трафику каждого веб-мастера. Например, веб-мастера используют в работе параметр subid, чтобы помечать трафик с разных источников в рамках одной и той же площадки.

Таким образом, вы сможете не только идентифицировать трафик конкретного веб-мастера с помощью publisher_id, но и оценивать качество каждого его источника благодаря subid. Это позволит вам гибко и эффективно управлять трафиком веб-мастера, не прибегая при этом к его отключению.

Назначение, наименование и настройка параметров и их переменных производится на стороне Admitad Partner Network и требует согласования с отделом технической интеграции.

1. После формирования ссылки со всеми необходимыми параметрами и их значениями, происходит редирект с нашего сервера на ваш сайт. Ваша задача — отслеживать каждый переход с соответствующими GET-параметрами в соответствии с моделью атрибуции Last Paid Click.

2. После перехода с GET-параметрами на ваш сайт, вы должны сохранить значение параметра с уникальным идентификатором клика (admitad_uid) в базу данных или в cookie, время жизни которой необходимо установить на срок, указанный в вашем договоре.

3. Теперь данный пользователь будет ассоциироваться с Admitad Partner Network, все дальнейшие действия (вход в игру, достижение уровня) должны передаваться тем же способом и с тем же идентификатором admitad_uid.

Интеграция через трекинг-код

Ссылка перехода Admitad Partner Network

Для начала работы с Admitad Partner Network предоставьте ссылку перехода на ваш сайт, включающую все необходимые вам 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 Partner Network.

От корректной и своевременно обновляемой XML-выгрузки напрямую зависит стабильность работы вашей партнерской программы и эффективность действий веб-мастеров, генерирующих для вас продажи.

1. Располагайте XML-выгрузку на надежном сервере, который будет всегда доступен и поддерживает загрузку файла по прямой ссылке.

2. Поддерживается загрузка XML с FTP-сервера, защита XML-выгрузки при помощи basic HTTP-авторизации, а также использование GET-параметров в ссылке.

3. Допускается защита XML-выгрузки при помощи фильтрации IP-адресов (IP-адреса нашего сервера можно узнать у технического специалиста Admitad Partner Network).

4. После настройки XML-выгрузки, ее работа обязательно тестируется техническим специалистом Admitad Partner Network.

5. Если у вас есть пожелания к оформлению тестового заказа (специальный тестовый аккаунт, особый номер телефона и/или комментарий к заказу), обязательно сообщите сотруднику Admitad Partner Network до начала тестирования установленных кодов.

6. Кроме того, обязательно сообщите сотруднику Admitad Partner Network название cookie, которая идентифицирует веб-мастера и источник перехода.

Обязательные параметры для передачи

Имя параметра
(курсивом выделены алиасы)

Описание Тип Примечание
 uid, key идентификатор Admitad Partner Network  строка, 32 символа значение генерируемое, приходит на входе пользователя на сайт в параметре admitad_uid
order_id, oid ваш внутренний id заказа строка, 1-100
символов

ваш внутренний id заказа

action_codeac, product, product_code код целевого действия целое число переменная, значение сообщает специалист отдела трекинга в начале интеграции
tariff_codetc код тарифа целое число переменная, значение сообщает специалист отдела трекинга в начале интеграции
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>

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