Что такое Client ID в Google Analytics? – This is Data

Автор: Роман Романчук 05.06.201712.04.2018

Client ID (в простонародье cid) — это обезличенный идентификатор, который создает Google Analytics для каждого посетителя сайта. Именно благодаря данному идентификатору и определяется уникальный пользователь. Но что такое «уникальный пользователь»? Давайте разбираться.

Люди могут заходить на ваш сайт не только при помощи стационарного компьютера или ноутбука, но и со смартфона и любого другого мобильного гаджета, а также с используя различные браузеры. Так вот, по умолчанию Google Analytics назначает каждому устройству и браузеру уникальный идентификатор клиента – Client ID.

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

Зачем нужен Client ID?

Благодаря Client ID Google Analytics может «узнавать» и различать уникальных посетителей и их сессии, связывать данные по ним, поступившие в разные периоды времени, а также хранить эти данные.

Где хранится Client ID?

По умолчанию библиотека analytics.js (которую вы подключаете, устанавливая код GA на сайте) сохраняет идентификатор клиента в cookie браузера посетителя создавая следующие файлы:

Название файла cookie	Срок действия	Описание
_ga	2 года	Позволяет различать пользователей.
_gid	24 часа	Позволяет различать пользователей.
_gat	10 минут	Ограничивает частоту запросов.

Нас интересует кука _ga которая и хранит Client ID. Срок ее жизни 2 года, однако он обновляется с каждым новым хитом.

Из чего состоит Client ID?

Кука _ga состоит из 4-х частей:

Где:

1. Формат версии cookie (сейчас он всего один).
2. Уровень домена (по умолчанию устанавливается домен верхнего уровня).
3. Уникальный случайно-сгенерированный идентификатор.
4. Дата первого посещения сайта в формате UNIX.

Третья и четвертая часть куки образуют Client ID.

Как найти Client ID?

Увидеть Client ID можно либо открыв консоль браузера (F12 в Chrome):

Либо найдя в настройках браузера сохраненные куки сайтов:

Кстати, если очистить кукис и обновить страницу, то сгенерируется новый Client ID. То есть Google Analytics будет считать вас новым пользователем 🙂

Как фиксировать Client ID?

Фиксировать Client ID лучше всего через GTM, про это у нас написана отдельная статья.

Кросс-девайсное отслеживание или как объединить несколько Client ID?

Как уже было сказано выше, разные устройства одного и того же человека Google Analytics будет считать разными уникальными пользователями. Но есть ли возможность «склеить» все устройства пользователя независимо от того, как и на чем он открывают ваш сайт ? Да есть! Для этого в Google Analytics предусмотрена специальная функция — User ID.

Подробнее о User ID я расскажу в своей следующей статье.

• Об авторе
• Свежие записи

Роман Романчук

Эксперт по аналитике данных, ex-директор по аналитике Сравни.ру. Директор команды данных в Xsolla.

Рубрика: Сбор данных | Тег: Google Analytics

Client ID & User ID Google Analytics: основы и отличия

Для многих, кто работает с Google Analytics на пользовательском уровне, в большинстве случаев Client ID и User ID является одним и тем же, но это далеко не так. Разберемся, почему это является заблуждением.

Самое основное это то, что каждая трековая система идентифицирует своих пользователей посредством присвоения конкретных идентификаторов, чтобы различать пользователей в будущем. Как правило, это осуществляется путем записи в cookies пользователя, о чем мы ранее уже говорили в нашей статье. Пройдемся по терминологии и основам каждой системы.

Client ID — автоматическая идентификация пользователей посредством Google Analytics с записью ID в файлы cookies браузера сроком до 2-х лет.

Согласно определения, привязка должна идти к браузеру. И по логике, в Google Analytics должна идти статистика по браузерам, но не пользователям. Логически да, но это не совсем так, и многие аналитики в этом вопросе заблуждаются.

👉 Google Analytics все-таки объединяет данные пользователей через Client ID, при наличии залогиненого аккаунта Google и согласно персонализированных настроек каждого пользователя.

Об этом свидетельствует наличие таких отчетов как:

• пересечение устройств;
• многоканальные последовательности.

Записывается Client ID в cookies в поле “_ga” и имеет следующий вид значения:

GA1.*.**********.**********

В сети есть разные мнения по поводу первых 2-х параметров, но они не подтверждены разработчиком самой аналитики. Сам Client ID это 2 раза по 10 цифр через точку — **********.**********.

Итого, если говорить про Client ID как об универсальном решении — Google идет в этом вопросе к совершенству, но не все пока удается, так как не все имеют залогиненные Google аккаунты. Именно поэтому был придуман User ID, как оптимальное решение.

User ID — уникальный идентификатор пользователя, присвоенный администратором сайта посредством своих алгоритмов.

Это, как правило, анонимное значение, которое не хранится в файлах cookies и используются в проектах, которые могут самостоятельно идентифицировать пользователей. Некоторые используют User ID даже для передачи данных в CRM систему для более легкого учета.

По мнению самих разработчиков Google Analytics, функция

User ID позволяет более точно идентифицировать пользователей, так как осуществляется ручное присвоение параметров пользователя в момент его аутентификации или пользовательского определения. Дополнительно осуществляется синхронизация поведения на разных устройствах, и это также происходит при идентификации.

Для передачи User ID в Google Analytics достаточно в современный код gtag.js добавить:

gtag('set', {'user_id': 'USER_ID'})

Если Вы используете Google Tag Manager, то чтобы отслеживать User ID необходимо:

• добавить внутри тега Google Analytics дополнительное поле — userId;
• через Data Layer организовать передачу значения пользовательской переменной userId.

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

Возможно это сложно для понимания, но на деле работает. Надеемся, что этот материал был для Вас полезным. До новых встреч в нашем блоге!

Поиск идентификатора клиента и секрета клиента

Чтобы найти идентификатор клиента и секрет вашего клиента Azure, выполните действия, перечисленные ниже.

• Перейдите по адресу https://portal.azure.com/#home и войдите на портал Azure, используя учетные данные администратора.
• Если ваша учетная запись дает вам доступ к более чем одному арендатору, выберите свою учетную запись в правом верхнем углу. Настройте сеанс портала на нужного арендатора Azure AD.
• На левой панели выберите Azure Active Directory .
• В Azure Active Directory выберите Регистрация приложений на левой панели
• Выберите
  Новая регистрация .
• В разделе Регистрация приложения введите осмысленное имя приложения, которое будет отображаться для пользователей. Выберите, кто может использовать это приложение в зависимости от вашей среды, и нажмите 9.0010 Регистр .
• После регистрации приложения нажмите кнопку Просмотр разрешений API .
• Выберите Добавьте разрешение .
• Выберите Microsoft Graph .
• Выберите Разрешения приложения . С помощью предоставленного поля поиска добавьте следующие разрешения: Application.ReadWrite.All, Device.ReadWrite.All, Directory.ReadWrite.All, Domain.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, ServicePrincipalEndpoint.ReadWrite. .All, Sites.FullControl.All, User.
  Read.All и User.ReadWrite.All. Нажмите Добавить права кнопка.
• После того, как вы выбрали все разрешения графа, ваш экран разрешений API будет выглядеть примерно так.
• Выберите Добавьте разрешение и выберите SharePoint .

• Выберите следующие разрешения SharePoint: Sites.FullControl.All (разрешение приложения), TermStore.ReadWrite.All (разрешение приложения), User.ReadWrite.All (разрешение приложения), User.ReadWrite.All (делегированное разрешение).
• Нажмите кнопку Предоставить согласие администратора для <имя клиента> , где <имя клиента> будет именем вашего клиента Azure.
• Выберите Да , чтобы подтвердить свой выбор.
• Нажмите Сертификаты и секреты на левой панели.
• Выберите Новый секрет клиента 9кнопка 0011.
• Укажите описание секрета клиента, продолжительность действия секрета клиента и нажмите Добавить .
• Скопируйте строку под столбцом Value . Вы не сможете получить его после того, как выполните другую операцию или покинете эту страницу. Используйте значок копирования, отмеченный ниже.
• Click Обзор на левой панели и скопируйте идентификатор клиента.

Теперь вы можете использовать идентификатор клиента и секрет в течение времени, указанного в поле срока действия, после чего вам придется повторить процесс.

Краткое руководство: зарегистрируйте приложение на платформе Microsoft Identity — Microsoft Entra

• Статья
• 14. 11.2022
• 8 минут на чтение

Начните работу с платформой Microsoft Identity, зарегистрировав приложение на портале Azure.

Платформа удостоверений Майкрософт выполняет управление удостоверениями и доступом (IAM) только для зарегистрированных приложений. Будь то клиентское приложение, такое как веб-приложение или мобильное приложение, или веб-API, поддерживающий клиентское приложение, его регистрация устанавливает доверительные отношения между вашим приложением и поставщиком удостоверений, платформой удостоверений Майкрософт.

Совет

Чтобы зарегистрировать приложение для Azure AD B2C, выполните действия, описанные в разделе Учебник. Зарегистрируйте веб-приложение в Azure AD B2C.

Предварительные условия

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно.
• У учетной записи Azure должно быть разрешение на управление приложениями в Azure Active Directory (Azure AD). Любая из следующих ролей Azure AD включает необходимые разрешения:
  • Администратор приложений
  • Разработчик приложения
  • Администратор облачных приложений
• Завершение краткого руководства по настройке арендатора.

Регистрация приложения

Регистрация приложения устанавливает доверительные отношения между вашим приложением и платформой идентификации Microsoft. Доверие является однонаправленным: ваше приложение доверяет платформе Microsoft Identity, а не наоборот.

Выполните следующие действия, чтобы создать регистрацию приложения:

1. Войдите на портал Azure.

2. Если у вас есть доступ к нескольким арендаторам, используйте фильтр Каталоги + подписки в верхнем меню переключиться на арендатора, в котором вы хотите зарегистрировать приложение.

3. Найдите и выберите Azure Active Directory .

4. В разделе Управление выберите Регистрация приложений > Новая регистрация .

5. Введите дисплей Имя для вашего приложения. Пользователи вашего приложения могут видеть отображаемое имя при использовании приложения, например, при входе в систему. Вы можете изменить отображаемое имя в любое время, и несколько регистраций приложений могут использовать одно и то же имя. Автоматически созданный идентификатор приложения (клиента) при регистрации приложения, а не его отображаемое имя, однозначно идентифицирует ваше приложение на платформе идентификации.

6. Укажите, кто может использовать приложение, иногда называемое его входная аудитория .

   Поддерживаемые типы учетных записей	Описание
   Только учетные записи в этом организационном каталоге	Выберите этот параметр, если вы создаете приложение для использования только пользователями (или гостями) в вашем клиенте . Часто называемое бизнес-приложением (LOB) , это приложение с одним арендатором на платформе Microsoft Identity.
   Учетные записи в любом каталоге организации	Выберите этот параметр, если вы хотите, чтобы пользователи любого клиента Azure Active Directory (Azure AD) могли использовать ваше приложение. Этот вариант подходит, если, например, вы создаете приложение «программное обеспечение как услуга» (SaaS), которое собираетесь предоставлять нескольким организациям. Этот тип приложения известен как многопользовательское приложение на платформе Microsoft Identity.
   Учетные записи в любом организационном каталоге и личные учетные записи Microsoft	Выберите этот параметр, чтобы настроить таргетинг на самый широкий круг клиентов. Выбирая этот параметр, вы регистрируете многопользовательское приложение, которое также может поддерживать пользователей, имеющих личные учетные записи Microsoft .
   Личные учетные записи Майкрософт	Выберите этот параметр, если вы создаете приложение только для пользователей, имеющих личные учетные записи Майкрософт. К личным учетным записям Microsoft относятся учетные записи Skype, Xbox, Live и Hotmail.

7. Ничего не вводите для URI перенаправления (необязательно) . В следующем разделе вы настроите URI перенаправления.

8. Выберите Зарегистрировать , чтобы завершить первоначальную регистрацию приложения.

По завершении регистрации на портале Azure отображается панель регистрации приложения Обзор . Вы видите приложение (клиент) ID . Также называется идентификатором клиента 9.0204 , это значение однозначно идентифицирует ваше приложение на платформе Microsoft Identity.

Важно

Регистрация новых приложений по умолчанию скрыта от пользователей. Когда вы будете готовы к тому, чтобы пользователи увидели приложение на своей странице «Мои приложения», вы можете включить его. Чтобы включить приложение, на портале Azure перейдите к Azure Active Directory > Корпоративные приложения и выберите приложение. Затем на странице Свойства переключите Видно пользователям? до Да.

Код вашего приложения или, чаще всего, библиотека проверки подлинности, используемая в вашем приложении, также использует идентификатор клиента. Идентификатор используется как часть проверки маркеров безопасности, которые он получает от платформы идентификации.

Добавить URI перенаправления

URI перенаправления — это место, куда платформа удостоверений Майкрософт перенаправляет клиент пользователя и отправляет маркеры безопасности после проверки подлинности.

Например, в рабочем веб-приложении URI перенаправления часто является общедоступной конечной точкой, где работает ваше приложение, например https://contoso.com/auth-response . Во время разработки обычно также добавляют конечную точку, в которой вы запускаете приложение локально, например https://127.0.0.1/auth-response или http://localhost/auth-response .

Вы добавляете и изменяете URI перенаправления для зарегистрированных приложений, настраивая параметры их платформы.

Настройка параметров платформы

Параметры для каждого типа приложения, включая URI перенаправления, настраиваются в Конфигурации платформы на портале Azure. Некоторые платформы, такие как Web и Одностраничные приложения , требуют, чтобы вы вручную указали URI перенаправления. Для других платформ, таких как мобильные и настольные, вы можете выбрать один из URI перенаправления, сгенерированных для вас при настройке других их параметров.

Чтобы настроить параметры приложения в зависимости от целевой платформы или устройства, выполните следующие действия:

1. На портале Azure в разделе Регистрация приложений выберите свое приложение.

2. В разделе Управление выберите Аутентификация .

3. В разделе Конфигурации платформы выберите Добавить платформу .

4. В разделе Настройка платформ выберите плитку для вашего типа приложения (платформы), чтобы настроить его параметры.

   Платформа	Параметры конфигурации
   Сеть	Введите URI перенаправления для вашего приложения. Этот универсальный код ресурса (URI) — это место, где платформа удостоверений Майкрософт перенаправляет клиент пользователя и отправляет маркеры безопасности после проверки подлинности. Выберите эту платформу для стандартных веб-приложений, работающих на сервере.
   Одностраничное приложение	Введите URI перенаправления для вашего приложения. Этот универсальный код ресурса (URI) — это место, где платформа удостоверений Майкрософт перенаправляет клиент пользователя и отправляет маркеры безопасности после проверки подлинности. Выберите эту платформу, если вы создаете клиентское веб-приложение с помощью JavaScript или такой платформы, как Angular, Vue. js, React.js или Blazor WebAssembly.
   iOS/macOS	Введите идентификатор пакета приложения . Найдите его в Build Settings или в Xcode в Info.plist . При указании идентификатора пакета создается URI перенаправления.
   Андроид	Введите приложение Имя пакета . Найдите его в файле AndroidManifest.xml . Также сгенерируйте и введите хэш подписи . При указании этих параметров для вас создается URI перенаправления.
   Мобильные и настольные приложения	Выберите один из предлагаемых URI перенаправления . Или укажите Пользовательский URI перенаправления . Для настольных приложений, использующих встроенный браузер, рекомендуется https://login.microsoftonline. com/common/oauth3/nativeclient Для настольных приложений, использующих системный браузер, мы рекомендуем http://localhost Выберите эту платформу для мобильных приложений, которые не используют последнюю версию Microsoft Authentication Library (MSAL) или не используете посредника. Также выберите эту платформу для настольных приложений.

5. Выберите Configure , чтобы завершить настройку платформы.

Ограничения URI перенаправления

Существуют некоторые ограничения на формат URI перенаправления, которые вы добавляете к регистрации приложения. Дополнительные сведения об этих ограничениях см. в разделе Ограничения и ограничения URI перенаправления (URL-адрес ответа).

Добавить учетные данные

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

Вы можете добавить как сертификаты, так и секреты клиента (строку) в качестве учетных данных при регистрации конфиденциального клиентского приложения.

Добавить сертификат

Иногда его называют открытым ключом . Рекомендуемым типом учетных данных является сертификат, поскольку он считается более безопасным, чем секреты клиента. Дополнительные сведения об использовании сертификата в качестве метода проверки подлинности в приложении см. в разделе Учетные данные сертификата проверки подлинности приложения Microsoft Identity Platform.

1. На портале Azure в разделе Регистрация приложений выберите свое приложение.
2. Выберите Сертификаты и секреты > Сертификаты > Загрузить сертификат .
3. Выберите файл, который хотите загрузить. Это должен быть файл одного из следующих типов: .cer , .pem , .crt .
4. Выбрать Добавить .

Добавить секрет клиента

Иногда называется пароль приложения , секрет клиента — это строковое значение, которое ваше приложение может использовать вместо сертификата для идентификации себя.

Секреты клиента считаются менее безопасными, чем учетные данные сертификата. Разработчики приложений иногда используют секреты клиента во время разработки локальных приложений из-за простоты их использования. Однако вы должны использовать учетные данные сертификата для любого из ваших приложений, работающих в рабочей среде.

1. На портале Azure в Регистрация приложений , выберите свое приложение.
2. Выберите Сертификаты и секреты > Секреты клиента > Новый секрет клиента .
3. Добавьте описание секрета вашего клиента.
4. Выберите срок действия секрета или укажите пользовательское время жизни.
   • Срок действия секрета клиента ограничен двумя годами (24 месяца) или менее. Вы не можете указать пользовательское время жизни более 24 месяцев.
   • Корпорация Майкрософт рекомендует установить срок действия менее 12 месяцев.
5. Выбрать Добавить .
6. Запишите значение секрета для использования в коде вашего клиентского приложения. Это секретное значение никогда больше не отображается после того, как вы покинете эту страницу.

Рекомендации по безопасности приложений см. в разделе Рекомендации и рекомендации по платформе Microsoft Identity.

Добавление федеративных учетных данных

Учетные данные федеративного удостоверения — это тип учетных данных, который позволяет рабочим нагрузкам, например действиям GitHub, рабочим нагрузкам, выполняемым в Kubernetes, или рабочим нагрузкам, выполняемым на вычислительных платформах за пределами Azure, получать доступ к защищенным ресурсам Azure AD без необходимости управлять секретами с помощью федерация удостоверений рабочих нагрузок.

Чтобы добавить федеративные учетные данные, выполните следующие действия:

1. На портале Azure в разделе Регистрация приложений выберите свое приложение.

2. Выберите Сертификаты и секреты > Федеративные учетные данные > Добавьте учетные данные .

3. В раскрывающемся списке Сценарий объединенных учетных данных выберите один из поддерживаемых сценариев и следуйте соответствующим указаниям для завершения настройки.

   • Управляемые клиентом ключи для шифрования данных в вашем арендаторе с помощью Azure Key Vault в другом арендаторе.
   • Действия GitHub по развертыванию ресурсов Azure для настройки рабочего процесса GitHub для получения токенов для вашего приложения и развертывания ресурсов в Azure.
   • Kubernetes получает доступ к ресурсам Azure , чтобы настроить учетную запись службы Kubernetes для получения токенов для вашего приложения и доступа к ресурсам Azure.