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

6. Замените значение {your_campaign_code} на значение параметра campaign_code (без фигурных скобок) и нажмите «Save».
Вы получите параметр вида: campaign_code=a1b2c3d4e5, где выделенная часть — уникальный номер вашей партнерской программы. Где получить значение параметра campaign_code

7. Нажмите «Exit», чтобы вернуться на предыдущую страницу, затем перейдите в раздел «Settings».

8. В модальном окне «Settings» нажмите «Checkout».

9. Проскрольте страницу вниз и найдите блок «Order status page». В поле «Additional scripts» добавьте следующий код:

• <script src="https://www.artfut.com/static/tagtag.min.js?campaign_code={your_campaign_code}" onerror='var self = this;window.ADMITAD=window.ADMITAD||{},ADMITAD.Helpers=ADMITAD.Helpers||{},ADMITAD.Helpers.generateDomains=function(){for(var e=new Date,n=Math.floor(new Date(2020,e.getMonth(),e.getDate()).setUTCHours(0,0,0,0)/1e3),t=parseInt(1e12*(Math.sin(n)+1)).toString(30),i=["de"],o=[],a=0;a'></script>
  <script type="text/javascript">
     ADMITAD = window.ADMITAD || {};
     ADMITAD.Invoice = ADMITAD.Invoice || {};
  
     ADMITAD.Invoice.category = '{your_action_code}';  // action code (defined during integration)
     var orderedItem = [];  // temporary array for product items
     var coup = '';
     var targ = '';
     {% for discount_application in discount_applications %}
         coup = '{{ discount_application.title }}';
         targ = '{{ discount_application.target_type }}';
     {% endfor %}
     var disc = ( targ != 'shipping_line' && '{{ discounts_amount  | divided_by: 100.00 }}' > 0 ) ? Number({{ discounts_amount  | divided_by: 100.00 }}) : '0';
     disc = Number(disc + {{ gift_cards_amount  | divided_by: 100.00 }});
     var total = Number(({{ subtotal_price | divided_by: 100.00  }} - {{ gift_cards_amount  | divided_by: 100.00 }}) + disc); //order price without discount
     // if there is a discount, we calculate the discount percentage and get the name of coupon
     var average_price = (disc > 0) ? Number((total - disc) / total) : '1';
     {% for item in checkout.line_items %}
     var price = '{{ item.price | divided_by: 100.00 }}';
     // repeat for every product item in the cart
     orderedItem.push({
         Product: {
             productID: '{{ item.product_id }}',
             category: '{your_tariff_code}',
             price: (price*average_price).toFixed(3), // apply a discount to the product price
             priceCurrency: '{{ currency }}', // currency
         },
         orderQuantity: '{{ item.quantity }}',
         additionalType: "sale" // payment_type
     });
     {% endfor %}
     ADMITAD.Invoice.referencesOrder = ADMITAD.Invoice.referencesOrder || [];
     // adding items to the order
     ADMITAD.Invoice.referencesOrder.push({
           orderNumber: '{{ checkout.order_id }}',
         discountCode: coup, // promocode
         orderedItem: orderedItem
     });
     // Important! If order data is loaded via AJAX, uncomment this string.
     // ADMITAD.Tracking.processPositions();
     </script>
  

10. Замените значение {your_action_code}, {your_tariff_code} и {your_campaign_code} на значения параметров action_code, tariff_code и campaign_code соответственно. Где получить значения этих параметров
Внизу страницы нажмите «Save».

Готово, трекинг-код установлен и настроен.

Как работает дедупликация в трекинг-коде на платформе Shopify

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

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

Код дедупликации уже встроен в трекинг-код.
Поэтому информация о действии передается в Admitad в соответствии с моделью атрибуции Last Paid Click: если последним платным источником был веб-мастер Admitad, то действие присваивается Admitad.

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

Когда пользователь делает заказ на вашем сайте, трекинг-код автоматически определяет последний источник по значению параметра utm_source.

Значение utm_source=admitad в последней ссылке, по которой перешел пользователь, означает, что целевое действие будет присвоено Admitad.

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

Чтобы настроить кастомную дедупликацию (например, задать свое наименование переменных или изменить срок хранения cookie):

Разместите код дедупликации на всех страницах сайта после трекинг-кода.

• <script type="text/javascript">
  // имя cookie для хранения источника
  // если используется другое имя, укажите его
  var cookie_name = 'deduplication_cookie';
  // число дней жизни cookie
  var days_to_store = 90;
  // ожидаемое значение deduplication_cookie для Admitad
  var deduplication_cookie_value = 'admitad';
  // имя GET-параметра для дедупликации
  // если у вас используется другой параметр, укажите его имя
  var channel_name = ‘utm_source’;
  // функция для получения источника из GET параметра
  getSourceParamFromUri = function () {
    var pattern = channel_name + '=([^&]+)';
    var re = new RegExp(pattern);
    return (re.exec(document.location.search) || [])[1] || '';
  };
  // функция для получения источника из cookie с именем cookie_name
  getSourceCookie = function () {
    var matches = document.cookie.match(new RegExp(
      '(?:^|; )' + cookie_name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + '=([^;]*)'
    ));
    return matches ? decodeURIComponent(matches[1]) : undefined;
  };
  // функция для записи источника в cookie с именем cookie_name
  setSourceCookie = function () {
    var param = getSourceParamFromUri();
    if (!param) { return; }
    var period = days_to_store * 60 * 60 * 24 * 1000; // в секундах
    var expiresDate = new Date((period) + +new Date);
    var cookieString = cookie_name + '=' + param + '; path=/; expires=' + expiresDate.toGMTString();
    document.cookie = cookieString;
    document.cookie = cookieString + '; domain=.' + location.host;
  };
  // запись cookie
  setSourceCookie();
  </script>

Чтобы источник трафика на странице «Спасибо за покупку» определялся корректно, разместите код, представленный ниже, сразу после трекинг-кода.

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

  <script>
  if (!getSourceCookie(cookie_name)) {
    ADMITAD.Invoice.broker = 'na';
  } else if (getSourceCookie(cookie_name) != deduplication_cookie_value) {
    ADMITAD.Invoice.broker = getSourceCookie(cookie_name);
  } else {
    ADMITAD.Invoice.broker = 'adm';
  }
  </script> 

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

1. Получите тестовую партнерскую ссылку на странице «Настройка интеграции для Shopify» в блоке «Тестирование интеграции».

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

  1.2 Затем нажмите «Далее» и на странице «Способы интеграции» выберите «Shopify». Нажмите «Далее».

  1.3 Блок «Тестирование интеграции» находится в нижней части экрана.

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

Рекомендации по тестированию интеграции:

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

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

• Если у вас есть форма быстрого заказа или заказа «В один клик», сделайте заказ через нее, чтобы проверить интеграцию формы.

Тестовый заказ появится в статистике Admitad в течение часа.

Если через час и более заказ не появился в статистике, проверьте, что настройка интеграции выполнена корректно (инструкция). Если проблема сохраняется, сообщите об этом специалисту Admitad.

3. Перейдите в свой личный кабинет Admitad → «Статистика» → «По действиям» и проверьте, что в статистике корректно отображается целевое действие и данные по нему:

• целевое действие соответствует настройкам партнерской программы;
• ID заказа в Admitad соответствует ID заказа в вашей системе;
• сумма заказа в Admitad соответствует сумме тестового заказа.

4. Сообщите специалисту Admitad об окончании тестирования — программа будет поставлена на подготовку к запуску.

Готово. Тестирование интеграции завершено.

Как удалить трекинг-код со своего сайта

1. В административной панели вашего сайта откройте файл theme.liquid, выполнив шаги 1–3 из этой инструкции.

2. Удалите код Admitad, который был добавлен перед закрывающим тегом </head>.
Нажмите «Save».

3. Нажмите «Exit», чтобы вернуться на предыдущую страницу.

4. На открывшейся странице нажмите «Settings». Откроется модальное окно «Settings».

5. В модальном окне «Settings» нажмите «Checkout».

6. Проскрольте страницу вниз и найдите блок «Order status page».
В поле «Additional scripts» удалите код Admitad. Внизу страницы нажмите «Save».

Готово, трекинг-код удален.

FAQ

• Где найти значение параметра campaign_code
• Где найти значение параметра action_code
• Где найти значение параметра tariff_code

Где найти значение параметра campaign_code?

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

2. Затем нажмите «Далее» и на странице «Способы интеграции» переключитесь на вкладку «Интеграция через плагины».

3. На вкладке «Интеграция через плагины» выберите «Shopify» и нажмите «Далее».

4. Значение параметра campaign_code представлено в таблице в верхней части экрана (блок «Настройка интеграции: уникальные значения параметров для вашей программы»).

Вернуться к установке и настройке трекинг-кода

Где найти значение параметра action_code?

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

2. Затем нажмите «Далее» и на странице «Способы интеграции» переключитесь на вкладку «Интеграция через плагины».

3. На вкладке «Интеграция через плагины» выберите «Shopify» и нажмите «Далее».

4. Во второй таблице на странице в столбце «Действие» найдите то, код которого вам нужен.
Значение параметра action_code представлено в строке с этим действием в столбце «Код действия» (блок «Настройка интеграции: уникальные значения параметров для вашей программы»).

Вернуться к установке и настройке трекинг-кода

Где найти значение параметра tariff_code?

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

2. Затем нажмите «Далее» и на странице «Способы интеграции» переключитесь на вкладку «Интеграция через плагины».

3. На вкладке «Интеграция через плагины» выберите «Shopify» и нажмите «Далее».

4. Во второй таблице на странице в столбце «Тариф» найдите тот, код которого вам нужен.
Значение параметра tariff_code представлено в строке с этим тарифом в столбце «Код тарифа» (блок «Настройка интеграции: уникальные значения параметров для вашей программы»).

Вернуться к установке и настройке трекинг-кода