[ 1 сообщение ] 
Начать новую тему Ответить на тему
Автор Сообщение
СообщениеДобавлено: 22 сен 2014, 13:14 
Сотрудник Миксмаркета
Аватара пользователя

Сообщения: 806
Поблагодарили: 62 раз.
Рады вам сообщить, что мы улучшили функциональность партнерских событийный отчетов в API.

Мы вывели 3 значения параметра status, единых для всех партнерских программ: (waiting | cancelled | validated), а также вывели дополнительные параметры order_price - реальную стоимость события, совершенного пользователем, и hold_price - потенциальную сумму вознаграждения партнера, рассчитываемую на основе суммы заказа в случае фиксированной ставки вознаграждения.


Для получения отчета по событиями необходимо указать: mixmarket.biz/uni/api.php?id=xxx&pass=xxx&e=eventsreport&period={day|week|month}&zip={0|1}

Если вы ранее с Api не работали, чтобы узнать ваши параметры id= и pass= , напишите в поддержку и укажите для какой площадки вам нужен доступ в API.

В ответе будет XML-файл в формате:

Код:
<?xml version='1.0' encoding='windows-1251'?>
<uni version="1.0">
  <events period="day">
    <event id="{ID события}">
    <status>{waiting|cancelled|validated} </status>
    <date>2011-01-01 12:00</date>
    <price>Размер партнерского вознаграждения</price>
    <hold_price>Размер потенциальной суммы вознаграждения </hold_price>
    <order_price>Реальная сумма заказа, сделанного пользователем</order_price>
    <condition id="{ID условия}">{Название условия}</condition>
    <program id="{ID программы}">{Название программы}</program>
    <advertizer>{Название рекламодателя}</advertizer>
    <click_ip>1.1.1.1</click_ip>
    <area>{Название рекламной площадки}</area>
    <material>Свободный формат</material>
    <click_date>2011-01-01 12:00</click_date>
    <click_id>{ID клика}</click_id>
    <stat_id>{Переданное значение stat_id}</stat>
    <sub_id>{Переданное значение sub_id}</stat>
    <obj_id>{id события  переданное рекламодателем }</obj_id>
  </event>
</events>
</uni>

Параметр <status> при одном и том же <obj_id> (id события на стороне рекламодателя ) может иметь до 3х типовых значения waiting|cancelled|validated.

Статус waiting - первоначальное или промежуточное событие, у которого будут наследники (статусы validated или cancelled), в этом случае могут быть переданы параметры <order_price> — реальная сумма заказа, на основе которой рассчитывается <hold_price> (потенциальная сумма вознаграждения партнера). Параметр <price> может быть нулевым (это значит, что за открытое событие по условиям программы партнерское начисление идет с нулевой ценой), так и с начислением, например, если рекламодатель проводит начисление за промежуточное событие, такое как оформление заказа.

Пример:

Код:
<event id="178765501">
<status>waiting</status>
<date>2014-09-18 11:37</date>
<price>0.00</price>
<hold_price>51.9232</hold_price>
<order_price>532</order_price>
<condition id="1294933351">Заказ оформлен</condition>
<program id="79">Оплата заказа в My-shop.ru</program>
<advertizer>Мой магазин, ООО</advertizer>
<click_ip>213.70.98.2</click_ip>
<area>site.ru</area>
<material>Свободный формат</material>
<click_date>2014-09-15 09:44</click_date>
<click_id>121144639</click_id>
<stat id="16190">16190</stat>
<stat_id>16190</stat_id>
<obj_id>3327731</obj_id>
</event>



Статус cancelled - конечное событие без наследников, где <order_price>, <hold_price> и <price> будут иметь нулевые значения, по факту это означает, что заказ не подтвержден / отменен.

Пример:
Код:
<event id="178762773">
<status>cancelled</status>
<date>2014-09-18 11:30</date>
<price>0.00</price>
<hold_price>0</hold_price>
<order_price>0</order_price>
<condition id="1294933351">Заказ оформлен</condition>
<program id="79">Оплата заказа в My-shop.ru</program>
<advertizer>Мой магазин, ООО</advertizer>
<click_ip>213.70.98.2</click_ip>
<area>site.ru</area>
<material>Свободный формат</material>
<click_date>2014-09-15 09:44</click_date>
<click_id>121144639</click_id>
<stat id="16190">16190</stat>
<stat_id>16190</stat_id>
<obj_id>3327696</obj_id>
</event>



Статус validated – означает конечное событие без наследников с начислением.

Пример:
Код:
<event id="178652899">
<status>validated</status>
<date>2014-09-18 00:11</date>
<price>45.68</price>
<hold_price>0</hold_price>
<order_price>468</order_price>
<condition id="1294933349">Заказ доставлен и оплачен</condition>
<program id="79">Оплата заказа в My-shop.ru</program>
<advertizer>Мой магазин, ООО</advertizer>
<click_ip>78.25.122.218</click_ip>
<area>site.ru</area>
<material>XML</material>
<click_date>2014-08-25 19:05</click_date>
<click_id>118353345</click_id>
<obj_id>3237464</obj_id>
</event>


Обратите внимание, что встречаются программы, где по условиям партнерское вознаграждение начисляется сразу, тогда у события бывает только один статус validated (статусы waiting или cancelled отсутствуют, в том числе может быть не передан <obj_id>, т.к. нет необходимости отслеживать его дальнейшие статусы).


Полная документация по API доступна по ссылке http://mixmarket.biz/images/docs/9_240_api.doc

_________________
Дарья Орлова, odaria@mixmarket.biz
Партнерская сеть Миксмаркет

Вернуться к началу
 Профиль  
 
Показать сообщения за:  Поле сортировки  
Начать новую тему Ответить на тему
 [ 1 сообщение ] 

   Похожие темы   Ответы   Автор   Просмотры   Последнее сообщение 
В этой теме нет новых непрочитанных сообщений. Всё ли в порядке с системой учёта заказов и покупок сегодня?

в форуме Микс-Товары

1

orass

5628

03 авг 2006, 15:40

Пырков Олег Перейти к последнему сообщению

В этой теме нет новых непрочитанных сообщений. Ютинет: оплата % с доставленных и оплаченных заказов

в форуме Микс-Юни

12

mixmarket

23213

07 мар 2014, 10:34

mixmarket Перейти к последнему сообщению

В этой теме нет новых непрочитанных сообщений. Какое кол-во заказов можно получить в месяц?

в форуме Микс-Юни

0

odezhkin

2569

09 ноя 2013, 00:32

odezhkin Перейти к последнему сообщению

В этой теме нет новых непрочитанных сообщений. Brandage.ru: оплата доставленных заказов (CPS)

в форуме Микс-Юни

1

mixmarket

4111

11 сен 2013, 07:44

mixmarket Перейти к последнему сообщению

В этой теме нет новых непрочитанных сообщений. KupiVip: оплата подтвержденный заказов. (CPS)

в форуме Микс-Юни

0

mixmarket

3851

27 сен 2012, 14:28

mixmarket Перейти к последнему сообщению



Вы не можете начинать темы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете добавлять вложения


О проекте Новости Пресса о нас Сотрудничество Вакансии Контакты
2005–2011 Партнерская сеть Миксмаркет
Разработка сайта — iji-design / AdLabs
Powered by phpBB Group