Если при работе с Admitad вы используете собственную систему статистики продаж и лидов, вы можете добавить postback URL своего сервера в нашу систему и мгновенно получать всю информацию о произошедших конверсиях.
Мы назвали этот инструмент «Код оптимизации», так как с его помощью вы получаете возможность построить такую аналитику, которая требуется именно вам, чтобы оптимизировать свою работу.
Собственная система статистики удобна тем, что вы можете получать все исходные данные о целевых действиях, а далее уже по своему усмотрению преобразовывать их в нужные именно вам таблицы, графики, диаграммы или использовать их в собственных приложениях. Также это облегчает работу с несколькими партнерскими сетями, так как вся статистика будет стекаться в одно место. Данные передаются с помощью GET или POST HTTP-запросов от сервера Admitad на ваш сервер.
К вашим услугам более 20 параметров, содержащих всю возможную информацию о действии — от времени, когда покупатель совершил клик по вашей партнерской ссылке, до статуса вашего заработка. Все эти данные при грамотном их анализе могут существенно помочь вам повысить конверсию ваших рекламных объявлений.
Добавление кода оптимизации (postback)
1. В меню «Инструменты» выберите «Код оптимизации».
2. Нажмите «Добавить postback URL».
Вы можете добавить несколько postback URL, настроив их под различные нужды.
3. В поле «Тип события» выберите событие, о котором на данный postback URL будет передаваться информация:
- О действии — запрос будет отправляться каждый раз при совершении действия (лида или продажи).
-
О статусе программы — запрос будет отправляться при изменении статуса партнерской программы, к которой подключена ваша площадка: при прекращении или возобновлении работы программы.
Программу и площадку выберите ниже. - О подключении реферала — при регистрации новых веб-мастеров, которых вы привели в Admitad по своей реферальной ссылке, будет отправляться пустой запрос (без каких-либо параметров).
-
О статусе сотрудничества с программой — данные будут передаваться:
- при одобрении или отклонении площадки после модерации;
- при отклонении площадки после активного сотрудничества;
-
при повторном одобрении площадки после разрыва сотрудничества.
Программу и площадку выберите ниже.
4. В поле «Площадка» выберите площадку, для которой вы хотите получать статистику.
Вы можете также выбрать вариант «Все площадки», а уже потом в своей системе рассортировать все действия по параметрам «Название площадки» или «ID площадки». Подробнее о доступных параметрах будет написано ниже.
5. В поле «Программа» укажите партнерскую программу, о событиях по которой вы хотите получать информацию.
Здесь также можно оставить пункт «Все программы».
6. Если вы указали какую-то одну партнерскую программу из списка, то вам также будет доступно поле «Тариф».
В этом случае тоже можно ничего не выбирать, и тогда будет передаваться информация по всем тарифам.
7. Если конкретный тариф не был выбран, то можно указать требуемый тип действия — «Sale», «Lead» или оставить «Все».
- Sale — действие, когда пользователь подтвердил заказ на сайте интернет-магазина. Однако в этот заказ еще могут быть внесены изменения в будущем, либо он может быть и вовсе отменен.
- Lead — действие пользователя, под которым может подразумеваться регистрация, подписка на рассылку, установка приложения, достижение определенного уровня в онлайн-игре.
-
Все — действия с типами Sale и Lead.
8. В поле «Тип запроса» выберите метод, которым вам было бы удобнее получать информацию.
Основное различие методов GET и POST заключается в способе передачи данных:
- метод GET отправляет вам всю собранную информацию как часть URL, добавляя параметры и их значения в хвост ссылки;
- метод POST передает данные в теле запроса, а не в самом URL.
Подробнее об особенностях каждого из запроса вы можете прочитать здесь.
9. В поле «Статус действия» выберите, о каких статусах действий вы бы хотели получать данные.
- Создано — этот статус появляется, когда посетитель, которого вы привели на сайт рекламодателя, совершил целевое действие, и оно впервые попало в статистику. Действие будет в этом статусе, пока рекламодатель не подтвердит или отклонит его.
- Подтверждено — рекламодатель проверил действие и подтвердил его.
- Отклонено — рекламодатель проверил действие и отклонил его.
- Ожидает — действие было подтверждено, но затем снова возвращено в обработку. Статус «Создано», в отличие от этого статуса, имеют те платежи, которые впервые попали в систему.
-
Оплачено — вознаграждение за подтвержденное действие перешло в статус «Готовы к снятию». Для получения этого статуса добавьте в ссылку переменную [[[reward_ready]]].
10. В поле «Ссылка» укажите ссылку на ваш сервер, по которой будет приходить HTTP-запрос.
11. Выберите один из двух режимов редактирования:
-
Простой режим — режим, при котором в запрос будет включен полный набор параметров, а сами параметры будут носить стандартные имена, принятые в системе Admitad.
-
Расширенный режим — позволяет самостоятельно сформировать список нужных параметров, а также присвоить им те имена, которые вы уже используете в собственной системе. Для этого введите имя параметра в одноименное поле, а в поле «Содержание параметра» перетащите соответствующее значение из области справа:
Если у вас был выбран GET-запрос, то в строке «Сгенерированная ссылка» вы увидите URL, в котором после символа «?» перечислены выбранные вами параметры и их содержание:
Именно так будет выглядеть ссылка, по которой будут отправляться HTTP-запросы на ваш сервер, только вместо [[[...]]] будут подставляться уже реальные значения параметров.
12. После того как вы добавили все нужные параметры, протестируйте ссылку. Для этого внизу страницы нажмите «Протестировать».
В зависимости от выбранного вами типа запроса в открывшемся окне вы увидите:
| GET-запрос | POST-запрос |
|
URL с тестовыми значениями параметров, которые будут переданы на ваш сервер. Вы можете заменить эти значения на свои собственные, отредактировав код. |
В верхнем поле — URL, по которому пойдет запрос, а в нижнем — параметры и их тестовые значения из тела запроса. В данном случае подставить свои тестовые значения нельзя. |
Нажмите на кнопку «Тестировать», чтобы отправить запрос, и вы увидите сообщение «Запрос на ваш адрес осуществлен».
Проверьте в своей системе статистики, что данные пришли.
- В случае, если запрос был отправлен, но данные не пришли — обратитесь в поддержку Admitad.
- Если сервер не принимает POST-запросы, недоступен, или его адрес был указан ошибочно, вы увидите сообщение: «Произошла ошибка во время запроса. Проверьте адрес».
13. Если вы убедились, что нужные данные поступают на ваш сервер, закройте окно тестирования и сохраните новый код оптимизации:
Он появится в таблице. Вы в любой момент отредактировать его или повторно протестировать в столбце «Настройки».
Типы параметров и их допустимые значения
Параметры для типа события «О действии»
| Имя | Формат значения | Описание |
|---|---|---|
| offer_id | целое число | ID партнерской программы |
| offer_name | строка | Название партнерской программы |
| admitad_id | целое число | Идентификатор платежа |
| website_name | строка | Название площадки |
| website_id | целое число | ID площадки |
| subid | строка |
SubID Может использоваться для значений subid, subaccount, source_id, affiliate_id, creative_id, adset_id |
| action | строка | Название тарифа |
| action_id | целое число | ID тарифа |
| subid1 | строка | SubID1 |
| subid2 | строка | SubID2 |
| subid3 | строка | SubID3 |
| subid4 | строка | SubID4 Может использоваться для значений click_id, transaction_id. |
| payment_sum | дробное число | Сумма вашего заработка |
| payment_status | строка, варианты: | Статус платежа |
new |
- новый платеж, который ещё не был ни подтвержден, ни отклонен | |
approved |
- платеж подтвержден | |
declined |
- платеж отклонен | |
pending |
- подтвержденный платеж снова перешел в холд | |
| currency | строка (макс. длинна = 3) | Валюта программы |
| order_id | целое число | Номер заказа |
| order_sum | дробное число | Сумма заказа |
| click_time | Unix-time | Время клика |
| time | Unix-time | Время действия |
| conversion_time | целое число | Время конверсии (в секундах) |
| type | строка, варианты: | Тип действия |
lead |
||
sale |
||
| country_code | строка | Код страны в формате RU / UA / US |
| user_agent | строка | User-Agent |
| user_referer | строка | User-Refferer |
|
reward_ready |
строка, варианты: |
Вознаграждение перешло в статус «Готовы к снятию» или вышло из него*. *Если вознаграждение вышло из статуса «Готовы к снятию», это значит, что оно либо вернулось в статус «В обработке», либо на баланс рекламодателя, т.к. он отклонил действие. |
true |
||
false |
Параметры для типа события «О статусе программы»
| Имя | Формат значения | Описание |
|---|---|---|
| offer_id | целое число | ID партнерской программы |
| offer_name | строка | Название партнерской программы |
| offer_status | строка, варианты: | Новый статус партнерской программы |
active |
- партнерская программа активна и сотрудничает с вами | |
denied |
- Admitad больше не сотрудничает с этой партнерской программой | |
disabled |
- программа отключена, но, возможно, снова станет активна | |
dead |
- программа закрыта и больше не будет работать в Admitad |
Параметры для типа события «О статусе сотрудничества с программой»
| Имя | Формат значения | Описание |
|---|---|---|
| offer_id | целое число | ID партнерской программы |
| offer_name | строка | Название партнерской программы |
| website_id | целое число | ID площадки |
| partnership_status | строка, варианты: | Статус сотрудничества с программой |
accepted |
- успешное подключение площадки к программе | |
denied |
- отключение площадки от программы |
Передача click_id и transaction_id
Если вы хотите передавать в партнерской ссылке ваши параметры click_id или transaction_id, используйте для этого параметр subid4.
Пример ссылки:
https://ad.admitad.com/g/f469ae904cb7e16523942b59d5275c/?subid4={click_id}
В этой ссылке значение в фигурных скобках {click_id} надо заменить на ваше значение click_id.
