При S2S интеграции оффера сервер рекламодателя отправляет через postback URL запрос с данными о совершенных на сайте рекламодателя (лендинге, приложении, и т.д.) целевых действиях серверу HOQU. Сервер HOQU получает эти данные, и они появляются в статистике платформы.

Особенности:

Изменения в интерфейсе сайта не затрагивают отправку запросов через postback
Для реализации решения необходим доступ к серверной части сайта или CRM (back-end) на стороне рекламодателя
Можно полностью автоматизировать обновление данных

Механизм работы партнерской ссылки

В ходе работы с партнерской программой вебмастер размещает на своей площадке партнерскую ссылку. Партнерская ссылка генерируется на основании ссылки, ведущей на ваш сайт (лендинг, приложение, и т.д.) и содержащей необходимые вам и HOQU платформе GET-параметры и UTM-метки.
Один из GET-параметров обязательно должен передавать значение click_id— уникального идентификатора, который генерируется на стороне платформы HOQU в момент перехода пользователя по ссылке.

Пример ссылки после перехода по партнерской ссылке:

https://site.com/?click_id=c7e2206f-03af-49fa-9046-dd6aeaa44e9b

Значение click_id необходимо получить из GET-параметра на входе пользователя на сайт и сохранить его на (как правило) 30 дней в cookies у пользователя. Параметр click_id настраивается при создании оффера:



После вам нужно связать click_id с целевым действием пользователя и записать в свою базу данных (базу данных рекламодателя). Далее, рекламодателю, необходимо передать значение click_id в postback-запросе, а также следующие обязательные параметры (для модели CPA с фиксированной выплатой):

request_id - уникальный ID на стороне Рекламодателя
action - имя действия в разделе “Выплаты”, указанное в карточке оффера
status - статус конверсии: hold, approved, rejected

Соответствие статусов конверсий

Для статуса HOLD: shipped, processing, accepted, waiting, open, new, pending.
Для статуса APPROVED: confirmed, confirm, paid, completed, sold, delivered.
Для статуса REJECTED: returned, canceled, cancelled, archived, refunded, cancel, archive, refund, spam, error, wrong, test, declined.

Краткие шаги интеграции на сайте Рекламодателя:

Реализация алгоритма создания cookie и записи значения click_id
Реализация алгоритма чтения click_id из cookie и записи в базу данных рекламодателя вместе с целевым действием пользователя
Реализация механизма отправки postback-запросов с сервера Рекламодателя на сервер HOQU
Тестирование - при помощи проведения тестовых лидов (подробнее об этом ниже в разделе “Порядок тестирования”).

Механизм отправки postback-запросов

Рекламодатель может отправить запросы, для того чтобы:

Сообщить платформе о новой конверсии (пользователь совершил целевое действие, но оно пока не подтверждено / отклонено рекламодателем). “status” = “hold”, в случае неподтвержденного лида “status” = “rejected”, в случае отклоненного рекламодателем лида.
Обновить статус конверсии лида на платформе. Если рекламодатель хочет отправить подтвержденный либ, то в параметре “status” необходимо прописать “approved”.

Запросы индивидуальны для каждого оффера. В зависимости от различных типов выплат данные, которые нужно передавать в postback-запросы, различны.

Обязательные параметры для CPA модели с фиксированной выплатой: click_id, request_id, action, status.
Обязательные параметры для CPA модели с процентной выплатой: click_id, request_id, action, status, price.
Обязательные параметры для модели выплаты Recurring payments (модель, при которой один и тот же клиент делает регулярные / периодические платежи):

Для добавления клиента.
customer_id - уникальный идентификатор клиента в системе рекламодателя
click_id - уникальный ID клика, который Сеть передает Рекламодателю, только для S2S интеграции
price - обязательный параметр только для выплат с типом оплаты Процент
status - activate или deactivate
Для добавления лида: click_id, request_id, action, status, customer_id.

Для того чтобы передавать дополнительные параметры вы можете настроить шаблон. Шаблоны postback-запросов настраиваются в разделе “Офферы” - “Шаблоны”:



Не забудьте выбрать Статус “Активный” для активации шаблона.
Далее созданный шаблон можно добавить в разделе “Выплаты” при создании и редактировании оффера. Для этого выберете модель оплаты, созданный ранее шаблон и заполните / отредактируйте другие параметры.



Сообщить платформе о новой конверсии

Для того чтобы сообщить платформе HOQU о новой конверсии, нужно отправить POST или GET-запрос.

Пример POST-запроса:

POST /api/v1/postback HTTP/1.1
Host: https://trackerdomain.com/advertiser_api_key
Content-Type: application/json
{
"click_id": "c7e2206f-03af-49fa-9046-dd6aeaa44e9b",
"request_id": "94583",
"action": "lead",
"price": 30,
"status": “hold”.
}


Пример GET-запроса:

https://trackerdomain.com/advertiser_api_key/s2s?click_id=c7e2206f-03af-49fa-9046-dd6aeaa44e9b&request_id=12345&action=lead&price=30&status=hold

В примерах передаются следующие данные:
click_id - GET-параметр click_id, который рекламодатель записывает в базу данных вместе с информацией о заявке пользователя.
request_id - уникальный идентификатор конверсии в вашей базе данных. Рекламодатели генерируют идентификатор у себя и подставляют в postback-запрос.
По нему будут автоматически исключаться дубли, и подтверждаться / отклоняться конверсии, а также можно будет провести ручную сверку.
price - сумма, которую клиент(рекламодатель) заплатил за лид. Рекламодатель должен передать полную сумму заработка с лида, без вычета каких-либо комиссий, весь расчет и распределение с учетом комиссий производится на стороне платформы. Данное поле обязательно только для тарифов, в которых партнерская сеть получает процент от стоимости заказа приведенного пользователем клиента.

Обновить статус заявки на платформе

Для того чтобы обновить статус заявки на платформе, нужно отправить GET-запрос, передав в него параметр status с одним из значений:

approved - подтверждён
rejected - отклонён

Рекламодатель может сразу передавать финальный статус лида в случае оплаты или отказа.
Пример GET-запроса, чтобы обновить статус на подтверждён:

https://trackerdomain.com/advertiser_api_key/s2s?click_id=c7e2206f-03af-49fa-9046-dd6aeaa44e9b&request_id=12345&action=lead&price=30&status=approved

Пример GET-запроса, чтобы обновить статус на отклонен:

https://trackerdomain.com/advertiser_api_key/s2s?click_id=c7e2206f-03af-49fa-9046-dd6aeaa44e9b&request_id=12345&action=lead&price=30&status=rejected

Где найти postback, pixel, Iframe



Порядок тестирования

После того как вы настроите алгоритм отправки postback-запросов с сервера, сделать тестовый лид можно двумя способами:
- Вы можете самостоятельно создать тестового вебмастера на hoqu.com, подключиться с аккаунта этого вебмастера к своему офферу, получить партнерскую ссылку и сделать тест. О том, как создать учетную запись вебмастера, читайте в этой статье - https://hoqu.crisp.help/ru/article/dobavlenie-veb-mastera-iz-interfejsa-seti-1o1vy8e/

- Также вы можете попросить менеджера HOQU отправить вам тестовую ссылку.
Интеграция успешно завершена, в случае если вы увидели конверсию в разделе Отчеты.
Если вы не увидели конверсию, перейдите в раздел “Логи” -> “Входящие постбеки” и проанализируйте ошибку при отправке неверного запроса.



Если анализ ошибки не помог вам провести успешный тест, обращайтесь к своему менеджеру HOQU.
Была ли эта статья полезна?
Отменить
Спасибо!