Получение статусов лидов по API является оптимальным вариантом работы. Если работа по API невозможна, вы можете использовать постбеки из целевой сети для получения статусов.
За работу постбеков отвечает функция status приложения comp. Вы можете ознакомиться с её полной документацией внутри своей сети. Мы рассмотрим её сокращённую версию, оптимальную для выгрузки данных.
Ссылку постбека и его готовый образец вы можете получить по кнопке "Интеграция" в разделе управления компаниями. Воспользуйтесь ссылкой из поля "Начните постбек с" и добавьте к ней необходимые вам параметры. Обязательными параметрами являются идентификатор заказа и его статус.
Идентификатор заказа
Вы можете использовать один из двух параметров для идентификации заказа:
oid- ваш внутренний идентификатор заказа. Вам предварительно нужно отправить его в один из SubID в сети.eid- идентификатор заказа на стороне целевой сети. Вам предварительно необходимо получить его при отправке заказа в сеть.
Статус заказа
Статус заказа должен передаваться в параметр status в произвольном виде. Система автоматически распознает статус по хитрым алгоритмам.
Автоматическое распознавание статуса подойдёт для большинства случаев. Но вы можете воспользоваться дополнительными параметрами, чтобы сообщить системе, какой статус считать подтверждённым заказом, а какой - отменой.
sta- статус или список статусов подтверждения заказа.stc- статус или список статусов отмены заказа.stt- статус или список статусов невалидных заказов (треш).stw- статус или список статусов заказов в ожидании и колл-центре.sth- статус или список статусов заказа в холде.
Важно! Статус "холд" в AlterCPA - это не статус ожидания! Данный статус используется для отложенного подтверждения заказов. Например, для заказов, по которым уже получено согласие покупателя, но ещё не прошла выплата. Не используйте этот статус для ожидающих заказов!
Пример указания особых статусов:
status={status}&sta=lead_approved&stc=lead_cancelled&stt=lead_trash
Дополнительные параметры
Эти параметры не являются обязательными:
comment- текстовый комментарий к заказу.wm- сумма отчислений по заказу, устанавливает отчисление для веб-мастер и рекламодателя, использует механизм "Ручных отчислений".pay- сумма отчисления для рекламодателя, не влияет на отчисление веб-мастер.cc- ISO-код валюты отчисления.base- сумма чека (не отчисления!) по заказу.currency- ISO-код валюты заказа (не отчисления!).
Примеры постбеков
Простой постбек с указанием внутреннего ID и статуса:
https://domain.ru/api/comp/status.json?id=123-abc&oid={subid}&status={status}
Постбек с использованием внешнего ID заказа:
https://domain.ru/api/comp/status.json?id=123-abc&eid={order_id}&status={status}
Постбек с использованием особых статусов для аппрува:
https://domain.ru/api/comp/status.json?id=123-abc&oid={subid}&status={status}&sta=completed,finished,done
Постбек с указанием суммы и валюты отчисления для рекламодателя:
https://domain.ru/api/comp/status.json?id=123-abc&oid={subid}&status={status}&pay={payout}&cc={currency}