Sobre os dados de eventos off-line
Usando os SDKs ou o Measurement Protocol, é possível importar eventos off-line de origens sem conexão com a Internet ou que não são compatíveis com a coleta de eventos em tempo real. Quando você faz o upload de eventos, eles são processados como se tivessem sido coletados pelos nossos SDKs e usam o carimbo de data/hora que você informa ou o carimbo do upload.
É possível importar qualquer evento que corresponda àqueles que o Google Analytics coleta automaticamente ou que recomendamos para diferentes indústrias, ou, então, qualquer evento, parâmetro ou propriedade do usuário personalizada com a formatação correta. Saiba mais.
Para remover esses dados, é preciso uma solicitação de exclusão de dados ou uma exclusão de usuário.
Como funciona a importação de dados de eventos off-line
Para importar eventos off-line, crie um arquivo CSV associado ao esquema de eventos do Google Analytics. Confira abaixo o exemplo de modelo.
Criar dimensões personalizadas
Se você estiver importando valores para dimensões que ainda não existem no Google Analytics e quer ver esses dados nos relatórios, crie essas dimensões antes de fazer o upload. Saiba mais.
Depois, é preciso aguardar até quatro horas para que o Google Analytics reconheça os dados importados. Para verificar se as dimensões personalizadas foram processadas, abra uma análise detalhada e verifique se elas estão disponíveis no seletor de dimensões.
Criar um arquivo CSV
Crie um arquivo CSV com os dados de eventos usando o modelo abaixo como guia.
Fazer upload dos dados
O procedimento geral de upload é descrito em Sobre a importação de dados.
Ao criar a fonte de dados, selecione Dados do evento off-line.
Para eventos off-line, seus campos importados são mapeados automaticamente para os campos do Google Analytics.
Depois que você fizer o upload, o Google Analytics poderá levar até 24 horas para disponibilizar os dados, públicos-alvo e análises detalhadas.
Os dados enviados não são removidos quando você exclui uma fonte de dados do serviço de upload de dados. Assim como acontece com todas as outras metodologias de coleta, pode ser necessário enviar um pedido de exclusão de dados para remover as informações enviadas pela importação de dados.
Detalhes da fonte de dados
Legenda
| Escopo | Evento |
|---|---|
| Campos obrigatórios |
client_id [ou] app_instance_id tag_id [ou] firebase_app_id (tag_id e client_id) ou (firebase_app_id e app_instance_id) event_name |
| Dados importados |
Você pode usar os seguintes formatos de cabeçalho para fazer o upload de eventos, parâmetros, itens ou dados de propriedades do usuário:
|
| Notas | Não é possível enviar ou associar informações de identificação pessoal com a importação de eventos off-line. Saiba mais. |
Modelo
Confira um exemplo de modelo CSV para os dados de eventos. Para criar arquivos de upload manualmente, use este exemplo como 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 | NEGADO | page_view | /home | referrer.com | Página inicial | 1600x900 | blue | 1-2 | |||||||||||||||||
| G-12345ABCDE | 1234567890.0987654321 | 1000001 | 1609488060000000 | NEGADO | NEGADO | page_view | /video_detail | Reprodução de vídeo | 1600x900 | blue | 1-4 | ||||||||||||||||||
| G-12345ABCDE | 1234567890.0987654321 | 1000001 | 1609488120000000 | NEGADO | CONCEDIDO | video_play | /video_detail | Reprodução de vídeo | 1600x900 | blue | |||||||||||||||||||
| G-67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574400000000 | NEGADO | CONCEDIDO | page_view | /home | referrer.com | Página inicial | 2560x1440 | green | 2-2 | |||||||||||||||||
| G-67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574460000000 | NEGADO | CONCEDIDO | page_view | /product_detail | Detalhes do produto | 2560x1440 | green | 2-16 | ||||||||||||||||||
| G-67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574520000000 | CONCEDIDO | CONCEDIDO | page_view | /product_detail | Detalhes do produto | 2560x1440 | green | |||||||||||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609574520000000 | CONCEDIDO | CONCEDIDO | page_view | /camp_lp_1 | referrer.com | Promoção de verão | 2560x1440 | blue | 3-1 | |||||||||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660801000000 | CONCEDIDO | NEGADO | view_item_list | /camp_lp_1 | Promoção de verão | 2560x1440 | blue | 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 | Promoção de verão | 2560x1440 | blue | 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 | blue | 3-5 | 234bcd | blue_shoe | shoe | list_123 | colorful_shoes | 2 | 1 | 30.00 | ||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660930000000 | NEGADO | CONCEDIDO | view_item | /product_detail | Detalhes do produto | 2560x1440 | blue | 3-17 | 234bcd | blue_shoe | shoe | 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 | blue | 234bcd | blue_shoe | shoe | list_123 | colorful_shoes | 2 | 1 | 30.00 | |||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660970000000 | CONCEDIDO | NEGADO | begin_checkout | /product_detail | Detalhes do produto | 2560x1440 | blue | 234bcd | blue_shoe | shoe | list_123 | colorful_shoes | 2 | 1 | 30.00 | |||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660975000000 | CONCEDIDO | NEGADO | page_view | /purchase_confirmation | Parabéns! | 2560x1440 | blue | 3-21 | 234bcd | blue_shoe | shoe | list_123 | colorful_shoes | 2 | 1 | 30.00 | ||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660980000000 | CONCEDIDO | NEGADO | purchase | /purchase_confirmation | Parabéns! | 2560x1440 | purple | 3-21 | 234bcd | blue_shoe | shoe | list_123 | colorful_shoes | 2 | 1 | 30.00 | t12345 | 37.49 | 2.50 | 4.99 | USD |
Limites
Eventos, parâmetros e propriedades do usuário que utilizam nomes reservados não serão aceitos.
Os parâmetros de evento de item (por exemplo, item_list_name) sem valores não serão aceitos. Os parâmetros de eventos de itens são aceitos pelo subconjunto recomendado de eventos (por exemplo, e-commerce, vagas, viagens).
Os nomes de eventos e parâmetros precisam obedecer às regras a seguir:
- Os eventos podem ter até 25 parâmetros.
- Os eventos podem ter até 25 propriedades do usuário.
- Os nomes das propriedades do usuário podem ter, no máximo, 24 caracteres.
- Os valores de propriedade do usuário precisam ter, no máximo, 36 caracteres.
- Os nomes dos eventos precisam ter no máximo 40 caracteres, começar com um caractere alfabético e podem conter apenas caracteres alfanuméricos e sublinhados (_).
- Os nomes dos parâmetros (incluindo os parâmetros de item) precisam ter até 40 caracteres alfanuméricos e sublinhados (_) e começar com um caractere alfabético.
- Os valores de parâmetros (incluindo aqueles de itens) podem ter, no máximo, 100 caracteres.