Інтеграція срм Бітрікс24 з CPA площадкою методом Postback

Доброго часу доби! Потрібна допомога в інтеграції срм бітрікс24 з cpa мережею LeadGid. Необхідно налаштувати передачу статусів заявки з срм на сра площадку.

Додаю тех. завдання.

Интеграция с помощью postback (или s2s, server-to-server).

Postback - механизм уведомления одной системой другую с помощью протокола HTTP(S). Когда происходит выполнение целевого действия, система рекламодателя отправляет на специальный URL HTTP запрос используя метод GET. Чтобы этот механизм работал, необходимо выполнить несколько этапов:

• передача и прием transaction_id в ссылке оффера;
• сохранение transaction_id для посетителя сайта рекламодателя;
• отправка postback;
• убедиться в успешной отправке postback.

Передачи и прием transaction_id.

transaction_id - уникальный идентификатор перехода по партнерской ссылке.

Договариваемся о названии параметра в котором будет осуществляться передача transaction_id на сайт рекламодателя. Мы со своей стороны можем назвать его как угодно. По-умолчанию используются: transaction_id, trans_id, tid, click_id.

<!--[if !supportLineBreakNewLine]-->

Сохранение transaction_id для посетителя сайта рекламодателя.

Система рекламодателя должна сохранять для каждого перехода из партнерской сети Leadgid соответствующий transaction_id. Способ реализации этого этапа выбирается и реализуется самостоятельно на стороне рекламодателя.

Отправка postback.

Шаблон URL в который будут подставляться необходимые параметры присылается нашим менеджером. Для каждого оффера он уникальный. При отправке в него подставляются необходимые параметры:

• transaction_id - уникальный id перехода;
• adv_sub - уникальный subid рекламодателя по которому будут производиться дальнейшие сверки;
• (опционально) format=json для получения ответа в виде json вместо plaintext.

Примеры ответов (формат json):

Постбек отработал без ошибок:

{

  "response": {

  "status_code": 43,

  "success": "true",

  "data": {

  "transaction_id": "1022904f665ba3cd69484db45839da"

  }

  }

}

Переданневерный/несуществующий transaction_id

{

  "response": {

  "status_code": 0,

  "success": "false",

  "error": "InvalidTrans. ID #TRANSACTIONID.",

  "data": {

  "transaction_id": "TRANSACTIONID"

  }

  }

}

Следует проверять значение success. Оно должно быть равно “true” ("success": "true").

Успешная отправка postback.

• Рекламодатель должен убедиться что postback был отправлен и обработан системой.
• При отправке постбека необходимо проверять http статус код ответа. Корректный запрос отвечает кодом 200. Любой другой должен расцениваться как ошибка отправки.
• Корректный запрос не означает, что переданные данные в постбеке были корректными. В примере с несуществующим transaction_id как раз показан этот случай.
• В случае получения статус кода отличного от 200 необходимо повторить отправку постбека.
• Интервал для повторной отправки можно выбрать равным 5 минутам.
• Крайне желательно вести лог отправки. Хороший лог содержит: SUBID рекламодателя, время отправки, URL постбека, код ответа, тело ответа.

Дополнительно. ID партнера.

В дополнение к transaction_id мы настраиваем передачу id нашего партнера (wmid, wm, webmaster т т.п.). Передавать его мы можем в параметре с любым названием. Его необходимо сохранять вместе с нашим transaction_id.