Интеграция: что это такое и как выбрать способ интеграции с Admitad

Что такое интеграция

Интеграция — это настройка совместной работы двух независимых систем: вашего сайта и/или приложения и платформы Admitad.

Интеграция с Admitad — обязательный этап для запуска партнерской программы, т.к. интеграция позволяет:

отслеживать целевые действия пользователей на вашем сайте и/или в приложении;
и отправлять зафиксированную информацию о действиях в систему Admitad.

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

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

Корректно настроенная интеграция позволяет регистрировать все целевые действия пользователей и правильно присваивать их веб-мастерам.

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

Подробнее об интеграции мобильных приложений читайте в этой статье.

Способы интеграции с Admitad

Вы можете выполнить интеграцию:

с помощью готовых плагинов — это наиболее быстрый способ для сайтов на базе SaaS или CMS-систем: WordPress, Shopify или 1C-Битрикс. Подробнее об интеграции через плагины
кастомным способом — эти способы подойдут для технически более сложных сайтов и приложений, поэтому для интеграции потребуется участие ваших разработчиков.
Доступна интеграция через postback-запрос, через трекинг-код, через XML, через Google Analytics API, через API вашего сайта или приложения. Подробнее о кастомных способах интеграции

Как приступить к выполнению интеграции

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

Если у вас есть личный менеджер, он добавит действия и тарифы за вас.
Если у вас нет менеджера, вам нужно самостоятельно добавить действия и тарифы в разделе «Действия» (Программа → Настройки трафика → Действия и вознаграждения) — инструкция по добавлению действий.

2. Определитесь со способом интеграции своего сайта и/или приложения с Admitad.

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

3. Затем в личном кабинете перейдите в раздел «Интеграция» (Программа → Интеграция) и нажмите «Далее».

4. Перейдите на одну из вкладок в зависимости от выбранного способа:

интеграция через плагины — если вам подходит интеграция через готовый плагин для сайта на базе CMS-системы: WordPress, Shopify или 1С-Битрикс;
кастомная интеграция — если вам подходит интеграция через postback-запрос, XML, трекинг-код или Google Analytics API.

5. Отметьте нужный способ и нажмите «Далее».

6. На следующей странице «Настройка интеграции» вы увидите блоки:

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

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

Инструкции по интеграции через плагины:

Инструкции по кастомным способам интеграции:

Как выбрать способ интеграции

Выбор способа интеграции зависит от технических особенностей вашего сайта.

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

Схема по выбору способа интеграции

Чтобы выбрать подходящий способ интеграции, определите:
вы планируете самостоятельно отправлять данные о целевых действиях с вашего сайта на сервер Admitad?

Если «Да»:
вы будете передавать данные с веб-сервера (back-end) или с сайта (front-end)?

Если с веб-сервера:
ваш сайт создан на платформе 1C-Битрикс, WordPress или Shopify?
- Если «Да» → выберите интеграцию через плагины.
- Если «Нет» → используйте интеграцию через postback-запрос.
Если с сайта → используйте интеграцию через трекинг-код.

Если «Нет», то Admitad будет получать данные о целевых действиях со своей стороны. У вас есть свой API?

Если «Да» → используйте интеграцию через API.
Если «Нет» → используйте интеграцию через XML или Google Analytics API.

Особенности и преимущества способов интеграции

Интеграция через плагины

Интеграция с помощью готовых плагинов — это самый быстрый и простой способ интеграции вашего сайта с Admitad.

Подойдет, если ваш сайт создан на базе одной из следующих платформ:

Преимущества:

Наиболее быстрый и доступный способ интеграции — для настройки и тестирования не требуется помощь разработчиков.

Недостатки:

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

Кастомная интеграция

В Admitad доступны следующие кастомные способы интеграции:

Для всех кастомных способов интеграции доступна настройка дедупликации и кросс-девайс трекинга.

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

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

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

Интеграция через postback-запрос

При интеграции через postback-запрос ваш сервер отправляет серверу Admitad postback-запрос с данными о целевых действиях, совершенных пользователями на вашем сайте.

Сервер Admitad получает эти данные и фиксирует их в статистике, на основании которой производится расчет с веб-мастерами.

Преимущества:

Postback-запрос обеспечивает безопасную передачу данных, так как содержит приватный ключ авторизации. При необходимости источник запроса можно узнать по логам.
Изменения на сайте (frond-end) не влияют на передачу данных о действиях, поскольку postback-запрос отправляется с сервера (back-end).

Недостатки:

Для реализации решения необходим доступ к серверной части сайта.

Подробнее об этом способе интеграции и его настройке читайте в статье «Интеграция через postback-запрос».

Интеграция через трекинг-код

При интеграции с помощью трекинг-кода на ваш сайт устанавливается JavaScript-код (трекинг-код), который срабатывает в момент совершения пользователем целевого действия. При этом информация о действии (код действия, номер заказа, код тарифа, сумма заказа и др.) фиксируется и отправляется на сервер Admitad.

Сервер Admitad регистрирует полученные данные в статистике, на основании которой производится расчет с веб-мастерами.

Преимущества:

Возможность редактировать трекинг-код при обновлении сайта.
Возможность тестировать интеграцию при помощи TagTag Check.
Трекинг-код не влияет на скорость загрузки сайта.

Недостатки:

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

Подробнее об этом способе интеграции и его настройке читайте в статье «Интеграция через трекинг-код».

Интеграция через XML

При интеграции через XML данные о целевых действиях пользователей экспортируются в XML-файл определенной структуры. К этому файлу с заданной периодичностью обращается сервер Admitad и выгружает данные по новым действиям из файла в статистику Admitad.

Преимущества:

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

Недостатки:

При увеличении очереди обработки XML-файла возможны задержки в появлении данных.

Подробнее об этом способе интеграции и его настройке читайте в статье «Интеграция через XML».

Google Analytics API

Если вы фиксируете данные о целевых действиях пользователей с помощью сервиса Google Analytics, то можно настроить интеграцию через Google Analytics API. При этом способе интеграции сервер Admitad получает данные о действиях с помощью GET-запроса к API сервиса Google Analytics.

Преимущества:

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

Недостатки:

Зависимость от сторонних решений и ограничений сервиса Google Analytics.
Отсутствие гибкой настройки для целевых действий и тарифов.
При работе по модели атрибуции Last Paid Click и без настройки резервной передачи данных — высокий процент неучтенных действий по сравнению с другими способами интеграции.

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

Подробнее об этом способе интеграции и его настройке читайте в статье «Интеграция через Google Analytics API».

Интеграция через API

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

Преимущества:

Возможность гибкой настройки условий сбора данных.
Минимальные доработки API с вашей стороны.
Возможность настроить дедупликацию действий и crossdevice-трекинг.

Недостатки:

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