Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия Следующая версия Следующая версия справа и слева | ||
postbacks [2015/10/05 20:34] admin |
postbacks [2016/01/29 20:41] admin |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
===== Примеры настройки Postback URL в различных CPA-системах ===== | ===== Примеры настройки Postback URL в различных CPA-системах ===== | ||
- | Postback URL находится во вкладке "Конверсии" - "Postback" на странице "Статистика". | + | Postback %%URL%% используется для передачи данных о конверсиях в Искандер. Он находится во вкладке "Конверсии" - "Postback" на странице "Статистика". |
{{postbacks:postback.png}} | {{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 ==== | ||
Строка 11: | Строка 37: | ||
{{postbacks:m1_label.png}} | {{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 %%URL%%" необходимо указать свою Postback-ссылку из интерфейса Искандера, добавив к ней в конце **&banner_id={s}&amount={web_total}**. Итоговая ссылка получится **%%http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&banner_id={s}&amount={web_total}%%**. |
Также необходимо поставить галочку "Отправлять запрос при подтверждении заказа" в раскрывающемся разделе "Дополнительные настройки PostBack". | Также необходимо поставить галочку "Отправлять запрос при подтверждении заказа" в раскрывающемся разделе "Дополнительные настройки PostBack". | ||
{{postbacks:m1_postback.png}} | {{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}} | ||
+ | |||
+ | ==== 7offers ==== | ||
+ | |||
+ | Постбек для системы AD1 выглядит следующим образом: | ||
+ | **%%http://iskander.su/api/postback.php?token=ПЕРСОНАЛЬНЫЙ_ТОКЕН&banner_id={{subid1}}&amount={{goal_value}}¤cy={{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}} |