Affilead API — инструмент для паблишеров Affilead, у которых есть свой сайт, браузер или браузерное расширение.
Благодаря Affilead API пользователи будут переходить по вашей ссылке прямо на сайт еля без редиректа на сайт партнерской сети. В результате больше целевых действий будут отслеживаться и попадают в статистику.
Вы можете найти Affilead API в разделе «Инструменты».
Для кого подойдет Affilead API
Вы можете использовать Affilead API, если:
- ваша площадка — кешбэк-сервис, браузер или браузерное расширение, дропшиппинг-платформа, витрина, купонный сервис или программа лояльности, поисковик, мобильное приложение;
- вы направляете пользователя на внутреннюю страницу, с которой происходит редирект на сайт бренда;
- у вас есть опыт работы с Affilead API или в команде есть технический специалист.
Если у вас площадка другого типа, но вы можете вносить изменения в ее код, обратитесь в поддержку Affilead или к своему менеджеру для настройки инструмента.
В чем польза инструмента
Affilead API позволяет исключить редирект на сайт партнерской сети и случайную блокировку.
На схеме показан процесс работы по стандартной модели и через Affilead API.
Обычно при переходе по партнерской ссылке пользователь проходит цепочку редиректов: ссылка → сайт Affilead → сайт бренда.
Редирект на сайт Affilead выполняется браузером в фоновом режиме, поэтому пользователь не видит перехода. В этот момент в ссылку добавляются метки, которые позволяют отслеживать данные о целевом действии.
В некоторых случаях эти данные могут теряться, например, если редирект блокируется браузером, блокировщиком рекламы или антивирусом. В результате часть переходов и целевых действий не отслеживается, что снижает конверсию.
Благодаря Affilead API пользователь сразу попадает на сайт бренда без редиректа на сайт партнерской сети, при этом параллельно происходит отслеживание целевых действий. Это позволяет избежать потери дохода из-за блокировщиков рекламы.
Работа c Affilead API
Как работает Affilead API
Логика работы Affilead API представлена на схеме.
1. Пользователь нажимает на ссылку товара, которая ведет на страницу редиректа на вашем сайте. В этот момент вы отправляете серверный запрос в Affilead согласно инструкции Как настроить Affilead API.
2. Affilead регистрирует клик и отвечает JSON-массивом со ссылкой на страницу товара на сайте бренда. Ссылка содержит все необходимые параметры для отслеживания целевых действий.
3. Вы извлекаете эту ссылку из массива и направляете по ней пользователя. Для него в этот момент будет происходить видимый редирект на сайт бренда.
Как настроить Affilead API
1. Определите партнерские ссылки Affilead, которые нужно преобразовать.
Кроме affid.ru, поддерживаются все трекинговые домены Affilead, например, afflt.ru, aflid.ru, afled.ru и affld.ru.
Пример: https://afflt.ru/g/b7e165239416525dc3e8/
2. Замените часть ссылки ‘/g/' на '/tptv2/'.
Пример: https://afflt.ru/tptv2/b7e165239416525dc3e8/
3. Добавьте к ссылке следующие параметры:
| Название параметра | Описание параметра |
|
user_agent (url-encoded) обязательный |
Нужен для того, чтобы Affilead исключал ботовый трафик с ваших площадок (например, от краулеров поисковых систем) и не показывал его в вашей статистике. Особенности При отправке запроса в Affilead API:
|
|
referer (url-encoded) обязательный |
Помогает в диагностике проблем с отслеживанием действий и в решении спорных ситуаций с брендом.ОсобенностиПри отправке запроса в Affilead API:
|
|
ip_addr (url-encoded) обязательный |
Нужен, чтобы:
Важно: передавать нужно именно IP-адреса посетителей вашей площадки, которые кликнули по ссылке, ведущей на сайт бренда. Не передавайте в качестве этого параметра IP-адрес вашего сервера. |
Пример ссылки со всеми параметрами:
https://afflt.ru/tptv2/b7e165239416525dc3e8/?ip_addr=0.0.0.0&user_agent=Chrome&referer=https%3A%2F%2Fwww.google.com&subid1=2&subid2=3&subid3=4&subid4=5
4. Вместо редиректа отправьте GET-запрос с вашего сервера на сервер Affilead.
Affilead ответит JSON-массивом со ссылкой на бренд:
[
"redirect_url"
]
Пример ссылки redirect_url:
https://www.advertiser.com?click_id=b8b3fba19a9d6788408610c627f5045e&publisher_id=ade12ba19a9d6788408610c627f5045e
5. Извлеките ссылку из массива и направьте по ней пользователя.
Как протестировать Affilead API
Чтобы убедиться, что отслеживание целевых действий работает корректно, сделайте тестовый заказ. Действие должно появиться у вас в статистике.
По некоторым офферам действия могут появляться в статистике с задержкой до 24 часов.
Ограничения и возможные ошибки
- Если в запросе битая ссылка, в ответе будет адрес страницы-заглушки (dummy).
- Ошибка с сообщением {"%Parameter name% is required"}.
1. Если в запросе вы передаете битую партнерскую ссылку, в ответе будет адрес страницы-заглушки (dummy) в следующих случаях:
- вы или бренд решили прекратить сотрудничество и отключили площадку от оффера;
- оффер приостановлен;
- в партнерской ссылке есть ошибка.
Рекомендуем все равно отправлять пользователя по ссылке dummy, но отслеживать такие переходы в разделе «Битые ссылки». При необходимости исправьте ошибку в партнерской ссылке или перенаправьте трафик на офферы, к которым подключена ваша площадка.
2. При попытке запроса к офферу в ответе приходит ошибка с сообщением {"%Parameter name% is required"}.
Если вы получили такую ошибку, проверьте, что добавили в запрос все обязательные параметры из таблицы. Если нет, добавьте недостающие параметры и повторите запрос.
Если вы не можете передать в запросе ip_addr, то примените последовательный редирект на стандартный адрес (замените ‘/tptv2/’ обратно на ‘/g/’).
Affilead API будет пропускать такие ссылки, и трафик по ним будет проходить через классический редирект.
FAQ по работе Affilead API
- Почему по некоторым офферам я вижу редиректы даже с использованием Affilead API?
- Дополнительное обращение к Affilead не повлияет на работу моей площадки и скорость отображения нужной страницы для пользователя?
- Что будет, если пользователь повторно перейдет по ссылке, сохранив ее в закладках, или из истории браузера?
- Использование инструмента Affilead API влияет на время жизни cookie?
Почему по некоторым офферам я вижу редиректы даже с использованием Affilead API?
В некоторых офферах редирект может происходить не на сайт бренда, а на его внутреннюю платформу для отслеживания целевых действий, после которой будет еще один редирект. В дальнейшем мы планируем настроить отслеживание таким образом, чтобы во всех случаях вести пользователя сразу на конечный адрес бренда.
Дополнительное обращение к Affilead не повлияет на работу моей площадки и скорость отображения нужной страницы для пользователя?
Дополнительное обращение занимает десятки миллисекунд, поэтому работа инструмента Affilead API практически не отличается от обычной работы с партнерскими ссылками. Наш сервер готов принимать нагрузку, аналогичную той, что была при кликах без использования инструмента.
Что будет, если пользователь повторно перейдет по ссылке, сохранив ее в закладках, или из истории браузера?
Если пользователь повторно перейдет на сайт бренда по ссылке Affilead API, которую запомнил его браузер:
- повторный клик не будет засчитан;
- целевые действия будут засчитаны вам в течение срока жизни Postclick Cookie (его можно найти на странице оффера);
- срок жизни Postclick Cookie будет отсчитываться от оригинального (первого) клика.
Нет, период времени, в течение которого пользователь будет привязан к офферу после первого перехода по вашей ссылке, остается прежним.