Как настраивать файлы cookie

Эта страница предназначена для разработчиков, которым нужно настроить файлы cookie с помощью тега Google или Google Менеджера тегов. Если вы не уверены, нужно ли вам настраивать файлы cookie, прочитайте статью Файлы cookie и идентификация пользователей.

По умолчанию теги Google используют автоматическую конфигурацию домена файлов cookie. Файлы cookie добавляются на максимально высокий уровень в домене. Например, если ваш сайт расположен по адресу blog.example.com, система выберет в качестве домена файлов cookie example.com. Если система определит, что сервер работает локально (например, по адресу localhost), для cookie_domain будет автоматически установлено значение 'none', а файлы cookie начнут использовать полный адрес домена из местоположения документа.

Чтобы изменить срок действия файла cookie или настройки обновления файлов cookie, можно изменить настройки файлов cookie по умолчанию в интерфейсе Аналитики

Для большинства сайтов и приложений хранение файлов cookie допускается только в случае согласия пользователя. В разделе Управление параметрами конфиденциальности пользователей приводятся возможные варианты настроек согласия.

Примечание. Если вы используете тег Google, и на странице несколько продуктов создают файлы cookie, используйте для изменения конфигурации файлов cookie команду gtag('set'), а не gtag('config'). Это поможет вам получать более согласованные результаты.

Как изменить домен файла cookie

Важно! Домен cookie_domain должен быть вышестоящим для текущего домена, иначе настройки файла cookie не будут заданы. Например, если домен вашего сайта one.two.three.root.com, вы можете задать для файла cookie домен root.com, но не someotherdomain.com. Если в файле cookie указан неверный домен, данные передаваться не будут.

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

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

gtag.js

Чтобы отключить автоматическую конфигурацию домена cookie, укажите значение параметра cookie_domain в команде config тега:

gtag('config', 'TAG_ID', {
  'cookie_domain': 'blog.example.com'
});

Менеджер тегов

Для тега Google:

1. В рабочей области откройте меню Теги.
2. Создайте новый или измените существующий тег Google.

3. В настройках конфигурации добавьте новый параметр:

   • Название: cookie_domain.
   • Значение: my.example.com

4. Сохраните тег и опубликуйте контейнер.

   Для тегов Google Рекламы и Floodlight

   Настройки домена можно изменить в теге связывания конверсий.

   1. В Менеджере тегов откройте существующий тег связывания конверсий или создайте новый, если в контейнере пока нет тега.
   2. В разделе Настройки тега связывания нажмите Переопределение настроек файлов cookie (дополнительно).
   3. В поле Домен укажите домен максимально высокого уровня, для которого вы разрешаете создавать файлы cookie. Вы также можете указать точный путь в поле Путь. Используйте эти настройки, только если хотите сохранять файлы cookie на уровне субдомена или подкаталога более низкого уровня.

Для тегов Universal Analytics

1. В Менеджере тегов откройте меню Теги.
2. Измените существующий тег Universal Analytics или создайте новый.
3. Создайте новую переменную настроек Google Аналитики. Выберите Конфигурация переменной > Дополнительные настройки > Поля, которые необходимо задать.
4. В разделе "Поля, которые необходимо задать" нажмите Добавить строку.
5. В строке Название поля введите cookieDomain.
6. В качестве значения укажите домен, например my.example.com.
7. Сохраните и опубликуйте тег.

Как переименовать файлы cookie

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

Внимание! Если имя файла cookie изменится после того, как пользователь впервые посетил ваш сайт, этот посетитель будет зарегистрирован как новый, поскольку контекст, хранящийся в неизмененных файлах cookie, будет утерян.

gtag.js

Эта конфигурация добавляет example в начало файла cookie. Например, _ga становится example_ga, а _gcl_au становится example_gcl_au.

gtag('config', 'TAG_ID', {
  cookie_prefix: 'example'
});

Менеджер тегов

Для тега Google:

1. В рабочей области откройте меню Теги.
2. Создайте новый или измените существующий тег Google.

3. В настройках конфигурации добавьте новый параметр:

   • Название: cookie_prefix.
   • Значение: example

4. Сохраните тег и опубликуйте контейнер.

Для тегов Universal Analytics:

Теги Universal Analytics в Менеджере тегов могут заменять название файла cookie на cookieName с помощью переменной настроек Google Аналитики.

1. В Менеджере тегов откройте переменную настроек Google Аналитики и выберите Конфигурация переменной > Дополнительные настройки > Поля, которые необходимо задать.
2. В разделе "Поля, которые необходимо задать" нажмите Добавить строку.
3. В строку Название поля введите cookieName.
4. В качестве значения укажите название файла cookie, например myCookie.
5. Сохраните и опубликуйте тег.

Примечание. Шаблон тега Universal Analytics в Менеджере тегов полностью меняет имя файла cookie. Свойство cookie_prefix тега Google действует иначе: оно лишь добавляет фрагмент текста в начало стандартного названия файла cookie.

Для тегов Google Рекламы и Floodlight

Настройки префикса можно изменить в теге связывания конверсий:

1.  In Tag Manager, open your existing Conversion Linker tag, or create
    one if the tag doesn't yet exist in your container.

1. В разделе Настройки тега связывания нажмите Переопределение настроек файлов cookie (дополнительно).
2. В поле Префикс имени укажите нужный префикс. Все теги, использующие эти файлы cookie (например, теги конверсий Google Рекламы), нужно будет перенастроить на использование такого же префикса.

Как настроить срок действия файлов cookie

Срок действия файла cookie обновляется при каждой загрузке страницы: к текущему времени прибавляется значение, заданное тегом Google. Таким образом, если в качестве срока действия задана одна неделя (604800 секунд) и пользователь заходит на сайт с помощью одного и того же браузера в течение пяти дней, файл cookie будет храниться ещё одну неделю, а Google Аналитика будет регистрировать посещения одного пользователя. Если тот же пользователь заходит на сайт после истечения срока действия исходного файла cookie, создается новый файл cookie, а первое и второе посещения указываются в отчетах как посещения разных пользователей.

Если вы зададите в качестве срока действия файла cookie значение 0 (ноль секунд), то файл cookie будет действовать только в течение текущего сеанса. Его срок действия истечет по окончании сеанса в браузере.

gtag.js

gtag('config', 'TAG_ID', {
  cookie_expires: 28 * 24 * 60 * 60 // 28 days, in seconds
});

Менеджер тегов

Для тега Google:

1. В рабочей области откройте меню Теги.
2. Создайте новый или измените существующий тег Google.

3. В настройках конфигурации добавьте новый параметр:

   • Название: cookie_expires.
   • Значение: 2419200.
   Примечание. Значение 2419200 равно 28 дням, но вы можете настроить любую продолжительность.

4. Сохраните тег и опубликуйте контейнер.

Для тегов Universal Analytics:

1. В рабочей области откройте меню Теги.
2. Измените существующий тег Universal Analytics.
3. Создайте новую переменную настроек Google Аналитики. Выберите Конфигурация переменной > Дополнительные настройки > Поля, которые необходимо задать.
4. В разделе "Поля, которые необходимо задать" нажмите Добавить строку.
5. В строке Название поля введите cookieExpires.
6. В качестве значения укажите количество секунд, в течение которого будет действовать файл cookie. Например, для 28 дней это будет 2419200.
7. Сохраните тег и опубликуйте контейнер.

Примечание. Файлы cookie Google Рекламы и Floodlight, заданные с помощью тега связывания конверсий, в настоящее время не поддерживают cookie_expires. Если требуется поддержка cookie_expires, используйте gtag.js для этой конфигурации тега.

Как настроить обновление файлов cookie

Если для параметра cookie_update задано значение true (по умолчанию), теги Google могут обновлять файлы cookie при каждой загрузке страницы. При этом срок действия файла cookie будет задаваться с учетом самого недавнего посещения сайта. Таким образом, если срок действия файла cookie равен одной неделе и пользователь заходит на сайт с помощью одного браузера каждые пять дней, срок действия файла cookie будет обновляться при каждом посещении и, следовательно, не истечет никогда.

Если задано значение false, файлы cookie не обновляются при каждой загрузке страницы. Срок действия файла cookie задается относительно первого посещения сайта.

gtag.js

gtag('config', 'TAG_ID', {
  cookie_update: false
});

Менеджер тегов

Для тега Google:

1. В рабочей области откройте меню Теги.
2. Создайте новый или измените существующий тег Google.

3. В настройках конфигурации добавьте новый параметр:

   • Название: cookie_update.
   • Значение: false

4. Сохраните тег и опубликуйте контейнер.

   Примечание.Файлы cookie Google Рекламы и Floodlight, заданные с помощью тега связывания конверсий, в настоящее время не поддерживают cookie_update. Если требуется поддержка cookie_update, используйте gtag.js для конфигурации тега.

Для тегов Universal Analytics:

1. В рабочей области откройте меню Теги.
2. Измените существующий тег Universal Analytics.
3. Создайте новую переменную настроек Google Аналитики. Выберите Конфигурация переменной > Дополнительные настройки > Поля, которые необходимо задать.
4. В разделе "Поля, которые необходимо задать" нажмите Добавить строку.
5. В строке Название поля введите cookieUpdate.
6. В качестве значения укажите логическое значение, например false.
7. Сохраните тег и опубликуйте контейнер.