Настройка автосверки через XML

  • Обновлено

Для настройки автосверки через XML вам нужно создать XML-файл с набором данных, описанным ниже, и передать ссылку на этот файл сотрудникам отдела трекинга Admitad Affiliate.

Они проверят, корректна ли структура файла, правильно ли передаются статусы и суммы заказов, проставят соответствующие настройки и сообщат вам о результате.

 

О том, что такое «сверка» и «автосверка», читайте в этой статье.

Конфиденциальность

Если вы хотите спрятать файл от лишних глаз, вы можете либо использовать HTTP Basic авторизацию для получения выгрузки (рекомендуем именно этот способ), либо просто шифровать имя файла, например: http://myshop.ru/23dvgdsfkl4tkerlgsfd.xml.

Частота обновления

Вам необходимо обновлять ваш файл хотя бы 1 раз в день, чтобы отдел трекинга мог сверять его с данными Admitad Affiliate.

Описание

Рекомендуемый срок хранения заказов в файле автосверки — 3 месяца.
Обязательно наличие «пространства имен» (namespace), которое у корневого элемента должно быть установлено в http://admitad.com/payments-revision.
Корневой элемент Payments может содержать любое количество элементов Payment. Каждый Payment должен иметь два обязательных дочерних элемента: OrderID и Status. Необязательные элементы: OrderAmount и Reward для случаев, когда нужно изменить сумму заказа или вознаграждения, а также Comment для указания причины отклонения заказа.

Некоторые возможные причины отклонения заказа:

  • Возврат
  • Не выкуплен
  • Некорректно заполнены данные
  • Отказ при получении

Обратите внимание:

  • Названия всех элементов чувствительны к регистру.
  • Недопустимы теги вида:
    <OrderAmount>None</OrderAmount> — несоответствие типа значения
    <Comment/> — пустые теги

Пример содержимого файла

Пример 1

Если вы хотите только подтвердить или отклонить действия, в файле обязательно должна присутствовать следующая информация:

Параметр Описание
OrderID Номер заказа
Status Статус заказа (1 – подтвержден, 2 – отклонен)
Comment В данном параметре вы можете передавать причину отклонения заказа (до 30 символов)
<Payments xmlns=”http://admitad.com/payments-revision”>
<Payment>
<OrderID>123456</OrderID>
<Status>2</Status>
<Comment>Отказ при получении</Comment>
</Payment>
</Payments>

Пример 2

Если вы хотите подтвердить действия и при этом изменить сумму заказа, чтобы система пересчитала вознаграждение для веб-мастеров, необходимо предварительно согласовать данную настройку с отделом трекинга. Данная настройка используется только в программах, в которых есть тариф «%».

Обязательная информация:

Параметр Описание
OrderID Номер заказа
Status Статус заказа (1 – подтвержден, 2 – отклонен)
Order amount Сумма заказа (дробное неотрицательное число, разделитель точка)
<Payments xmlns=”http://admitad.com/payments-revision”>
<Payment>
<OrderID>123456</OrderID>
<OrderAmount>1000</OrderAmount>
<Status>1</Status>
</Payment>
</Payments> 

Пример 3

Если вы хотите изменить вознаграждение веб-мастерa, вам необходимо предварительно согласовать данную настройку с отделом трекинга.

Обязательная информация:

Параметр Описание
OrderID Номер заказа
Status Статус заказа (1 – подтвержден, 2 – отклонен)
Reward Вознаграждение веб-мастера (дробное неотрицательное число, разделитель точка)
<Payments xmlns=”http://admitad.com/payments-revision”>
<Payment>
<OrderID>123456</OrderID>
<OrderAmount>1000</OrderAmount>
<Reward>100</Reward>
<Status>1</Status>
</Payment>
</Payments>

 

Получение информации по открытым заказам из Admitad Affiliate

Вы можете запросить у технического специалиста Admitad Affiliate ссылку на XML-выгрузку, из которой вы cможете получать информацию о том, какие действия сейчас открыты, т.е. по ним еще неизвестен статус.

Пример ссылки:
https://www.admitad.com/sid103584/ru/advertiser/advcampaign/5441/payments/xml_export/?uid=rksNfWrTIQesLvZ

Если вы захотите получать информацию по действиям только за определенный период, то можете добавить следующие параметры к ссылке:

start-date – дата, С которой делать выборку по заказам, iso формат (например, 2014-01-01)
end-date – дата, ПО которую делать выборку, iso формат (например, 2014-01-31)

и тогда ссылка будет выглядеть так:
https://www.admitad.com/sid103584/ru/advertiser/advcampaign/5441/payments/xml_export/?uid=rksNfWrTIQesLvZ
&start-date=2014-01-01&end-date=2014-01-31

Данную информацию вы сможете использовать для того, чтобы производить сверку по статусам заказов для конкретных действий, после чего передавать их Admitad Affiliate в файле автосверки.

Была ли эта статья полезной?