Obtenga más información sobre la API de generación de informes y sobre cómo resolver algunos problemas comunes de generación de informes.
Consejo: asegúrese de leer primero Introducción a la API de generación de informes de Singular.
Solución de problemas
- Compruebe el código de error devuelto por Obtener estado del informe y vea si puede encontrar el motivo del fallo utilizando el índice Códigos de error.
- Si el problema persiste, póngase en contacto con el equipo de soporte de Singular. Recomendamos guardar el ID del informe porque el equipo puede utilizarlo para encontrar la llamada específica a la API que devolvió el error y comprobar las razones técnicas por las que no se pudo completar.
Por lo general, los datos de ayer deberían estar listos a las 8 de la mañana en su zona horaria local. Si no están listos, compruebe el parámetro "estado" devuelto por el punto final Disponibilidad de datos. Es posible que incluya más información sobre el problema (para más información, consulte la referencia del punto final de disponibilidad de datos ). Si hay un problema de inicio de sesión (Singular no pudo iniciar sesión en la fuente para extraer los datos), vaya a la página de conectores de datos en la aplicación Singular y vuelva a introducir sus credenciales.
Sin embargo, puede que no haya un problema inmediatamente identificable, como un error de inicio de sesión. Las extracciones de datos pueden retrasarse por diversos motivos. Tenga en cuenta que el equipo de Singular es alertado automáticamente de los retrasos en los datos e inmediatamente comienza a trabajar en el problema. Mientras tanto, puede
- Consultar todas las demás redes y dejar las que sufren retrasos para más tarde.
- Esperar al menos una hora y volver a consultar
- En casos urgentes, si has esperado y la fuente sigue sin estar poblada, puedes avisar al soporte de Singular, pero ten en cuenta que probablemente ya estén trabajando en ello.
Para entender por qué obtiene valores "N/A", consulte Solución de problemas de "N/A" y datos faltantes en los informes.
A veces, en lugar de obtener todas las métricas de una campaña en una única fila, obtendrá las métricas de la red publicitaria (como Coste) en una fila y las métricas del rastreador de atribución (como Instalaciones) en una segunda fila.
Para entender por qué ocurre esto, consulte Unir datos de la red y del rastreador (parte de nuestra guía, Entender los datos de informes singulares).
Este error aparece cuando la consulta incluye un filtro que no existe. Por ejemplo, puede que haya intentado filtrar por una aplicación que no existe en la página Aplicaciones, o por un sistema operativo que no existe en absoluto. Examine el valor del filtro devuelto y corrija la consulta adecuadamente.
Para obtener una lista de todos los campos por los que puede filtrar y todos los valores válidos para cada campo, utilice el punto final de filtros.
Si incluyó dimensiones personalizadas en su consulta, utilice el punto final Dimensiones personalizadas para comprobar que las dimensiones siguen estando disponibles. Este error puede producirse si usted o su equipo han realizado cambios en la página de configuración de dimensiones personalizadas desde que se escribió la consulta.
Además, para las dimensiones personalizadas, asegúrese de utilizar el ID de dimensión (en lugar del "nombre para mostrar").
Obtenga más información en las Preguntas frecuentes sobre dimensiones personalizadas.
Si incluyó métricas o eventos de cohorte en su consulta, utilice el punto final Métricas de cohorte para volver a comprobar que las métricas y los periodos que utilizó están disponibles. Asegúrese de que ha utilizado el nombre de la métrica (en lugar del "nombre para mostrar").
Una de las razones por las que sus datos pueden cambiar con el tiempo es que Singular muestra los datos tal y como son reportados por sus redes y rastreador(es). Algunos de estos socios pueden informar de datos estimados antes de tener los datos finales. Por ejemplo, Twitter afirma que "los informes de Twitter se finalizan en las 24-48 horas siguientes a la publicación de las impresiones. Antes de ese momento, estimamos los datos para proporcionar información en tiempo real, pero los datos están sujetos a cambios"(fuente).
Esto se debe a una solución a un problema técnico con algunas de las redes publicitarias de las que extraemos datos.
A veces, las métricas de la red publicitaria para las creatividades dentro de una campaña no coinciden exactamente con la métrica de la red publicitaria para la campaña.
Por ejemplo, aquí hay datos extraídos a nivel creativo que suman 50 clics, mientras que los datos extraídos a nivel de campaña muestran 45 clics para la misma campaña:
En estos casos , para alinear los datos, Singular añade una fila creativa ficticia a la base de datos y le da el valor necesario para que las métricas de las creatividades sumen la métrica de toda la campaña. Este valor a veces es negativo. El Nombre Creativo en esta fila ficticia se da como "Datos Creativos Faltantes".
Estas filas ficticias normalmente sólo se muestran en los resultados de la API (no en los informes que ejecutas en la plataforma web de Singular). Puede ocultarlas añadiendo lo siguiente a su consulta: display_alignment=False
más información en Preguntas frecuentes y resolución de problemas de Creative Reports
Singular ofrece algunas métricas que se calculan en función de otras métricas de la fila. Por ejemplo, CPI (coste por instalación) es el coste dividido por el número de instalaciones. Recomendamos evitar el uso de estas métricas en los informes API porque en cualquier consulta agregada (donde las métricas se suman con una operación "+"), se obtienen resultados sin sentido.
Por ejemplo:
Compruebe si su consulta incluye dimensiones creativas, como creative_id, creative_name, asset_id, asset_name, etc. Algunas redes, como Google Ads, proporcionan datos de país por campaña pero no por creatividad, por lo que si el informe se desglosa por creatividades, no podrá ver la información de país.
Para obtener más información sobre las funciones y limitaciones de Google Ads, consulte Conector de datos de AdWords (Google Ads).
Singular API y la interfaz de usuario de Singular (en app.singular.net) utilizan el mismo código para extraer los datos de la base de datos de Singular, por lo que los resultados deberían coincidir siempre. Si no lo hacen, probablemente significa que no has ejecutado exactamente la misma consulta.
Compare la configuración de la consulta en la interfaz de usuario de Singular con la consulta de la API, prestando especial atención a las siguientes diferencias:
- Consulta de diferentes conjuntos de fechas
- Uso de métricas de discrepancia en lugar de métricas normales
- Visualización de filas ficticias en los informes creativos (consulte ¿Por qué aparecen "Datos creativos ausentes" en la dimensión "Nombre creativo"?)
También puede utilizar las herramientas para desarrolladores para comprobar la llamada a la API get_new_data que se ejecuta al utilizar la interfaz de usuario.
Sólo puede ejecutar 100 informes asíncronos al mismo tiempo. Si ya ha enviado 100 informes, espere a que termine un informe antes de enviar otro.
Esto puede ocurrir por varias razones. Espere unos instantes y vuelva a intentar la llamada a la API. Si ejecuta el mismo código todos los días para extraer sus informes, debería añadir reintentos al código en caso de errores 500.
Si el problema persiste, póngase en contacto con el servicio de asistencia de Singular.
PREGUNTAS FRECUENTES
Para la mayoría de las redes, Singular actualiza los datos diariamente, por lo que ejecutar sus informes todos los días es una buena práctica. No hay razón para consultar los datos con más frecuencia. Consulte Ejecutar informes diarios para obtener más información.