Что такое Client ID в Google Analytics

Client ID — это уникальный идентификатор, который отправляется в Google Analytics вместе с каждым обращением с сайта и позволяет связать эти обращения с одним пользователем. Обычно он выглядит вот так:

943178168.1518807211

Когда читатель заходит на сайт, библиотека analytics.js, которая подключается при установке счетчика, отправляет в Google Analytics запрос, содержащий различную информацию о факте посещения: url посещенной страницы, её название, referrer, приведший пользователя, размер окна, язык, кодировку, идентификатор пользователя, номер счетчика, куда это все надо сложить, и т.д.

Именно Client ID позволяет связывать такие обращения и относить их к одному и тому же пользователю, но конечно не без нюансов.

Тонкости настройки аналитики в Telegram каналеПодписаться на @burgerdata

Содержание

1. Где найти Client ID
2. Отчет в GA по Client ID
3. Как получить Client ID
4. Как передать Client ID в Google Analytics
5. Как создать Client ID
6. Комментарии

Где найти Client ID

Client ID хранится в cookies, и поэтому определяет уникальность пользователя только в рамках этого конкретного браузера. Если читатель почистит cookies, зайдет под инкогнито, с другого браузера, с телефона, то для Google Analytics он станет еще одним пользователем.

Короче, по-пацански должно быть так:

В Google Chrome свой Client ID для определенного сайта можно увидеть, нажав F12, далее вкладка Application, слева Cookies, выбираете сайт и находите _ga.

Здесь к идентификатору добавляется еще служебная информация для парсера, распишу, что какая часть означает:

• Первая часть (GA1) всегда такая и указывает версию формата записи идентификатора в cookie
• Вторая зависит от уровня домена, для которого установлена _ga, т.е. для доменов первого и второго уровней она равна 1, для третьего — 2
• Третья представляет собой случайно сгенерированное число
• Четвертая показывает Unix Timestamp в секундах, когда Client ID был создан.

Отчет в GA по Client ID

В марте 2016 года в Google Analytics появился отчет Статистика пользователей. Его можно найти в разделе Аудитория и в нём доступна история обращений для каждого Client ID, а так же некоторая информация об этом пользователе.

К отчету применимы сегменты, но почему-то нет поиска, поэтому смотреть историю для нужного Client ID не очень удобно, но возможно. Для этого открываем отчет на любом пользователе, находим в url параметр userId и меняем идентификатор на свой:

userId%3D1411521834.1519670042%26

Этот отчет очень полезен при отладке, особенно, когда надо проследить, куда делись рекламные клики 😆

upd: Не так давно поиск все-таки появился, но способ по-прежнему валиден.

Как получить Client ID

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

Для этой цели лучше всего подойдет параметр уровня Пользователь, который можно создать в разделе Администратор — Ресурс — Пользовательские определения — Пользовательские параметры. Подробно о создании пользовательских параметров Рома всё разжевал в своем блоге.

Достать Client ID программно можно разными способами. Google рекомендует брать из объекта счетчика:

ga.getAll()[0].get('clientId')

На серверной стороне можно достать его из cookies. Некоторые делают это и на клиентской, но я конечно не советую. Если пользователь заходит на сайт впервые, то cookie _ga у него отсутствует, и может не успеть сформироваться к тому моменту, когда вы захотите её взять, в итоге дополнительный код и костыли.

Как передать Client ID в Google Analytics

После того как Google представил метод customTask в интерфейсе заданий analytics.js (есть только в английской документации), он стал лучшим способом передачи Client ID в Google Analytics. Благодаря этому методу читатель может вмешаться в запрос, который отправляется вместе с первоначальным хитом, и добавить в него передачу идентификатора пользователя в нужный

Пользовательский параметр. Об этом у меня есть отдельная статья «Как передать Client ID через customTask»

Ранее Client ID лучше всего было передавать отдельным событием. У этого метода есть определенные недостатки, тем не менее многие им еще пользуются.

Что касается Яндекс Метрики

Возможно читатель захочет увидеть гугловский Client ID в тамошних отчетах, по такому поводу у Яндекса используется Параметры посетителей. В Tag Manager создаем переменную типа Собственный код JavaScript со следующим содержимым:

function(){
  var tracker = ga.getAll()[0];
  return tracker.get('clientId')
}

Далее передаем её в счетчик при установке:

yaCounterXXXXXX.userParams({
  'Client ID': '{{Client ID}}',
})

Подробнее описано в моей статье как правильно устанавливать Яндекс Метрику через GTM.

Как создать Client ID

Вместо абуза идентификатора, который сотворяет analytics.js, читатель может использовать собственный. Google analytics прекрасно воспринимает UUID, о чем сказано в документации.

Собственный Client ID может пригодиться, если вы категорически против посторонних скриптов на своем сайте, особенно в его части с персональными данными (что абсолютно нормально), но все-таки определенные функции Google Analytics вам нужны.

Проверяем через Hit Builder

burgerdata.com

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

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 я расскажу в своей следующей статье.

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

Веб-аналитик. Сертифицированный специалист Google Analytics, Google AdWords и Яндекс Директ.

thisisdata.ru

client ID — это… Что такое client ID?

client — client, cliente [ klijɑ̃, klijɑ̃t ] n. • 1437; lat. cliens, clientis 1 ♦ Antiq. À Rome, Plébéien qui se mettait sous la protection d un patricien appelé patron. ♢ (1538) Vx Personne qui se place sous la protection de qqn. ⇒ protégé. 2 ♦ Mod.… …   Encyclopédie Universelle

Client — Основная информация Жанр Электроклэш …   Википедия

Client — Datos generales Origen …   Wikipedia Español

client — CLIÉNT, Ă, clienţi, e, s.m. şi f. 1. Persoană care cumpără (regulat) de la un magazin, consumă ceva într un local public etc., considerată în raport cu persoana sau întreprinderea de la care cumpără, consumă etc.; muşteriu. 2. Persoană care se… …   Dicționar Român

Client — may refer to: Customer, someone who purchases or hires something from someone else Client (computing), software that accesses a remote service on another computer The client (Latin cliens) who received patronage in ancient Rome Client (band), a… …   Wikipedia

client — I noun business contact, buyer of labor, cliens, consultor, consumer, customer, employer of legal advice, hirer, offerer, patron, patron of professional servies, patronizer, person employing advice, person represented, person represented by… …   Law dictionary

Client — Cli ent, n. [L. cliens, emtis, for cluens, one who hears (in relation to his protector), a client, fr. L. cluere to be named or called; akin to Gr. ? to hear, Skr. [,c]ry, and E. loud: cf. F. client. See {Loud}.] 1. (Rom. Antiq.) A citizen who… …   The Collaborative International Dictionary of English

client — CLIENT, ENTE. s. Celui, celle qui a chargé de sa cause un Avocat. Il ne se dit proprement que des Parties à l égard de leurs Avocats, et quelquefois des Parties à l égard de leurs Juges. Bon client. C est mon client. Je suis sa cliente. La salle… …   Dictionnaire de l’Académie Française 1798

client — client, e n. Ne pas être client, ne pas être disposé à effectuer un acte désavantageux ou désagréable : Vingt bornes à pince ? Merci, je ne suis pas client …   Dictionnaire du Français argotique et populaire

client — CLIENT, [cli]ente. s. Celuy ou celle qui a chargé de sa cause un Avocat. Il ne se dit proprement que des parties à l égard de leurs Avocats, mais quelquefois des parties à l égard de leurs Juges, Bon client. c est mon client. je suis sa cliente.… …   Dictionnaire de l’Académie française

client — Client, Qui s est donné en la tutelle et protection de quelque grand seigneur, lequel prend sa defense en toutes choses honnestes à l encontre de tous: et pareillement en tous affaires qu il a, il a aide et secours de ce client, Cliens clientis.… …   Thresor de la langue françoyse

normative_en_ru.academic.ru

Проверка подлинности с помощью библиотек управления Azure для Python

• 04/11/2019
• Время чтения: 6 мин

В этой статье

В этой статье описано, как проверить подлинность приложения при использовании библиотек управления Python.This article shows you how to authenticate your application when using the Python management libraries. Проверить подлинность приложения в Azure можно несколькими способами.You have several options to authenticate your application with Azure.

Примечание

You need to verify your website works as expected with the upcoming changes in how cookies are handled in Google Chrome. Although the change helps prevent cross-site request forgery (CSRF) attacks, without proper remediation it will severely affect many applications and services that rely on today’s cookie handling defaults, including Microsoft cloud services or your own. This change is expected to roll out as the default Chrome behavior in release 80 that is targeted for February 4, 2020. For more information and details on how to test your app, see Potential disruption to customer websites and Microsoft products and services in Chrome version 79 and later.

Проверка подлинности с использованием учетных данных токенаAuthenticate with token credentials

Учетные данные можно безопасно хранить в файле конфигурации, реестре или Azure Key Vault.Store the credentials securely in a configuration file, the registry, or Azure KeyVault.

В следующем примере для проверки подлинности используется субъект-служба.The following example uses a Service Principal for authentication.

from azure.common.credentials import ServicePrincipalCredentials

# Tenant ID for your Azure subscription
TENANT_ID = '<Your tenant ID>'

# Your service principal App ID
CLIENT = '<Your service principal ID>'

# Your service principal password
KEY = '<Your service principal password>'

credentials = ServicePrincipalCredentials(
    client_id = CLIENT,
    secret = KEY,
    tenant = TENANT_ID
)

Примечание

Чтобы подключиться к одному из независимых облаков Azure, используйте параметр cloud_environment.To connect to one of the Azure sovereign clouds, use the cloud_environment parameter.

from azure.common.credentials import ServicePrincipalCredentials
from msrestazure.azure_cloud import AZURE_CHINA_CLOUD

# Tenant ID for your Azure Subscription
TENANT_ID = 'ABCDEFGH-1234-1234-1234-ABCDEFGHIJKL'

# Your Service Principal App ID
CLIENT = 'a2ab11af-01aa-4759-8345-7803287dbd39'

# Your Service Principal Password
KEY = 'password'

credentials = ServicePrincipalCredentials(
    client_id = CLIENT,
    secret = KEY,
    tenant = TENANT_ID,
    cloud_environment = AZURE_CHINA_CLOUD
)

Если требуется более строгий контроль, рекомендуем использовать ADAL и программу-оболочку ADAL для SDK.If you need more control, it is recommended to use ADAL and the SDK ADAL wrapper. Список всех доступных сценариев и примеры см. на веб-сайте ADAL.Please refer to the ADAL website for all the available scenarios list and samples. Пример проверки подлинности на основе субъекта-службы:For instance, for service principal authentication:

import adal
from msrestazure.azure_active_directory import AdalAuthentication
from msrestazure.azure_cloud import AZURE_PUBLIC_CLOUD

# Tenant ID for your Azure Subscription
TENANT_ID = 'ABCDEFGH-1234-1234-1234-ABCDEFGHIJKL'

# Your Service Principal App ID
CLIENT = 'a2ab11af-01aa-4759-8345-7803287dbd39'

# Your Service Principal Password
KEY = 'password'

LOGIN_ENDPOINT = AZURE_PUBLIC_CLOUD.endpoints.active_directory
RESOURCE = AZURE_PUBLIC_CLOUD.endpoints.active_directory_resource_id

context = adal.AuthenticationContext(LOGIN_ENDPOINT + '/' + TENANT_ID)
credentials = AdalAuthentication(
    context.acquire_token_with_client_credentials,
    RESOURCE,
    CLIENT,
    KEY
)

Все допустимые вызовы ADAL можно использовать с классом AdalAuthentication.All ADAL valid calls can be used with the AdalAuthentication class.

Затем создайте клиентский объект, чтобы приступить к работе с API.Next, create a client object to start working with the API:

from azure.mgmt.compute import ComputeManagementClient

# Your Azure Subscription ID
subscription_id = '33333333-3333-3333-3333-333333333333'

client = ComputeManagementClient(credentials, subscription_id)

Примечание

Если используется независимое облако Azure, при создании клиента управления необходимо также указать соответствующий базовый URL-адрес (используя константы в msrestazure.azure_cloud).When using an Azure sovereign cloud you must also specify the appropriate base URL (via the constants in msrestazure.azure_cloud) when creating the management client. Пример для облака Azure для Китая:For example for Azure China Cloud:

client = ComputeManagementClient(credentials, subscription_id,
    base_url=AZURE_CHINA_CLOUD.endpoints.resource_manager)

Проверка подлинности на основе файловFile based authentication

Самый простой способ реализовать проверку подлинности — создать JSON-файл, который содержит учетные данные для субъекта-службы Azure.The simplest way to authenticate is to create a JSON file that contains credentials for an Azure Service Principal. Вы можете одновременно создать субъект-службу и этот файл с помощью следующей команды интерфейса командной строки:You can use the following CLI command to create a new Service Principal and this file at the same time:

az ad sp create-for-rbac --sdk-auth > mycredentials.json

Сохраните этот файл в безопасном расположении в вашей системе, доступном для кода.Save this file in a secure location on your system where your code can read it. Задайте переменную среды и укажите полный путь к файлу в оболочке:Set an environment variable with the full path to the file in your shell:

export AZURE_AUTH_LOCATION=~/.azure/azure_credentials.json

Если вы хотите создать файл самостоятельно, придерживайтесь следующего формата:If you want to create the file yourself, please follow this format:

{
    "clientId": "<Service principal ID>",
    "clientSecret": "<Service principal secret/password>",
    "subscriptionId": "<Subscription associated with the service principal>",
    "tenantId": "<The service principal's tenant>",
    "activeDirectoryEndpointUrl": "https://login.microsoftonline.com",
    "resourceManagerEndpointUrl": "https://management.azure.com/",
    "activeDirectoryGraphResourceId": "https://graph.windows.net/",
    "sqlManagementEndpointUrl": "https://management.core.windows.net:8443/",
    "galleryEndpointUrl": "https://gallery.azure.com/",
    "managementEndpointUrl": "https://management.core.windows.net/"
}

Затем можно создать любой клиент с помощью фабрики клиента.You can then create any client using the client factory:

from azure.common.client_factory import get_client_from_auth_file
from azure.mgmt.compute import ComputeManagementClient

client = get_client_from_auth_file(ComputeManagementClient)

Аутентификация с помощью управляемых удостоверений AzureAuthenticate with Azure Managed Identities

Управляемые удостоверения Azure позволяют использовать пакеты SDK или CLI для ресурсов в Azure без необходимости создавать соответствующие учетные данные.Azure Managed Identity is a simple way for a resource in Azure to use SDK/CLI without the need to create specific credentials.

from msrestazure.azure_active_directory import MSIAuthentication
from azure.mgmt.resource import ResourceManagementClient, SubscriptionClient

# Create MSI Authentication
credentials = MSIAuthentication()


# Create a Subscription Client
subscription_client = SubscriptionClient(credentials)
subscription = next(subscription_client.subscriptions.list())
subscription_id = subscription.subscription_id

# Create a Resource Management client
resource_client = ResourceManagementClient(credentials, subscription_id)


# List resource groups as an example. The only limit is what role and policy are assigned to this MSI token.
for resource_group in resource_client.resource_groups.list():
    print(resource_group.name)

Проверка подлинности на основе интерфейса командной строкиCLI-based authentication

Пакет SDK позволяет создать клиент, используя активную подписку Azure CLI.The SDK is able to create a client using the Azure CLI’s active subscription.

Важно!

Эти инструкции следует применять в качестве краткого руководства по разработке.This should be used as quick start developer experience. В рабочей среде используйте ADAL или свою систему учетных данных.For production purposes, use ADAL or your own credentials system. Любые изменения конфигурации CLI повлияют на выполнение пакета SDK.Any change to your CLI configuration will impact the SDK execution.

Чтобы указать активные учетные данные, используйте команду az login.To define active credentials, use az login. По умолчанию используется существующий идентификатор подписки, но вы также можете указать его с помощью команды az account.Default subscription ID is either the only one you have, or you can define it using az account

from azure.common.client_factory import get_client_from_cli_profile
from azure.mgmt.compute import ComputeManagementClient

client = get_client_from_cli_profile(ComputeManagementClient)

Проверка подлинности с использованием учетных данных токена (для прежних версий)Authenticate with token credentials (legacy)

В предыдущей версии пакета SDK библиотека ADAL не была доступна, и мы указывали класс UserPassCredentials.In previous version of the SDK, ADAL was not yet available and we provided a UserPassCredentials class. Использование этого класса считается устаревшим методом, и мы не рекомендуем его применять.Using this class is considered deprecated and should not be used anymore.

В этом примере показан сценарий «пользователь/пароль», который не поддерживает 2FA.This sample shows user/password scenario, which does not support 2FA.

from azure.common.credentials import UserPassCredentials

credentials = UserPassCredentials(
    '[email protected]',
    'my_smart_password'
)

docs.microsoft.com