Получение постбеков (Postbacks)

Как это работает?

Каждый переход в Keitaro имеет свой уникальный SubID. Его необходимо перебросить в партнерку через макрос {subid}:

http://affiliate.com/offer?clickid={subid}

Это лишь пример ссылки, у каждой партнерки свой механизм передачи этого subid.

Затем в партнерке настраивается постбек. Постбек содержит уникальный ключ (postback_key), который откличается у каждой TDS. Ваш постбек можно взять на странице «Кампания > Постбек».

Keitaro ожидает получить обратно переданный SubID в параметре sub_id, иначе конверсия не засчитывается.

Как подключить постбек к партнерке?

  1. На странице кампании нажмите в меню «Постбек».
  2. Выберите из списка предустановок вашу партнерку или оставьте «Default».
  3. Посмотрите, появилась ли инструкция по настройке партнерских ссылок. Если её нет, необходимо поискать инструкцию по передаче subid на сайте вашей партнерки.
  4. Полученный URL вставьте в настройках постбека на сайте партнерки.

Какие параметры можно передать в постбеке?

  • subid — id перехода, который сгенерировала Keitaro (обязательный)
  • tid — Transaction ID, уникальный ID действия со стороны партнерки. Необходим, если происходят ребиллы;
  • revenue или profit — сумма полученного дохода;
  • cost — стоимость лида (расходы);
  • status — статус конверсии;
  • sale_status — какие статусы считать продажами. Пример, «&sale_status=status1,status2»;
  • lead_status — какие статусы считать лидами. Пример, «&lead_status=status3,status4»;
  • rejected_status — какие статусы считать за отклоненные. Пример, «&rejected_status=status5,status6»;
  • currency — валюта дохода и расхода (usd, eur или rub). Передавайте, если валюта отличается от установленной в Keitaro;
  • sub_id_1, sub_id_2, sub_id_3, sub_id_4 — по умолчанию значения берутся из перехода, но можно для конврсии можно заменить;
  • extra_param_1, extra_param_2…, extra_param_7 — дополнительная информация, которая будет доступна в отчете «Конверсии»;
  • return — строка ответа, для случаев когда партнерка ждет определенный ответ. Пример, &return=OK.

Все остальные переданные параметры будут доступны в отчете «Конверсии», по клику на «Параметры».

Постбек через пиксель

Добавьте к вашему постбеку &return=gif:

<img src="http://domain.com/123/postback?....&return=gif" width=1 height=1/>

Как получить определенный ответ от TDS?

Добавьте к вашему постбеку необходимый ответ &return=OK:

http://domain.com/123/postback?....&return=OK

Если имя параметра "subid" занято, как передать свои subid?

Передавайте их через параметры: sub_id_1, sub_id_2, sub_id_3, sub_id_4. Макросы для передачи в офферы, соответственно, {sub_id_1}, {sub_id_2}, {sub_id_3}, {sub_id_4}. Проверьте правила составления ссылок и добавления subid на офферы в разделе помощи партнерки.

Как учитывать ребиллы?

Перед обработкой постбека в Keitaro проверяется наличие записи о конверсии по ключам «subid + tid». В случае нахождения постбек игнорируется. Поэтому передавайте в постбеке параметр tid со значением операции, чтобы учитывались ребиллы.

Неправильно определяется статус?

Вы можете уточнять статусы в параметрах «lead_status», «sale_status», «rejected_status». Пример

http://tds.com/123/postback?lead_status=register&sale_status=paid,rebill&rejected_status=refund...

Постбек не работает. Что делать?

Посмотрите содержимое файла var/log/postbacks.log. Объяснение ошибок ниже.

Ошибка в логе "Incorrect SubId..."

Причины:

  1. В потоке не передается subid перехода на оффер;
  2. В постбеке не возвращается subid;

Решение:

  1. Проверьте, что в ссылке на оффер имеется передача subid, через макрос {subid}. О том, как передавать subid, почитайте в разделе помощи на сайте партнерки.
  2. Проверьте, что в постбеке имеется передача subid. В разделе помощи партнерки посмотрите, какие макросы для этого предусмотрены. Также попробуйте собрать новый Postback URL

Ошибка в логе "Conversion by pair "SubId + tid" is already exists. Postback ignored."

Причины:

  1. Партнерка повторно отправила уведомление о лиде или продаже.
  2. Совершен ребилл, но не передан tid (Transaction ID)

Исправление:

  1. На странице помощи в партнерке посмотрите какой макрос предусмотрен для Transaction ID (уникальный id операции). Он может называться также, txid, oid.

Как конвертируется сумма в валюте?

В момент получения платежа, забираются текущие котировки с Google Finance и сумма переводится в валюту, которая выставлена в настройках Keitaro.

Почему тестовый постбек из ПП не добавляет конверсию?

Проверьте, чтобы во время теста передавался существующий sub_id. Взять его можно с одного из переходов из отчета детализации.

Как отправить постбек со своего сайта?

Для этого необходимо фиксировать subid перехода и после совершения действия отправлять постбек в TDS.

1. В потоке, который отправляет на ваш сайт. Добавьте передачу subid. Пример, http://mysite.ru/welcome?subid={subid}.

2. На странице сайта, куда попадают пользователи, добавьте код сохранения subid в сессию:

<?php
if (!headers_sent() && !session_id()) {
      session_start();
}
if (isset($_GET['subid'])) {
    $_SESSION['subid'] = $_GET['subid'];
}

3. После совершения покупки, отправляйте постбек:

$url = 'http://tds/POSTBACK_KEY/postback?revenue=200.10&subid=' . $_SESSION['subid'];
file_get_contents($url);

Список доступны параметров для постбека на странице какие_параметры_можно_передать_в_постбеке.

Как передавать конверсии в режиме Трекинга?

Читайте на странице Трекинг.

Подключение постбека к admintad.com

  1. В Keitaro зайдите на страницу Постбек (Кампания > Постбек);
  2. Выберите в списке «admitad.com»;
  3. Скопируйте содержимое Postback URL;
  4. Зайдите в admitad.com на странице «Tools > Postback URL»;
  5. Нажмите «Add Postback URL»;
  6. В строке «Status» поставьте галочки у всех статусов;
  7. В поле «Link» вставьте скопированный ранее Postback URL;
  8. Нажмите в самом низу страницы «Save».

Подключение постбека в cityads.ru

Партнерка принимает subid через параметр «sa». URL для потока будет выглядеть так: http://www.cityads.ru/click-NNNNNNNN-YYYYYYYYY?sa={subid}, где {subid} — это макрос, который подставит значение subid.

На странице «Операции/Postbacks» выберите из списка предустановок CityAds. Скопируйте «URL приема postback'ов».

В кабинете партнерки зайдите на страницу «Conversion Postback», нажмите «Создать». Вставьте ранее скопированную ссылку в «Postback URL» и проставьте галочки у всех параметров.

Почему отклоняется постбек в cityads.ru?

Это связано с тем, что их интерфейс срезает параметры в адресе. Например, при добавлении http://tds.com/?postback=1&key=123 из адреса удалятся postback=1&key=123, что делает постбек нерабочим.

Для этих случаев предусмотрен дополнительный формат адресов http://domain/KEY/postback.