> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roxydesk.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Google Tag Manager
# Підключення та налаштування Google Tag Manager
Google Tag Manager — система керування тегами аналітики, реклами та сторонніх сервісів. Після підключення Roxy Desk завантажує в онлайн-віджет указаний контейнер, а теги, тригери та змінні ви налаштовуєте в кабінеті Google Tag Manager.
Для налаштування знадобиться ідентифікатор вебконтейнера у форматі `GTM-XXXXXXX`.
> **Важливо:** ідентифікатор контейнера не є паролем, але через опубліковану версію контейнера можна запускати аналітичні та сторонні скрипти. Використовуйте контейнер, який контролює ваша компанія, і надавайте право публікації лише довіреним користувачам.
## Перед початком
Переконайтеся, що:
* у вас є доступ до [Google Tag Manager](https://tagmanager.google.com/);
* для віджета створено вебконтейнер або ви маєте доступ до наявного;
* у контейнері підготовлені потрібні теги та тригери;
* ви маєте право редагувати інтеграції в Roxy Desk;
* збір даних відповідає політиці конфіденційності вашої компанії та налаштуванням згоди користувачів.
### Створіть або виберіть контейнер
Якщо контейнера ще немає:
1. Увійдіть до Google Tag Manager.
2. Натисніть «Create Account» і вкажіть дані облікового запису компанії.
3. Введіть назву контейнера.
4. Виберіть цільову платформу «Web».
5. Створіть контейнер і прийміть умови сервісу.
Для Roxy Desk потрібен саме вебконтейнер. Не використовуйте контейнер для Android, iOS, AMP або server-side, якщо для нього не передбачено окремого сценарію.
### Скопіюйте ідентифікатор контейнера
1. Відкрийте потрібний контейнер у Google Tag Manager.
2. Перейдіть до робочої області «Workspace».
3. Знайдіть ідентифікатор контейнера у верхній частині сторінки.
4. Скопіюйте значення повністю разом із префіксом `GTM-`.
Ідентифікатор вебконтейнера починається з `GTM-`. Не плутайте його з ідентифікатором Google Analytics формату `G-…` або Google Ads формату `AW-…`. Розташування ідентифікатора показано в [офіційній довідці Google Tag Manager](https://support.google.com/tagmanager/answer/14842866?hl=en).
### Підготуйте теги
Підключення контейнера в Roxy Desk не створює теги автоматично. У Google Tag Manager потрібно окремо:
1. Створити потрібні теги аналітики або реклами.
2. Вказати для них коректні ідентифікатори відповідних сервісів.
3. Налаштувати тригери, за яких теги мають спрацьовувати.
4. Перевірити налаштування в режимі Preview.
5. Опублікувати перевірену версію контейнера.
## 1. Відкрийте розділ «Інтеграції»
У лівому меню розгорніть розділ «Адміністрування» і натисніть «Інтеграції».
Відкриється сторінка зі списком доступних інтеграцій. У верхній частині сторінки показано загальну кількість інтеграцій, а також кількість активних і неактивних сервісів.
## 2. Знайдіть інтеграцію Google Tag Manager
Знайдіть у списку картку «Google Tag Manager».
У картці відображається поточний стан інтеграції:
* «Активний» — контейнер підключений до віджета;
* «Неактивний» — контейнер вимкнений або ще не налаштований.
Праворуч від стану розташоване меню дій із трьома крапками.
## 3. Відкрийте форму редагування
Натисніть кнопку з трьома крапками в картці Google Tag Manager і виберіть «Редагувати».
Відкриється форма «Редагування інтеграції Google Tag Manager». Якщо потрібно лише перевірити поточні налаштування без внесення змін, у меню картки виберіть «Переглянути».
## 4. Заповніть налаштування Google Tag Manager
Заповніть усі обов’язкові поля форми.
### Тип інтеграції
Переконайтеся, що в полі «Тип інтеграції» вибрано значення «Система аналітики».
### Стан
Виберіть потрібний стан:
* «Активний» — щоб Roxy Desk підключив контейнер до віджета;
* «Неактивний» — щоб зберегти ідентифікатор, але не завантажувати контейнер у віджеті.
Для завершення підключення виберіть «Активний».
### Ідентифікатор контейнера
Вставте в поле «Ідентифікатор контейнера» значення з Google Tag Manager.
Перевірте, що:
* значення починається з `GTM-`;
* після префікса вказана повна буквено-цифрова частина;
* перед ідентифікатором і після нього немає пробілів;
* ви не вставили весь код встановлення контейнера;
* ви не використали ідентифікатор Google Analytics `G-…` або Google Ads `AW-…`;
* контейнер належить потрібній компанії та призначений для вебсередовища.
## 5. Збережіть налаштування
Перед збереженням перевірте:
* тип інтеграції — «Система аналітики»;
* стан — «Активний»;
* ідентифікатор має формат `GTM-…`;
* у значенні немає зайвих символів або пробілів.
Натисніть «Зберегти» в нижній частині форми.
Якщо система показує помилку біля поля, перевірте формат ідентифікатора та повторіть збереження.
## 6. Перевірте стан інтеграції
Поверніться до картки Google Tag Manager у списку інтеграцій.
Якщо під час налаштування було вибрано «Активний», картка також має показувати стан «Активний». Це означає, що Roxy Desk зберіг ідентифікатор і має підключати контейнер до віджета.
Для додаткової перевірки відкрийте меню картки, виберіть «Переглянути» та переконайтеся, що збережений правильний ідентифікатор.
## 7. Перевірте контейнер через Tag Assistant
1. У Google Tag Manager відкрийте потрібний контейнер.
2. Натисніть «Preview» у верхній частині робочої області.
3. Введіть адресу сторінки, на якій відкривається віджет Roxy Desk.
4. Натисніть «Connect».
5. Відкрийте віджет і виконайте дії, для яких налаштовані тригери.
6. У Tag Assistant перевірте, які теги спрацювали, а які — ні.
Режим Preview дозволяє перевірити чернетку контейнера до публікації. Докладний порядок наведено в [інструкції Google з попереднього перегляду та налагодження](https://support.google.com/tagmanager/answer/6107056?hl=en).
## 8. Опублікуйте контейнер
Після успішної перевірки:
1. У Google Tag Manager натисніть «Submit».
2. Виберіть «Publish and Create Version».
3. Вкажіть зрозумілі назву й опис версії.
4. Перевірте перелік змін.
5. Натисніть «Publish».
Неопубліковані зміни доступні лише в робочій області або режимі Preview і не працюватимуть для звичайних відвідувачів. Порядок публікації описано в [офіційній довідці Google](https://support.google.com/tagmanager/answer/6107163?hl=en).
## Як змінити або вимкнути інтеграцію
1. Відкрийте `Адміністрування → Інтеграції`.
2. Знайдіть картку Google Tag Manager.
3. Натисніть кнопку з трьома крапками та виберіть «Редагувати».
4. Вставте інший ідентифікатор або встановіть стан «Неактивний».
5. Натисніть «Зберегти».
Після вимкнення Roxy Desk не повинен завантажувати контейнер у віджеті. Історичні дані, які вже були передані зовнішнім системам, при цьому не видаляються.
## Якщо контейнер або теги не працюють
Перевірте налаштування у такому порядку:
1. Переконайтеся, що картка Google Tag Manager має стан «Активний».
2. Повторно скопіюйте ідентифікатор із потрібного контейнера.
3. Перевірте префікс `GTM-` і відсутність зайвих пробілів.
4. Переконайтеся, що використовується вебконтейнер.
5. Відкрийте саме ту сторінку, де завантажується віджет Roxy Desk.
6. Перевірте підключення контейнера через режим Preview і Tag Assistant.
7. Перевірте умови тригерів і налаштування тегів.
8. Переконайтеся, що потрібна версія контейнера опублікована.
9. Перевірте налаштування згоди користувача, блокувальники реклами та обмеження браузера.
10. Якщо контейнер завантажується, але очікуваної події немає, зафіксуйте сторінку, дію, час перевірки та ідентифікатор контейнера й передайте ці дані підтримці.
Перелік подій і даних, які Roxy Desk передає до `dataLayer`, у наданому сценарії не визначений. Якщо для тегів потрібні спеціальні події віджета, їхню наявність і назви потрібно уточнити окремо.