Para obter informações gerais sobre destinos de dados Singular, como eles funcionam e os diferentes tipos de dados que podem ser exportados, consulte Perguntas frequentes sobre destinos de dados Singular (ETL).
Quando você usa destinos de dados do Singular, o Singular padroniza os dados de diferentes fontes no mesmo esquema de dados para que você possa consultá-los facilmente em seu banco de dados.
O Singular oferece diferentes esquemas de dados à sua escolha. Cada esquema define um conjunto diferente de campos que o destino de dados do Singular carregará no seu banco de dados.
Conversões e eventos estão disponíveis para todos os clientes de destinos de dados, enquanto outros esquemas são recursos premium. Use a tabela abaixo para ajudá-lo a escolher o esquema de dados que melhor atende às suas necessidades.
Esquemas de dados no nível do usuário
Para obter mais informações sobre cada campo, consulte Logs de exportação: 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.
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 foram atribuídos e outros detalhes sobre a atribuição (por exemplo, se foi determinística ou 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 em 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
waid
attribution__touchpoint__agency_id
attribution__event__device_id_type Inclui dados sobre eventos no aplicativo, incluindo sessões, registros, compras e quaisquer outros eventos que tenham sido definidos no aplicativo ao integrar o SDK/S2S da 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_termInclui dados no nível do usuário para instalações assistidas, fornecendo detalhes sobre pontos de contato que contribuíram para uma conversão, mas não foram a atribuição 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
waidOutros esquemas
Para usar um dos esquemas abaixo, abra um ticket através da 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 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 SKAdNetwork e para parceiros que têm uma integração 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 da SKAdNetwork recebidos diretamente da Apple pelas redes de publicidade. Estes podem então ser encaminhados para a Singular. 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 de Fraudes da Singular (para saber mais, consulte Entendendo a Prevenção de Fraudes da Singular e as Perguntas Frequentes sobre Relatórios e Registros de Fraudes).
Esses dados incluem uma linha para cada clique e impressão associados 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 carimbos de data/hora
Dica: o Singular fornece vários campos de carimbo de data/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 nos 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 BigQuery não suportam fusos horários. Todos os timestamps enviados para o BigQuery estão em UTC.
| Campo de carimbode data/hora | Descrição |
|---|---|
| etl_record_processing_hour_utc | A hora em que os dados foram totalmente processados pelo Singular. Isso pode ser posterior à hora do evento ou ao timestamp do servidor. A cada hora, o 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 ocorreu no dispositivo. |
|
server_timestamp server_timestamp_unix_utc |
A hora em que o evento foi recebido pelos servidores 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. |
Alterando o esquema de dados
Depois de criar e salvar o destino dos dados, você não pode mudar para outro esquema de dados. Isso porque alterar a estrutura da tabela em um banco de dados ativo com dados existentes traz uma série de riscos 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 os 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.