Exportación de registros y datos a nivel de usuario FAQ

Documento

Los datos a nivel de usuario son los datos brutos registrados por el rastreador de atribución de Singular, el motor de protección contra el fraude y las integraciones de SKAdNetwork. Puede descargar los registros a nivel de usuario a través de la página Exportar registros (Atribución > Exportar registros).

Para obtener una descripción de los campos de cada registro, consulte Exportar registros: Campos admitidos.

Este artículo describe las funciones de exportación de registros disponibles para los clientes de Singular. Si usted es un socio de Singular, consulte Uso del portal de socios.

Resolución de problemas con los registros

¿Por qué los registros de conversiones/eventos no coinciden con los informes agregados de Singular?

Si descarga los registros de conversiones o eventos (en la página Exportar registros ) y los recuentos no coinciden con lo que ve en los informes de Singular (la página Informes o los informes de API), compruebe lo siguiente:

El informe puede estar utilizando análisis de cohortes

Es posible que el informe muestre los eventos por cohorte, lo que significa que para cada día del intervalo de fechas, el informe cuenta los eventos creados por los usuarios que instalaron la aplicación ese día (consulte ¿Qué son las métricas de cohorte y los períodos de cohorte?). En cambio, los eventos de los registros exportados siempre se asocian a la fecha y hora reales en que se produjeron.

Comprueba la configuración del informe para asegurarte de que el periodo de cohorte está configurado como real para que muestre los eventos que se produjeron en la fecha real.

Hora del servidor frente a hora ajustada

La base de datos Singular tiene dos valores de tiempo distintos asociados a cada evento:

  • La hora del servidor (Server Timestamp ) refleja la hora en la que el evento fue recibido por los servidores de Singular. Esta hora puede ser muy diferente de la hora original en la que se produjo el suceso si se produjo un retraso técnico en el envío de los datos del suceso.
  • La hora ajustada refleja la hora original en la que se produjo el suceso.

El intervalo de fechas de la página Exportar registros se basa en la marca de hora del servidor.

Los intervalos de fechas de la página Informes y otras herramientas de generación de informes de Singular (por ejemplo, la API de Singular) se basan en la fecha y hora ajustadas.

Esto puede causar discrepancias en el recuento de eventos si, por ejemplo, un evento que se produjo el 1 de junio se retrasó de tal manera que llegó a los servidores de Singular el 2 de junio.

" Para obtener más consejos sobre la solución de problemas, consulte la sección Solución de problemas de sus informes.

¿Por qué veo "Orgánico", "Suprimido" o "No atribuido" en los registros en lugar de los nombres de redes y campañas?

Puede haber varias razones para que aparezcan estos valores en los registros descargados.

1. Conversiones orgánicas reales

Si se considera que una conversión no tiene un origen de pago, se marca como orgánica, y así es como aparece en los registros a nivel de usuario:

  • Red: "Orgánica"
  • Campaña: "No atribuida"

2. Campañas de Facebook

Por motivos de privacidad del usuario final, Facebook no nos permite mostrar datos a nivel de usuario para atribuciones basadas en la API de autoatribución de Facebook. Estas atribuciones aparecen como:

  • Red: "Sin atribuir"
  • Campaña: "Sin atribuir"

Ten en cuenta que, además de la API de autoatribución, Facebook también dispone de un método de atribución independiente basado en el Referrer de instalación de Android. Las atribuciones basadas en ese método se muestran con todos los detalles normales en los informes a nivel de usuario.

" Para obtener más información, consulta Integración de la atribución de anuncios de Facebook.

3. Campañas View-Through de TikTok

A partir del 22 de marzo de 2022, TikTok requiere que los MMPenmascaren los datos a nivel de usuario para las campañas view-through debido a la preocupación por la privacidad de los usuarios. Por lo tanto, si una conversión se atribuye a una campaña view-through (basada en impresiones) de TikTok, se muestra de la siguiente manera tanto en tus postbacks como en los registros:

  • Red: "TikTok Restringido"
  • Campaña: "TikTok Restringido"

" Para obtener más información, consulta Integración de la atribución de TikTok para empresas.

4. El período de retención de datos ha pasado

Algunos socios requieren que Singular enmascare los datos a nivel de usuario después de que haya pasado un cierto período de tiempo debido a preocupaciones sobre la privacidad del usuario.

Si una instalación o reconexión se atribuye a uno de los siguientes, y se activa un evento in-app después de que haya pasado el período de retención de datos, verá los siguientes detalles en los registros de eventos a nivel de usuario:

  • Red: "Orgánica"
  • Campaña: "Suprimida"
Socio Periodo máximo de conservación de datos
Facebook 6 meses
TikTok 6 meses
Twitter 6 meses
Anuncios Google 6 meses
Snapchat 2 meses

Sugerencia: Si recibe devoluciones a su plataforma interna de BI que incluyan conversiones y eventos, puede consultar los detalles internamente para comprender la fuente de adquisición original para el ID de dispositivo específico.

¿Por qué hay menos eventos/instalaciones de Facebook en el registro que en los informes agregados de Singular?

Desde octubre de 2021, Facebook no permite que los MMP como Singular muestren información a nivel de usuario sobre ninguna instalación o evento que se haya atribuido a través de la API de autoatribución de Facebook. Por lo tanto, estas instalaciones y eventos no se marcan como de Facebook en los registros de exportación ni en los postbacks enviados a tu BI interno. La limitación no se aplica a los datos agregados, por lo que Singular sí muestra información sobre estas instalaciones y eventos en los informes agregados (es decir, la página Informes, Singular API, etc.).

Ten en cuenta que, además de la API de autoatribución, Facebook dispone de otra solución de atribución, basada en el Referrer de instalación de Android. Las instalaciones y los eventos que se han atribuido a través de la referencia de instalación aparecen en los registros de exportación.

Te animamos a que proporciones a Singular las claves de descifrado del referente de instalación de tus aplicaciones para que podamos ofrecerte información basada en el referente de instalación sobre las campañas de Facebook.

" Para obtener más información, consulta Integración de atribución de anuncios de Facebook.

PREGUNTAS FRECUENTES

¿Qué son los datos a nivel de usuario?

Los datos a nivel de usuario son los datos en bruto que registra el mecanismo de atribución y el motor de protección contra el fraude de Singular.

Contienen los detalles de las actividades de los usuarios y los registros relacionados con la atribución, incluidos los clics, las conversiones, los reenganches, los eventos de usuario dentro de la aplicación, los postbacks, las decisiones de fraude, etc.

Singular utiliza estos datos para calcular los datos agregados que usted ve en los informes (por ejemplo, en la página Informes).

Como cliente del servicio de atribución de Singular, puede acceder a los datos sin procesar a nivel de usuario y utilizarlos de varias formas, por ejemplo, para cotejar los datos de los informes agregados si sospecha que hay algún problema.

Ejemplo: Registro con datos de eventos a nivel de usuario

Screen_Shot_2020-12-30_at_19.46.06.png

¿Cómo puedo acceder a los datos a nivel de usuario?

Hay tres formas de acceder a los datos a nivel de usuario:

1. La página Exportar registros (Atribución > Exportar registros)

La página Exportar registros de la plataforma Singular le permite descargar manualmente datos a nivel de usuario sobre clics, instalaciones, reconexiones, eventos dentro de la aplicación, devoluciones y datos relacionados con fraudes. La página genera un archivo CSV.

Como cliente, puede descargar datos desde principios del mes anterior. Por ejemplo, si estamos a mediados de febrero, puede descargar los datos del 1 de enero en adelante.

Para conocer las opciones disponibles para los socios deSingular, consulte Uso del portal de socios: Exportar registros.

2. Destinos de datos

Los destinos de datos de Singular (ETL) envían datos desde Singular directamente a su plataforma interna de BI, almacén de datos o servicio de almacenamiento. Uno de los tipos de datos que puede exportar de esta forma son las conversiones y los eventos a nivel de usuario.

" Obtenga más información en las preguntas frecuentes sobre destinos de datos de Singular.

3. Configuración de postbacksde BI internos

Si configura Singular para enviar postbacks a su plataforma interna de BI, puede recibir datos en tiempo real sobre instalaciones, reenganches, eventos dentro de la aplicación y decisiones de fraude.

" Obtenga más información en las Preguntas frecuentes sobre postbacks de BI internos.

¿Cómo descargo datos a nivel de usuario desde la página Exportar registros?

Para exportar un registro:

  1. Vaya a Atribución > Exportar Registros.
  2. Elija el intervalo de fechas pertinente. Puede exportar registros hasta principios del mes pasado. Recomendamos mantener el intervalo de fechas lo más reducido posible para evitar superar el límite de registros por descarga.
  3. Seleccione la aplicación, el sitio de la aplicación y el tipo de registro que desea exportar (clics, instalaciones, eventos o postbacks).
  4. Seleccione los campos que desea incluir arrastrándolos al cuadro Campos seleccionados.

    Screen_Shot_2020-12-30_at_19.52.07.png

    Asegúrese de seleccionar el campo ID de dispositivo al exportar cualquier registro para obtener datos precisos a nivel de usuario.

  5. Opcionalmente, puede filtrar el registro por Socios Atribuidos, Países, ID de Dispositivo y Tipo de Dispositivo. Para los registros de eventos, también puede filtrar por eventos específicos, y para los registros de conversión, puede filtrar por tipo de conversión. Recomendamos filtrar el registro tanto como sea posible para evitar sobrepasar el límite de registros.Screen_Shot_2020-12-30_at_19.19.49.png
  6. Seleccione Exportar registro.

Limitaciones

  • Facebook no permite el acceso a ningún dato a nivel de usuario basado en la API de autoatribución de Facebook. Cualquier campo que normalmente identifique una instalación autoatribuida de Facebook se marca como "No atribuido". Ten en cuenta que Facebook también tiene una solución de atribución independiente basada en la referencia de instalación de Android y que las instalaciones atribuidas en base a esta solución aparecen en las exportaciones a nivel de usuario. Para obtener más información, consulta la documentación sobre la integración de la atribución de anuncios de Facebook.
  • El intervalo de fechas se limita a principios del mes pasado para los clientes de Singular. Para conocer las opciones disponibles para los socios de Singular, consulta Uso del portal de socios: Exportar registros.
  • La exportación está limitada a 5M de registros por solicitud.
  • Los registros proporcionarán datos hasta los últimos 60 minutos del día en curso. Seleccione la casilla de verificación de datos en tiempo real para obtener los datos de los últimos 60 minutos.
  • La base de datos de Singular tiene dos valores de tiempo distintos asociados a cada registro de los diarios: la marca de tiempo del servidor (que refleja el momento en que los servidores de Singular recibieron el evento) y la marca de tiempo ajustada (que refleja el momento original en que se produjo el evento). Esto puede causar discrepancias entre los datos a nivel de usuario y los informes agregados(más información).

Otras notas

  • El campo de zona horaria indica la zona horaria configurada para su cuenta de Singular.
  • Los campos con fecha y hora (por ejemplo, touchpoint__timestamp) se exportan en la zona horaria configurada. Las marcas de tiempo basadas en la hora Unix (por ejemplo, touchpoint__unix_timestamp) están en la zona horaria UTC.
  • Si desea cambiar la lista de campos exportados de forma predeterminada, o añadir una solicitud para que se exporte un nuevo campo, póngase en contacto con su Gestor de éxito del cliente.
  • Si una red solicita datos de fraude a nivel de usuario y no está habilitada para recibir devoluciones de fraude a través de Configuración de socios, puede descargar y compartir los registros de fraude con la red. Singular no compartirá estos datos con ninguna red a través de un ticket de soporte sin consentimiento.
¿Qué tipos de registros puedo descargar?

Clics

Incluye todos los clics que se examinaron para determinar la atribución de una instalación o un reenganche.

Conversiones

Incluye información sobre eventos de instalación y reconexión, a quién se atribuyeron y otros detalles sobre la atribución (por ejemplo, si fue determinista o probabilística).

Nota: La ubicación proporcionada para el evento de conversión se basa en la IP desde la que se activó, no en ninguna ubicación detectada internamente en su aplicación ni en ninguna información proporcionada por el usuario. Si dispone de otra fuente de datos de ubicación para el evento, puede comprobarla leyendo el parámetro passthrough enviado por su aplicación a Singular.

Eventos

Incluye datos sobre eventos dentro de la aplicación, como sesiones, registros, compras y cualquier otro evento que se haya definido en la aplicación al integrar Singular SDK/S2S.
Al comparar datos de registros de eventos con recuentos de eventos en Informes, asegúrese de utilizar ACTUAL en Informes en lugar de un período de cohorte de 1d,7d,14d, etc. Tenga en cuenta que los Informes no muestran los datos frente a los eventos Únicos para el período ACTUAL.

Devoluciones

Incluye datos sobre cualquier devolución enviada por Singular (no sólo devoluciones sobre decisiones de atribución). El registro incluye devoluciones a su BI interno (si lo ha configurado) y a herramientas de análisis de terceros.

Consejo: Cuando descargue los registros de devoluciones, asegúrese de seleccionar los campos Código HTTP de respuesta y Cuerpo HTTP de respuesta. Response HTTP Code le indica si la devolución se ha realizado correctamente. Un código 200 significa éxito; otros valores significan que hubo un error. Cuando se produce un error en el envío, Singular reintenta el postback 5 veces más, en intervalos de 1, 5, 15, 30 y 60 minutos. El cuerpo HTTP de la respuesta puede incluir detalles adicionales sobre el error.

Postbacks deSKAN(SKAdNetwork)

Registros de las devoluciones de SKAdNetwork que Singular ha recibido de sus socios de redes publicitarias. Estas devoluciones sólo están disponibles para aplicaciones iOS que utilicen el seguimiento de SKAdNetwork y para socios que tengan una integración de SKAdNetwork con Singular que implique el reenvío de devoluciones. Más información sobre la solución SKAdNetwork de Singular.

Fraude

La salida bruta del sistema de prevención de fraudes de Singular.

Tenga en cuenta que este registro incluye una fila para cada punto de contacto (clic, impresión, etc.) asociado a un evento de instalación, incluida una fila para la opción "instalación orgánica", que también se examina como opción de atribución para cada instalación (consulte El proceso de detección de fraudes para obtener más información). Por lo tanto, puede ver múltiples puntos de contacto rechazados por fraude para una sola instalación.

¿Qué significan los diferentes campos?

" Para obtener una descripción de los campos de cada registro, consulte Exportar registros: Campos admitidos.

¿Cómo puedo utilizar los registros para cotejar las instalaciones en mi informe agregado?
  1. Ejecute un informe en la página Informes (o en la API de informes) que muestre las instalaciones por origen y campaña.
  2. En la página Exportar registros, elija el tipo de registro Conversiones y extraiga los siguientes campos para el mismo intervalo de fechas:

crosscheck.png

¿Cuánto tiempo conserva Singular los datos a nivel de usuario?

Para cumplir con nuestros socios integrados y las normas globales de privacidad del usuario, Singular puede restringir la retención de datos a nivel de usuario a un máximo de 30 días en determinados casos. A menos que se especifique lo contrario, los períodos de retención por defecto para los datos a nivel de usuario son los siguientes:

  • Datos de impresión: Retenidos durante 14 días desde la fecha de recogida.
  • Datos de clics: Conservados durante 30 días a partir de la fecha de recogida.
  • Datos de devolución: Conservados durante 30 días a partir de la fecha de recogida.
  • Datos de eventos: Conservados desde el inicio del mes anterior(hasta 60 días).
  • Datos de atribución: Conservados desde el inicio del mes anterior(hasta 60 días).
  • Datos de fraude: Conservados desde el inicio del mes anterior(hasta 60 días).

Estos periodos de conservación garantizan el cumplimiento de la normativa sobre privacidad, al tiempo que proporcionan acceso a datos esenciales para el análisis y la elaboración de informes. Para conservar todos los datos de nivel de registro más allá de estos periodos, recomendamos encarecidamente configurar exportaciones automatizadas para capturar y almacenar esta información en sus sistemas internos.