Resolución de problemas del SDK web

Resumen: Guía de resolución de problemas del SDK web de AppsFlyer, añadido directamente a tu sitio web o implementado mediante Google Tag Manager.

SDK añadido directamente

Puedes añadir el SDK directamente a tu sitio web.

No hay datos o hay datos parciales en el dashboard de PBA

Causa	SOLUCIÓN
Los datos pueden tardar hasta 24 horas en mostrarse en los dashboards de People-Based Analysis después de implementar el SDK.	Espera 24 horas. Si los datos siguen sin estar disponibles, consulta causas adicionales en este documento.
Clave de desarrollador web incorrecta	El SDK web utiliza la clave de desarrollador web para identificar los eventos web enviados y así saber a qué paquete atribuir los datos. Verifica que estás utilizando la clave de desarrollador web correcta. Página del paquete de marca
Has colocado el SDK web en el cuerpo de la página	Puedes colocar el SDK web en el body de la página, pero esto puede afectar a los datos que se envían a AppsFlyer. Te recomendamos que lo pongas en la sección head de la página.
El SDK web no está colocado en todas las páginas de tu sitio web	Te recomendamos colocar el SDK web en todas las páginas de tu sitio web.

No se envían eventos

Causa	SOLUCIÓN
Los eventos se envían antes de que se cargue el SDK web. En estos casos, la consola para desarrolladores del navegador muestra el error: `Uncaught ReferenceError: AF is not defined`	Verifica que el SDK web se cargue antes que el código que envía eventos.
Clave de desarrollador web incorrecta	PBA requiere una clave de desarrollador web para saber a qué paquete atribuir los datos. Asegúrate de que se utiliza la clave de desarrollador web correcta. Verifica que estás utilizando la clave de desarrollador web correcta.
Eventos malformados	Asegúrate de que el evento esté bien formado. Consulta los parámetros de evento disponibles para saber más sobre los eventos con el formato correcto.
SDK llamado dos veces

SDK y bibliotecas en conflicto

Muchos SDK web hacen uso de bibliotecas JavaScript populares. Estos SDK también ocupan nombres en el ámbito global. Por ejemplo, nuestro SDK web ocupa AF como el objeto principal que habilita el SDK web.

Si algún SDK hace uso de la versión 1.2 de la biblioteca X y el SDK de AppsFlyer hace uso de la versión 2.1 de la biblioteca X, las dos bibliotecas podrían entrar en conflicto.
Si otro SDK o biblioteca hace uso de AF (en el ámbito global) como nombre de objeto, los dos SDK entran en conflicto y uno podría sobrescribir al otro.

SDK añadido mediante Google Tag Manager

Implementar el SDK web con la ayuda de Google Tag Manager (GTM) puede ahorrarte tiempo.
Puedes implementarlo de forma independiente y no tienes que depender de tu desarrollador web para añadirlo a tu sitio web.

Si encuentras problemas. Además de los problemas descritos en la implementación nativa del SDK, hay algunos posibles problemas específicos de GTM.

Llamada al SDK

Causa	SOLUCIÓN
Nuestra guía del SDK web muestra cómo añadir el SDK web usando una etiqueta. Algunos usuarios, al crear etiquetas para llamar a eventos, configuran la etiqueta para que también vuelva a llamar a la etiqueta del SDK. Pero esto puede causar problemas.	La mejor opción es configurar una etiqueta para cargar el SDK y hacer que se active en todas las páginas. Las etiquetas que envían eventos no deben volver a llamar a la etiqueta del SDK.

Causa

SOLUCIÓN

Nuestra guía del SDK web muestra cómo añadir el SDK web usando una etiqueta.

Algunos usuarios, al crear etiquetas para llamar a eventos, configuran la etiqueta para que también vuelva a llamar a la etiqueta del SDK. Pero esto puede causar problemas.

La mejor opción es configurar una etiqueta para cargar el SDK y hacer que se active en todas las páginas. Las etiquetas que envían eventos no deben volver a llamar a la etiqueta del SDK.

Prioridad de la etiqueta

GTM te permite establecer la prioridad de las etiquetas. Esto significa que puedes controlar qué etiquetas se activan primero.

Causa	SOLUCIÓN
Una etiqueta que carga el SDK tiene una prioridad inferior a la de una etiqueta que envía un evento al cargar la página. Como resultado, el SDK no se inicializa a tiempo para enviar el evento.	En la etiqueta que carga el SDK, establece siempre una prioridad superior a la de las etiquetas que envían eventos o identifican usuarios.

Activación de etiquetas

En GTM, cada etiqueta tiene un activador que determina cuándo debe activarse esa etiqueta.

Causa	SOLUCIÓN
El activador encargado de activar la etiqueta que carga el SDK no está configurado para todas las páginas. Como resultado, no se registran todas las visitas a la página y algunos eventos no se envían.	Lo mejor es configurar un activador de vistas de todas las páginas para la etiqueta que carga el SDK.
El activador encargado de activar las etiquetas que envían eventos no está configurado correctamente. Como resultado, algunos eventos no se envían.	Determina las condiciones del activador. Por ejemplo: una interacción con elementos del DOM, como hacer clic en un botón una visita a una página con una ruta concreta, como /thank-you-page o /confirmation-page

Causa

SOLUCIÓN

El activador encargado de activar la etiqueta que carga el SDK no está configurado para todas las páginas. Como resultado, no se registran todas las visitas a la página y algunos eventos no se envían.

Lo mejor es configurar un activador de vistas de todas las páginas para la etiqueta que carga el SDK.

El activador encargado de activar las etiquetas que envían eventos no está configurado correctamente. Como resultado, algunos eventos no se envían.

Determina las condiciones del activador. Por ejemplo:

una interacción con elementos del DOM, como hacer clic en un botón
una visita a una página con una ruta concreta, como /thank-you-page o /confirmation-page

Publicación de contenedores de GTM

Todos los cambios en GTM, como añadir o editar etiquetas y activadores, requieren que publiques el contenedor de GTM para que los cambios surtan efecto. Si usas el SDK web con GTM, pero el SDK no se carga o no se envían eventos, asegúrate de publicar el contenedor de GTM.

This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.

How can we help?

Búsqueda