Як додати кастомний домен до серверного контейнера Google Tag Manager

Автор:

Ira Holubovska

Оновлено 19 трав. 2026 р. коментарів

У цій статті ми опишемо, як налаштувати кастомний домен у серверному контейнері 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:

Використання субдомену.
Використання спільного домену.

Використання субдомену

Використовуйте власний URL-адресу сервера тегування, який також називають власним доменом, для встановлення власних файлів cookie. Ця URL-адреса повинна використовувати той самий кореневий домен, що й ваш веб-сайт. Наприклад, якщо ваш веб-сайт — `example.com`, URL-адреса вашого сервера тегування може бути `ss.example.com`.

Існує три способи налаштування власного домену:

Одне походження — сервер тегування має той самий домен і шлях, що й ваш сайт. Дізнайтеся більше про те, як налаштувати власний домен з однаковим походженням.
Піддомен — сервер тегування працює на піддомені вашого кореневого домену. У цій статті ми розповімо, як це налаштувати.
Домен за замовчуванням — власний домен відсутній; використовується стандартна адреса, надана Stape.

Детальне порівняння цих методів дивіться в посібнику щодо доменів GTM на стороні сервера.

Крок 1. Додайте свій кастомний домен

Оберіть свій контейнер у Stape, прокрутіть сторінку вниз і натисніть Add custom domain.

Як додати кастомний домен в акаунті Stape

Додайте 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-запису

Додавання кастомного субдомену за допомогою A і AAAA-записів

Зверніть увагу: A/AAAA-записи несумісні з увімкненим CDN.

Крок 5. Верифікуйте домен

Після введення DNS-записів у свого DNS-провайдера поверніться на сторінку контейнера Stape, де ви налаштовували кастомний домен, і натисніть Verify.

Зачекайте, поки 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)

Попередні вимоги

Перед початком переконайтеся, що у вас є наступне:

Контейнер серверного Google Tag Manager, налаштований на Stape.
Контейнер CDN або балансувальник навантаження, здатний переадресовувати запити, через який проходить весь трафік вашого сайту.
Якщо ви використовуєте App Engine, сервер тегування повинен працювати на версії 2.2.0 або пізнішій.

Примітка:

Для коректної роботи деяких тегів ваш CDN не повинен застосовувати кешування або сортування рядків запиту. Query String Sort від Cloudflare або URL normalization, наприклад, заважатиме роботі sendPixelFromBrowser API, який використовується деякими серверними тегами.

Покрокове налаштування домену same-origin

Залежно від вашої інфраструктури ви можете налаштувати користувацький домен same-origin за допомогою різних платформ і сервісів. Ось посібники для кожного з них:

Примітка:

Якщо ви використовуєте платформу, не зазначену вище, будемо вдячні, якщо ви надішлете свої пропозиції на support@stape.io.

Нижче ми розглянемо налаштування на прикладі 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.shop.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

Перейдіть до вашого sGTM worker → натисніть Domains → Add domain → Route pattern. Виберіть свій домен зі списку та додайте URL, який ви використовуєте для server GTM, що закінчується на * (у нашому прикладі це shop.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.

Збережіть правило.

Крок 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 вікна попереднього перегляду.

Зайдіть на ваш сайт. У попередньому перегляді контейнера серверному ви повинні побачити вхідний page_view запит з реального домену вашого сайту.

Висновок

Додавання кастомного домену до серверного контейнера Google Tag Manager (GTM) може суттєво підвищити ефективність і гнучкість вашого серверного відстеження. У цій статті ми розглянули два методи впровадження кастомного домену.

Підхід зі спільним доменом забезпечує підвищену безпеку та спрощене управління файлами cookie — він ідеально підходить для одного цілеспрямованого домену. Налаштування субдомену забезпечує гнучкість та оптимізацію продуктивності, що підходить для складних структур із кількома доменами. Кожен варіант має свої компроміси щодо складності, продуктивності та управління. Уважно зважте ваші технічні вимоги, потреби в безпеці та цілі відстеження, щоб обрати найбільш відповідну конфігурацію для вашого серверного відстеження.

Якщо у вас виникнуть питання, відвідайте наш helpdesk або надішліть запит у службу підтримки. Наша команда фахівців із задоволенням допоможе вам із будь-якими питаннями щодо хостингу Stape та серверного трекінгу.

Хочете приєднатися до серверної сторони?

Спробувати безкоштовно

Автор:

Ira Holubovska

Content writer

Ira має понад 10 років досвіду в цифровому маркетингу, з яких останні 5 років зосереджені на серверному відстеженні. Вона знає, як і коли використовувати це в різних маркетингових ситуаціях.

Ця стаття була корисною?

Коментарі

Схожі пости

Блог

Термін дії сторонніх файлів cookie скоро закінчиться. Чи допоможе відстеження на стороні сервера?

4 черв. 2025 р.

Блог

Скільки коштує server GTM і чому Stape дешевше, ніж Google Cloud Run

Яку вартість можна очікувати за сервер Менеджера тегів Google, розміщений у Google Cloud? Чи варто використовувати тестове середовище на виробничому сайті. Чому хостинг Stape для сервера GTM дешевший і як ми захищаємо дані наших користувачів.

4 верес. 2025 р.

Перетворіть якісніше відстеження на кращі маркетингові результати

Спробувати безкоштовно