Mapeamentos de campo

Use os mapeamentos nas tabelas para mapear uma solicitação de coleta de dados do Measurement Protocol (/mp/collect) ao equivalente IngestEventsRequest na API Data Manager.

Campos de solicitação

Solicitação /mp/collect (Measurement Protocol) IngestEventsRequest (API Data Manager) Observações
measurement_id (parâmetro de consulta) destinations Mapa para product_destination_id para eventos da Web. Consulte Campos de destino para mais detalhes.
firebase_app_id (parâmetro de consulta) destinations Mapeie para product_destination_id em eventos de app. Consulte Campos de destino para mais detalhes.
api_secret (parâmetro de consulta) Não há equivalente Consulte Configurar o acesso à API para saber como autenticar solicitações na API Data Manager.
consent consent Definido como um objeto Consent.
events events Definido como uma lista de recursos Event. Consulte a seção Campos de evento para mais detalhes.
client_id events.client_id Obrigatório para eventos da Web.
app_instance_id events.app_instance_id Obrigatório para eventos de app.
user_id events.user_id Opcional. Identificador exclusivo de um usuário.
timestamp_micros events.event_timestamp No Measurement Protocol, isso pode ser fornecido no nível da solicitação ou para um evento individual. Na API Data Manager, não há um carimbo de data/hora no nível da solicitação. Defina event_timestamp em cada evento como o horário em que ele ocorreu.
  • Se você estiver usando o formato JSON, defina um valor no formato RFC 3339.
  • Se você estiver usando buffers de protocolo, use um Timestamp e defina os campos seconds e (opcionalmente) nanoseconds.

Consulte Formato do carimbo de data/hora para mais detalhes.
user_properties events.user_properties Definido como um objeto UserProperties. A API Data Manager não é compatível com carimbos de data/hora de configuração para propriedades individuais do usuário. Os carimbos de data/hora associados a mudanças nas propriedades do usuário são inferidos do carimbo de data/hora do evento (event_timestamp).
user_data events.user_data Definido como um objeto UserData. Consulte Campos de identificador do usuário para mais detalhes.
non_personalized_ads events.consent.ad_personalization Se non_personalized_ads for true, defina ad_personalization como DENIED.
user_location events.event_location Consulte Campos de local do usuário para mais detalhes.
ip_override events.event_device_info.ip_address
device events.event_device_info Consulte Campos de dispositivo para mais detalhes.
user_agent events.event_device_info.user_agent
validation_behavior Não há equivalente Use o Diagnóstico para recuperar o status do upload, além de erros e avisos de eventos individuais durante o processamento downstream. Se o IngestEventsRequest falhar (por exemplo, devido à falta de campos obrigatórios), nenhum evento será processado. Você precisará resolver o erro e tentar novamente. Consulte Entender erros de API para mais informações.
/debug/mp/collect validate_only Defina validate_only como true para validar eventos sem ingerir dados, semelhante ao servidor de validação do Measurement Protocol.
Não há equivalente encoding Obrigatório para uploads de UserData. Definido como o Encoding usado para valores de UserIdentifier.

Campos de destino

O Measurement Protocol envia eventos diretamente para um fluxo de dados específico usando o parâmetro de consulta measurement_id ou firebase_app_id.

A API Data Manager usa um objeto Destination para especificar onde enviar dados. Confira Configurar destinos para mais informações.

Veja como mapear os campos do Measurement Protocol para os campos equivalentes em um Destination:

Measurement Protocol Destination (API Data Manager) Observações
measurement_id (parâmetro de consulta) product_destination_id Definido como o ID de métricas do fluxo de dados da Web do Google Analytics.
firebase_app_id (parâmetro de consulta) product_destination_id Definido como o ID do app do Firebase do fluxo de dados do app do Google Analytics.
Não há equivalente operating_account Defina account_id como o ID da propriedade do Google Analytics. Defina account_type como GOOGLE_ANALYTICS_PROPERTY.
Não há equivalente login_account Defina account_id como o ID da propriedade do Google Analytics. Defina account_type como GOOGLE_ANALYTICS_PROPERTY.

Campos de evento

Measurement Protocol events[] Event (API Data Manager) Observações
name event_name Se event_name usar um nome reservado, a API vai rejeitar o evento com um erro INVALID_EVENT_NAME.
Não há equivalente event_source Defina como WEB se o evento foi gerado em um navegador da Web e APP se foi gerado em um app.
Não há equivalente destination_references Obrigatório se a lista destinations no nível da solicitação contiver mais de um Destination do Google Analytics. Adicione uma entrada para especificar qual destino vai receber o evento.
timestamp_micros event_timestamp
  • Se você estiver usando o formato JSON, defina um valor no formato RFC 3339.
  • Se você estiver usando buffers de protocolo, use um Timestamp e defina os campos seconds e (opcionalmente) nanoseconds.

Consulte Formato do carimbo de data/hora para mais detalhes.
params.currency currency
params.value conversion_value
params.customer_type user_properties.customer_type No Measurement Protocol, o parâmetro customer_type é definido como um parâmetro de evento. Na API Data Manager, defina o campo customer_type no objeto UserProperties do evento.
params.transaction_id transaction_id Obrigatório para alguns eventos e casos de uso. Consulte Converter os dados em objetos Event para mais detalhes.
params.items cart_data.items Consulte Campos de item para dados do carrinho para mais detalhes.
params.coupon cart_data.coupon_codes Use o campo coupon_codes para informar os cupons aplicados ao carrinho. Forneça apenas um cupom para o Google Analytics. Isso é independente dos cupons no nível Item, que podem ser definidos usando cart_data.items.additional_item_parameters para itens individuais.
params.session_id additional_event_parameters Mapeia para uma entrada com parameter_name definido como session_id.
params.engagement_time_msec additional_event_parameters Mapeia para uma entrada com parameter_name definido como engagement_time_msec.
Outros: params additional_event_parameters

Mapeie outros parâmetros como uma lista de objetos com parameter_name e value.

Observação:não adicione entradas para transaction_id, currency ou value aqui. Use os campos de nível superior no Event.

Campos do identificador de usuário

Measurement Protocol user_data UserIdentifier (API Data Manager) Observações
sha256_email_address[] email_address Definido como o endereço de e-mail formatado e com hash. Também é possível criptografar o endereço de e-mail com hash.
sha256_phone_number[] phone_number Definido como o número de telefone formatado e com hash. Também é possível criptografar o número de telefone com hash.
address[] address Definido como um objeto AddressInfo. Siga as diretrizes de formatação e hash.
address[].sha256_first_name address.given_name Definido como o nome formatado e com hash. Também é possível criptografar o nome fornecido com hash.
address[].sha256_last_name address.family_name Definido como o nome da família formatado e com hash. Também é possível criptografar o nome da família com hash.
address[].country address.region_code
address[].postal_code address.postal_code
address[].city Não há equivalente Indisponível na versão atual da API Data Manager.
address[].region Não há equivalente Indisponível na versão atual da API Data Manager.
address[].sha256_street Não há equivalente Indisponível na versão atual da API Data Manager.

Campos de item para dados do carrinho

Measurement Protocol items[] Item (API Data Manager) Observações
item_id item_id Obrigatório.
item_name additional_item_parameters Mapeia para uma entrada com parameter_name definido como item_name.
quantity quantity Obrigatório.
price unit_price Obrigatório.
Outros campos de itens additional_item_parameters

Mapeie outros parâmetros de item (como discount, affiliation, item_brand etc.) como uma lista de objetos com parameter_name e value.

Observação:não adicione entradas para quantity, price ou item_id aqui. Use os campos de nível superior em Item.

Campos de localização do usuário

Measurement Protocol user_location EventLocation (API Data Manager) Observações
city city O nome da cidade em que o evento ocorreu.
country_id region_code Definido como o código de região CLDR de duas letras.
region_id subdivision_code Definido como o código de subdivisão ISO 3166-2.
continent_id continent_code Definido como o código do continente no formato UN M49.
subcontinent_id subcontinent_code Definido como o código do subcontinente no formato M49 da ONU.

Campos do dispositivo

Measurement Protocol device DeviceInfo (API Data Manager) Observações
category category
language language_code
screen_resolution screen_height e screen_width No Measurement Protocol, screen_resolution é fornecido como uma string ("1280x720"). Na API Data Manager, envie screen_height e screen_width como valores inteiros separados.
operating_system operating_system
operating_system_version operating_system_version
model model
brand brand
browser browser
browser_version browser_version
Anterior
Etapas para o upgrade