Здесь показаны различия между двумя версиями данной страницы.
Следующая версия | Предыдущая версия Следующая версия Следующая версия справа и слева | ||
postbacks [2015/10/05 20:04] admin создано |
postbacks [2015/12/09 17:25] 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¤cy=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 ==== | ==== 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}¤cy=usd** | ||
+ | |||
+ | Итоговая ссылка получится: | ||
+ | **%%http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&campaign_id={sub_id}&banner_id={sub_id2}&amount={profit_usd}¤cy=usd%%** | ||
+ | |||
+ | ПЕРСОНАЛЬНЫЙ_ТОКЕН - обязательно замените на ваш личный токен. | ||
+ | Формат запроса выберите «GET». | ||
+ | |||
+ | ==== AD1 ==== | ||
+ | |||
+ | Постбек для системы AD1 выглядит следующим образом: | ||
+ | **%%http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&banner_id={subid1}&amount={summ_total}¤cy={currency}&status={status}&conversion_id={goal_id}&add_time={lead_time}%%** | ||
+ | |||
+ | ПЕРСОНАЛЬНЫЙ_ТОКЕН можно найти на странице Настройки в Искандере. | ||
+ | |||
+ | {{postbacks:personal_token.png}} | ||
+ | |||
+ | При создании потока в AD1 необходимо добавить постбек и выставить все галочки. | ||
+ | |||
+ | {{postbacks:ad1.png}} | ||
+ | |||
+ | При получении ссылки необходимо использовать в качестве субаккаунта строку **%%{{banner_id}}%%**. Полученную ссылку необходимо использовать при создании объявлений в Искандере. | ||
+ | |||
+ | {{postbacks:ad1_link.png}} |