Bienvenido a la API de generación de informes de Singular, que ofrece estadísticas agregadas sobre sus campañas de marketing que puede incorporar a sus sistemas internos de BI o cuadros de mando de rendimiento de marketing.

Esta guía explica la API de generación de informes de Singular, cómo entender su caso de uso y cómo empezar a ejecutar consultas.

Lea esta guía en primer lugar y, a continuación, consulte laReferencia de la API deelaboración de informes para conocer los detalles técnicos.

Primeros pasos: Comprender su caso de uso

Singular recopila y sintetiza datos de diferentes orígenes (recomendamos leer Understanding Singular Reporting Data para una revisión en profundidad).

Cuando utiliza la API de generación de informes, puede elegir si desea ver

• Datos agregados de sus redes publicitarias y agencias asociadas, como el coste de la campaña;
• Datos agregados de su rastreador de atribución/MMP, que puede introducir en su sistema de BI y unir a los datos de la red según sea necesario;
• O datos combinados, que son el resultado de la unión inteligente de Singular de los datos de la red y del rastreador para permitirle analizar su ROI con la mayor granularidad posible.

Aunque todas las consultas se ejecutan a través del mismo punto final (Crear informe asíncrono), difieren en los campos que se incluyen en la consulta.

Para empezar, comprenda lo que desea obtener de la API:

Su caso de uso:	Ver:
Utiliza Singular para recopilar datos de campañas de todas sus redes y agencias publicitarias. Desea obtener datos sobre sus costes y tasas de ejecución.	Consulta de datos de red
Utiliza el servicio de atribución de Sing ular o ha configurado un conector de datos para su rastreador de atribución de terceros. Desea extraer datos del rastreador, como conversiones e ingresos, e ingerirlos en su plataforma de BI o para su análisis. Si une los datos del rastreador a los datos de la red publicitaria (como el coste de la campaña) para calcular su ROAS, tiene previsto utilizar sus propias herramientas para hacerlo.	Consulta de los datos del rastreador y los datos de la red por separado
Utiliza el servicio de atribución de Singular o ha configurado un conector de datos para su rastreador de atribución de terceros. Desea aprovechar la lógica ya preparada de Singular para unir los datos de la red y del rastreador con la mayor granularidad posible.	Consulta de datos combinados

Tipos de datos disponibles a través de la API de generación de informes

Consulta de datos de red

Losdatos de red incluyen las estadísticas de campaña de todas las redes publicitarias que haya configurado en Singular. No incluye datos de su rastreador de atribución (si ha configurado alguno en Singular).

Por ejemplo, puede ejecutar una consulta para ver el coste (adn_cost) de cada una de sus campañas (adn_campaign_id) en un intervalo de fechas determinado.

Campos disponibles para datos de red

Consulte la página Métricas y dimensiones para obtener una descripción de cada campo.

Consulta por separado de los datos del rastreador y de los datos de la red

Puede utilizar la API para extraer datos del rastreador: estadísticas del servicio de atribución de Singular o de un rastreador de atribución de terceros que haya configurado en Singular (como Appsflyer o Google Analytics).

Por ejemplo, puede ejecutar una consulta para ver los clics (tracker_clicks) y las instalaciones (tracker_installs) de cada una de sus campañas (tracker_campaign_id) en un intervalo de fechas determinado. Las estadísticas del rastreador también incluyen eventos posteriores a la instalación e ingresos.

Tras realizar una consulta sobre los datos del rastreador, puede unirlos a los datos de su red para poder calcular el IPC o el ROI de su campaña.

Sin embargo, ejecutar un informe combinado suele ser una forma más sencilla de obtener el mismo resultado.

Campos disponibles para los datos del seguidor

Consulte la página Métricas y dimensiones para obtener una descripción de cada campo.

Consulta de datos combinados

Puede utilizar la API para ejecutar una consulta combinada de red y rastreador, que muestra tanto los costes de su campaña como sus ingresos u otros KPI de rendimiento de campaña.

Este tipo de consulta hace uso de dimensiones y métricas especiales que se basan en los datos del rastreador y de la red, pero implican una lógica adicional entre bastidores, como se detalla a continuación.

¿Qué hace una consulta combinada?

1. Incluye estadísticas de red (como el coste) y estadísticas del rastreador (como las instalaciones y los ingresos) en la misma consulta.

2. Las dimensiones inteligentes ayudan a combinar los datos de la red y del rastreador en la misma fila siempre que sea posible.

   Las dimensiones "combinadas" o "unificadas" de Singular se basan tanto en los datos de red como en los de seguimiento. Singular las procesa para corregir desajustes de datos comunes y asegurarse de que usted vea sus datos combinados con la mayor granularidad posible.

   Por ejemplo, el nombre de una campaña específica en el rastreador puede ser ligeramente diferente del nombre de la campaña extraído de la red publicitaria. Así que si ejecuta un informe de seguimiento y un informe de red y une los resultados, puede obtener filas divididas para la campaña, donde una fila tiene estadísticas de red y la otra tiene estadísticas de seguimiento. Pero si ejecuta un informe combinado (utilizando la dimensión unified_campaign_name), Singular se asegura de que pueda obtener tanto estadísticas de red como de seguimiento en la misma fila para la campaña.

3. Las métricas inteligentes y personalizables extraen los datos de la fuente adecuada en cada caso.

   En situaciones en las que la misma estadística es ofrecida tanto por la red como por el rastreador, por ejemplo, el número de instalaciones por campaña en un intervalo de fechas determinado, la métrica combinada le ofrece una única fuente de verdad, eligiendo de forma inteligente la estadística del rastreador o la de la red basándose en el uso estándar del sector.

   Por ejemplo, la métrica custom_installs contiene el número de instalaciones del rastreador, a menos que se trate de una red autoatribuida(SAN) como Facebook o Twitter, en cuyo caso la estadística de red es más importante, y custom_installs contiene la métrica de red.

   Si la opción por defecto de Singular no funciona para su caso específico, puede hacer que Singular reconfigure métricas específicas para usted.

   Nota: las métricas personalizadas no están disponibles para los desgloses creativos. Seleccione métricas de red o métricas de seguimiento.

¿Qué ocurre si necesito conocer la fuente de mis métricas?

Es posible que desee conocer la fuente exacta de cada métrica para cada campaña, por ejemplo, si está intentando encontrar y solucionar discrepancias significativas entre la red y el rastreador.

En ese caso, puede añadir la métrica de red (consulte Campos disponibles para datos de red) y la métrica del seguidor (consulte Campos disponibles para datos del seguidor) al informe combinado. Por ejemplo, extraiga las tres métricas de instalación: custom_installs, adn_installs, tracker_installs.

De esta forma, puede utilizar custom_installs como su KPI pero ver si hay una diferencia significativa entre adn_installs y tracker_installs.

Campos disponibles para datos combinados

Consulte la página Métricas y dimensiones para obtener una descripción de cada campo.

Resumen: ¿Qué tipos de datos están disponibles para usted?

	Utilizo Singular para...
	Analytics + Singular Attribution	Sólo Analytics, pero configuro Singular para que extraiga datos de mi rastreador de terceros	Extraer datos sólo de mis redes publicitarias
Datos de red	Disponible	Disponible	Disponible
Datos de seguimiento	Disponible	Disponible	-
Campos combinados	Disponible	Disponible para redes autoatribuidas (sin desglose creativo)	-

Cómo consultar la API de informes

Una vez que haya decidido qué tipo de datos desea consultar y haya hecho una lista de las métricas y dimensiones específicas que le interesan, a continuación se explica cómo utilizar la API de elaboración de informes.

Ejecución de una consulta básica

1	Consulte el punto final Crear informe asíncrono (consulte la referencia del punto final), especificando las métricas y dimensiones que ha elegido. Esto generará una consulta de informe asíncrona y devolverá un ID de informe.
2	Utilizando el ID del informe, consulte el endpoint de la API Get Report Status (ver referencia del endpoint) para ver cuándo ha terminado de ejecutarse el informe. Cuando el informe haya finalizado, el endpoint Obtener Estado del Informe devolverá una URL del informe.
3	Descargue el informe desde la URL del informe.

Informes diarios

Los datos de Singular se actualizan diariamente. Por lo general, querrás extraer tus datos de Singular todos los días, incluidos:

• Datos de ayer
• Datos históricos que puedan haber sido actualizados por sus redes.

En sus informes diarios habituales, le recomendamos que utilice las siguientes ventanas temporales para extraer datos históricos:

Tipo de consulta	Ventana de tiempo recomendada
Datos de red	7 días atrás.
Datos de seguimiento o datos combinados	Un período tan largo como su período de cohorte más largo. Por ejemplo, si tiene cohortes de 30 días, consulte 30 días atrás. Si no está extrayendo datos de cohortes, como ingresos, suele ser suficiente con extraer datos de 7 días atrás.

Comprobación de la disponibilidad de datos

Puede utilizar el punto final Estado de disponibilidad de datos para comprobar para cada conector de datos si Singular tiene datos de ese conector para la fecha dada, y cuándo fue la última vez que se actualizaron los datos.

El uso más común de este punto final es comprobar si los datos ya están disponibles para ayer para cada uno de sus conectores de datos. De esta forma, si todos los conectores de datos están listos, puede empezar a ejecutar informes para todos sus datos. Si sólo algunos de los conectores de datos tienen datos mientras que otros no, usted decide si desea esperar a que todos terminen o ejecutar un informe en cada fuente de datos a medida que sus datos estén disponibles. (Para ejecutar un informe en un único conector de datos en Crear informe asíncrono, filtre el informe por data_connector_id).

Tenga en cuenta que Singular no recomienda ejecutar un informe en más de un conector/fuente de datos en la misma consulta.

Comprobación de la actualidad de los datos

Para ver cómo de actualizados están los datos de su red en Singular, incluya la dimensión data_connector_timestamp_utc en la consulta de su informe.

Esta dimensión incluye la fecha y la hora en que Singular comenzó a extraer los datos del conector de datos (independientemente del tiempo que se tardó en ingerir, procesar y guardar los datos en la base de datos de Singular).

Algunos ejemplos de casos de uso de la marca de tiempo de los datos son:

• Si está experimentando discrepancias entre los informes de Singular y los datos de su cuadro de mando de red.
• Si está utilizando destinos de datos de Singular (ETL) para extraer datos de Singular en su plataforma de BI y desea ver si Singular tiene datos más recientes.