Створення спеціального пікселя 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 і отримайте ідентифікатор контейнера GTM.
- З міркувань безпеки менеджери тегів, завантажені в нашому ізольованому програмному середовищі, мають такі ж обмеження, як і будь-які інші пікселі. Дізнайтеся більше про обмеження ізольованого програмного середовища пікселів.
Створення спеціального пікселя Google Tag Manager
Ви можете створити спеціальний піксель Google Tag Manager для керування сторонніми пікселями.
Кроки:
- Відкрийте акаунт Google Tag Manager і виберіть акаунт, для якого потрібно налаштувати спеціальний піксель.
- Натисніть Адміністратор, а потім — Установити Менеджер тегів Google, щоб відкрити код установлення.
- Скопіюйте блок коду, який належить розділу
headна сторінці. - Видаліть HTML-теги з блока коду. Наприклад,
<script></script>. - Вставте код, що залишився, у новий спеціальний піксель Shopify.
- Підпишіться на дії користувачів і передавайте їх до dataLayer у GTM.
- Щоб переглянути, як має відображатися код, див. приклад спеціального пікселя Google Tag Manager.
- Налаштуйте Google Tag Manager на прийом дій із вашого спеціального пікселя.
- Необов’язково: якщо у вашому файлі
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 | Тригер | Подія 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 |
|---|---|
| event.data?.checkout?.currencyCode | currency |
| event.data?.checkout?.totalPrice?.amount | value |
| event.data?.checkout?.order?.id | transaction_id |
| event.data?.checkout?.discountAllocations | coupon |
| event.data?.checkout?.shippingLine?.price?.amount | shipping |
| event.data?.checkout?.totalTax | tax |
| event.data?.checkout?.lineItems | items |
Ось приклад використання події 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.