Parâmetros de evento do servidor

Obrigatório.
O nome de um evento-padrão ou de um evento personalizado. Esse campo é usado para desduplicar eventos enviados pela web (por meio do Pixel da Meta) ou pelo app (por meio do SDK ou da API de Eventos do App) e pela API de Conversões. O parâmetro event_id também é usado na desduplicação.

Para a mesma ação de cliente, o event do navegador ou do app corresponde ao event_name do servidor. Se encontrarmos uma correspondência entre os eventos enviados dentro de um período de 48 horas, consideraremos apenas o primeiro deles. Se um evento do servidor e um evento do navegador/app forem recebidos ao mesmo tempo (com até 5 minutos de diferença), o evento favorecido será o do navegador/app. Saiba mais sobre a Desduplicação de eventos de pixel e do servidor.

Obrigatório.
Um mapa que contém dados de informações do cliente. Consulte as opções em Parâmetros de informações do cliente. Consulte Correspondência avançada para conferir as opções comparáveis disponíveis para dados enviados por meio do Pixel da Meta.

Opcional.
A URL do navegador em que o evento ocorreu. A URL deve iniciar com http:// ou https:// e corresponder ao domínio verificado.

Observação: o event_source_url é obrigatório para eventos do site compartilhados por meio da API de Conversões.

Opcional.
Esta identificação pode ser qualquer string única escolhida pelo anunciante. Os parâmetros event_id e event_name são usados para desduplicar eventos enviados pela web (por meio do Pixel da Meta) ou pelo app (por meio do SDK ou da API de Eventos do App) e pela API de Conversões. Apesar de o parâmetro event_id estar marcado como opcional, ele é recomendado para a desduplicação de eventos.

Para a desduplicação, o eventID de um evento do navegador ou do app precisa coincidir com o event_id do evento correspondente do servidor. Saiba mais sobre Como gerenciar eventos duplicados de Pixel e da API de Conversões.

O número de um pedido ou a identificação da transação podem ser usados como identificadores em event_id. Por exemplo, se um cliente faz duas compras no site cujos números dos pedidos são 123 e 456, cada chamada da API de Conversões incluirá o respectivo número do pedido para event_id. Com isso, é possível distinguir os dois eventos de compra como pedidos diferentes. Os dois eventos correspondentes de compra de pixel do navegador também precisariam enviar os mesmos números de encomenda no parâmetro eventID. Assim, entenderíamos que ocorreram apenas dois eventos, não quatro compras únicas.

Para eventos sem um número de identificação intrínseco, é possível usar um número aleatório, desde que o mesmo número seja enviado em eventos do navegador e do servidor.

Opcional.
As opções de processamento que você gostaria de habilitar para um evento específico. O valor aceito atualmente é LDU para o Uso limitado de dados. Uma matriz vazia pode ser enviada para especificar de maneira explícita que esse evento não deve ser processado com as restrições de Uso limitado de dados. Saiba mais sobre as opções de processamento de dados. Veja exemplos de implementação da API de Conversões.

Obrigatório em alguns casos (veja a observação para mais detalhes).
Um estado que você deseja associar a esta opção de processamento de dados. Os valores aceitos atualmente são 1000, para a Califórnia, ou 0, para solicitar a geolocalização do evento.

Observações:

• Se você definir um país, deverá definir também um estado. Caso contrário, aplicaremos nossa lógica de geolocalização a todo o evento.
• Esse campo é obrigatório se você enviar LDU em data_processing_options e não fornecer um endereço IP.

Saiba mais sobre as opções de processamento de dados. Veja exemplos de implementação da API de Conversões.