Уникальные промокоды — промокоды, закрепленные за конкретным веб-мастером.
Механизм работы
При использовании обычных промокодов атрибуция действий происходит по UID веб-мастера, который привел пользователя. Однако эта модель атрибуции не очень удобна, когда требуется предоставить особенный промокод одному или нескольким веб-мастерам: если другие веб-мастера скопируют кодовое слово и используют со своими партнерскими ссылками, действия после перехода по этим ссылкам будут засчитываться им, а не тем веб-мастерам, для которых промокод был предназначен изначально.
В случае с уникальными промокодами действия присваиваются на основании значения уникального промокода, которое привязывается к конкретному веб-мастеру. UID при этом игнорируется. Таким образом, неважно, какие еще источники участвовали в приведении пользователя к конверсии, действие в любом случае будет засчитано веб-мастеру, которому принадлежит промокод.
Помимо прочего, такой механизм атрибуции позволяет веб-мастерам использовать уникальные промокоды офлайн, например, распространять в виде флаеров на мероприятиях.
Порядок работы с уникальным промокодом
Настройте автоматическую отправку в зависимости от типа вашей интеграции:
1. Вы присылаете аккаунт-менеджеру список промокодов и логинов веб-мастеров, для которых они предназначены.
2. Менеджер заводит уникальные промокоды и передает их веб-мастерам.
3. Веб-мастера размещают промокоды онлайн или офлайн.
4. Пользователь при оформлении заказа вводит промокод.
5. С вашей стороны на сторону Admitad Affiliate отправляются данные о заказе, в том числе код промокода.
6. На основании этого кода система присваивает заказ веб-мастеру, за которым закреплен промокод.
Для одного веб-мастера можно создать сколько угодно уникальных промокодов. Ограничение на общее количество промокодов для всех веб-мастеров также отсутствует.
Передача данных по заказам с уникальными промокодами в Admitad Affiliate
Вы можете:
- настроить автоматическую отправку данных в Admitad Affiliate;
- передавать данные в виде файла своему менеджеру.
Автоматическая отправка заказов с уникальными промокодами
- При интеграции через TagTag
- При интеграции через postback-запрос
- При интеграции через плагины
- При интеграции через XML
- При интеграции через API
При интеграции через TagTag
0. Ознакомьтесь с инструкцией «Интеграция через трекинг-код».
1. Убедитесь, что в форме оформления заказа на сайте присутствует поле «Промокод».
2. Запишите уникальный промокод из формы оформления заказа в параметр discountCode.
Пример кода
ADMITAD.Invoice.referencesOrder = ADMITAD.Invoice.referencesOrder || []; // добавление товарных позиций к заказу ADMITAD.Invoice.referencesOrder.push({ orderNumber: "{{order number}}", // внутренний номер заказа (не более 100 символов) discountCode: "{{promocode}}", // код уникального промокода orderedItem: orderedItem });
3. При передаче заказа с уникальным промокодом всегда устанавливайте значение параметра дедупликации «adm», т.к. этот заказ принадлежит Admitad Affiliate.
ADMITAD.Invoice.broker = "adm";
4. При передаче заказа с обычным промокодом (неуникальным) используйте стандартную настройку дедупликации.
Логика атрибуции
Если у вас настроена интеграция через GTM, процесс настройки будет отличаться. Подробнее об отправке уникальных промокодов через трекинг-код в GTM читайте здесь.
При интеграции через postback-запрос
0. Ознакомьтесь с инструкцией «Интеграция через postback-запрос».
1. Убедитесь, что в форме оформления заказа на сайте присутствует поле «Промокод».
2. Запишите уникальный промокод из формы оформления заказа в параметр promocode.
Имя параметра | Описание | Тип |
---|---|---|
promocode | код уникального промокода | строка, 255 символов |
Пример postback-запроса
https://ad.admitad.com/r?campaign_code=your_campaign_code&postback=1&postback_key=your_postback_key
&action_code=1&uid=03b374fa9c2f34069e8df0bda61b8627&order_id=123456&tariff_code=1¤cy_code=RUB
&price=50000&quantity=1&position_id=3&position_count=3&product_id=31&client_id=&payment_type=sale&promocode=admitad500
3. Убедитесь, что все заказы с уникальным промокодом отправляются в Admitad Affiliate.
В Admitad Affiliate заказ должен передаваться в следующих случаях:
- присутствует и admitad_uid, и уникальный промокод;
- присутствует только уникальный промокод;
- присутствует только admitad_uid.
В другие каналы информация о заказе с уникальным промокодом передаваться не должна.
При интеграции через плагины
На данный момент работа с уникальными промокодами поддерживается в Magento 1, 1C-Bitrix, WooCommerce и InSales. Для других плагинов функционал может быть добавлен по запросу.
При интеграции через XML
0. Ознакомьтесь с инструкцией «Интеграция через XML».
1. Убедитесь, что в форме оформления заказа на сайте присутствует поле «Промокод».
2. Запишите уникальный промокод из формы оформления заказа в параметр promocode.
Имя параметра | Описание | Тип |
---|---|---|
promocode | код уникального промокода | строка, 255 символов |
3. При наличии уникального промокода заказ должен быть включен в XML-выгрузку независимо от наличия admitad_uid.
В Admitad Affiliate заказ должен передаваться в следующих случаях:
- присутствует и admitad_uid, и уникальный промокод;
- присутствует только уникальный промокод;
- присутствует только admitad_uid.
При этом в другие каналы информация о заказе с уникальным промокодом передаваться не должна.
Пример XML-файла для заказа с уникальным промокодом
<?xml version="1.0" encoding="UTF-8"?> <payment_list version="2"> <payment> <uid>admitad_uid</uid> <order_id>15</order_id> <product_id>125</product_id> <tracking>Ручные инструменты - бензопила</tracking> <quantity>1</quantity> <currency_code>RUB</currency_code> <price>2000</price> <position_id>1</position_id> <payment_type>sale</payment_type> <action_code>1</action_code> <tariff_code>1</tariff_code> <position_count>1</position_count> <promocode>10OFF</promocode> </payment> </payment_list>
При интеграции через API
Убедитесь, что заказы с уникальным промокодом попадают в список заказов, доступных Admitad Affiliate по API.
В Admitad Affiliate заказ должен передаваться в следующих случаях:
- присутствует и admitad_uid, и уникальный промокод;
- присутствует только уникальный промокод;
- присутствует только admitad_uid.
В другие каналы информация о заказе с уникальным промокодом передаваться не должна.
Передача данных по заказу в виде xlsx-файла
Вы можете передавать данные по заказам с уникальными промокодами в виде файла.
1. Запросите шаблон файла для передачи заказов у своего менеджера.
2. Внесите в файл данные по заказам с уникальными промокодами:
Обязательные параметры:
- promocode — название промокода.
- price — сумма заказа.
Необязательные параметры:
- datetime_action — дата заказа в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС.
Если поле не заполнено, то в качестве даты заказа автоматически будет указана дата загрузки файла в систему. - order_id — id заказа.
Если поле не заполнено, при загрузке файла в систему будет автоматически сгенерирован уникальный order_id с меткой «UNIQUE_PROMOCODE».
Пример: Egc7VsFpuY-UNIQUE_PROMOCODE
3. Отправьте заполненный файл своему менеджеру, чтобы он загрузил данные в систему.