===== Примеры настройки 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, который обновляет статус параметр **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».

==== AD1 ====

Постбек для системы AD1 выглядит следующим образом:
**%%http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&banner_id={subid1}&amount={summ_total}&currency={currency}&status={status}&conversion_id={order_id}&add_time={lead_time}%%**
 
ПЕРСОНАЛЬНЫЙ_ТОКЕН можно найти на странице Настройки в Искандере.

{{postbacks:personal_token.png}}

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

{{postbacks:ad1.png}}

При получении ссылки необходимо использовать в качестве субаккаунта строку **%%{{banner_id}}%%**. Полученную ссылку необходимо использовать при создании объявлений в Искандере.

{{postbacks:ad1_link.png}}

==== 7offers ====

Постбек для системы AD1 выглядит следующим образом:
**%%http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&banner_id={{subid1}}&amount={{goal_value}}&currency={{currency}}&add_time={{action_time}}%%**
 
ПЕРСОНАЛЬНЫЙ_ТОКЕН можно найти на странице Настройки в Искандере.

{{postbacks:personal_token.png}}

При создании ссылки необходимо нажать на кнопку "Настройки".

{{postbacks:7offers_options.png}}

В открывшемся окне в поле "SubID1" необходимо вбить "%%{{banner_id}}%%".

{{postbacks:7offers_subid.png}}

В итоге должна получиться вот такая ссылка. Эту ссылку необходимо использовать при создании объявлений.

{{postbacks:7offers_link.png}}

Далее необходимо перейти в раздел "Postback".

{{postbacks:7offers_menu_postback.png}}

Здесь необходимо вбить указанный выше Postback и выбрать "Отправка при статусе Подтвержден".

{{postbacks:7offers_postback.png}}