Подключить GA4

Это руководство проведет вас через весь процесс настройки: открытие подключения GA4, авторизацию правильного аккаунта Google, выбор ресурса для вашего работающего сайта, публикацию обновления отслеживания, подтверждение того, что данные собираются, и подготовку подключения для проверки Google Search Console.

Как работает подключение GA4

Ресурс GA4 — это ресурс Google Analytics, который собирает данные для сайта или приложения и формирует отчеты по ним. Atoms использует аккаунт Google, который вы авторизуете, чтобы найти аккаунты Analytics и ресурсы, к которым у этого аккаунта есть доступ. Подключите ресурс, используемый опубликованным сайтом для вашего текущего проекта Atoms.

Настройка состоит из трех частей:

1. Авторизуйте аккаунт Google. Войдите в аккаунт, у которого есть доступ к нужному ресурсу GA4, и одобрите запрошенные разрешения Google.
2. Подключите соответствующий ресурс. Выберите аккаунт Analytics и ресурс GA4, используемые работающим сайтом вашего проекта.
3. Добавьте настройку отслеживания, опубликуйте и проверьте отчетность. Дождитесь, пока Atoms добавит конфигурацию отслеживания, просмотрите и опубликуйте обновленный сайт, затем подтвердите, что подключен правильный ресурс и что он получает данные.

Подключение GA4 отделено от рабочего процесса SEO-контента Sarah. Sarah может планировать и генерировать SEO-страницы без GA4. Это подключение используется для отчетности Analytics.

Подключение GA4, авторизованное пользователем, также может поддерживать автоматическую проверку сайта, когда вы позже подключите Google Search Console, если подключение соответствует требованиям Google.

Перед началом

Перед подключением Google Analytics 4 (GA4) убедитесь, что:

• Вы являетесь владельцем проекта. Другие участники могут иметь возможность просматривать проект, но только владелец может управлять его подключением GA4.
• У вас есть аккаунт Google с доступом к ресурсу GA4, используемому вашим сайтом.
• Вы знаете, какой ресурс GA4 относится к опубликованному сайту. Если у нескольких ресурсов похожие названия, сначала проверьте сайт или поток веб-данных в Google Analytics.
• Ваш сайт был сгенерирован и опубликован или готов к публикации. Если Marketing → Analytics предлагает вам начать создание сайта, завершите его генерацию, прежде чем продолжить.
• Ваш Браузер разрешает всплывающие окна авторизации Google из Atoms.
• Любая текущая задача Sarah или Alex завершена, прежде чем вы измените подключение Marketing.

Вы можете подключить GA4 до того, как ваш пользовательский домен начнет работать. Однако ваш опубликованный сайт должен отправлять данные в подключенный ресурс, прежде чем смогут появиться отчеты Analytics.

Если вы планируете использовать GA4 для помощи в проверке вашего сайта в Google Search Console, используйте один и тот же аккаунт Google для обоих подключений. Этот аккаунт также должен иметь доступ на редактирование к ресурсу GA4.

Если вы не можете получить доступ к ресурсу, попросите администратора Google Analytics предоставить вам необходимый доступ. См. руководство Google по доступу пользователей Analytics.

Если у вашего аккаунта Google еще нет аккаунта Analytics, ресурса или потока веб-данных, Atoms может предложить вам создать их во время настройки. Вы также можете создать их напрямую в Google Analytics, используя руководство Google по настройке Analytics для сайта.

Разрешение Google Analytics: Используйте аккаунт Google, у которого есть доступ к аккаунту Analytics и ресурсу GA4 для этого сайта. Выбор существующего ресурса или потока веб-данных требует доступа к этому ресурсу. Создание аккаунта Analytics, ресурса GA4 или потока веб-данных в процессе настройки требует разрешения Editor (или эквивалентного) на соответствующем уровне Analytics. Если ресурс отсутствует или у вас нет необходимого разрешения, попросите администратора Analytics предоставить доступ или сначала создать ресурс в Google Analytics, затем вернитесь в Atoms и выберите Refresh.

Никогда не вставляйте пароли Google, коды подтверждения, токены доступа или другие учетные данные в чат.

Подключение Google Analytics 4

Откройте коннектор GA4

1. Откройте проект Atoms, опубликованный сайт которого вы хотите измерять.
2. Выберите Marketing на панели инструментов проекта.
3. Откройте Analytics. Если вы начинаете с Overview, вы также можете найти карточку Analytics в разделе Marketing и выбрать Set up Analytics.
4. Выберите Authorize GA4. Это авторизует аккаунт Google; ресурс вы подключите на следующем шаге.

Авторизуйте Google Analytics 4 из Marketing

Авторизуйте аккаунт Google

1. В окне авторизации Google войдите в аккаунт Google, у которого есть доступ к ресурсу GA4 для этого сайта.
2. Проверьте, что выбран правильный аккаунт Google.
3. Просмотрите доступ, который запрашивает Atoms. Продолжайте, только если вы согласны.
4. Вернитесь в Atoms и дождитесь завершения шага авторизации.

Если Браузер блокирует окно авторизации, разрешите всплывающие окна для Atoms и попробуйте снова. Если Atoms предлагает Open authorization page, используйте этот вариант, чтобы продолжить в новой вкладке.

Подключите ресурс для работающего сайта

После авторизации вашего аккаунта Google Atoms показывает аккаунты и ресурсы Google Analytics, к которым у вас есть доступ. То, что вы увидите дальше, может различаться в зависимости от того, сколько ресурсов Analytics связано с вашим аккаунтом.

1. Если Atoms просит вас выбрать Analytics account, выберите тот, который содержит ресурс для вашего сайта.
2. Выберите GA4 property, используемый вашим опубликованным сайтом. Если вы не уверены, какой выбрать, сначала проверьте ресурс в Google Analytics.
3. Если появляется web data stream, подтвердите, что он использует правильный адрес работающего сайта.
4. Выберите Connect property.
5. Не закрывайте страницу, пока Atoms не подтвердит, что подключение завершено.

Если часть настройки Analytics отсутствует:

• Нет аккаунта Analytics: Если доступно, выберите Let Atoms create it for you fast, завершите настройку Google, затем вернитесь в Atoms и выберите Refresh.
• Нет ресурса GA4: Выберите правильный аккаунт Analytics, затем выберите Create property in Atoms и дождитесь появления нового ресурса.
• Нет потока веб-данных: Выберите ресурс и нажмите Quick Create в разделе Create web stream, либо создайте его вручную в Google Analytics Admin.

Если аккаунт, ресурс или поток данных, который уже должен существовать, не отображается, проверьте, что вы используете правильный аккаунт Google и имеете к нему доступ. Если он был создан недавно или вам только что предоставили к нему доступ, немного подождите и выберите Refresh.

Подключите ресурс GA4, используемый работающим сайтом

Завершите обновление отслеживания и опубликуйте сайт

Подключение ресурса Google само по себе не заставляет опубликованный сайт начать собирать данные. После того как Atoms подтвердит подключение ресурса, он запускает задачу проекта для добавления конфигурации отслеживания Analytics на сайт.

1. Дождитесь завершения задачи отслеживания. Не запускайте другую сборку или задачу Marketing, пока выполняется обновление.
2. Просмотрите завершенное изменение и предварительно просмотрите сайт. Убедитесь, что сайт по-прежнему загружается и работает как ожидается.
3. Опубликуйте обновленный проект. Если сайт уже был доступен, убедитесь, что теперь опубликована именно новая обновленная версия.
4. Откройте опубликованную главную страницу в новой вкладке и используйте сайт как обычно, чтобы создать тестовое посещение.
5. Вернитесь в Marketing → Analytics, чтобы проверить подключение и, после того как Google обработает посещение, состояние отчетности.

Ожидаемый результат: Atoms показывает, что подключен нужный ресурс, обновление отслеживания присутствует в опубликованной версии, а работающий сайт начинает отправлять новую активность в этот ресурс. Подключение GA4 не создает исторические данные об активности, которая произошла до начала сбора.

Проверьте, что подключение сработало

1. Вернитесь в Marketing → Analytics.
2. Убедитесь, что в настройке Google Analytics 4 больше не отображается исходное приглашение к подключению.
3. Проверьте, что подключенный аккаунт или ресурс соответствует работающему сайту.
4. Если область отчетности Analytics доступна, откройте ее и выберите недавний диапазон дат.
5. Если сайт новый, посетите опубликованный сайт и вернитесь позже, чтобы проверить обработанные данные.

Пустой отчет не обязательно означает, что авторизация не удалась. Рассматривайте состояние подключенного ресурса и состояние отчетности как отдельные контрольные точки. Убедитесь, что задача отслеживания завершилась, обновленная версия опубликована и тот же ресурс получает события с работающего сайта. Google отмечает, что заполнение многих стандартных отчетов GA4 после начала сбора может занять 24–48 часов; используйте Google Analytics Realtime, если вам нужна более ранняя проверка сбора. См. руководство Google по проверке сбора данных.

Просмотрите отчетность Analytics после того, как данные GA4 станут доступны

Восстановление после неудачного подключения GA4

Используйте состояние, на котором произошел сбой, чтобы выбрать следующее безопасное действие. При неудачной авторизации или загрузке списка ресурсов обычно требуется заново открыть окно авторизации, выбрать правильную учетную запись Google или выполнить обновление после предоставления доступа. Если ресурс подключен, но данных отчетности нет, перед повторной попыткой подключения нужно проверить задачу отслеживания и публикацию.

• Сбой авторизации или загрузки аккаунта: Разрешите всплывающие окна, снова откройте Open authorization page, если этот вариант предлагается, подтвердите нужную учетную запись Google и повторите попытку один раз.
• Отсутствует аккаунт, ресурс или поток: Подтвердите необходимый доступ и разрешение Editor для создания, затем выберите Refresh после того, как недавно созданный или предоставленный вам ресурс станет доступен.
• Ресурс подключается, но отслеживание или отчетность не работают: Дождитесь завершения задачи отслеживания, просмотрите и опубликуйте последнюю версию, убедитесь, что подключенный ресурс соответствует работающему сайту, и используйте Google Analytics Realtime или учитывайте задокументированную задержку отчетности перед повторной попыткой.

Если тот же этап по-прежнему завершается сбоем после одной повторной попытки, обратитесь в поддержку Atoms или к администратору вашего рабочего пространства. Укажите название проекта, название подключенного ресурса, если оно отображается, этап сбоя, видимый статус или текст ошибки, примерное время и скриншот с удаленными конфиденциальными данными. Никогда не включайте пароли, коды подтверждения, токены доступа, коды OAuth или другие учетные данные.

Использование GA4 с Google Search Console

Проверка Search Console на основе Google Analytics является условной. В Atoms функция Auto Verify via Google Analytics требует подходящего пользовательского подключения GA4 с авторизацией. Управляемая настройка GA4, созданная Atoms, не может использовать это действие автоматической проверки. GA4 не требуется, если вы используете один из ручных методов проверки Google.

Чтобы настроить и проверить ваш сайт в Search Console, см. Connect Google Search Console для получения полных шагов и требований.

Метод проверки Google через Analytics также требует общедоступную главную страницу, содержащую поддерживаемый тег Analytics, и применяется к свойству Search Console с префиксом URL, а не к свойству Domain. Если автоматическая проверка недоступна, потому что настройка GA4 управляется Atoms или не выполнено какое-либо требование Google, продолжайте с Verify manually in Google Search Console. См. требования Google к подтверждению права собственности на сайт.

Для связанного рабочего процесса контента и отчетности см. SEO Agent.