Admitad Teleport

  • Обновлено

Admitad Teleport — инструмент для веб-мастеров Admitad Affiliate, у которых есть свой сайт, браузер или браузерное расширение.

Благодаря Teleport пользователи будут переходить по вашей ссылке прямо на сайт рекламодателя без редиректа на сайт партнерской сети. В результате больше целевых действий будут отслеживаться и попадать в статистику.

Admitad Teleport можно найти в верхнем меню личного кабинета в разделе «Инструменты».
 

Для кого подойдет Admitad Teleport

На данном этапе Admitad Teleport могут использовать только веб-мастера со следующими типами площадок:

  • веб-сайт — кэшбек-сервис, форум, персональный блог, сайты с отзывами и рекомендациями, новостной или информационный портал, купонный сервис, витрина, программа лояльности, поисковик, дропшип-платформа;
  • мобильное приложение;
  • браузер или браузерное расширение.

Если у вас площадка другого типа, но вы можете вносить изменения в ее код, обратитесь в техподдержку или к своему менеджеру, чтобы уточнить возможность настройки инструмента.

Admitad Teleport не поддерживает работу с программами Third-Party Advertisers, а также ссылками, которые получены в расширении Admitad Extension на вкладке Lite или с помощью инструмента MoneyLink.

В чем польза инструмента

Admitad Teleport позволит исключить редирект на сайт партнерской сети и случайную блокировку

На схеме отражен процесс работы по стандартной модели и при работе через Admitad Teleport. Описание представлено под схемой.

1_teleport-RU.png


Обычно при переходе по партнерской ссылке на вашей площадке пользователь проходит по цепочке редиректов: ссылка → сайт Admitad Affiliate → сайт рекламодателя.

Редирект на сайт Admitad Affiliate делает браузер в фоновом режиме, поэтому пользователь не видит перехода, но в этот момент в ссылку записываются метки, которые позволяют отследить данные о целевом действии.
В некоторых случаях эти данные могут теряться: например, когда переадресация «обрубается» браузером, блокировщиком рекламы или антивирусом.
В результате часть переходов и целевых действий не отслеживается, и конверсия падает.

Благодаря Admitad Teleport пользователь сразу попадает на сайт рекламодателя без редиректа на сайт партнерской сети, при этом параллельно происходит отслеживание целевых действий. В результате вы сможете не терять доход из-за блокировщиков рекламы.
 

Admitad Teleport поможет увеличить конверсию в условиях действия GDPR, ePrivacy и других политик защиты персональных данных

Со вступлением в силу всех правил GDPR и ePrivacy, а также их аналогов в других регионах, пользователь должен будет дать согласие на обработку данных на каждом сайте из цепочки редиректов. То есть и на вашем сайте, и на сайте Admitad Affiliate.
Это может привести к тому, что пользователи будут отказываться от передачи данных.

Т.к. Admitad Teleport исключает редирект на сайт партнерской сети, пользователю будет достаточно дать согласие на обработку данных только на вашем сайте.
Это поможет увеличить конверсию, когда наступит эпоха строгой приватности.
 

Как работать с инструментом

Сейчас есть 2 варианта настройки и использования Admitad Teleport:

Работа c Teleport Script

Содержание подраздела:

Кому подойдет Teleport Script

Настройка через скрипт подойдет вам, если:

  • ваша площадка — блог, форум, новостной или информационный портал, купонный сервис, витрина или программа лояльности;
  • партнерские ссылки размещены непосредственно в коде страницы, то есть на сайте не используются внутренние редиректы на них;
  • у вас нет разработчика для бэкенда (серверной части) сайта или нет возможности работать через Teleport API.
     

Как работает Teleport Script

Логика работы скрипта представлена на схеме. Под ней вы найдете описание всех шагов.

2_teleport-RU.png


1. После установки скрипт ищет все партнерские ссылки на сайты рекламодателей на вашей площадке и готовит их к замене в момент клика.

2. Когда пользователь кликает по ссылке, происходит фоновый запрос на специальные домены Admitad Affiliate, в котором:

  • передаются SubID и другие дополнительные параметры (если они указаны в ссылке); 
  • создается admitad_uid для дальнейшего отслеживания целевых действий.

3. Скрипт преобразует партнерские ссылки в целевые ссылки на сайт рекламодателя.

4. Скрипт сразу переадресует пользователя на сайт рекламодателя, без видимых браузеру редиректов на домен ad.admitad.com.

5. Рекламодатель принимает пользователя на свой сайт или на внутреннюю платформу для отслеживания целевых действий. При этом он сохраняет себе значения параметров из ссылки и использует их для отслеживания действий.
 

Как установить Teleport Script

1. Перейдите на страницу инструмента (меню → «Инструменты» → «Teleport») и в блоке «Через Script» нажмите «Настроить».

2. Выберите площадку, на которой вы хотите разместить скрипт.

3. Нажмите «Сгенерировать скрипт».

4. Скопируйте скрипт и разместите его на своем сайте перед закрывающим тегом </body>.

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

Admitad Affiliate не хранит коды сгенерированных вами скриптов.
Если вы не можете найти скрипт, который уже создавали, пройдите по процессу заново. Код для выбранной площадки получится таким же, как и при первой генерации.

Как сделать так, чтобы отдельные партнерские ссылки не преобразовывались при работе через Teleport Script
 

Как тестировать работу скрипта

При первой установке скрипта разместите его на странице без трафика, чтобы проверить, что ссылки преобразуются корректно.

Сделайте тестовый заказ, чтобы убедиться, что отслеживание целевых действий работает корректно. Действие должно появиться у вас в статистике.

По некоторым программам действия появляются в статистике с задержкой до суток.


Ограничения и возможные ошибки

  1. Скрипт не сможет преобразовать партнерские ссылки, которые перестали работать
  2. Скрипт временно не поддерживает партнерские ссылки некоторых партнерских программ
  3. Скрипт не сможет обработать ссылки, загруженные асинхронно после загрузки основной страницы
     

1. Скрипт не сможет преобразовать партнерские ссылки, которые перестали работать

В случаях, когда:

  • вы или рекламодатель решили прекратить сотрудничество и отключили площадку от партнерской программы;
  • работа программы приостановлена;
  • в партнерской ссылке есть ошибка;

скрипт перенаправит пользователя на адрес страницы-заглушки dummy.

Отслеживайте такие ошибки в разделе «Битые ссылки». Исправьте партнерские ссылки или перенаправьте трафик на те программы, к которым подключена ваша площадка.
 

2. Скрипт временно не поддерживает партнерские ссылки некоторых партнерских программ

Список таких программ все время меняется. Мы работаем над доступностью инструмента Teleport для всех интеграций, поэтому программа может появляться и пропадать из списка ограниченно поддерживаемых.
Как узнать, что программа временно не поддерживается Teleport

Вы все равно можете размещать партнерские ссылки на такие программы на своей площадке. Трафик по ним будет проходить через классический редирект, и действия все равно будут отслеживаться. 
 

3. Скрипт не сможет обработать ссылки, загруженные асинхронно после загрузки основной страницы

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

Для работы Teleport с такими ссылками вы можете вызвать функцию ADMITAD.pubtag.runAllPlugins() после загрузки контента.
 

Работа c Teleport API

Содержание подраздела:

Кому подойдет Teleport API

Настройка по API подойдет вам, если:

  • ваша площадка — кэшбек, браузер или браузерное расширение, дропшиппинг-платформа, витрина, купонный сервис или программа лояльности, поисковик, мобильное приложение;
  • вы ведете пользователя на внутреннюю страницу, с которой происходит редирект на адрес сайта рекламодателя;
  • у вас есть опыт работы с Admitad API, или в команде есть технический специалист.
     

Как работает Teleport API

Логика работы Teleport API представлена на схеме. Под ней вы найдете описание всех шагов.

3_teleport-RU.png


1. Пользователь кликает на ссылку товара, которая ведет на страницу редиректа на вашем сайте. В этот момент вы отправляете в Admitad Affiliate серверный запрос, согласно инструкции ниже.

2. Admitad Affiliate регистрирует клик и отвечает JSON-массивом со ссылкой на страницу товара на сайте рекламодателя. Ссылка будет содержать все необходимые параметры для отслеживания целевых действий.

3. Извлеките эту ссылку из массива и направьте по ней пользователя. Для него в этот момент будет происходить видимый редирект на сайт рекламодателя.
 

Как настроить Teleport API

1. Определите партнерские ссылки Admitad Affiliate, которые нужно преобразовать.

Помимо ad.admitad.com, поддерживаются все трекинговые домены Admitad Affiliate, кроме сокращателей ссылок (например, fas.st или ali.ski).

Пример ссылки: https://ad.admitad.com/g/1e8d114494b7e165239416525dc3e8/

2. Замените часть ссылки ‘/g/’ на ‘/tptv2/’.

На примере ссылки выше: https://ad.admitad.com/tptv2/1e8d114494b7e165239416525dc3e8/

3. Добавьте к ссылке следующие параметры:

Название параметра Описание параметра
user_agent
(url-encoded)
обязательный

Нужен для того, чтобы Admitad Affiliate мог отсекать ботовый трафик с ваших площадок (например, от краулеров поисковых систем) и не показывать его в вашей статистике.

referer
(url-encoded)
обязательный

Поможет в диагностике проблем с отслеживанием действий и в решении спорных ситуаций с рекламодателем.

ip_addr
(url-encoded)
обязательный

Нужен, чтобы:

  • вам корректно начислялось вознаграждение по программам, в которых размер ставки зависит от страны пользователя;
  • вы могли работать с программами, в которых от страны пользователя зависит финальный URL сайта рекламодателя;
  • облегчить диагностику проблем с отслеживанием действий и помочь в решении спорных ситуаций с рекламодателем. 

Поскольку запрос по Teleport API будет поступать с вашего сервера, наша система не сможет самостоятельно определить страну пользователя. 

Важно: передавать нужно именно IP-адреса посетителей вашей площадки, которые кликнули по ссылке, ведущей на сайт рекламодателя. Не передавайте в качестве этого параметра IP-адрес вашего сервера.

Что делать, если вы не можете передавать параметр ip_addr

country_code
(двухбуквенный, в стандарте ISO 3166-1 alpha-2)
необязательный
Этот параметр может понадобиться для программ, в которых разрешен трафик только из одной или нескольких определенных стран.
Определить страну пользователя можно с помощью геосервисов, таких как MaxMind.
subid
(строка, макс. длина 50 символов, нельзя использовать сочетание «%00»)
необязательный
Передайте этот параметр, если хотите анализировать эффективность отдельно взятой ссылки или объявления. Можно передать до пяти разных SubID. Подробнее о SubID

 

Пример ссылки со всеми параметрами:

https://ad.admitad.com/tptv2/1e8d114494b7e165239416525dc3e8/?country_code=RU&ip_addr=0.0.0.0&user_agent=Chrome&referer=https%3A%2F%2Fwww.google.com&subid=1&subid1=2&subid2=3&subid3=4&subid4=5 

5. Вместо редиректа проведите GET-запрос с вашего сервера на сервер Admitad Affiliate.

По Teleport API допускаются только запросы с вашего сервера, запросы из браузера не пройдут проверку. Делайте запрос при каждом клике пользователя — нельзя хранить ответы в кэше.

6. Admitad Affiliate ответит JSON-массивом со ссылкой на рекламодателя:

[
"redirect_url"
]

Пример ссылки redirect_url:

https://www.advertiser.com?admitad_uid=b8b3fba19a9d6788408610c627f5045e&utm_source=admitad&utm_medium=affiliate

7. Извлеките ссылку из массива и направьте по ней пользователя.
 

Как тестировать работу Teleport API

Чтобы убедиться, что отслеживание целевых действий работает корректно, сделайте тестовый заказ. Действие должно появиться у вас в статистике.

По некоторым программам действия появляются в статистике с задержкой до суток.

Ограничения и возможные ошибки

  1. Если в запросе вы передаете битую партнерскую ссылку, в ответе будет адрес страницы-заглушки (dummy).
  2. При попытке запроса к партнерской программе в ответе приходит ошибка с сообщением {"%Parameter name% is required"}
  3. Teleport API временно не поддерживает партнерские ссылки некоторых программ.
     

1. Если в запросе вы передаете битую партнерскую ссылку, в ответе будет адрес страницы-заглушки (dummy)

В случае, когда: 

  • вы или рекламодатель решили прекратить сотрудничество и отключили площадку от партнерской программы;
  • работа программы приостановлена;
  • в партнерской ссылке есть ошибка; 

в ответе поступит адрес страницы-заглушки dummy.

Рекомендуем все равно отправлять пользователя по ссылке dummy, но отслеживать такие переходы в разделе «Битые ссылки». При необходимости исправьте ошибку в партнерской ссылке или перенаправьте трафик на те программы, к которым подключена ваша площадка.
 

2. При попытке запроса к партнерской программе в ответе приходит ошибка с сообщением {"%Parameter name% is required"}

В случае, если вы получили такую ошибку, проверьте, что вы добавили к запросу все обязательные параметры из этой таблицы, добавьте недостающие и повторите запрос.

Если вы не можете передать в запросе ip_addr, то примените последовательный редирект на стандартный адрес (замените ‘/tptv2/’ обратно на ‘/g/’).

Teleport API будет пропускать такие ссылки, и трафик по ним будет проходить через классический редирект.

Также вы можете заключить с Admitad Affiliate договор по обработке и передаче данных пользователей (Data processing Agreement). Он регулирует особенности обработки персональных данных пользователей и поможет гарантировать юридическую чистоту работы с Teleport API. Для этого создайте тикет в службу поддержки или обратитесь к своему персональному менеджеру.

3. Teleport API временно не поддерживает партнерские ссылки некоторых программ

В каталоге программ Admitad Store есть партнерские программы, которые временно не поддерживают работу по Teleport API. Список таких программ все время меняется.

Мы работаем над доступностью инструмента Teleport API для всех интеграций, поэтому программа может появляться и пропадать из списка ограниченно поддерживаемых. Как узнать, что программа временно не поддерживается Admitad Teleport

При попытке запроса по этим программам вы получите в ответ ошибку 403 и сообщение:

{"error": "teleport API response is currently not being supported for affiliate program id {campaign_id}"}

Где {campaign_id} — это ID партнерской программы.

Если ошибка возникает, залогируйте ее и направьте пользователя по стандартной партнерской ссылке (замените ‘/tptv2/’ обратно на ‘/g/’). Трафик по таким программам будет проходить через классический редирект, и действия все равно будут отслеживаться.

 

Согласие пользователей на передачу онлайн-идентификаторов

Если посетители вашего сайта попадают под законы о защите персональных данных GDRP/ePrivacy, то согласно пункту 9.6 Правил Admitad Affiliate для веб-мастеров при использовании инструмента Admitad Teleport вам необходимо получить их согласие на передачу онлайн-идентификаторов.

Также вы можете заключить с Admitad Affiliate договор по обработке и передаче данных пользователей (Data processing Agreement). Он регулирует особенности обработки персональных данных пользователей и поможет гарантировать юридическую чистоту работы с Teleport API. Для этого создайте тикет в службу поддержки или обратитесь к своему персональному менеджеру.
 

FAQ по работе Admitad Teleport 

Как узнать, что программа не поддерживается Teleport?

1. Скопируйте партнерскую ссылку программы и замените в ней параметр /g/ на /tptv2/. Как получить партнерскую ссылку

2. Перейдите по ссылке с /tptv2/ в браузере и проверьте результат загрузки.
Если программа временно не поддерживается, вы увидите следующее сообщение об ошибке:

{"error": "teleport API response is currently not being supported for affiliate program id {campaign_id}"}

Вместо {campaign_id} будет указан ID партнерской программы. 

Поддерживает ли Teleport работу с программами Third-Party Advertisers?

Нет, не поддерживает.

Нет, Admitad Teleport не может преобразовывать такие ссылки. 

Почему по некоторым программам я вижу редиректы даже с использованием Teleport?

В ряде программ переадресация может происходить не на сайт рекламодателя, а на его внутреннюю платформу для отслеживания целевых действий, после которой будет еще один редирект. В дальнейшем мы планируем настроить отслеживание таким образом, чтобы во всех случаях вести пользователя сразу на конечный адрес рекламодателя.
 

Дополнительное обращение к Admitad Affiliate не повлияет на работу моей площадки и скорость отображения нужной страницы для пользователя?

Дополнительное обращение занимает десятки миллисекунд, поэтому работа инструмента Teleport практически не отличается от обычной работы с партнерскими ссылками. Наш сервер готов принимать нагрузку, аналогичную той, что была при кликах без использования инструмента.
 

Что будет, если пользователь повторно перейдет по ссылке, сохранив ее в закладках, или из истории браузера?

Если пользователь повторно перейдет на сайт рекламодателя по ссылке Teleport, которую запомнил его браузер:

  • повторный клик не будет засчитан;
  • целевые действия будут засчитаны вам в течение срока жизни Postclick Cookie (его можно найти на странице программы);
  • срок жизни Postclick Cookie будет отсчитываться от оригинального (первого) клика.
     

Не будет ли проблем с антиспамом в партнерской программе AliExpress?

Нет, проблем не будет.
 

Нет, период времени, в течение которого пользователь будет привязан к программе после первого перехода по вашей ссылке, остается прежним.
 

Добавьте к ссылке в коде вашего сайта атрибут pubtag="0". Скрипт проигнорирует такую ссылку.

Пример: <a href="https://advertiser.com/" pubtag="0">Ссылка, которую не нужно преобразовывать</a>

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