← Cloudflare Zaraz / zaraz

Часто задаваемые вопросы

Ниже приведены ответы на наиболее часто задаваемые вопросы. Если вы не нашли нужный ответ, обратитесь к страница сообщества ↗ или канал Discord ↗ чтобы изучить дополнительные материалы.

• Общее
• Инструменты
• Согласие

Если вам нужна информация о тарифах Zaraz, см. Zaraz Pricing страницу.

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

Чтобы проверить, корректно ли загружается скрипт, выполните следующие шаги:

1. Откройте сайт в веб-браузере.
2. Откройте Developer Tools браузера.
3. В консоли введите zaraz.
4. Если вы видите сообщение об ошибке zaraz is not defined, это значит, что Zaraz не удалось загрузить.

Если Zaraz не загружается, проверьте следующее:

• Домен, на котором работает Zaraz проксируется через Cloudflare.
• Функция Auto Injection включена в вашем Zaraz Settings.
• HTML-код вашего сайта корректен и включает <head> и </head> теги.
• У вас есть как минимум один включённый инструмент настроенный в Zaraz.

Zaraz загружает инструменты на стороне сервера, поэтому код, выполняющийся в браузере, не может их увидеть. Загрузка инструментов на стороне сервера полезна для производительности сайта и приватности, но при этом означает, что для отладки инструментов Zaraz нельзя использовать обычные расширения браузера.

Да. Вы можете использовать метрики в Zaraz Monitoring и Debug Mode чтобы определить, на каком этапе рабочего процесса возникла проблема.

Мы рекомендуем отключить Rocket Loader при использовании Zaraz. Хотя Zaraz можно использовать вместе с Rocket Loader, обычно в этом нет необходимости. Rocket Loader иногда может задерживать поступление данных в Zaraz, что вызывает проблемы.

Да. Подробнее о совместимости Zaraz с CSP настроек, см. Cloudflare Zaraz поддерживает CSP ↗ в записи блога.

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

Да. См. безопасность на стороне клиента (ранее известный как Page Shield) для получения дополнительной информации об этом продукте.

Чтобы запретить загрузку Zaraz на определённых страницах, см. Выборочная загрузка Zaraz.

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

1. На панели управления Cloudflare перейдите к разделу Настройки страницу.

   Перейдите в Настройки ↗

2. Перейдите в Продвинутый уровень.

3. Нажмите «Reset» и следуйте инструкциям.

Отслеживание электронной коммерции необходимо включить в страница Zaraz Settings прежде чем вы сможете начать использовать E-commerce Web API.

В Zaraz есть встроенная поддержка Поддержка одностраничных приложений (SPA) который автоматически отправляет события pageview при переходах между страницами вашего SPA. Однако для более сложных сценариев может понадобиться собственная система запуска событий pageview. В таком случае можно вызвать внутреннее событие SPA pageview с помощью zaraz.spaPageview().

Вероятно, у вас включён Hide Originating IP Address в Раздел Settings для Google Analytics 4. Это указывает Zaraz не отправлять IP-адрес в Google. Чтобы получить доступ к демографическим данным и анонимизировать IP-адрес посетителя, используйте Anonymize Originating IP Address взамен.

Единственно верного варианта нет, так как оба варианта, доступных в Google Analytics (GA), выполняют разные задачи.

Опция "Hide Originating IP Address" в Настройки инструмента не позволяет Zaraz отправлять IP адрес посетителя в Google. Это означает, что GA воспринимает IP адрес Worker'а Zaraz как IP адрес посетителя. Часто это близко по местоположению, но не всегда.

С Anonymize Originating IP Address доступный в Add field опции Cloudflare отправляет IP адрес посетителя в Google как есть и передаёт параметр 'aip' в GA. Это указывает GA анонимизировать данные.

Это не ошибка. Zaraz не поддерживает все автоматические события, которые обычные JavaScript-сниппеты GA4 предоставляют «из коробки». Вам потребуется создать триггеры и действия чтобы фиксировать эти события. См. Начало работы чтобы узнать больше о работе Zaraz.

Да. См. Дополнительные поля чтобы узнать, как отправлять инструментам дополнительные данные.

В своём действии Google Analytics 4 выберите Add field > Add custom field... и введите название поля, начинающееся с up. например, up.name. Это заставит Zaraz отправлять поле как User Property, а не как Event Property.

Zaraz имеет встроенную поддержку Google Consent Mode v2. Подробнее о том, как его использовать, читайте в Страница Google Consent Mode.

Из-за особенностей работы Facebook Pixel данные могут появиться в интерфейсе Facebook в течение периода от 15 минут до нескольких часов. Также можно использовать режим отладки чтобы убедиться, что данные корректно отправляются из вашего аккаунта Zaraz.

Conversion ID и Conversion Label обычно предоставляются Google Ads в виде «gtag script». Пример для конверсии на $1 USD:

gtag("event", "conversion", {
	send_to: "AW-123456789/AbC-D_efG-h12_34-567",
	value: 1.0,
	currency: "USD",
});

Conversion ID представляет собой первую часть send_to параметр, без AW-. В приведённом выше примере это будет 123456789. Conversion Label представляет собой вторую часть send_to параметр, поэтому AbC-D_efG-h12_34-567 в примере выше. При настройке конверсий Google Ads через Zaraz используйте данные из исходных скриптов, которые вам нужно было внедрить.

Вы можете загружать Google Tag Manager через Zaraz, но делать это не рекомендуется. Инструменты, настроенные внутри Google Tag Manager, не могут быть оптимизированы Zaraz и не подчиняются его настройкам приватности. Кроме того, Google Tag Manager может замедлять сайт, поскольку требует дополнительного JavaScript, а его правила выполняются на стороне клиента. Если вы уже используете Google Tag Manager, рекомендуем заменить его на Zaraz, настроив теги напрямую как инструменты Zaraz.

Добавление инструмента на сайт через встроенную интеграцию Zaraz всегда предпочтительнее использования HTML-фрагмента. HTML-фрагменты обычно требуют дополнительных клиентских запросов и выполнения кода на стороне клиента, что может замедлять работу сайта. Они также нередко представляют риск для безопасности, поскольку их можно взломать. Кроме того, крайне сложно контролировать их влияние на конфиденциальность посетителей. Инструменты из библиотеки Zaraz лишены этих недостатков: они работают быстро, выполняются на edge и могут быть ограничены и настроены благодаря песочнице.

Если в Zaraz Settings включена опция "Single Page Application support", код Custom HTML может без необходимости внедряться при каждой загрузке новой страницы SPA. Это может приводить к дублированию. Чтобы избежать этого, перейдите к своему действию Custom HTML и выберите опцию "Add Field". Затем добавьте поле "Ignore SPA" и включите переключатель. Это предотвратит срабатывание кода при каждом pageview SPA и обеспечит его однократное внедрение.

Команда разработки Zaraz постоянно добавляет поддержку новых инструментов. Также вы можете обратиться к пространство сообщества ↗ чтобы запросить новые интеграции.

Если ваш домен проксируется через Cloudflare, добавлять код на сайт не требуется. По умолчанию Zaraz включает автоматический Pageview триггер. Некоторые инструменты, например Google Analytics, автоматически добавляют Pageview действие, использующее этот триггер. Для других инструментов его потребуется добавить вручную. См. Начало работы, где это описано подробнее.

Команда Zaraz совместно со сторонними поставщиками разрабатывает собственные интеграции с помощью Zaraz SDK. Чтобы запросить интеграцию с новым инструментом или обсудить сотрудничество по SDK, напишите нам на [email protected].

В этом случае можно изменить имя cookie в Имя cookie согласия поле в настройках Zaraz Consent. Это приведет к тому, что модальное окно согласия снова появится у всех пользователей. Убедитесь, что используете название cookie-файла, которое еще не использовалось для Zaraz на вашем сайте.