[ 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

5328

03 авг 2006, 15:40

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

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

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

12

mixmarket

22843

07 мар 2014, 10:34

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

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

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

0

odezhkin

2227

09 ноя 2013, 00:32

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

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

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

1

mixmarket

3774

11 сен 2013, 07:44

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

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

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

0

mixmarket

3538

27 сен 2012, 14:28

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



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


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