[GA4] Importe eventos offline

Acerca dos dados de eventos offline

Pode importar eventos offline 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 offline

Para importar eventos offline, crie um ficheiro CSV que corresponda ao esquema de eventos do Analytics. Veja o exemplo de modelo 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.

Carregue os 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 evento offline.

No caso dos eventos offline, 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.

Detalhes da origem de dados

Legenda

Âmbito Evento
Campos obrigatórios

[um destes] client_id ou app_instance_id

[um destes] tag_id ou firebase_app_id

(tag_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; tem de ocorrer no prazo de 72 horas após o evento; data/hora do carregamento se não 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 offline. 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, utilize 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 CONCEDIDO RECUSADO page_view /home referrer.com Página inicial 1600x900 azul 1-2                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488060000000 RECUSADO RECUSADO page_view /video_detail   Visualizador de vídeos 1600x900 azul 1-4                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488120000000 RECUSADO CONCEDIDO video_play /video_detail   Visualizador de vídeos 1600x900 azul                                    
G-67890ABCDE 2345678901.9876543210 1000002 1609574400000000 RECUSADO CONCEDIDO page_view /home referrer.com Página inicial 2560x1440 verde 2-2                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574460000000 RECUSADO CONCEDIDO page_view /product_detail   Detalhes do produto 2560x1440 verde 2-16                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574520000000 CONCEDIDO CONCEDIDO page_view /product_detail   Detalhes do produto 2560x1440 verde                                    
G-67890ABCDE 121212.3434 1000003 1609574520000000 CONCEDIDO CONCEDIDO page_view /camp_lp_1 referrer.com Liquidação de verão! 2560x1440 azul 3-1                                  
G-67890ABCDE 121212.3434 1000003 1609660801000000 CONCEDIDO RECUSADO view_item_list /camp_lp_1   Liquidação de verão! 2560x1440 azul   123abc red_shoe shoe list_123 colorful_shoes 1 1   234bcd blue_shoe 1 30.00          
G-67890ABCDE 121212.3434 1000003 1609660860000000 CONCEDIDO CONCEDIDO select_item /camp_lp_1   Liquidação de verão! 2560x1440 azul   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660870000000 CONCEDIDO CONCEDIDO page_view /product_detail   Detalhes do produto 2560x1440 azul 3-5 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660930000000 RECUSADO CONCEDIDO view_item /product_detail   Detalhes do produto 2560x1440 azul 3-17 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660950000000 RECUSADO RECUSADO add_to_cart /product_detail   Detalhes do produto 2560x1440 azul   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660970000000 CONCEDIDO RECUSADO begin_checkout /product_detail   Detalhes do produto 2560x1440 azul   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660975000000 CONCEDIDO RECUSADO page_view /purchase_confirmation   Parabéns! 2560x1440 azul 3-21 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660980000000 CONCEDIDO RECUSADO purchase /purchase_confirmation   Parabéns! 2560x1440 roxo 3-21 234bcd blue_shoe shoe 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.

A informação foi útil?

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