1. Admitad
  2. Admitad Advertisers
  3. Рекламные инструменты

Уникальные промокоды

  • Обновлено

Уникальные промокоды — промокоды, закрепленные за конкретным веб-мастером.

Механизм работы

При использовании обычных промокодов атрибуция действий происходит по UID веб-мастера, который привел пользователя. Однако эта модель атрибуции не очень удобна, когда требуется предоставить особенный промокод одному или нескольким веб-мастерам: если другие веб-мастера скопируют кодовое слово и используют со своими партнерскими ссылками, действия после перехода по этим ссылкам будут засчитываться им, а не тем веб-мастерам, для которых промокод был предназначен изначально.

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

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

Порядок работы с уникальным промокодом

Настройте автоматическую отправку в зависимости от типа вашей интеграции:

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

2. Менеджер заводит уникальные промокоды и передает их веб-мастерам.

3. Веб-мастера размещают промокоды онлайн или офлайн.

4. Пользователь при оформлении заказа вводит промокод.

5. С вашей стороны на сторону Admitad Affiliate отправляются данные о заказе, в том числе код промокода.

6. На основании этого кода система присваивает заказ веб-мастеру, за которым закреплен промокод.

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

Передача данных по заказам с уникальными промокодами в Admitad Affiliate

Вы можете:

Автоматическая отправка заказов с уникальными промокодами

При интеграции через 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. При передаче заказа с обычным промокодом (неуникальным) используйте стандартную настройку дедупликации. 

Логика атрибуции

  • Уникальный промокод 1

Если у вас настроена интеграция через 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&currency_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. Отправьте заполненный файл своему менеджеру, чтобы он загрузил данные в систему.

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