Postback URL используется для передачи данных о конверсиях в Искандер. Он находится во вкладке «Конверсии» - «Postback» на странице «Статистика».

В Postback можно передавать различные данные. Полный список принимаемых параметров:

1. campaign_id - id рекламной кампании
2. banner_id - id баннера
3. amount - потенциальная стоимость конверсии
4. currency - валюта стоимости конверсии. Возможные значения: «rur», «usd», «eur». По-умолчанию значение «rur».
5. conversion_id - идентификатор конверсии. Если с одним conversion_id приходит несколько Postback-запросов, то будут обновляться данные конверсии.
6. status - статус конверсии. Возможные значения: «-1», «0», «1». Эти статусы соответственно означают «плохая», «новая» и «подтвержденная» конверсии.
7. add_time - время создания конверсии в формате timestamp или YYYY-MM-DD hh:mm:ss.

Для корректной работы Postback необходимо передавать как минимум banner_id и amount. Если переменная currency не указана, то считается, что выплата производится в рублях.

Примеры обычного использования Postback URL

Например, ссылка http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&banner_id=123456789&amount=1000 передает данные о том, что произошла конверсия стоимостью 1000 рублей после клика по баннеру с id 123456789, а ссылка http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&banner_id=987654321&amount=0.45&currency=usd передает данные о том, что произошла конверсия стоимостью 0.45 долларов после клика по баннеру с id 987654321.

Если основная валюта аккаунта рубль, а выплаты происходят в долларах или евро, то в статистике будет автоматический пересчет выплат в рубли по курсу ЦБ РФ на текущий день.

Примеры использования Postback URL с передачей статуса

В случае передачи статуса необходимо использовать параметр conversion_id. Например, ссылка http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&banner_id=123456789&amount=1000&conversion_id=119232&status=0 создаст конверсию с id 119232 в статусе «новая».

Затем, если эта конверсия подтверждается, то необходимо вызвать Postback с тем же conversion_id, но с новым статусом, например, вот так http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&conversion_id=119232&status=1. Эта ссылка обновит статус конверсии с id 119232 на «подтвержденная». В случае вызова Postback, который обновляет статус параметры banner_id, и amount передавать необязательно.

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

При создании ссылки необходимо указать в поле «Значение метки S:» строку «{{banner_id}}».

В поле «Postback URL» необходимо указать свою Postback-ссылку из интерфейса Искандера, добавив к ней в конце &banner_id={s}&amount={web_total}. Итоговая ссылка получится http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&banner_id={s}&amount={web_total}.

Также необходимо поставить галочку «Отправлять запрос при подтверждении заказа» в раскрывающемся разделе «Дополнительные настройки PostBack».