Як додати кастомний домен до серверного контейнера Google Tag Manager
У цій статті ми опишемо, як налаштувати кастомний домен у серверному контейнері Google Tag Manager. Головною перевагою використання власного домену для sGTM є те, що він допомагає збільшити термін дії файлів cookie, встановлюючи власні файли cookie замість сторонніх.
Переваги налаштування кастомного домену в sGTM
Основною перевагою серверного тегінгу є встановлення власних файлів cookie, хоча ця перевага не активна за замовчуванням. Щоб скористатися нею, необхідно спершу налаштувати кастомний домен у вашому серверному GTM контейнері.
Оскільки Chrome є останнім браузером, який підтримує сторонні файли cookie, і планує припинити їх використання на початку 2025 року, саме зараз час почати використовувати власні файли cookie замість сторонніх.
⚠️ОНОВЛЕННЯ: Google оголосив, що більше не планує відмовлятися від підтримки сторонніх файлів cookie. Натомість компанія запровадить нове рішення: одноразовий запит, який дозволяє користувачам встановити свої налаштування, що будуть застосовуватися у всіх сервісах Google під час перегляду.
Стабільність і довговічність файлів cookie, встановлених sGTM, залежать від того, як саме налаштований кастомний домен. У sGTM є три типи конфігурацій кастомних доменів.
Ви можете використовувати URL-адресу кастомного сервера тегів, щоб налаштувати власні файли cookie. URL-адреса кастомного сервера тегів або кастомний домен повинні мати той самий домен, що й ваш веб-сайт. Наприклад, якщо домен вашого веб-сайту — example.com, то URL-адреса сервера тегів повинна виглядати так: sst.example.com.
Існує три способи налаштування кастомного домену:
- Спільний домен (same origin)
- Субдомен (subdomain)
- Типовий домен (default domain)
Як додати кастомний домен у серверному контейнері Google Tag Manager
Перш за все, вам потрібно створити та налаштувати серверний контейнер Google Tag Manager. Якщо у вас немає серверного контейнера, дотримуйтесь цієї інструкції.
Ми покажемо два способи прив'язки кастомного домену до серверного контейнера Google Tag Manager:
- Використання субдомену.
- Використання спільного домену.
Використання субдомену
Крок 1. Додайте свій кастомний домен
Оберіть свій контейнер у Stape, прокрутіть сторінку вниз і натисніть Add custom domain.
Додайте Subdomain name - це може бути будь-яка зручна для вас назва, однак рекомендуємо уникати термінів, пов'язаних із рекламою або трекінгом: ad, gtm, stgm, tracking, analytics, metrics, stape, gtag тощо.
Крок 2. Додайте CDN
Content Delivery Network (CDN) розподіляє ресурси вашого сайту через глобальну мережу серверів, щоб зменшити затримку та пришвидшити завантаження сторінок для користувачів у різних локаціях. Це корисно, якщо ваша аудиторія географічно розосереджена або якщо ви хочете покращити відстеження файлів cookie та точність даних.
За замовчуванням CDN вимкнено, тобто JavaScript-файли (наприклад, gtm.js, gtag.js та analytics.js) передаються безпосередньо з сервера, на якому розміщено ваш контейнер sGTM. Фактично це відбувається в обхід як Stape Global CDN, так і Own CDN і забезпечує пряме з'єднання між вашим сайтом і контейнером sGTM, без проксі.
| Важливо: перед налаштуванням CDN ознайомтеся з вимогами щодо конфіденційності даних у вашій країні. |
Щоб увімкнути CDN, натисніть перемикач Add CDN і оберіть один із таких варіантів:
- Stape Global CDN: завантажує скрипти з сервера, найближчого до локації відвідувача вашого сайту, що зменшує затримку та пришвидшує завантаження сторінок для географічно розосередженої аудиторії. Ми використовуватимемо Stape Global CDN у нашому прикладі. Він безкоштовний і доступний для всіх контейнерів sGTM у Stape.
- Own CDN (несумісний з параметром підключення Automatically (via Entri)): допомагає маршрутизувати кастомний домен sGTM і проксіювати трафік sGTM через DNS-провайдера вашого сайту. У цьому випадку IP-адреси вашого сайту та кастомного домену sGTM збігатимуться, а сервер-сайд файли cookie вважатимуться first-party (основними). Завдяки цьому з'являється можливість збільшити термін дії файлів cookie.
Крок 3. Оберіть метод підключення
Далі в розділі How to connect є два способи підключення кастомного домену до вашого контейнера:
- Automatically (via Entri)
Найпростіший спосіб підключення доменів. Увійдіть за допомогою даних свого DNS-провайдера через Entri і надайте нам одноразовий дозвіл на підключення вашого домену. Після цього ви можете одразу перейти до Кроку 5, щоб верифікувати ваш домен; не потрібно нічого налаштовувати вручну.
- Manually
У цьому випадку вам потрібно вручну додати DNS-записи у вашому хостинг-провайдері, щоб підключити субдомен до Stape.
Після додавання кастомного субдомену до контейнера ви побачите DNS-записи, які необхідно створити для верифікації кастомного домену. Тип DNS-запису залежить від розташування сервера та обраного параметра CDN. У наступному кроці показано, як додати DNS-записи.
Крок 4. Додайте DNS-записи (для методу ручного підключення)
За замовчуванням верифікація субдомену виконується за допомогою CNAME-записів, але за потреби ви можете верифікувати субдомен за допомогою A і AAAA-записів (зазвичай у випадках, коли необхідно уникнути додавання дублюючих записів).
Нижче ми розглянемо обидва варіанти з покроковим гайдом зі створення записів за допомогою Cloudflare. Але ви можете використовувати будь-якого іншого провайдера.
Додавання кастомного домену за допомогою CNAME-запису
Вам потрібно створити один CNAME-запис, якщо ви не використовуєте Stape Global CDN, і два записи, якщо використовуєте.
1. Увійдіть до свого DNS-провайдера і створіть новий DNS-запис для субдомену, який ви хочете використовувати. Для цього натисніть три крапки та оберіть Configure DNS поруч із назвою вашого домену на головній сторінці облікового запису.
2. Натисніть Add record.
3. Поверніться до свого облікового запису Stape та введіть запис, який бачите в обліковому записі. Переконайтеся, що Proxy status вимкнено (off).
Ми використовуємо Stape Global CDN, тому створюємо два CNAME-записи:
Додавання кастомного субдомену за допомогою A і AAAA-записів
| Зверніть увагу: A/AAAA-записи несумісні з увімкненим CDN. |
1. Якщо вам необхідно верифікувати кастомний субдомен за допомогою A і AAAA-записів, додайте назву вагшого кастомного субдомену до контейнера та переконайтеся, що перемикач CDN вимкнено (off).
Натисніть Advanced settings і поставте прапорець Use A records instead of CNAME records. Ви побачите DNS-записи, які слід додати у свій контейнер Stape. DNS-записи, які необхідно налаштувати, залежать від розташування сервера.
2. Увійдіть до свого облікового запису DNS та додайте записи, які бачите у своєму обліковому записі Stape. На головній сторінці облікового запису, поруч із назвою вашого домену, натисніть три крапки та оберіть Configure DNS.
3. Натисніть Add record.
4. Потім створіть записи, які бачите у своєму обліковому записі Stape. Переконайтеся, що Proxy status вимкнено (off).
Значення для ваших DNS-записів скопіюйте з облікового запису Stape:
В результаті ви отримаєте два DNS-записи:
Крок 5. Верифікуйте домен
Після введення DNS-записів у свого DNS-провайдера поверніться на сторінку контейнера Stape, де ви налаштовували кастомний домен, і натисніть Verify.
![[Кнопка "Verify"]](/_next/image?url=https%3A%2F%2Fcdn.stape.io%2Fi%2F69fb59b6249dd138292882.png&w=3840&q=75)
Зачекайте, поки Stape завершить верифікацію вашого власного домену (коли рядок стану контейнера зміниться з Verifying на Ready). Зазвичай верифікація кастомного домену займає 2–3 години. Для деяких DNS-провайдерів верифікація записів може тривати до 72 годин. Ми надішлемо вам електронного листа, щойно кастомний домен буде верифіковано або якщо виявиться помилка.
Якщо у вас виникнуть проблеми з верифікацією домену, скористайтеся нашим гайдом з усунення несправностей кастомного домену.
Крок 6. Додайте Tagging server URL та оновіть скрипт сайту
Перейдіть до серверного контейнера у Google Tag Manager → Admin → Container Settings → змініть Tagging server URL на ваш субдомен.
Оновлення скрипту
Якщо ви використовуєте кастомний домен, наполегливо рекомендуємо оновити скрипт Web GTM на вашому сайті. Це дозволить завантажувати gtm.js з вашого домену. Для цього замініть домен за замовчуванням googletagmanager.com на кастомний домен, який ви налаштували у попередньому кроці.
Як альтернативу, ви можете автоматизувати цей процес за допомогою Custom Loader power-up. Замість ручного редагування скрипта GTM, Custom Loader генерує готовий фрагмент коду, який завантажує скрипти GTM і GA4 безпосередньо з вашого власного домену. Це економить час, робить ваші скрипти відстеження більш стійкими до блокувальників реклами та гарантує, що всі файли cookie розглядаються як first-party (основні).
Використання спільного домену (Same Origin)
Попередні вимоги
Перед початком переконайтеся, що у вас є наступне:
- Контейнер CDN або балансувальник навантаження, здатний переадресовувати запити, через який проходить весь трафік вашого сайту.
- Якщо ви використовуєте App Engine, сервер тегування повинен працювати на версії 2.2.0 або пізнішій.
Примітка:
Покрокове налаштування домену same-origin
Залежно від вашої інфраструктури ви можете налаштувати користувацький домен same-origin за допомогою різних платформ і сервісів. Ось посібники для кожного з них:
Примітка:
Нижче ми розглянемо налаштування на прикладі Cloudflare.
Для роботи цього варіанту весь трафік вашого сайту повинен проксуватися через Cloudflare — функціональність Cloudflare Workers дозволить вам також проксувати запити sGTM. Ви також повинні використовувати SSL/TLS у режимі Full; інакше проксування same-origin може працювати через редирект 301, що є некоректним.
Крок 1. Створення Cloudflare Worker
На лівій бічній панелі натисніть Compute → Workers & Pages → натисніть Create application → виберіть варіант Start with Hello World!.
Крок 2. Назва та розгортання worker
Додайте ім'я worker → натисніть Deploy.
Крок 3. Редагування коду worker
Визначте path для вашого користувацького домену sGTM – наприклад, example.com/sgtm, example.com/data або example.com/metrics.
У налаштуваннях worker натисніть Edit code і вставте JS, аналогічний прикладу нижче, де:
/metrics/— це path, обраний вами для серверного контейнера.https://sst.stapedesk.com/— це URL вашого сервера тегування.
Для URL сервера тегування у вас є два варіанти:
- [Не рекомендується] URL сервера тегування за замовчуванням, що надається Stape (наприклад,
https://wapdsrl.ca.stape.io). - [Рекомендується] Користувацький піддомен, налаштований у Stape admin. Використання користувацького піддомену дає дві переваги: завантажує
gtm.jsіgtag.jsз користувацького шляху через Custom Loader power-up, роблячи скрипти відстеження незаблокованими, і вмикає довгоживучі файли cookie першої сторони.
Якщо ви використовуєте користувацький піддомен як URL сервера тегування same-origin, переконайтеся, що ви додали користувацький домен до контейнера sGTM на Stape та створили необхідні DNS-записи. Не використовуйте Own CDN з доменом same-origin.
export default {
async fetch(request, env, ctx) {
let { pathname, search, host } = new URL(request.url);
pathname = pathname.replace('/metrics/', '/');
const domain = 'sst.stapedesk.com';
let newRequest = new Request((`https://` + domain + pathname + search), request);
newRequest.headers.set('Host', domain);
return fetch(newRequest);
},
};
Розгорніть і збережіть зміни.
Крок 4. Додавання маршруту до worker
Перейдіть до вашого worker sGTM → натисніть Settings → Domains & Routes → створіть новий Route. Додайте URL, який ви використовуєте для серверного GTM, що закінчується на * (у нашому прикладі це stapedesk.com/metrics*) і виберіть свій домен у розділі вибору зони.
Крок 5. Створення правила конфігурації
Поруч з іменем вашого домену натисніть на три крапки → Configure Rules.
Натисніть Create rule → Configuration Rules:
- Вкажіть зрозуміле ім'я правила, наприклад, sGTM same origin.
- Виберіть Custom filter expression.
- URI-шлях починається з
/metrics(оновіть, якщо використовуєте інший path). - SSL → виберіть варіант Full.
Натисніть Deploy.
Крок 6. Створення правила перетворення заголовка запиту
Перейдіть до Rules → Overview → Create Rule → Request Header Transform Rule:
- Введіть описову назву правила, наприклад, sGTM header.
- Виберіть Custom filter expression.
- URI-шлях починається з
/metrics(оновіть, якщо використовуєте інший path). - Задайте статичне ім'я заголовка
X-From-Cdnзі значеннямcf-stape.
Збережіть правило.
Якщо ви не використовуєте власний піддомен і проксуєте запити на стандартний піддомен Stape, вам також потрібно додати заголовок X-Stape-Host.
Перейдіть до Rules → Overview → Create Rule → Request Header Transform Rule:
- Введіть описову назву правила, наприклад, sGTM same origin Stape host.
- Виберіть Custom filter expression.
- URI-шлях починається з /metrics (оновіть, якщо використовуєте інший path).
- Задайте статичне ім'я заголовка
X-Stape-Hostзі значенням хоста, на якому відбуваються події (у нашому прикладі це stape.work).
Збережіть правило.
Крок 7. Оновлення Custom Loader
Після завершення налаштування same-origin ми також рекомендуємо оновити power-up Custom Loader для захисту від блокувальників реклами та впровадити його на ваш сайт. Не забудьте вказати в ньому ваш шлях Same Origin.
Детальніше дивіться наш посібник з Custom Loader.
Крок 8. Додавання URL серверного контейнера у веб- та серверний GTM
1. У вашому веб-контейнері GTM додайте Google Tag і вкажіть ваш Measurement ID (будь-який ID підійде для тестування). Встановіть server_container_url на налаштований вами шлях same-origin (у нашому прикладі це https://stapedesk.com/metrics).
2. Для спрощення тестування натисніть Admin → Container Settings → введіть шлях у полі Server container URLs.
3. Для тестування домену same-origin (як показано на наступному кроці) вам також потрібно буде налаштувати Client (який передаватиме дані з веб-контейнера до серверного контейнера) та тег Google Analytics: GA4 у серверному серверному GTM.
Як Client ми будемо використовувати GA4.
Щоб додати Client GA4 у серверний GTM, відкрийте розділ clients → Create New client → Виберіть тип client Google Analytics: GA4 (Web) → Додайте ім'я client і натисніть Save.
Для налаштування тега GA4 додайте новий тег з конфігурацією тега “Google Analytics: GA4” і просто вкажіть ваш Measurement ID у тезі.
Додайте тригер для тега. Він повинен спрацьовувати, коли ім'я client отримує запити (у нашому випадку Client — GA4):
Тестування налаштування Same Origin
Натисніть Preview в обох контейнерах GTM — веб і серверному.
Якщо все налаштовано правильно, серверний контейнер повинен відкритися в режимі попереднього перегляду за новим шляхом. Якщо з якоїсь причини попередній перегляд не відкривається за новим шляхом, ви можете ввести його вручну в URL вікна попереднього перегляду.
- У DNS Records Cloudflare переконайтеся, що запити до вашого основного домену проксуються через Cloudflare.
- У SSL/TLS переконайтеся, що режим шифрування встановлений у Full. Якщо ні, натисніть Configure, виберіть Full і натисніть Save. Це зміна може зайняти до 24 годин, тому дайте їй достатньо часу для оновлення.
Зайдіть на ваш сайт. У попередньому перегляді контейнера серверному ви повинні побачити вхідний page_view запит з реального домену вашого сайту.
Висновок
Додавання кастомного домену до серверного контейнера Google Tag Manager (GTM) може суттєво підвищити ефективність і гнучкість вашого серверного відстеження. У цій статті ми розглянули два методи впровадження кастомного домену.
Підхід зі спільним доменом забезпечує підвищену безпеку та спрощене управління файлами cookie — він ідеально підходить для одного цілеспрямованого домену. Налаштування субдомену забезпечує гнучкість та оптимізацію продуктивності, що підходить для складних структур із кількома доменами. Кожен варіант має свої компроміси щодо складності, продуктивності та управління. Уважно зважте ваші технічні вимоги, потреби в безпеці та цілі відстеження, щоб обрати найбільш відповідну конфігурацію для вашого серверного відстеження.
Якщо у вас виникнуть питання, відвідайте наш helpdesk або надішліть запит у службу підтримки. Наша команда фахівців із задоволенням допоможе вам із будь-якими питаннями щодо хостингу Stape та серверного трекінгу.
Коментарі