Postback CPA-размещений

1. Введение

Различают два типа вызова сервиса postback:

• client - server
  

• server - server 
  

Клиент - сервер вариант используется в случаях, когда действие пользователя приводит к лиду, при этом пользователь в этот момент взаимодействует со страницей (например, когда лид - это заполнение формы регистрации).

Сервер - сервер вариант используется для случаев, когда пользователь не взаимодействует со страницей в момент совершения лида (например, когда лидом считается подтвержденный заказ, то есть перед тем, как засчитается лид, оператор call центра должен позвонить пользователю, и в этот момент пользователь никак не взаимодействует со страницей). При такой схеме сервер рекламодателя взаимодействует с сервером MediaSniper, передавая идентификатор показа.

Основная суть postback вызова заключается в уведомлении о лиде. Весь трафик, который присылает MediaSniper через систему Media Sniper, содержит в get параметрах уникальный номер показа, как правило, он называется “s_trk.

Чтобы проинформировать о лиде, необходимо вернуть MediaSniper get параметр s_trk пользователя совершившего лид.

Для клиент - сервер варианта можно хранить ключ в куке и читать ее в момент лида.

Для сервер - сервер варианта требуется хранить сопоставление id пользователя, по которому идентифицируются пользователи и ставить ему в соответствие значение s_trk.

2. Пример postback ссылки

http://pback.mediasniperleads.com/ap_back_url.php?type=accept&pid={partner_ID}&plus={revenue}&offer_id={offer_id}&s_trk={s_trk}&apid={trans_id}¤cy={currency}&s_leadid={s_leadid}

Возможен модификатор для типа лида (используется для отклоненных лидов)
type=decline

{partner_ID}	Идентификатор партнера в системе MediaSniper. Стандартно можно использовать site_{site_name} где {site_name} для test.ru - testru То есть в конечном варианте site_testru
{revenue}	Стоимость лида. Если это тестовая кампания, или стоимость лида не оговаривалась отдельно, можно передавать “1”. Также число, переданное в этом поле, может быть не целым, для этого используется разделитель “.” Например: “154.32”. Подразумевается, что валюта рубли.
{offer_id}	Идентификатор оффера в рамках партнера. Если офер один, то можно передавать в это поле “1”, если оферов больше, то можно передавать их идентификатор или текстовое название.
{s_trk}	Значение get параметра s_trk, присвоенное пользователю. Пример s_trk: ChRhZHA0WncRerU-EeSLfgElkJWCShCpsuuqDBjNw4OnBSDkw4OnBQ
{trans_id}	Уникальный номер транзакции. Если транзакции отдельно не отслеживаются, то в это поле можно передать Unix Time Stamp
{s_leadid}	Идентификатор лида. В основном этот get отсутствует, добавляется только в случае, если надо отслеживать несколько типов лидов. Алфавит a-zA-Z0-9_-
{currency}	Валюта, в которой передается лид. Считается по курсу ЦБ РФ и конвертируется в рубли. (это необязательное поле и может быть пропущено, в этом случае конвертация производиться не будет)

3. Описание механики работы postback

MediaSniper имеет агрегированную статистику и поэтому не может изменять статус лида. Поддержка актуальности осуществляется путем хранения статусов lead / unlead. Таким образом, когда в CPA создается лид в статусе hold для CC, - это принятый лид. Если в CPA этот лид был принят, то СС никак не обрабатывает эту ситуацию, если в CPA лид был отклонен, то СС создаст еще одну запись со статусом лида unlead. Таким образом, при расчете профита от CPA из суммы лидов со статусом lead вычитается сумма лидов со статусом unlead.

Пример работы для офера с автопринятием:

Если для офера не существует такого понятия, как холд / принятие / отклонение, то есть все лиды сразу считаются принятыми, но CPA имеет три поля для настройки: lead / hold / reject, то должно быть заполнено только поле lead.

Пример работы для офера с различными состояниями:

Если для офера существуют три состояния hold / lead / reject, то в СС нужно передавать type=accept, когда лид в CPA находится в состоянии hold. То есть, как только лид создался в CPA, СС получит информацию и о лиде и сможет его обработать.
При принятии лида в CPA в СС не надо отправлять информацию, так как, если повторно отправить то же самое, лид может задвоиться.
При отклонении лида в CPA в СС надо отравить type=decline, чтобы СС понял, что надо засчитать этот лид как отклоненный.

4. Особенности подсчета статистики

MediaSniper записывает статистику по 2м различным событиям: времени клика (lead) и времени прихода лида (lead now). Такая статистика позволяет считать доход и по времени совершения клика пользователя, и по времени совершения действия. Это необходимо, чтобы решить вопрос подсчета прибыли.
Ниже пример рекламной кампании, которая была запущена 1 день:

Дата	Показы	Клики	Lead	Lead Now	eCPM (lead)	eCPM (lead now)
01.08.ХХХХ	10000	100	100	0	10	0
02.08.ХХХХ	1	1	0	100	0	100000