Destinos de datos: esquemas de datos a nivel de usuario (nivel de evento)

Seguir
Avatar
Vaibhav Gupta
Updated

Si desea información general sobre los destinos de datos de Singular, su funcionamiento y los distintos tipos de datos que pueden exportarse, consulte las preguntas frecuentes sobre destinos de datos de Singular (ETL).

Cuando utiliza los destinos de datos de Singular, Singular estandariza los datos de diferentes fuentes en el mismo esquema de datos para que pueda consultarlos fácilmente en su base de datos.

Singular ofrece diferentes esquemas de datos entre los que puede elegir. Cada esquema define un conjunto diferente de campos que el destino de datos de Singular cargará en su base de datos.

Las conversiones y los eventos están disponibles para todos los clientes de destinos de datos, mientras que los demás esquemas son funciones premium. Utilice la tabla siguiente para elegir el esquema de datos que mejor se adapte a sus necesidades.

Esquemas de datos a nivel de usuario

Para obtener más información sobre cada campo, consulte Exportar registros: Campos admitidos. Para obtener más información sobre los distintos campos de marca de hora, consulte Significados y formatos de las marcas de horamás abajo.

Nota: Las impresiones a nivel de usuario están disponibles como un esquema personalizado para S3.Para obtener más información, póngase en contacto con su Gestor de éxito de clientes.

Esquemas predeterminados

Los siguientes esquemas están disponibles para todos nuestros clientes.

Esquema de datos de atribuciones(v2)

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

Nota: La ubicación proporcionada para el evento de conversión se basa en la dirección IP asociada al evento, 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.

etl_record_processing_hour_utc
  affiliate_id
  affiliate_name
  android_id
  android_id_md5
  android_sha1
  app_longname
  app_version
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  country
  creative_id
  creative_name
  custom_user_ids
  device_id
  device_id_type
  device_make
  device_model
  event_timestamp
  event_timestamp_unix_utc
  fraud_reason
  fraud_status
  gaid
  gaid_md5
  gaid_sha_1
  google_click_id
  idfa
  idfa_md5
  idfa_sha_1
  idfv
  is_reengagement
  is_view_through
  method
  os_version
  partner
  passthrough
  platform
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  singular_campaign_name
  singular_partner_name
  state
  store
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  touchpoint_ip
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name
  utm_campaign
  utm_content
  utm_medium
  utm_source
  utm_term
  waid
Esquema de datos de eventos (v3)
#

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.

etl_record_processing_hour_utc
  adjusted_timestamp
  adjusted_timestamp_unix_utc
  affiliate_id
  affiliate_name
  app_longname
  app_version
  arguments
  attribution_event_timestamp
  attribution_event_timestamp_unix_utc
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  converted_currency
  converted_revenue
  country
  creative_id
  creative_name
  currency
  custom_user_id
  device_id
  device_id_type
  install_source
  ip
  is_reengagement
  is_revenue_receipt_included
  is_revenue_valid
  is_view_through 
  name 
  os_version 
  partner 
  passthrough 
  platform 
  product_category
  product_name 
  product_price 
  product_quantity 
  product_sku 
  publisher_concatenated
  publisher_hashed_id 
  publisher_id 
  publisher_name 
  received_revenue 
  received_revenue_event
  revenue 
  server_timestamp 
  server_timestamp_unix_utc 
  session_id 
  singular_campaign_name
  state 
  sub_campaign_id 
  sub_campaign_name 
  sub_publisher_id 
  sub_publisher_name
  tag_id 
  touchpoint_timestamp 
  touchpoint_timestamp_unix_utc 
  tracker_name
  utm_campaign
  utm_content
  utm_medium
  utm_source
  utm_term

Otros esquemas

Para utilizar uno de los esquemas siguientes, abra un ticket a través de la plataforma Singular
(Ayuda > Contacto).

Esquema de datos Clicks (v2)
#

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

etl_record_processing_hour_utc
  adjusted_timestamp
  adjusted_timestamp_unix_utc
  affiliate_id
  affiliate_name
  app_longname
  app_version
  arguments
  attribution_event_timestamp
  attribution_event_timestamp_unix_utc
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  converted_currency
  converted_revenue
  country
  creative_id
  creative_name
  currency
  custom_user_id
  device_id
  device_id_type
  install_source
  ip
  is_reengagement
  is_revenue_receipt_included
  is_revenue_valid
  is_view_through
  name
  os_version
  partner
  passthrough
  platform
  product_category
  product_name
  product_price
  product_quantity
  product_sku
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  received_revenue
  received_revenue_event
  revenue
  server_timestamp
  server_timestamp_unix_utc
  session_id
  singular_campaign_name
  state
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  tag_id
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name
  utm_campaign
  utm_content
  utm_medium
  utm_source
  utm_term
Esquema de datos de SKAdNetwork Postbacks
#

Incluye todas las devoluciones de SKAdNetwork que Singular recibió de sus socios de redes publicitarias. Estos postbacks sólo están disponibles para aplicaciones iOS que utilizan el seguimiento de SKAdNetwork y para socios que tienen una integración de SKAdNetwork con Singular que implica el reenvío de postbacks.

Singular también ofrece datos agregados de SKAdNetwork: consulte Esquemas de datos brutos de SKAdNetworky Esquemas dedatos de SKAdNetwork.

etl_record_processing_hour_utc
  app_longname
  city
  conversion_model_measurement_period
  conversion_model_name
  conversion_model_types
  conversion_model_version
  conversion_value
  country
  decoded_conversion_value
  estimated_cohort_period
  estimated_conversion_date
  estimated_install_date
  fraud_reason
  fraud_status
  ip
  is_view_through
  max_install_date
  min_install_date
  partner
  partner_campaign_id
  partner_campaign_name
  partner_creative_id
  partner_creative_name
  partner_sub_campaign_id
  partner_sub_campaign_name
  partner_sub_publisher_name
  referrer
  region
  signature
  singular_partner_name
  skadnetwork_app_id
  skadnetwork_campaign_id
  skadnetwork_network_id
  skadnetwork_publisher_app_id
  skadnetwork_redownload
  skadnetwork_version
  timestamp
  timestamp_unix_utc
  transaction_id
  user_agent
skan_postback__source_identifier
skan_postback__source_domain
skan_postback__postback_sequence_index
skan_postback__coarse_conversion_value
App SKAN Postbacks
#

Incluye todos los postbacks de SKAdNetwork que las redes publicitarias reciben directamente de Apple. Consulte Cómo enviar postbacks de SKAdNetwork a Singular (iOS 15+).

etl_record_processing_hour_utc
  app_longname
  skadnetwork_version
  transaction_id
  skadnetwork_network_id
  skadnetwork_campaign_id
  skadnetwork_app_id
  skadnetwork_publisher_app_id
  conversion_value
  signature
  skadnetwork_redownload
  is_view_through
  timestamp_unix_utc
  timestamp
  ip
  user_agent
  partner
  fraud_status
  fraud_reason
  decoded_conversion_value
  conversion_model_name
  conversion_model_version
  conversion_model_types
  conversion_model_measurement_period
  estimated_conversion_date
  estimated_install_date
  estimated_cohort_period
  min_install_date
  max_install_date
  singular_partner_name
skan_postback__source_identifier
skan_postback__source_domain
skan_postback__postback_sequence_index
skan_postback__coarse_conversion_value
Esquema de datos de fraude
#

La salida bruta del sistema de prevención de fraude de Singular (para obtener más información, consulte Cómo entender la prevención de fraude de Singulary las preguntas frecuentes sobre informes de fraude y registros de fraude).

Estos datos incluyen una fila para cada clic e impresiónasociada con un evento de instalación, incluida una fila para la opción "instalación orgánica", que también se examina como una opción de atribución para cada instalación. Para clasificar o agrupar todos los clics e impresiones pertenecientes a la misma instalación, utilice el campo unique_install_identifier.

etl_record_processing_hour_utc
  app_longname
  app_version
  creative
  device_id
  device_make
  device_model
  fraud_external_reason
  fraud_reason
  fraud_status
  idfv
  install_city
  install_country
  install_ip
  install_timestamp
  install_timestamp_unix_utc
  is_view_through
  os_version
  partner
  platform
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  time_to_install
  touchpoint_campaign
  touchpoint_city
  touchpoint_country
  touchpoint_ip
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  unique_install_identifier
Esquema de datos de atribuciones de usuario entre dispositivos
etl_record_processing_hour_utc
  affiliate_id
  affiliate_name
  android_id
  android_id_md5
  android_sha1
  app_longname
  app_version
  bid_type
  campaign_id
  campaign_name
  click_id
  country
  creative_id
  creative_name
  custom_user_ids
  device_id
  device_id_type
  event_timestamp
  event_timestamp_unix_utc
  gaid
  gaid_md5
  gaid_sha_1
  google_click_id
  idfa
  idfa_md5
  idfa_sha_1
  idfv
  is_view_through
  os_version
  partner
  passthrough
  platform
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  singular_campaign_name
  singular_partner_name
  state
  store
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  touchpoint_ip
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name
  waid
Esquema de datos de eventos entre dispositivos
etl_record_processing_hour_utc
  adjusted_timestamp
  adjusted_timestamp_unix_utc
  affiliate_id
  affiliate_name
  app_longname
  app_version
  arguments
  attribution_event_timestamp
  attribution_event_timestamp_unix_utc
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  converted_currency
  converted_revenue
  country
  creative_id
  creative_name
  currency
  custom_user_id
  device_id
  device_id_type
  install_source
  ip
  is_reengagement
  is_revenue_receipt_included
  is_revenue_valid
  is_view_through
  name
  os_version
  partner
  passthrough
  platform
  product_category
  product_name
  product_price
  product_quantity
  product_sku
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  received_revenue
  received_revenue_event
  revenue
  server_timestamp
  server_timestamp_unix_utc
  session_id
  singular_campaign_name
  state
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  tag_id
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name

Apéndice: Significados y formatos de las marcas de tiempo

Consejo: Singular proporciona varios campos de marca de tiempo para cada fila de datos. La mayoría de los campos de fecha y hora tienen dos versiones, por ejemplo, "event_timestamp" y "event_timestamp_unix_utc".

  • Los campos que terminan en _timestamp se formatean como una columna de marca de tiempo con información de zona horaria en destinos de base de datos, y como una marca de tiempo con información de zona horaria para destinos basados en archivos (S3/SFTP/GCS). La zona horaria es la del anunciante.
  • Los campos que terminan en _timestamp_unix_utc contienen la hora en formato UNIX timestamp (entero) en UTC.
  • Tenga en cuenta que los destinos de BigQuery no admiten zonas horarias. Todas las marcas de tiempo enviadas a BigQuery están en UTC.
Campo Timestamp Descripción
etl_record_processing_hour_utc Hora en la que Singular procesó por completo los datos. Cada hora, Singular actualiza este valor para los datos que se procesaron por completo durante la hora anterior.
Atribuciones
event_timestamp
event_timestamp_unix_utc 		La hora en la que se produjo el evento de atribución (por ejemplo, la instalación) en el dispositivo.
touchpoint_timestamp
touchpoint_timestamp_unix_utc 		La hora del punto de contacto (clic en el anuncio o impresión del anuncio) que condujo al evento de atribución.
Eventos
adjusted_timestamp
adjusted_timestamp_unix_utc 		Hora en la que se produjo realmente el evento en el dispositivo.
server_timestamp
server_timestamp_unix_utc 		La hora a la que los servidores de Singular recibieron el evento. Nota: puede diferir significativamente de la hora ajustada si se ha producido un retraso técnico en el envío de los datos del evento.
attribution_event_timestamp
attribution_event_timestamp_unix_utc 		La hora en la que se produjo el evento de atribución (por ejemplo, la instalación de la aplicación) en el dispositivo.
touchpoint_timestamp
touchpoint_timestamp_unix_utc 		La hora del punto de contacto (clic o impresión del anuncio) que condujo al evento de atribución.

Modificación del esquema de datos

Una vez creado y guardado el destino de los datos, no se puede cambiar a otro esquema de datos. Esto se debe a que cambiar la estructura de tablas en una base de datos activa con datos existentes conlleva una serie de peligros y complicaciones.

Si necesita cambiar el esquema de datos, simplemente cree un nuevo destino. Puede eliminar la tabla antigua antes de crear el nuevo destino o configurar el nuevo destino para que cargue los datos en una tabla nueva con un nombre diferente. Este proceso garantizará que tus datos permanezcan seguros y que las consultas y cargas de trabajo existentes sigan funcionando.