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

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

2. Чтобы избежать перезаписи UTM-меток, необходимо провести аудит всех рекламных инструментов и скриптов, которые могут влиять на URL.

3. После настройки UTM-меток и устранения конфликтов важно интегрировать данные с аналитическими инструментами, такими как Google Analytics или Яндекс Метрика. 

Это позволит отслеживать не только количество переходов, но и конверсии, что особенно важно для оценки эффективности кампаний. 

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

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

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

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

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

Его задачи:

• убедиться, что маппинги статусов и типов оплат корректно настроены;

• что и сайт, и Адмитад готовы к обмену данными в нужном формате.

Заказчик также берет на себя ответственность за определение, от кого ожидаются дальнейшие действия. 

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

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

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

Сохранение рекламной метки

• Когда пользователь переходит на сайт по рекламной ссылке, в том числе через партнерскую сеть Admitad, система проверяет параметр "utm_source". Если значение utm_source равно adm, то в браузере пользователя создается кука, которая сохраняет эту рекламную метку из другого параметра "tagtag_uid" или "admitad_uid". 

• Кука действует в течение одного месяца с момента первого перехода. Это позволяет отслеживать пользователя в течение длительного периода, даже если он возвращается на сайт позже.

Идентификация пользователя

• Если пользователь возвращается на сайт в течение срока действия куки, система автоматически определяет, что он пришел с рекламного канала Admitad (по значению "utm_source=adm"), и учитывает это при формировании заказов.

Учет рекламного канала при заказе

• При оформлении заказа система проверяет наличие куки с рекламной меткой. Если кука присутствует и содержит значение "tagtag_uid" или "admitad_uid, заказ связывается с рекламным каналом Admitad.

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

Обновление рекламной метки

• Если пользователь переходит на сайт по новой рекламной ссылке, система проверяет параметр "utm_source". Если значение "utm_source" отличается от "adm", существующая кука удаляется, и новая кука не создается.

• Если значение "utm_source" равно "adm", то старая кука (если она была) заменяется новой.

Удаление куки

Кука удаляется в следующих случаях:

• После успешного оформления заказа.

• Если пользователь переходит по ссылке с параметром "utm_source", отличным от "adm".

use Bitrix\Main\EventManager;


$eventManager = EventManager::getInstance();


$eventManager->addEventHandlerCompatible(
   'main',
   'OnPageStart',
   [Admitad\Helpers::class, 'checkCookie']
);

namespace Admitad;


use Bitrix\Main\Loader;
use Bitrix\Main\Application;
use Bitrix\Main\Context;
use Bitrix\Main\Web\Cookie;


use O2k\Config\Settings;


Loader::includeModule('o2k.settings');


class Helpers
{

   const COOKIE_NAME = 'ADMITAD_UID'; // название куки и код свойства заказа

   const URL_SEND = 'https://ad.admitad.com/r';

   public static function getPostBackKey()
   {
       $settings = new Settings();
       return $settings->getByCode('ADMITAD_POSTBACK_KEY');
   }

   public static function getCampaignCode()
   {
       $settings = new Settings();
       return $settings->getByCode('ADMITAD_CAMPAIGN_CODE');
   }

   public static function getCookie()
   {

       return Application::getInstance()->getContext()->getRequest()->getCookie(self::COOKIE_NAME);
   }

   public static function checkCookie()
   {
       $request = Context::getCurrent()->getRequest();
       $uid = $request->get('admitad_uid') ?? $request->get('tagtag_uid');
       $source = $request->get('utm_source');

       if ($source == 'adm') {
           self::setCookie($uid);
       } else if ($source && $source !== 'adm') {
           self::clearCookie();
       }
   }

   public static function setCookie($val)
   {
       if($val !== self::getCookie()) {
   
           $cookie = new Cookie(self::COOKIE_NAME, $val, time() + 3600 * 24 * 30);
           $cookie->setDomain(Application::getInstance()->getContext()->getServer()->get('SERVER_NAME'));
           $cookie->setPath('/');
           $cookie->setSecure(false);
           $cookie->setHttpOnly(false);
           $cookie->setSpread(Cookie::SPREAD_DOMAIN);

           Context::getCurrent()->getResponse()->addCookie($cookie);
       }
   }

   public static function clearCookie(){

       $cookie = new Cookie(self::COOKIE_NAME, 'clear', time() - 3600);
       $cookie->setDomain(Application::getInstance()->getContext()->getServer()->get('SERVER_NAME'));
       $cookie->setPath('/');
       $cookie->setSecure(false);
       $cookie->setHttpOnly(false);
       $cookie->setSpread(Cookie::SPREAD_DOMAIN);

       Context::getCurrent()->getResponse()->addCookie($cookie);
   }
}

use Bitrix\Main\EventManager;

$eventManager = EventManager::getInstance();

$eventManager->addEventHandler(
   'sale',
   'OnSaleOrderBeforeSaved',
   [Admitad\Bus::class, 'onBeforeSaveOrderHandler']
);

$eventManager->addEventHandler(
   'sale',
   'OnSaleOrderSaved',
   [Admitad\Bus::class, 'onSaveOrderHandler']
);

namespace Admitad;

use Bitrix\Main\ArgumentException;
use Bitrix\Main\ArgumentNullException;
use Bitrix\Main\ArgumentOutOfRangeException;
use Bitrix\Main\Event;
use Bitrix\Main\NotImplementedException;
use Bitrix\Main\ObjectPropertyException;
use Bitrix\Main\SystemException;
use Bitrix\Sale\BasketItem;
use Bitrix\Sale\Order;
use Bitrix\Sale\Internals;

use Logger\Logger;

class Bus
{
   /**
    * @var Order|null
    */
   protected Order $order;
  
   protected string $activationCode;
   /**
    * @var array
    */
   public array $coupons = [];
   /**
    * @var string|null
    */
   protected $uid = null;
   /**
    * @var int
    */
   public $index = 0;
   /**
    * @var Logger
    */
   protected $logger;
   /**
    * @var int
    */
   protected $countItems;

   const DEBUG = false;

   public function __construct(int $orderId)
   {
       $this->logger = new Logger('admitad/'.date('Y-m-d').'.log');

       $this->order = Order::load($orderId);
       $this->uid = Helpers::getCookie();

       $this->getActionCode();
       $this->getCoupon();

       $this->countItems = count($this->order->getBasket());
   }

   public function sendOrder(): bool
   {
       try {
           foreach ($this->order->getBasket() as $index => $item) {
               $this->index = $index + 1;
               $params = $this->getParamsOrder($item);
               $this->addPromocode($params);
               $this->sendPosition($params);
           }
       } catch (Exception|\Error $e) {

           $this->logger->error(json_encode([
               'method' => __METHOD__,
               'line' => __LINE__,
               'message' => $e->getMessage(),
               'trace' => $e->getTrace()
           ]));

           return false;
       }

       return true;
   }

   private function addPromocode(&$params)
   {
       if($this->coupons) {
           $coupons = $this->coupons;
           $params['promocode'] = array_shift($coupons);
       }
   }

   private function sendPosition(array $params)
   {
       $curl = curl_init();
       curl_setopt_array($curl, [
           CURLOPT_URL => Helpers::URL_SEND . '?' . http_build_query($params),
           CURLOPT_RETURNTRANSFER => true,
           CURLOPT_HEADER => false,
           CURLOPT_SSL_VERIFYPEER => false,
           CURLOPT_SSL_VERIFYHOST => false,
       ]);
       curl_exec($curl);
       $info = curl_getinfo($curl);
       $error = curl_error($curl);
       curl_close($curl);

       if($info['http_code'] != 200) {
           $this->logger->error(json_encode([
               "info" => $info,
               "error" => $error,
           ]));
       } else {
           $this->logger->info("Заказ ".$this->order->getId()." позиция ".$params["position_id"].' товар ID '.$params['product_id']);
       }

       if(self::DEBUG) {
           $this->logger->debug("Заказ " . $this->order->getId() . ' ссылки ' . json_encode($params));
           $this->logger->debug("Ссылка " . Helpers::URL_SEND . '?' . http_build_query($params));
       }
   }


   private function getParamsOrder(BasketItem $basketItem): array
   {
       $fields = $basketItem->getFields()->getValues();
       return [
           'postback' => '1',
           'tariff_code' => '1',
           'payment_type' => 'sale',
           'postback_key' => Helpers::getPostBackKey(),
           'campaign_code' => Helpers::getCampaignCode(),
           'uid' => $this->uid,
           'position_count' => $this->countItems,
           'position_id' => $this->index,
           'price' => $fields['PRICE'],
           'quantity' => (int)$fields['QUANTITY'],
           'currency_code' => $fields['CURRENCY'],
           'product_id' => $fields['PRODUCT_ID'],
           'order_id' => $this->order->getId(),
           'action_code' => $this->activationCode,
       ];
   }

   protected function getEmailOrder(): string
   {
       if ($this->order instanceof Order)
           return (string)$this->order->getPropertyCollection()->getUserEmail()->getValue();

     return '';
   }

   protected function getActionCode(): string
   {
       /*
        *  Целевые действия и тарифы:


           action_code=1 – Оплаченный заказ старого клиента (без купона)
           tariff_code=1 – Тариф по умолчанию


           action_code=2 – Оплаченный заказ старого клиента (с купоном)
           tariff_code=1 – Тариф по умолчанию


           action_code=3 – Оплаченный заказ нового клиента с купоном
           tariff_code=1 – Тариф по умолчанию


           action_code=4 – Оплаченный заказ нового клиента без купона
           tariff_code=1 – Тариф по умолчанию
       */
       $matrix = [
           'ORDER_OLD_USER_0' => '1', //Оплаченный заказ старого клиента (без купона)
           'ORDER_OLD_USER_1' => '2', //Оплаченный заказ старого клиента (с купоном)
           'ORDER_NEW_USER_0' => '4', //Оплаченный заказ нового клиента (без купона)
           'ORDER_NEW_USER_1' => '3', //Оплаченный заказ нового клиента (с купоном)
       ];
       $email = $this->getEmailOrder();
       $key = ($email !== '' && $this->isNewUserByEmail($email)) ? 'ORDER_NEW_USER_' : 'ORDER_OLD_USER_';
       $key .= ($this->isUseCoupon() ? '1' : '0');
       $this->activationCode = $matrix[$key];

       return $this->activationCode;
   }

   protected function getCoupon() {

       $discountData = $this->order->getDiscount()->getApplyResult();
       foreach ($discountData['COUPON_LIST'] as $coupon => $params) {
           if ($params['APPLY'] == 'Y') {
               $this->coupons[] = $params['COUPON'];
           }
       }
       if(self::DEBUG)
           $this->logger->debug("Купоны " . json_encode($this->coupons));
   }

   protected function isUseCoupon(): bool
   {
       $discountData = $this->order->getDiscount()->getApplyResult();
       foreach ($discountData['COUPON_LIST'] as $coupon => $params) {
           if ($params['APPLY'] === 'Y') {
               return true;
           }
       }

       return false;
   }

   protected function isNewUserByEmail($email): bool
   {
       $result = Internals\OrderPropsValueTable::getList([
           "filter" => [
               "CODE" => "EMAIL",
               "VALUE" => $email
           ]
       ])->fetchAll();

       if(self::DEBUG)
           $this->logger->debug("Количество заказов ".$email.' '.count($result));

       if (count($result) > 1) // больше 1 заказа, текущего
           return false;

       return true;
   }

   /**
    * Метод сохраняет куку Admitad
    * @param Event $event
    * @return void
    * @throws ArgumentException
    * @throws ArgumentOutOfRangeException
    * @throws NotImplementedException
    * @throws ObjectPropertyException
    * @throws SystemException
    */
   public static function onBeforeSaveOrderHandler(Event $event)
   {
       $uid = Helpers::getCookie();
       if ($uid) {
           /** @var  Sale\Order $order */
           $order = $event->getParameter('ENTITY');

           $propAdmitad = $order->getPropertyCollection()->getItemByOrderPropertyCode(Helpers::COOKIE_NAME);
           $propAdmitad->setValue($uid);
       }
   }

   /**
    * Метод отправляет заказ в Admitad
    * @param Event $event
    * @return void
    * @throws ArgumentNullException
    */
   public static function onSaveOrderHandler(Event $event)
   {
       $isNew = $event->getParameter('IS_NEW');

       if ($isNew) {
           /** @var \Bitrix\Sale\Order $order */
           $order = $event->getParameter('ENTITY');
           $propAdmitad = $order->getPropertyCollection()->getItemByOrderPropertyCode(Helpers::COOKIE_NAME);
           if ($propAdmitad->getValue()) {
               try {
                   (new self($order->getId()))->sendOrder();
               } catch (Exception|\Error $e) {
                   (new Logger('admitad/error_send.log'))->error(json_encode([
                       "orderId" => $order->getId(),
                       "message" => $e->getMessage(),
                       "line" => $e->getLine(),
                       "file" => $e->getFile(),
                       "trace" => $e->getTrace(),
                   ]));
               }
           }
       }
   }
}

Цель

Определить тип заказа в зависимости от того, является ли пользователь новым или старым, а также от того, использован ли купон.

Как это работает

В зависимости от email пользователя и наличия купона в заказе определяется action_code:

• 1 — оплаченный заказ старого клиента без купона.

• 2 — оплаченный заказ старого клиента с купоном.

• 3 — оплаченный заказ нового клиента с купоном.

• 4 — оплаченный заказ нового клиента без купона.

Также проверяется, использовался ли купон в заказе isUseCoupon().

Логирование

Цель

Записывать информацию об успешных и неудачных операциях для отладки и анализа.

Как это работает

• Используется класс Logger, который записывает данные в файлы логов (например, admitad/error_send.log).

• Логируются ошибки, успешные отправки, а также отладочная информация (если включен режим "DEBUG").

Параметры action_code и tariff_code

Цель

Определить тип заказа и тариф для расчета вознаграждения.

Значения

1. tariff_code=1 — тариф по умолчанию.

2. action_code — определяется тип клиента и наличие купона.

Где:

• 1 — заказ старого клиента без купона.

• 2 — заказ старого клиента с купоном.

• 3 — заказ нового клиента с купоном.

• 4 — заказ нового клиента без купона.

Этот код реализует интеграцию с партнерской сетью Адмитад на платформе Битрикс.

1. Сохраняет идентификатор пользователя (UID) из партнерской ссылки в куки.

2. При создании заказа записывает UID в свойства заказа.

3. Отправляет данные о заказе в Адмитад для учета и начисления вознаграждений.

4. Определяет тип заказа (новый/старый клиент, с купоном/без купона) для корректного расчета вознаграждения.

5. Логирует все операции для отладки и анализа.