Para obter informações gerais sobre os destinos de dados da Singular, como eles funcionam e os diferentes tipos de dados que podem ser exportados, consulte Perguntas frequentes sobre destinos de dados da Singular (ETL).
Quando você usa destinos de dados da Singular, a Singular padroniza os dados de diferentes fontes no mesmo esquema de dados para que você possa consultá-los facilmente em seu banco de dados.
A Singular oferece diferentes esquemas de dados que você pode escolher. Cada esquema define um conjunto diferente de campos que o destino de dados da Singular carregará em seu banco de dados.
Conversões e eventos estão disponíveis para todos os clientes do Data Destinations, enquanto outros esquemas são recursos premium. Use a tabela abaixo para ajudá-lo a escolher o esquema de dados que melhor atenda às suas necessidades.
Esquemas de dados em nível de usuário
Para obter mais informações sobre cada campo, consulte Export Logs: Campos compatíveis. Para saber mais sobre os diferentes campos de carimbo de data/hora, consulte Significados e formatos de carimbo de data/hora abaixo.
Observação: as impressões em nível de usuário estão disponíveis como um esquema personalizado para o S3. Para obter mais informações, entre em contato com seu gerente de sucesso do cliente.
Esquemas padrão
Os esquemas abaixo estão disponíveis para todos os nossos clientes.
Inclui informações sobre instalações e eventos de reengajamento, a quem eles foram atribuídos e outros detalhes sobre a atribuição (por exemplo, se foi determinísticaou probabilística).
Observação: a localização fornecida para o evento de conversão é baseada no endereço IP associado ao evento, e não em qualquer localização detectada internamente no seu aplicativo ou em qualquer informação fornecida pelo usuário. Se você tiver outra fonte de dados de localização para o evento, poderá verificá-la lendo o parâmetro de passagem enviado pelo seu aplicativo para o 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
waidInclui dados sobre eventos in-app, incluindo sessões, registros, compras e quaisquer outros eventos que tenham sido definidos no aplicativo ao integrar o 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_termOutros esquemas
Para usar um dos esquemas abaixo, abra um ticket na plataforma Singular
(Ajuda > Entre em contato conosco).
Inclui todos os cliques que foram examinados para determinar a atribuição de uma instalação ou reengajamento.
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_termInclui todos os postbacks de SKAdNetwork que a Singular recebeu de seus parceiros de rede de anúncios. Esses postbacks estão disponíveis apenas para aplicativos iOS que usam rastreamento de SKAdNetwork e para parceiros que têm uma integração de SKAdNetwork com a Singular que envolve o encaminhamento de postbacks.
A Singular também oferece dados agregados da SKAdNetwork: consulte Esquemas de dados brutos da SKAdNetwork e Esquemasde dados da 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_valueInclui todos os postbacks de SKAdNetwork que são recebidos diretamente da Apple pelas redes de anúncios. Consulte Como enviar postbacks da SKAdNetwork para 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_valueA saída bruta do sistema de prevenção contra fraudes da Singular (para saber mais, consulte Entendendo a prevenção contra fraudes da Singulare as Perguntas frequentes sobre relatórios e registros de fraudes).
Esses dados incluem uma linha para cada clique e impressãoassociados a um evento de instalação - incluindo uma linha para a opção "instalação orgânica", que também é examinada como uma opção de atribuição para cada instalação. Portanto, você pode ver vários pontos de contato rejeitados por fraude para uma única instalação. Para classificar ou agrupar todos os cliques e impressões pertencentes à mesma instalação, use o 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: Significados e formatos de carimbo de data/hora
Dica: A Singular fornece vários campos de registro de data e hora para cada linha de dados. A maioria dos campos de carimbo de data/hora tem duas versões, por exemplo, "event_timestamp" e "event_timestamp_unix_utc".
- Os campos que terminam em _timestamp são formatados como uma coluna de carimbo de data/hora com reconhecimento de fuso horário em destinos de banco de dados e como um carimbo de data/hora com informações de fuso horário para destinos baseados em arquivos (S3/SFTP/GCS). O fuso horário é o fuso horário do anunciante.
- Os campos que terminam em _timestamp_unix_utc contêm a hora no formato de carimbo de data/hora UNIX (inteiro) em UTC.
- Observe que os destinos do BigQuery não são compatíveis com fusos horários. Todos os registros de data e hora enviados ao BigQuery estão em UTC.
| Campo de carimbo dedata/hora | Descrição |
| etl_record_processing_hour_utc | A hora em que os dados foram totalmente processados pela Singular. Esse valor pode ser posterior à hora do evento ou ao carimbo de data/hora do servidor. A cada hora, a Singular atualiza esse valor para os dados que foram totalmente processados durante a hora anterior. |
| Atribuições | |
|
event_timestamp event_timestamp_unix_utc |
A hora em que o evento de atribuição (por exemplo, a instalação) ocorreu no dispositivo. |
|
touchpoint_timestamp touchpoint_timestamp_unix_utc |
A hora do ponto de contato (clique ou impressão do anúncio) que levou ao evento de atribuição. |
| Eventos | |
|
adjusted_timestamp adjusted_timestamp_unix_utc |
A hora em que o evento realmente aconteceu no dispositivo. |
|
server_timestamp server_timestamp_unix_utc |
A hora em que o evento foi recebido pelos servidores da Singular. Observação: isso pode ser significativamente diferente do adjusted_timestamp se houver um atraso técnico no envio dos dados do evento. |
|
attribution_event_timestamp attribution_event_timestamp_unix_utc |
A hora em que o evento de atribuição (por exemplo, a instalação do aplicativo) ocorreu no dispositivo. |
|
touchpoint_timestamp touchpoint_timestamp_unix_utc |
A hora do ponto de contato (clique ou impressão do anúncio) que levou ao evento de atribuição. |
Como alterar o esquema de dados
Depois de criar e salvar o destino dos dados, você não pode mudar para outro esquema de dados. Isso ocorre porque a alteração da estrutura da tabela em um banco de dados ativo com dados existentes traz uma série de perigos e complicações.
Se você precisar alterar o esquema de dados, basta criar um novo destino. Você pode excluir a tabela antiga antes de criar o novo destino ou configurar o novo destino para carregar dados em uma nova tabela com um nome diferente. Esse processo garantirá que seus dados permaneçam seguros e que as consultas e cargas de trabalho existentes continuem funcionando.