API de conversiones

Parámetros de eventos del servidor

Parámetro	Descripción
`event_name` Cadena	Obligatorio. Nombre de un evento estándar o un evento personalizado. Este campo se usa para eliminar eventos duplicados enviados por la web (a través del píxel de Meta) o la aplicación (a través del SDK o la API de eventos de la aplicación) y la API de conversiones. El parámetro `event_id` también se usa en la eliminación de duplicados. Para la misma acción del cliente, `event` del evento del navegador o la aplicación coincide con `event_name` del evento del servidor. Si encontramos una coincidencia entre eventos enviados en un plazo de 48 horas, solo se tiene en cuenta el primero. Si un evento del servidor o la aplicación y uno del navegador llegan aproximadamente a la vez (es decir, con una diferencia de cinco minutos como mucho), conservamos el evento del navegador o la aplicación. Obtén más información sobre la eliminación de eventos duplicados del píxel y del servidor.
`event_time` Entero	Obligatorio. Marca de tiempo Unix en segundos que indica cuándo se produjo el evento real. La hora especificada puede ser anterior a la hora en que enviaste el evento a Facebook. De esta forma, se puede activar la optimización del rendimiento del servidor y el procesamiento por lotes. Debes enviar esta fecha en la zona horaria GMT. El valor de `event_time` puede ser hasta siete días antes del envío de un evento a Facebook. Si algún valor de `event_time` en `data` es de hace más de siete días, se devuelve un error para la toda la solicitud y no se procesa ningún evento.
`user_data` Objeto	Obligatorio. Mapa que contiene la información del cliente. Consulta las opciones en Parámetros de información del cliente. Consulta Coincidencias avanzadas para conocer las opciones comparables disponibles para los datos enviados a través del píxel de Meta.
`custom_data` Objeto	Opcional. Mapa que incluye datos empresariales adicionales sobre el evento. Consulta Parámetros de datos personalizados para obtener más información.
`event_source_url` Cadena	Opcional. URL del navegador donde se produjo el evento. La URL debe coincidir con el dominio verificado. Nota: El parámetro `event_source_url` es obligatorio para los eventos del sitio web compartidos mediante la API de conversiones.
`opt_out` Booleano	Opcional. Marca que indica que no deberíamos utilizar este evento para la optimización de la entrega de anuncios. Si se establece en `true`, solo utilizamos el evento para la atribución.
`event_id` Cadena	Opcional. Este identificador puede ser cualquier cadena única que elija el anunciante. Los parámetros `event_id` y `event_name` se usan para eliminar eventos duplicados enviados por la web (a través del píxel de Meta) o la aplicación (a través del SDK o la API de eventos de la aplicación) y la API de conversiones. Ten en cuenta que, aunque el parámetro `event_id` se marca como opcional, es recomendable para la eliminación de duplicados. Para la eliminación de duplicados, el valor de `eventID` de un evento del navegador o de la aplicación debe coincidir con el de `event_id` en el evento del servidor correspondiente. Obtén más información sobre la gestión de los eventos duplicados del píxel y la API de conversiones. Un número de pedido o un identificador de transacción son dos posibles identificadores que se pueden usar para `event_id`. Por ejemplo, si un cliente realiza dos compras en tu sitio web con los números de pedido 123 y 456, cada llamada a la API de conversiones necesitará incluir su número de pedido correspondiente para `event_id`. De esta forma, podemos distinguir correctamente estos dos eventos de compra como pedidos diferentes. Los dos eventos de compra correspondientes del píxel del navegador necesitarán enviar también los mismos números de pedido en el parámetro `eventID` para que podamos comprender que solo se produjeron dos eventos y no cuatro compras únicas. En el caso de otros eventos sin un número de identificación intrínseco, se puede usar un número aleatorio (siempre que se envíe el mismo número aleatorio entre los eventos del navegador y del servidor).
`action_source` Cadena	Obligatorio. Este campo permite especificar dónde se produjeron las conversiones. Saber dónde tuvieron lugar los eventos te ayuda a asegurarte de que los anuncios lleguen a las personas adecuadas. Al utilizar la API de conversiones, aceptas que el parámetro `action_source` es adecuado hasta donde tú sabes. Los valores que puedes enviar en el campo `action_source` son los siguientes: `email`: la conversión se produjo a través del correo electrónico. `website`: la conversión se realizó en tu sitio web. `app`: la conversión se realizó en tu aplicación para móviles. `phone_call`: la conversión se realizó por teléfono. `chat`: la conversión se realizó a través de una aplicación de mensajes, de SMS o de una función de mensajes en internet. `physical_store`: la conversión se realizó en persona en tu tienda física. `system_generated`: la conversión se produjo automáticamente; por ejemplo, la renovación de una suscripción establecida para el pago automático cada mes. `business_messaging`: la conversión se produjo desde anuncios de clic a Messenger, Instagram o WhatsApp. `other`: la conversión se produjo de una manera que no se indica en la lista. Nota: Todos los valores de action_source activan las funciones de medición de publicidad y creación de audiencias personalizadas. Todos los valores de action_source activan las funciones de optimización de anuncios excepto `physical_store`.
`data_processing_options` Matriz	Opcional. Opciones de procesamiento que te gustaría activar para un evento concreto. El valor aceptado actualmente es `LDU` para el uso de datos limitado. Se puede enviar una matriz vacía para especificar explícitamente que este evento no debe procesarse con las restricciones de uso de datos limitado. Más información acerca de las opciones de procesamiento de datos. Consulta los ejemplos de implementación de la API de conversiones.
`data_processing_options_country` Entero	Obligatorio si envías `LDU` en `data_processing_options`. País que quieres asociar con esta opción de procesamiento de datos. Los valores aceptados actualmente son `1`, para los Estados Unidos de América, o `0`, para solicitar la geolocalización del evento. Obtén más información sobre las opciones de procesamiento de datos. Consulta los ejemplos de implementación de la API de conversiones.
`data_processing_options_state` Entero	Obligatorio en algunos casos. (Consulta la nota siguiente para obtener más información). Estado que quieres asociar con esta opción de procesamiento de datos. Actualmente, los valores aceptados son `1000`, para California, o `0`, para solicitar la geolocalización del evento. Nota: Si estableces un país, también debes establecer un estado. En caso contrario, aplicaremos la lógica de geolocalización a todo el evento. Este campo es obligatorio si envías `LDU` en `data_processing_options` y no proporcionas ninguna dirección IP. Obtén más información sobre las opciones de tratamiento de datos. Consulta los ejemplos de implementación de la API de conversiones.
`app_data` Objeto	Obligatorio para los eventos de la aplicación Parámetros para compartir los datos de la aplicación y la información del dispositivo a través de la API de conversiones. `extinfo` es un parámetro secundario de `app_data`.
`extinfo` Objeto	Obligatorio para los eventos de la aplicación Información del dispositivo ampliada, por ejemplo, el ancho y el alto de la pantalla. Este parámetro es una matriz y los valores están separados por comas. Al usar extinfo, se requieren todos los valores, que deben seguir el orden indexado a continuación. Si te falta un valor, incluye una cadena vacía como marcador de posición. Nota: `version` debe ser `a2` para Android. `version` debe ser `i2` para iOS.
`0` Cadena	Obligatorio. Versión de extinfo Ejemplo: `i2`
`1` Cadena	nombre del paquete de aplicaciones Ejemplo: `com.facebook.sdk.samples.hellofacebook`
`2` Cadena	versión corta (int o string) Ejemplo: `1.0`
`3` Cadena	versión larga Ejemplo: `1.0 long`
`4` Cadena	Obligatorio. Versión de SO Ejemplo: `13.4.1`
`5` Cadena	nombre del modelo de dispositivo Ejemplo: `iPhone5,1`
`6` Cadena	idioma Ejemplo: `En_US`
`7` Cadena	abreviatura de zona horaria Ejemplo: `PDT`
`8` Cadena	operador Ejemplo: `AT&T`
`9` Entero de 64 bits	ancho de la pantalla Ejemplo: `320`
`10` Entero de 64 bits	alto de la pantalla Ejemplo: `568`
`11` Cadena	densidad de la pantalla Ejemplo: `2`
`12` Entero de 64 bits	núcleos de la CPU Ejemplo: `2`
`13` Entero de 64 bits	capacidad de almacenamiento externo expresada en GB Ejemplo: `13`
`14` Entero de 64 bits	espacio libre en el almacenamiento externo expresado en GB Ejemplo: `8`
`15` Cadena	zona horaria del dispositivo Ejemplo: `USA/New York`
`referrer_url` Cadena	Opcional. Encabezado de referencia HTTP observado por la página que ha activado el evento de la API de conversiones o del píxel de Meta. Suele ser la página anterior del navegador.
`original_event_data` Objeto	Opcional. Todos los campos de metadatos que los anunciantes pueden usar para especificar cómo debe asociarse un evento “retrasado” a un evento de captación pasado. Recomendamos encarecidamente que uses `original_event_data` cuando haya un retraso entre la hora de envío de un evento y un evento de captación pasado al que debería asociarse. Consulta Parámetros de datos de los eventos originales para obtener más información.