Устранение неполадок Web SDK

Кратко: руководство по устранению неполадок AppsFlyer Web SDK, добавленного непосредственно на ваш сайт или реализованного через Google Tag Manager.

SDK, добавленный напрямую на сайт

Вы можете добавить SDK непосредственно на свой сайт.

Нет данных или отображаются только часть данных в дэшборде PBA

Причина	РЕШЕНИЕ
После внедрения SDK данные могут отображаться в дэшбордах People-Based Analysis в течение 24 часов.	Подождите 24 часов. Если данные по-прежнему недоступны, см. дополнительные причины в этом документе.
Неверный веб-ключ разработчика	Web SDK использует веб-ключ разработчика для идентификации веб-событий, чтобы определить, какому бандлу следует атрибутировать данные. Убедитесь, что вы используете правильный Web Dev Key. Страница бандла бренда
Вы разместили Web SDK в теле страницы	Вы можете разместить Web SDK в теле страницы, но это может повлиять на данные, отправляемые в AppsFlyer. Рекомендуем разместить его в разделе head страницы.
Web SDK установлен не на всех страницах вашего сайта	Рекомендуем разместить веб-SDK на всех страницах вашего сайта.

События не отправляются

Причина	РЕШЕНИЕ
События отправляются до загрузки Web SDK. В таких случаях в консоли разработчика браузера отображается ошибка: `Uncaught ReferenceError: AF is not defined`	Убедитесь, что Web SDK загружается до кода, который отправляет события.
Неверный веб-ключ разработчика	Для PBA требуется веб-ключ разработчика, чтобы определить, какому бандлу следует атрибутировать данные. Убедитесь, что используется правильный web dev key. Убедитесь, что вы используете правильный web dev key.
Некорректно сформированные события	Убедитесь, что событие сформировано правильно. См. раздел доступные параметры события, чтобы узнать больше о правильно сформированных событиях.
SDK вызван дважды

Конфликтующие SDK и библиотеки

Многие веб-SDK используют популярные библиотеки JavaScript. Такие SDK также занимают имена в глобальной области видимости. Например, наш веб-SDK использует AF в качестве основного объекта, который обеспечивает работу веб-SDK.

Если какой-либо SDK использует библиотеку X версии 1.2, а SDK AppsFlyer использует библиотеку X версии 2.1, эти две библиотеки могут конфликтовать.
Если другой SDK или библиотека использует AF (в глобальной области видимости) как имя объекта, два SDK конфликтуют, и один SDK может переопределить другой.

SDK, добавленный через Google Tag Manager

Реализация веб-SDK с помощью Google Tag Manager (GTM) может сэкономить вам время.
Вы можете внедрить его самостоятельно, не обращаясь к веб-разработчику для добавления на сайт.

Если у вас возникли проблемы. Помимо проблем, описанных в разделе прямая реализация SDK, возможны некоторые проблемы, характерные именно для GTM.

Вызов SDK

Причина	РЕШЕНИЕ
В нашем руководстве по Web SDK показано, как добавить веб-SDK с помощью тега. Некоторые пользователи при создании тегов для вызова событий настраивают тег так, чтобы он также повторно вызывал тег SDK. Но это может вызвать проблемы.	Лучше всего настроить один тег для загрузки SDK и запускать этот тег на всех страницах. Теги, которые отправляют события, не должны повторно вызывать тег SDK.

Причина

РЕШЕНИЕ

В нашем руководстве по Web SDK показано, как добавить веб-SDK с помощью тега.

Некоторые пользователи при создании тегов для вызова событий настраивают тег так, чтобы он также повторно вызывал тег SDK. Но это может вызвать проблемы.

Лучше всего настроить один тег для загрузки SDK и запускать этот тег на всех страницах. Теги, которые отправляют события, не должны повторно вызывать тег SDK.

Приоритет тега

GTM позволяет настроить приоритет тега. Это означает, что вы можете контролировать, какие теги срабатывают первыми.

Причина	РЕШЕНИЕ
Для тега, который загружает SDK, установлен более низкий приоритет, чем для тега, который отправляет событие при загрузке страницы. В результате SDK не успевает инициализироваться вовремя, чтобы отправить событие.	Для тега, который загружает SDK, всегда задавайте более высокий приоритет, чем для тегов, которые отправляют события или идентифицируют пользователей.

Триггеры тегов

В GTM у каждого тега есть триггер, который определяет, когда этот тег должен срабатывать.

Причина	РЕШЕНИЕ
Триггер, отвечающий за срабатывание тега, который загружает SDK, настроен не для всех страниц. В результате регистрируются не все посещения страниц, и некоторые события не отправляются.	Оптимальный вариант — настроить для тега, который загружает SDK, триггер просмотра всех страниц.
Триггер, отвечающий за срабатывание тегов, которые отправляют события, настроен неправильно. В результате некоторые события не отправляются.	Определите условия срабатывания триггера. Например: взаимодействие с элементами DOM, например клик по кнопке посещение страницы с определённым путём, например /thank-you-page или /confirmation-page

Причина

РЕШЕНИЕ

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

Оптимальный вариант — настроить для тега, который загружает SDK, триггер просмотра всех страниц.

Триггер, отвечающий за срабатывание тегов, которые отправляют события, настроен неправильно. В результате некоторые события не отправляются.

Определите условия срабатывания триггера. Например:

взаимодействие с элементами DOM, например клик по кнопке
посещение страницы с определённым путём, например /thank-you-page или /confirmation-page

Публикация контейнеров GTM

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

Чем мы можем помочь?

Поиск