Referência

Eventos-padrão

É possível usar a função fbq('track') do Pixel da Meta para rastrear os eventos-padrão a seguir. Os eventos-padrão também são compatíveis com objetos de parâmetro com propriedades específicas de objeto, o que permite incluir informações detalhadas sobre um evento.

Se estiver implementando o Pixel da Meta em conjunto com a API de Conversões, recomendamos a inclusão do parâmetro eventID como um quarto parâmetro na função fbq(‘track’). Consulte a documentação sobre desduplicação de eventos de pixel e de servidor para saber mais.

Nome do evento	Descrição do evento	Propriedades do objeto	Valor do custom_event_type de objeto promovido
`AddPaymentInfo`	Quando os dados de pagamento são adicionados ao fluxo de finalização da compra. Uma pessoa clica em um botão para salvar informações de cobrança.	`content_ids`, `contents`, `currency`, `value` Opcional.	ADD_PAYMENT_INFO
`AddToCart`	Quando um produto é adicionado ao carrinho de compras. Uma pessoa clica em um botão de adição ao carrinho.	`content_ids`, `content_type`, `contents`, `currency`, `value` Opcional. Obrigatório para anúncios de catálogo Advantage+: `contents`	ADD_TO_CART
`AddToWishlist`	Quando um produto é adicionado a uma lista de desejos. Uma pessoa clica em um botão de adição à lista de desejos.	`content_ids`, `contents`, `currency`, `value` Opcional.	ADD_TO_WISHLIST
`CompleteRegistration`	Quando um formulário de registro é preenchido. Uma pessoa envia um formulário preenchido de cadastro ou de inscrição.	`currency`, `value` Opcional.	COMPLETE_REGISTRATION
`Contact`	Quando uma pessoa inicia um contato com sua empresa por telefone, SMS, email, bate-papo etc. Uma pessoa envia uma pergunta sobre um produto.	Opcional.	CONTACT
`CustomizeProduct`	Quando uma pessoa personaliza um produto. Uma pessoa seleciona a cor de uma camiseta.	Opcional.	CUSTOMIZE_PRODUCT
`Donate`	Quando uma pessoa doa fundos para sua organização ou causa. Uma pessoa adiciona ao carrinho uma doação para uma ONG.	Opcional.
`FindLocation`	Quando uma pessoa pesquisa a localização da sua loja por um site ou app com a intenção de visitar pessoalmente o local físico. Uma pessoa quer encontrar um produto específico em uma loja local.	Opcional.	FIND_LOCATION
`InitiateCheckout`	Quando uma pessoa entra no fluxo de finalização da compra antes de concluí-lo. Uma pessoa clica em um botão de finalização da compra.	`content_ids`, `contents`, `currency`, `num_items`, `value` Opcional.	INITIATE_CHECKOUT
`Lead`	Quando um cadastro é concluído. Uma pessoa clica em preços.	`currency`, `value` Opcional.	LEAD
`Purchase`	Quando uma compra é feita ou um fluxo de finalização da compra é concluído. Após encerrar a compra ou o fluxo de finalização da compra, uma pessoa acessa a página de confirmação ou agradecimento.	`content_ids`, `content_type`, `contents`, `currency`, `num_items`, `value` Obrigatório: `currency` e `value` Obrigatório para anúncios de catálogo Advantage+: `contents` ou `content_ids`	PURCHASE
`Schedule`	Quando uma pessoa reserva um horário para visitar uma das suas localizações. Uma pessoa seleciona a data e o horário de uma aula de tênis.	Opcional.	SCHEDULE
`Search`	Quando uma pesquisa é feita. Uma pessoa pesquisa um produto no seu site.	`content_ids`, `content_type`, `contents`, `currency`, `search_string`, `value` Opcional. Obrigatório para anúncios de catálogo Advantage+: `contents` ou `content_ids`	SEARCH
`StartTrial`	Quando uma pessoa começa a usar uma versão de avaliação gratuita de um produto ou serviço que você oferece. Uma pessoa seleciona uma semana gratuita do seu jogo.	`currency`, `predicted_ltv` e `value` Opcional.	START_TRIAL
`SubmitApplication`	Quando uma pessoa se inscreve em um produto, serviço ou programa que você oferece. Uma pessoa solicita um cartão de crédito, se cadastra em um programa educacional ou se candidata a uma vaga de emprego.	Opcional.	SUBMIT_APPLICATION
`Subscribe`	Quando uma pessoa se inscreve para começar uma assinatura paga de um produto ou serviço que você oferece. Uma pessoa assina seu serviço de streaming.	`currency`, `predicted_ltv` e `value` Opcional.	SUBSCRIBE
`ViewContent`	Uma visita a uma página da web do seu interesse (por exemplo, uma página de produto ou uma página de destino). Com `ViewContent`, é possível ver se alguém acessou a URL de uma página da web, mas não o que foi visto ou feito na página em questão. Uma pessoa é direcionada para a página de detalhes de um produto.	`content_ids`, `content_type`, `contents`, `currency`, `value` Opcional. Obrigatório para anúncios de catálogo Advantage+: `contents` ou `content_ids`	VIEW_CONTENT

Propriedades do objeto

Você pode incluir as seguintes propriedades de objetos predefinidas com eventos personalizados e todos os eventos-padrão que as aceitam. Formate os dados de objeto de parâmetro usando JSON. Saiba mais sobre parâmetros de evento com o Blueprint.

Chave da propriedade	Tipo de valor	Descrição do parâmetro
`content_category`	String	Categoria da página ou do produto. Opcional.
`content_ids`	Matriz de números inteiros ou strings	As identificações de produtos associadas ao evento, como SKUs (por exemplo, `['ABC123', 'XYZ789']`).
`content_name`	String	Nome da página ou do produto. Opcional.
`content_type`	String	`product` ou `product_group`, dependendo dos `content_ids` ou `contents` que estão sendo transmitidos. Se as identificações enviadas nos parâmetros `content_ids` ou `contents` forem de produtos, o valor deverá ser `product`. No caso do envio de identificações de grupos de produtos, o valor deverá ser `product_group`. Caso nenhum `content_type` seja fornecido, a Meta fará a correspondência do evento a cada item com o mesmo ID, independentemente do tipo.
`contents`	Matriz de objetos	Uma matriz de objetos JSON que contém a quantidade e o código de barras internacional (EAN, pelas iniciais em inglês), quando aplicável, ou outros identificadores de produto e de conteúdo. `id` e `quantity` são os campos obrigatórios, por exemplo, `[{'id': 'ABC123', 'quantity': 2}, {'id': 'XYZ789', 'quantity': 2}]`.
`currency`	String	A moeda do `value` especificado.
`num_items`	Número inteiro	Usado com o evento `InitiateCheckout`. O número de itens quando a finalização da compra é iniciada.
`predicted_ltv`	Número inteiro, float	O valor total previsto de um assinante conforme definido pelo anunciante e expresso como um valor exato.
`search_string`	String	Usado com o evento `Search`. A string inserida pelo usuário para a pesquisa.
`status`	Booliano	Usado com o evento `CompleteRegistration` para mostrar o status do registro. Opcional.
`value`	Número inteiro ou float	O valor de um usuário executando esse evento para o negócio.