Код оптимизации (Postback веб-мастера)

  • Обновлено

Если при работе с Admitad Affiliate вы используете собственную систему статистики продаж и лидов, вы можете добавить postback URL своего сервера в нашу систему и мгновенно получать всю информацию о произошедших конверсиях.

Мы назвали этот инструмент «Код оптимизации», так как с его помощью вы получаете возможность построить такую аналитику, которая требуется именно вам, чтобы оптимизировать свою работу.

Собственная система статистики удобна тем, что вы можете получать все исходные данные о целевых действиях, а далее уже по своему усмотрению преобразовывать их в нужные именно вам таблицы, графики, диаграммы или использовать их в собственных приложениях. Также это облегчает работу с несколькими партнерскими сетями, так как вся статистика будет стекаться в одно место. Данные передаются с помощью GET или POST HTTP-запросов от сервера Admitad Affiliate на ваш сервер.

К вашим услугам более 20 параметров, содержащих всю возможную информацию о действии — от времени, когда покупатель совершил клик по вашей партнерской ссылке, до статуса вашего заработка. Все эти данные при грамотном их анализе могут существенно помочь вам повысить конверсию ваших рекламных объявлений.

Добавление кода оптимизации (postback)

1. В меню «Инструменты» выберите «Код оптимизации».

2. Нажмите «Добавить postback URL».

Вы можете добавить несколько postback URL, настроив их под различные нужды.

Как работает Код оптимизации? 1


3. В поле «Тип события» выберите событие, о котором на данный postback URL будет передаваться информация:

  • О действии — запрос будет отправляться каждый раз при совершении действия (лида или продажи).
  • О статусе программы — запрос будет отправляться при изменении статуса партнерской программы, к которой подключена ваша площадка: при прекращении или возобновлении работы программы.
    Программу и площадку выберите ниже.
  • О подключении реферала — данные будут передаваться при регистрации новых веб-мастеров, которых вы привели в Admitad Affiliate по своей реферальной ссылке.

Как работает Код оптимизации? 2

4. Выберите площадку, для которой вы хотите получать статистику.

Вы можете также выбрать вариант «Все площадки», а уже потом в своей системе рассортировать все действия по параметрам «Название площадки» или «ID площадки». Подробнее о доступных параметрах будет написано ниже.

Как работает Код оптимизации? 3

5. Укажите партнерскую программу, о событиях по которой вы хотите получать информацию.

Здесь также можно оставить пункт «Все программы».

Как работает Код оптимизации? 4
 

6. Если вы указали какую-то одну партнерскую программу из списка, то вам также будет доступно поле «Тариф».

В этом случае тоже можно ничего не выбирать, и тогда будет передаваться информация по всем тарифам.

Как работает Код оптимизации? 5

7. Если конкретный тариф не был выбран, то можно указать требуемый тип действия — «Sale», «Lead» или оставить «Все».

  • Sale — действие, когда пользователь подтвердил заказ на сайте интернет-магазина. Однако в этот заказ еще могут быть внесены изменения в будущем, либо он может быть и вовсе отменен.
  • Lead — действие пользователя, под которым может подразумеваться регистрация, подписка на рассылку, установка приложения, достижение определенного уровня в онлайн-игре.

Как работает Код оптимизации? 6

8. Укажите тип запроса, которым вам было бы удобнее получать информацию.

Основное различие методов GET и POST заключается в способе передачи данных:

  • метод GET отправляет вам всю собранную информацию как часть URL, добавляя параметры и их значения в хвост ссылки;
  • метод POST передает данные в теле запроса, а не в самом URL.

Подробнее об особенностях каждого из запроса вы можете прочитать здесь.

9. Выберите, о каких статусах действий вы бы хотели получать данные.

  • Создан — этот статус появляется, когда посетитель, которого вы привели на сайт рекламодателя, совершил действие: сделал покупку, установил приложение, набрал требуемый уровень в онлайн-игре и т.д. До того, как рекламодатель подтвердит или отклонит это действие, оно будет оставаться в этом статусе.
  • Подтвержден — рекламодатель проверил действие и подтвердил его.
  • Отклонен — рекламодатель проверил действие и отклонил его.
  • Ожидает — действие было подтверждено, но затем снова возвращено в обработку. Статус «Создан», в отличие от этого статуса, имеют те платежи, которые впервые попали в систему.

Как работает Код оптимизации? 7

10. Укажите ссылку на ваш сервер, по которой будет приходить HTTP-запрос.

Как работает Код оптимизации? 8

11. Выберите один из двух режимов редактирования:

  • Простой режим — режим, при котором в запрос будет включен полный набор параметров, а сами параметры будут носить стандартные имена, принятые в системе Admitad Affiliate.

    Как работает Код оптимизации? 9

  • Расширенный режим позволяет самостоятельно сформировать список нужных параметров, а также присвоить им те имена, которые вы уже используете в собственной системе. Для этого введите имя параметра в одноименное поле, а в поле «Содержание параметра» перетащите соответствующее значение из области справа:

    Как работает Код оптимизации? 10


Если у вас был выбран GET-запрос, то в строке «Сгенерированная ссылка» вы увидите URL, в котором после символа «?» перечислены выбранные вами параметры и их содержание:

Как работает Код оптимизации? 11

Именно так будет выглядеть ссылка, по которой будут отправляться HTTP-запросы на ваш сервер, только вместо [[[...]]] будут подставляться уже реальные значения параметров.
 

12. После того как вы добавили все нужные параметры, протестируйте ссылку. Для этого внизу страницы нажмите «Протестировать».

Как работает Код оптимизации? 12

В зависимости от выбранного вами типа запроса в открывшемся окне вы увидите:

GET-запрос POST-запрос

Как работает Код оптимизации? 13

 

URL с тестовыми значениями параметров, которые будут переданы на ваш сервер. Вы можете заменить эти значения на свои собственные, отредактировав код.

Как работает Код оптимизации? 14

В верхнем поле — URL, по которому пойдет запрос, а в нижнем — параметры и их тестовые значения из тела запроса. В данном случае подставить свои тестовые значения нельзя.


Нажмите на кнопку «Тестировать», чтобы отправить запрос, и вы увидите сообщение «Запрос на ваш адрес осуществлен».

Проверьте в своей системе статистики, пришли ли данные.

В случае, если запрос был отправлен, но данные не пришли — обратитесь в службу поддержки.

Если сервер не принимает POST-запросы, недоступен, или его адрес был указан ошибочно, вы увидите сообщение: «Произошла ошибка во время запроса. Проверьте адрес».

13. Если вы убедились, что нужные данные поступают на ваш сервер, закройте окно тестирования и сохраните новый код оптимизации:

Как работает Код оптимизации? 15

Он появится в таблице. Вы в любой момент отредактировать его или повторно протестировать в столбце «Настройки».

Как работает Код оптимизации? 16

Типы параметров и их допустимые значения

Параметры для типа события «О действии»

Имя Формат значения Описание
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 строка Название тарифа
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
action_id целое число ID тарифа

 

Параметры для типа события «О статусе программы»

Имя Формат значения Описание
offer_id целое число ID партнерской программы
offer_name строка Название партнерской программы
offer_status строка, варианты: Новый статус партнерской программы
active - партнерская программа активна и сотрудничает с вами
denied - программа отклонила ваш запрос на сотрудничество
disabled - программа отключена, но, возможно, снова станет активна
dead - программа закрыта и больше не будет работать в Admitad Affiliate

 

Передача click_id и transaction_id

Если вы хотите передавать в партнерской ссылке ваши параметры click_id или transaction_id, используйте для этого параметр subid4.

Пример ссылки:
https://ad.admitad.com/g/f469ae904cb7e16523942b59d5275c/?subid4={click_id}

В этой ссылке значение в фигурных скобках {click_id} надо заменить на ваше значение click_id.

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