Importe eventos

Acerca dos dados de eventos

Pode importar eventos de origens que não tenham uma ligação à Internet ou que, de outro modo, não suportem a recolha de eventos em tempo real através dos SDKs ou do Protocolo de Medição. Assim que carregados, os eventos são processados como se tivessem sido recolhidos através de SDKs e usam a data/hora fornecida por si ou a data/hora do carregamento, se não a tiver fornecido.

Pode importar qualquer evento que corresponda aos eventos que o Analytics recolhe automaticamente ou aos que recomendamos para diferentes verticais, ou qualquer propriedade do utilizador, evento ou parâmetro personalizado formatado corretamente. Saiba mais

A remoção destes dados exige um pedido de eliminação de dados ou uma eliminação de utilizadores.

Como funciona a importação de dados de eventos

Para importar eventos, crie um ficheiro CSV que corresponda ao esquema de eventos do Analytics. Veja os exemplos de modelos abaixo.

Crie as dimensões personalizadas

Se estiver a importar valores de dimensões que ainda não existam no Analytics e pretender ver esses dados nos relatórios, tem de criar essas dimensões antes de carregar os seus dados. Saiba mais

Depois de criar as dimensões personalizadas, o Analytics precisa de até 4 horas para ser capaz de reconhecer os dados importados. (Pode validar o processamento das dimensões personalizadas ao abrir uma exploração e verificar se as dimensões estão disponíveis no selecionador de dimensões.)

Crie um ficheiro CSV

Crie um ficheiro CSV dos dados de eventos com o modelo abaixo como guia.

Carregar dados

O procedimento geral de carregamento está descrito no artigo Acerca da Importação de dados.

Quando criar a origem de dados, selecione Dados de eventos.

No caso dos eventos, os campos importados são mapeados automaticamente para os campos do Analytics.

Depois de carregar os dados, o Analytics pode demorar até 24 horas a disponibilizar os dados em relatórios, públicos-alvo e explorações.

Eliminar uma origem de dados do serviço de carregamento de dados não elimina os dados carregados. Se necessário e tal como acontece com todas as outras metodologias de recolha, pode ter de efetuar o acompanhamento com um pedido de eliminação de dados para remover os dados carregados através da Importação de dados.

Nota: consoante o tipo de carregamento ou a origem da Importação de dados, pode ou não ser possível editar os nomes dos campos.

Detalhes da origem de dados

Legend

Âmbito Evento
Campos obrigatórios

[um destes] client_id ou app_instance_id

[um destes] measurement_id ou firebase_app_id

(measurement_id e client_id) ou (firebase_app_id e app_instance_id)

event_name

Dados importados

Pode carregar dados de eventos, parâmetros, artigos ou propriedades do utilizador com os seguintes formatos de cabeçalho:

  • timestamp_micros (opcional; o evento tem de ocorrer nos 2 dias civis anteriores, mais o dia de hoje; data/hora do carregamento se não tiver sido fornecido)
  • user_id (opcional, mas recomendado quando disponível)
  • sinais de consentimento (opcionais, mas vivamente recomendados quando estão disponíveis. Saiba mais)
  • event_param.<xxxxx> (importe qualquer parâmetro, com qualquer nome)
  • user_property.<yyyyy> (importe qualquer propriedade do utilizador, com qualquer nome)
  • item<x>.<item_param> (por exemplo: item2.item_name)
Notas Não pode carregar ou associar informações de identificação pessoal à importação de eventos. Saiba mais

 

Modelo

Segue-se um exemplo de modelo CSV para os dados de eventos. Se precisar de criar os seus ficheiros de carregamento manualmente, use este exemplo como um guia.

measurement_id client_id user_id timestamp_micros ad_personalization ad_user_data event_name event_param.page_location event_param.page_referrer event_param.page_title event_param.screen_resolution user_property.color_score event_param.foo item1.item_id item1.item_name item1.category item1.item_list_id item1.item_list_name item1.index item1.quantity item1.price item2.item_id item2.item_name item2.quantity item2.price event_param.transaction_id event_param.value event_param.tax event_param.shipping event_param.currency
G-12345ABCDE 1234567890.0987654321 1000001 1609488000000000 concedida negado page_view /home referrer.com Página inicial 1600x900 azul 1-2                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488060000000 negado negado page_view /video_detail   Visualizador de vídeos 1600x900 azul 1-4                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488120000000 negado concedida video_play /video_detail   Visualizador de vídeos 1600x900 azul                                    
G-67890ABCDE 2345678901.9876543210 1000002 1609574400000000 negado concedida page_view /home referrer.com Página inicial 2560x1440 verde 2-2                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574460000000 negado concedida page_view /product_detail   Detalhes do produto 2560x1440 verde 2-16                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574520000000 concedida concedida page_view /product_detail   Detalhes do produto 2560x1440 verde                                    
G-67890ABCDE 121212.3434 1000003 1609574520000000 concedida concedida page_view /camp_lp_1 referrer.com Liquidação de verão! 2560x1440 azul 3-1                                  
G-67890ABCDE 121212.3434 1000003 1609660801000000 concedida negado view_item_list /camp_lp_1   Liquidação de verão! 2560x1440 azul   123abc red_shoe sapato list_123 colorful_shoes 1 1   234bcd blue_shoe 1 30.00          
G-67890ABCDE 121212.3434 1000003 1609660860000000 concedida concedida select_item /camp_lp_1   Liquidação de verão! 2560x1440 azul   234bcd blue_shoe sapato list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660870000000 concedida concedida page_view /product_detail   Detalhes do produto 2560x1440 azul 3-5 234bcd blue_shoe sapato list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660930000000 negado concedida view_item /product_detail   Detalhes do produto 2560x1440 azul 3-17 234bcd blue_shoe sapato list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660950000000 negado negado add_to_cart /product_detail   Detalhes do produto 2560x1440 azul   234bcd blue_shoe sapato list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660970000000 concedida negado begin_checkout /product_detail   Detalhes do produto 2560x1440 azul   234bcd blue_shoe sapato list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660975000000 concedida negado page_view /purchase_confirmation   Parabéns! 2560x1440 azul 3-21 234bcd blue_shoe sapato list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660980000000 concedida negado purchase /purchase_confirmation   Parabéns! 2560x1440 roxo 3-21 234bcd blue_shoe sapato list_123 colorful_shoes 2 1 30.00         t12345 37.49 2.50 4.99 USD

 

 

Limites

Os eventos, os parâmetros e as propriedades do utilizador que utilizem nomes reservados serão rejeitados.

Os parâmetros de eventos de artigos (por exemplo, item_list_name) sem valores serão rejeitados. Os parâmetros de eventos de artigos são suportados para um subconjunto de eventos recomendado (por exemplo, Comércio eletrónico, Empregos, Viagens).

Os nomes dos eventos e dos parâmetros têm de respeitar as seguintes regras:

  • Os eventos podem ter, no máximo, 25 parâmetros.
  • Os eventos podem ter, no máximo, 25 propriedades do utilizador.
  • Os nomes de propriedades do utilizador têm de ter 24 carateres ou menos.
  • Os valores de propriedades do utilizador têm de ter 36 carateres ou menos.
  • Os nomes de eventos têm de ter 40 carateres ou menos, só podem conter carateres alfanuméricos e sublinhados e têm de começar por um caráter do alfabeto.
  • Os nomes de parâmetros (incluindo parâmetros de artigos) têm de ter 40 carateres ou menos, só podem conter carateres alfanuméricos e sublinhados e têm de começar por um caráter do alfabeto.
  • Os valores de parâmetros (incluindo os valores de parâmetros de artigos) têm de ter 100 carateres ou menos.

Limites da importação de dados de eventos

Pode criar até 10 origens de dados para dados de eventos.

Esta página pode incluir conteúdo traduzido com tecnologia de IA. As traduções de IA podem conter erros.

A informação foi útil?

Como podemos melhorá-la?
Pesquisa
Limpar pesquisa
Fechar pesquisa
Google Apps
Menu principal
16701441471157394770
true
Pesquisar no Centro de ajuda
false
true
true
true
true
true
69256
false
false
false
false
false