Para obtener información general sobre los destinos de datos de Singular, cómo funcionan y los diferentes tipos de datos que se pueden exportar, consulte las preguntas frecuentes sobre destinos de datos de Singular (ETL).
Cuando utiliza 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 otros esquemas son funciones premium. Utilice la tabla siguiente para ayudarle a 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 compatibles. Para obtener más información sobre los diferentes campos de marca de tiempo, consulte Significado y formatos de las marcas de tiempo a continuación.
Esquemas predeterminados
Los esquemas siguientes están disponibles para todos nuestros clientes.
Incluye información sobre instalaciones y eventos de reenganche, 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 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 de paso 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
attribution__touchpoint__agency_id
attribution__event__device_id_type 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 el SDK/S2S de Singular.
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
banner name (from v4)
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
estimated_skan_user (from V5)
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_termIncluye datos a nivel de usuario para instalaciones asistidas, proporcionando detalles sobre los puntos de contacto que contribuyeron a una conversión, pero que no fueron la atribución final.
affiliate_id
affiliate_name
android_id
android_id_md5
android_sha1
app_longname
app_version
assist_touchpoints_count
assisted_level
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
gaid
gaid_md5
gaid_sha_1
google_click_id
idfa
idfa_md5
idfa_sha_1
idfv
is_fingerprinted
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_id
touchpoint_ip
touchpoint_timestamp
touchpoint_timestamp_unix_utc
tracker_name
waidOtros esquemas
Para utilizar uno de los esquemas siguientes, abra un ticket a través de la plataforma Singular
(Ayuda > Contacte con nosotros).
Incluye todos los clics que se examinaron para determinar la atribución de una instalación o 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_termIncluye todos los postbacks de SKAdNetwork que Singular recibió de sus socios de redes publicitarias. Estos postbacks solo 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 sin procesar de SKAdNetwork y Esquemasde datos 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_valueIncluye todos los postbacks de SKAdNetwork que las redes publicitarias reciben directamente de Apple. Estos pueden reenviarse a Singular. 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_valueEl resultado sin procesar del sistema de prevención de fraudes de Singular (para obtener más información, consulte Comprender la prevención de fraudes de Singular y las preguntas frecuentes sobre informes y registros de fraudes).
Estos datos incluyen una fila para cada clic e impresión asociados 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. Por lo tanto, es posible que vea varios puntos de contacto rechazados por fraude para una sola instalación. Para ordenar o agrupar todos los clics e impresiones que pertenecen 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_identifieretl_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
waidetl_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_nameApéndice: Significado 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 marca de tiempo 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 reconocimiento de zona horaria en destinos de bases 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 zona horaria del anunciante.
- Los campos que terminan en_timestamp_unix_utc contienen la hora en formato de marca de tiempo UNIX (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 de marca de tiempo | Descripción |
|---|---|
| etl_record_processing_hour_utc | La hora en la que Singular procesó completamente los datos. Esta puede ser posterior a la hora del evento o a la marca de tiempo del servidor. Cada hora, Singular actualiza este valor para los datos que se procesaron completamente 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 un anuncio o impresión de un anuncio) que condujo al evento de atribución. |
| Eventos | |
|
adjusted_timestamp ajustado_timestamp_unix_utc |
La hora en la que el evento ocurrió realmente en el dispositivo. |
|
server_timestamp server_timestamp_unix_utc |
La hora en la que los servidores de Singular recibieron el evento. Nota: puede diferir significativamente de la marca de tiempo ajustada si se produjo 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 en un anuncio o impresión de un anuncio) que condujo al evento de atribución. |
Cambiar el esquema de datos
Una vez que haya creado y guardado el destino de datos, no podrá cambiar a otro esquema de datos. Esto se debe a que cambiar la estructura de la tabla en una base de datos activa con datos existentes conlleva una serie de riesgos 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 nueva tabla con un nombre diferente. Este proceso garantizará que sus datos permanezcan seguros y que las consultas y cargas de trabajo existentes sigan funcionando.