Настройка автосверки через 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 в файле автосверки.

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