Створення спеціального пікселя Google Tag Manager

Google Tag Manager (GTM) можна використовувати як спеціальний піксель для керування сторонніми пікселями.

Коли все буде готово до тестування спеціального пікселя GTM, скористайтеся інструментом Shopify Pixel Helper, щоб переконатися, що всі дії, які потрібно відстежувати, додаються до ізольованого програмного середовища без помилок.

Ви також можете використовувати розширення Google Tag Assistant, щоб перевірити, які теги Google завантажуються на сторінці. Однак функція Troubleshoot tag у Google Tag Assistant несумісна зі спеціальними пікселями та не виявляє теги Google у спеціальному пікселі або інші пікселі, що завантажуються через GTM.

Підготовка до створення спеціального пікселя

Перш ніж створити спеціальний піксель за допомогою Google Tag Manager, перегляньте наведену нижче інформацію, щоб переконатися, що ви розумієте, як його налаштувати:

Створення спеціального пікселя Google Tag Manager

Ви можете створити спеціальний піксель Google Tag Manager для керування сторонніми пікселями.

Кроки:

  1. Відкрийте акаунт Google Tag Manager і виберіть акаунт, для якого потрібно налаштувати спеціальний піксель.
  2. Натисніть Адміністратор, а потім — Установити Менеджер тегів Google, щоб відкрити код установлення.
  3. Скопіюйте блок коду, який належить розділу head на сторінці.
  4. Видаліть HTML-теги з блока коду. Наприклад, <script></script>.
  5. Вставте код, що залишився, у новий спеціальний піксель Shopify.
  6. Підпишіться на дії користувачів і передавайте їх до dataLayer у GTM.
  7. Щоб переглянути, як має відображатися код, див. приклад спеціального пікселя Google Tag Manager.
  8. Налаштуйте Google Tag Manager на прийом дій із вашого спеціального пікселя.
  9. Необов’язково: якщо у вашому файлі checkout.liquid є наявні виклики dataLayer.push(event), замініть їх на analytics.publish().

Підписка на дії користувачів і передача до data layer у GTM

Ви можете підписатися на дії користувачів за допомогою dataLayer GTM у коді спеціального пікселя.

За замовчуванням існує набір стандартних подій, на які можна підписатися. Однак, якщо ви хочете відстежувати дії користувачів, які не входять до стандартних, ви можете опублікувати власні спеціальні події з файлів шаблону Liquid.

Нижче наведено приклад підписки на стандартну подію product_viewed, яка вказує, коли хтось переглядає товар. Коли подія спрацьовує, вона передається до dataLayer.

analytics.subscribe("product_viewed", (event) => {
  window.dataLayer.push({
    event: "product_viewed",
    product_title: event.data?.productVariant?.title,
  });
});

У цьому прикладі назва товару передається в корисних даних події. Ви можете використовувати змінну Google Tag Manager, щоб отримати назву товару з корисних даних події у вибраному тезі.

Приклад спеціального пікселя Google Tag Manager

Наведений нижче приклад — це спрощена версія спеціального пікселя Google Tag Manager, яка показує, як надсилати дані до Google Tag Manager. Щоб передавати більше подій до dataLayer, ви можете підписатися на додаткові стандартні та спеціальні події.

// Define dataLayer and the gtag function.
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}

//Initialize GTM tag
(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer', 'GTM-XXXXXXX');

//Google Consent Mode v2
gtag('consent', 'update', {
  'ad_storage': 'granted',
  'analytics_storage': 'granted',
  'ad_user_data': 'granted',
  'ad_personalization': 'granted',
});

//subscribe to events
analytics.subscribe("checkout_completed", (event) => {
  window.dataLayer.push({
    event: "checkout_completed",
    timestamp: event.timestamp,
    id: event.id,
    token: event.data?.checkout?.token,
    url: event.context.document.location.href,
    client_id: event.clientId,
    email: event.data?.checkout?.email,
    phone: event.data?.checkout?.phone,
    first_name: event.data?.checkout?.shippingAddress?.firstName,
    last_name: event.data?.checkout?.shippingAddress?.lastName,
    address1: event.data?.checkout?.shippingAddress?.address1,
    address2: event.data?.checkout?.shippingAddress?.address2,
    city: event.data?.checkout?.shippingAddress?.city,
    country: event.data?.checkout?.shippingAddress?.country,
    countryCode: event.data?.checkout?.shippingAddress?.countryCode,
    province: event.data?.checkout?.shippingAddress?.province,
    provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
    zip: event.data?.checkout?.shippingAddress?.zip,
    orderId: event.data?.checkout?.order?.id,
    currency: event.data?.checkout?.currencyCode,
    subtotal: event.data?.checkout?.subtotalPrice?.amount,
    shipping: event.data?.checkout?.shippingLine?.price?.amount,
    value: event.data?.checkout?.totalPrice?.amount,
    tax: event.data?.checkout?.totalTax?.amount,
  });
});

analytics.subscribe("payment_info_submitted", (event) => {
  window.dataLayer.push({
    event: "payment_info_submitted",
    timestamp: event.timestamp,
    id: event.id,
    token: event.data?.checkout?.token,
    url: event.context.document.location.href,
    client_id: event.clientId,
    email: event.data?.checkout?.email,
    phone: event.data?.checkout?.phone,
    first_name: event.data?.checkout?.shippingAddress?.firstName,
    last_name: event.data?.checkout?.shippingAddress?.lastName,
    address1: event.data?.checkout?.shippingAddress?.address1,
    address2: event.data?.checkout?.shippingAddress?.address2,
    city: event.data?.checkout?.shippingAddress?.city,
    country: event.data?.checkout?.shippingAddress?.country,
    countryCode: event.data?.checkout?.shippingAddress?.countryCode,
    province: event.data?.checkout?.shippingAddress?.province,
    provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
    zip: event.data?.checkout?.shippingAddress?.zip,
    orderId: event.data?.checkout?.order?.id,
    currency: event.data?.checkout?.currencyCode,
    subtotal: event.data?.checkout?.subtotalPrice?.amount,
    shipping: event.data?.checkout?.shippingLine?.price?.amount,
    value: event.data?.checkout?.totalPrice?.amount,
    tax: event.data?.checkout?.totalTax?.amount,
  });
});

analytics.subscribe("checkout_shipping_info_submitted", (event) => {
  window.dataLayer.push({
    event: "checkout_shipping_info_submitted",
    timestamp: event.timestamp,
    id: event.id,
    token: event.data?.checkout?.token,
    url: event.context.document.location.href,
    client_id: event.clientId,
    email: event.data?.checkout?.email,
    phone: event.data?.checkout?.phone,
    first_name: event.data?.checkout?.shippingAddress?.firstName,
    last_name: event.data?.checkout?.shippingAddress?.lastName,
    address1: event.data?.checkout?.shippingAddress?.address1,
    address2: event.data?.checkout?.shippingAddress?.address2,
    city: event.data?.checkout?.shippingAddress?.city,
    country: event.data?.checkout?.shippingAddress?.country,
    countryCode: event.data?.checkout?.shippingAddress?.countryCode,
    province: event.data?.checkout?.shippingAddress?.province,
    provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
    zip: event.data?.checkout?.shippingAddress?.zip,
    orderId: event.data?.checkout?.order?.id,
    currency: event.data?.checkout?.currencyCode,
    subtotal: event.data?.checkout?.subtotalPrice?.amount,
    shipping: event.data?.checkout?.shippingLine?.price?.amount,
    value: event.data?.checkout?.totalPrice?.amount,
    tax: event.data?.checkout?.totalTax?.amount,
  });
});

analytics.subscribe("checkout_address_info_submitted", (event) => {
  window.dataLayer.push({
    event: "checkout_address_info_submitted",
    timestamp: event.timestamp,
    id: event.id,
    token: event.data?.checkout?.token,
    url: event.context.document.location.href,
    client_id: event.clientId,
    email: event.data?.checkout?.email,
    phone: event.data?.checkout?.phone,
    first_name: event.data?.checkout?.shippingAddress?.firstName,
    last_name: event.data?.checkout?.shippingAddress?.lastName,
    address1: event.data?.checkout?.shippingAddress?.address1,
    address2: event.data?.checkout?.shippingAddress?.address2,
    city: event.data?.checkout?.shippingAddress?.city,
    country: event.data?.checkout?.shippingAddress?.country,
    countryCode: event.data?.checkout?.shippingAddress?.countryCode,
    province: event.data?.checkout?.shippingAddress?.province,
    provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
    zip: event.data?.checkout?.shippingAddress?.zip,
    orderId: event.data?.checkout?.order?.id,
    currency: event.data?.checkout?.currencyCode,
    subtotal: event.data?.checkout?.subtotalPrice?.amount,
    shipping: event.data?.checkout?.shippingLine?.price?.amount,
    value: event.data?.checkout?.totalPrice?.amount,
    tax: event.data?.checkout?.totalTax?.amount,
  });
});

analytics.subscribe("checkout_contact_info_submitted", (event) => {
  window.dataLayer.push({
    event: "checkout_contact_info_submitted",
    timestamp: event.timestamp,
    id: event.id,
    token: event.data?.checkout?.token,
    url: event.context.document.location.href,
    client_id: event.clientId,
    email: event.data?.checkout?.email,
    phone: event.data?.checkout?.phone,
    first_name: event.data?.checkout?.shippingAddress?.firstName,
    last_name: event.data?.checkout?.shippingAddress?.lastName,
    address1: event.data?.checkout?.shippingAddress?.address1,
    address2: event.data?.checkout?.shippingAddress?.address2,
    city: event.data?.checkout?.shippingAddress?.city,
    country: event.data?.checkout?.shippingAddress?.country,
    countryCode: event.data?.checkout?.shippingAddress?.countryCode,
    province: event.data?.checkout?.shippingAddress?.province,
    provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
    zip: event.data?.checkout?.shippingAddress?.zip,
    orderId: event.data?.checkout?.order?.id,
    currency: event.data?.checkout?.currencyCode,
    subtotal: event.data?.checkout?.subtotalPrice?.amount,
    shipping: event.data?.checkout?.shippingLine?.price?.amount,
    value: event.data?.checkout?.totalPrice?.amount,
    tax: event.data?.checkout?.totalTax?.amount,
  });
});

analytics.subscribe("checkout_started", (event) => {
  window.dataLayer.push({
    event: "checkout_started",
    timestamp: event.timestamp,
    id: event.id,
    token: event.data?.checkout?.token,
    url: event.context.document.location.href,
    client_id: event.clientId,
    email: event.data?.checkout?.email,
    phone: event.data?.checkout?.phone,
    first_name: event.data?.checkout?.shippingAddress?.firstName,
    last_name: event.data?.checkout?.shippingAddress?.lastName,
    address1: event.data?.checkout?.shippingAddress?.address1,
    address2: event.data?.checkout?.shippingAddress?.address2,
    city: event.data?.checkout?.shippingAddress?.city,
    country: event.data?.checkout?.shippingAddress?.country,
    countryCode: event.data?.checkout?.shippingAddress?.countryCode,
    province: event.data?.checkout?.shippingAddress?.province,
    provinceCode: event.data?.checkout?.shippingAddress?.provinceCode,
    zip: event.data?.checkout?.shippingAddress?.zip,
    orderId: event.data?.checkout?.order?.id,
    currency: event.data?.checkout?.currencyCode,
    subtotal: event.data?.checkout?.subtotalPrice?.amount,
    shipping: event.data?.checkout?.shippingLine?.price?.amount,
    value: event.data?.checkout?.totalPrice?.amount,
    tax: event.data?.checkout?.totalTax?.amount,
  });
});

analytics.subscribe("product_added_to_cart", (event) => {
  window.dataLayer.push({
    event: "product_added_to_cart",
    timestamp: event.timestamp,
    id: event.id,
    client_id: event.clientId,
    url: event.context.document.location.href,
    price: event.data?.cartLine?.merchandise?.price?.amount,
    currency: event.data?.cartLine?.merchandise?.id,
    product_title: event.data?.cartLine?.merchandise?.product?.title,
    quantity: event.data?.cartLine?.quantity,
    total_cost: event.data?.cartLine?.cost?.totalAmount?.amount,
  });
});

analytics.subscribe("cart_viewed", (event) => {
  window.dataLayer.push({
    event: "cart_viewed",
    timestamp: event.timestamp,
    id: event.id,
    client_id: event.clientId,
    url: event.context.document.location.href,
    total_cost: event.data?.cart?.cost?.totalAmount?.amount,
    quantity: event.data?.cart?.totalQuantity,
    cart_id: event.data?.cart?.id,
  });
});

analytics.subscribe("page_viewed", (event) => {
  window.dataLayer.push({
    event: "page_viewed",
    timestamp: event.timestamp,
    id: event.id,
    client_id: event.clientId,
    url: event.context.document.location.href,
    page_title: event.context.document.title,
  });
});

analytics.subscribe("product_viewed", (event) => {
  window.dataLayer.push({
    event: "product_viewed",
    timestamp: event.timestamp,
    id: event.id,
    client_id: event.clientId,
    url: event.context.document.location.href,
    product_id: event.data?.productVariant?.product?.id,
    product_title: event.data?.productVariant?.title,
    product_sku: event.data?.productVariant?.sku,
  });
});

analytics.subscribe("search_submitted", (event) => {
  window.dataLayer.push({
    event: "search_submitted",
    timestamp: event.timestamp,
    id: event.id,
    client_id: event.clientId,
    url: event.context.document.location.href,
    query: event.data?.searchResult?.query,
  });
});

analytics.subscribe("collection_viewed", (event) => {
  window.dataLayer.push({
    event: "collection_viewed",
    timestamp: event.timestamp,
    id: event.id,
    client_id: event.clientId,
    url: event.context.document.location.href,
    collection_id: event.data?.collection?.id,
    collection_title: event.data?.collection?.title,
  });
});

Налаштування Google Tag Manager на прийом дій із вашого спеціального пікселя

Після створення спеціального пікселя потрібно налаштувати Google Tag Manager на прийом дій із нього. Для цього потрібен тег, тригер і змінні dataLayer у Google Tag Manager.

Деякі приклади вибраних стандартних дій користувачів та їх еквіваленти в Google Tag Manager наведено в таблиці нижче:

Перелік стандартних дій користувачів Shopify для використання з пікселями у порівнянні з їхніми еквівалентами в Google Tag Manager, а також тригер, необхідний для спрацьовування цих подій.
Подія ShopifyТригерПодія GTM
payment_info_submittedНадіслати платіжну інформаціюadd_payment_info
checkout_address_info_submittedНадіслати інформацію про доставкуadd_shipping_info
product_added_to_cartДодати одиницю в кошикadd_to_cart
checkout_startedПочати оформлення замовленняbegin_checkout
checkout_completedЗавершити оформлення замовленняpurchase
product_removed_from_cartВилучити одиницю з кошикаremove_from_cart
cart_viewedПереглянути кошикview_cart
product_viewedПереглянути сторінку з відомостями про товарview_item
collection_viewedПерегляд списку одиницьview_item_list

Параметри подій тегу GTM мають відповідати очікуваним правилам іменування, щоб події dataLayer вашого користувацького пікселя могли оброблятися.

Нижче наведено кілька прикладів вибраних властивостей подій dataLayer користувацького пікселя та їхніх еквівалентних параметрів подій Google Analytics 4 (GA4):

Список подій dataLayer користувацького пікселя, які використовують правила іменування GA4
Події dataLayer користувацького пікселяПараметри подій GA4
event.data?.checkout?.currencyCodecurrency
event.data?.checkout?.totalPrice?.amountvalue
event.data?.checkout?.order?.idtransaction_id
event.data?.checkout?.discountAllocationscoupon
event.data?.checkout?.shippingLine?.price?.amountshipping
event.data?.checkout?.totalTaxtax
event.data?.checkout?.lineItemsitems

Ось приклад використання події checkout_completed:

analytics.subscribe("checkout_completed", (event) => {
  window.dataLayer.push({
    event: "checkout_completed",
    orderId: event.data?.checkout?.order?.id,
    currency: event.data?.checkout?.currencyCode,
    price: event.data.checkout.totalPrice.amount,
    shippingLine: event.data.checkout.shippingLine.price.amount,
    totalTax: event.data.checkout.totalTax,
  });
});

Тригер Google Tag Manager — це тип користувацької події з назвою checkout_completed. Поле Назва події в тригері має збігатися з ключем event у вашому користувацькому пікселі.

orderId і currency — це змінні, які використовуються в Google Tag Manager для збору даних із події. Їх можна зіставити зі змінною dataLayer у Google Tag Manager. Кожна змінна події потребує власної змінної dataLayer. Налаштуйте тригер так, щоб він спрацьовував на всі користувацькі події.

Створіть тег, який використовує щойно створений тригер. У розділі параметрів події додайте змінні, дані яких потрібно отримувати. У наведеному вище прикладі orderId, currency, price, shippingLine і totalTax будуть налаштовані як змінні dataLayer. Щоразу, коли тег спрацьовуватиме, він отримуватиме ці змінні dataLayer разом із подією.

Зверніть увагу: щоб відбувалося передавання даних, у Google Tag Manager має бути налаштовано принаймні один тег і тригер.

Заміна старих викликів dataLayer.push(event) на analytics.publish()

Якщо ви раніше налаштовували Google Tag Manager, вам потрібно замінити виклики dataLayer.push на виклики Shopify.analytics.publish(). Виклики dataLayer.push знаходяться у файлах theme.liquid, у розділі Макет вашого редактора тем.

Також потрібно замінити виклики dataLayer.push у файлі checkout.liquid. Однак оскільки checkout.liquid не сумісний із Shopify Extensions, для передавання даних у вебпікселі потрібно використовувати розширення інтерфейсу користувача.

Нижче наведено спрощений приклад відстеження користувацької події реєстрації електронною поштою за допомогою dataLayer у файлах theme.liquid:

<script>
  dataLayer.push({ event: 'email_signup', email: customer.email });
</script>

Еквівалент у Shopify виглядає таким чином і передає дані у ваш користувацький піксель:

<script>
  Shopify.analytics.publish('email_signup', {email: customer.email });
</script>

Потім у код користувацького пікселя потрібно додати щось подібне до цього:

analytics.subscribe("email_signup", (event) => {
  window.dataLayer.push({
   'event': 'email_signup',
   'email': event.customData.email,
  });
});

Заміна старого dataLayer.push(data)

Google Tag Manager має функцію, що дає змогу передавати об'єкт dataLayer зі збереженням стану під час кожної події. Хоча пісочниця пікселів Shopify не має еквівалентної функції, ви можете досягти того ж результату, створивши власний об'єкт даних і передаючи його в користувацькі події.

Наприклад, визначте об’єкт «customData» перед публікацією будь-яких користувацьких подій:

<script>
  const customData = {email: customer.email}
</script>

Потім щоразу, коли потрібно включити власні дані, передавайте їх у метод publish:

<script>
  Shopify.analytics.publish('email_signup', customData);
</script>

Поради щодо налаштування Google Analytics 4

Ознайомтеся з наведеними нижче порадами щодо налаштування Google Analytics 4 (GA4) за умови використання Google Tag Manager як користувацького пікселя.

Чистіші URL-адреси сторінок

Коли GA4 працює в пісочниці, ви можете помітити, що URL-адреси сторінок містять інформацію про цю пісочницю. Якщо ви хочете видалити інформацію про пісочницю з таких URL-адрес, ви можете вимкнути автоматичне відстеження сторінок у GA4 і натомість реалізувати власне за допомогою стандартної події page_viewed.

analytics.subscribe('page_viewed', (event) => {
  window.dataLayer.push({
   'event': 'page_viewed',
   'page_location': event.context.window.location.href,
   'page_title': event.context.document.title,
  });
});

Після публікації власної події в dataLayer ви можете створити тег GA4 page_view, який спрацьовуватиме на подію page_viewed. Найчастіше можна використовувати тип тегу Google Analytics: подія GA4 і встановити назву події page_view. Після налаштування типу тегу й назви події потрібно додати параметр page_location і задати для нього те саме значення, яке ви передали в dataLayer із користувацького пікселя.

Покращена статистика

Під час завантаження GA4 у пісочниці пікселів Shopify деякі події, які зазвичай визначаються автоматично, потрібно налаштовувати вручну. Наприклад, кліки вихідних посилань (як частина налаштувань покращеної статистики GA4) не можуть ініціюватися автоматично з міркувань безпеки, коли використовуються користувацькі пікселі. Проте ви можете самостійно реалізувати події покращеної статистики GA4 як користувацькі події.

Наведений нижче код містить спрощений приклад відстеження кліків вихідних посилань:

<script>
  function detectOutboundLink() {
    // add your logic for determining if a link click is outbound

    // if the link click is outbound then publish it
    if (isOutboundLink) {
      Shopify.analytics.publish('outbound_link', { link_url: link_url });
    }
  }
</script>

Нарешті, у GTM створіть тег GA4, який надсилає інформацію про клік посилання до GA4; для цього переконайтеся, що подія називається click, відповідно до розширеного найменування подій GA4.

Ви можете налаштувати таке саме відстеження для будь-якої метрики розширеного вимірювання від Google.

Тестування й налагодження користувацького пікселя

Коли все буде готово до тестування спеціального пікселя GTM, скористайтеся інструментом Shopify Pixel Helper, щоб переконатися, що всі дії, які потрібно відстежувати, додаються до ізольованого програмного середовища без помилок.

Ви також можете використовувати розширення Google Tag Assistant, щоб перевірити, які теги Google завантажуються на сторінці. Однак функція Troubleshoot tag у Google Tag Assistant несумісна зі спеціальними пікселями та не виявляє теги Google у спеціальному пікселі або інші пікселі, що завантажуються через GTM.