✎ postbacks []

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
===== Примеры настройки Postback URL в различных CPA-системах =====

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

{{postbacks:postback.png}}

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

  - **campaign_id** - id рекламной кампании
  - **banner_id** - id баннера
  - **amount** - потенциальная стоимость конверсии
  - **currency** - валюта стоимости конверсии. Возможные значения: "rur", "usd", "eur". По-умолчанию значение "rur".
  - **conversion_id** - идентификатор конверсии. Если с одним conversion_id приходит несколько Postback-запросов, то будут обновляться данные конверсии.
  - **status** - статус конверсии. Возможные значения: "-1", "0", "1". Эти статусы соответственно означают "плохая", "новая" и "подтвержденная" конверсии.
  - **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** передавать необязательно.

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

==== M1-shop ====

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

{{postbacks:m1_label.png}}

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

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

{{postbacks:m1_postback.png}}

==== RichPays ====

В трекинг-ссылке необходимо использовать "sub_id" для кампании и "sub_id2" для баннера.
Для этого к трекинг-ссылке добавьте **?sub_id=%%{{campaign_id}}%%&sub_id2=%%{{banner_id}}%%** и используйте сформированную  ссылку в MyTarget.
 
В платформе RichPays, в поле «Postback %%URL%%» необходимо указать свою Postback-ссылку из интерфейса Искандера, добавив к ней в конце **&campaign_id={sub_id}&banner_id={sub_id2}&amount={profit_usd}&currency=usd**
 
Итоговая ссылка получится:
**%%http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&campaign_id={sub_id}&banner_id={sub_id2}&amount={profit_usd}&currency=usd%%**
 
ПЕРСОНАЛЬНЫЙ_ТОКЕН - обязательно замените на ваш личный токен.
Формат запроса выберите «GET».
Инструменты пользователя

Инструменты сайта

Инструменты страницы
