Различия

Здесь показаны различия между двумя версиями данной страницы.

--- postbacks [2015/10/05 20:04]
admin создано
+++ postbacks [2015/10/08 17:24]
admin
@@ Строка 1: / Строка 1: @@
-===== Настройка Postback URL =====
+===== Примеры настройки 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}}

Инструменты пользователя

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

Различия

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