Este documento se ha actualizado.
La traducción en Español (España) no está disponible todavía.

Actualización del documento en inglés: 19 nov.

Prácticas recomendadas: API de conversiones

Utiliza estas prácticas recomendadas como recomendaciones generales para integrar correctamente la API de conversiones. El objetivo de estas recomendaciones es ayudarte a usar la API de conversiones de la forma más eficaz. Sigue las recomendaciones para la implementación y el proceso posterior a fin de garantizar una integración fluida y unos resultados óptimos al compartir datos con Meta.

Además de las prácticas recomendadas que se señalan a continuación, recomendamos ver este vídeo, que ofrece un tutorial más práctico sobre el uso de la API de conversiones. En el vídeo se describen los siguientes procesos:

Envío de solicitudes
Gestión de los eventos omitidos, la hora de transacción de los eventos y las solicitudes por lotes
Verificación de eventos
Uso de la herramienta “Probar eventos”

Los eventos de la web, la aplicación y la tienda física compartidos mediante la API de conversiones requieren parámetros específicos. La lista de parámetros necesarios está disponible aquí.

Implementación

Al configurar una campaña, puedes simplificar la estructura de la cuenta y usar las prácticas recomendadas consolidadas para campañas que se indican a continuación:

Implementa las prácticas recomendadas para la fase de aprendizaje.
Evita hacer cambios significativos en la campaña.
Minimiza la superposición en la subasta.
Selecciona las ubicaciones automáticas y la optimización del presupuesto de la campaña.
Elige la estrategia de puja adecuada en función de tus objetivos de negocio.

Configurar eventos redundantes

Recomendamos usar la API de conversiones, además del píxel de Meta, y compartir los mismos eventos con ambas herramientas. Este proceso se conoce como configuración de eventos redundantes. Por ejemplo, si compartes los eventos Purchase, Initiate Checkout y Contact con el píxel de Meta, también deberías compartirlos desde el servidor mediante la API de conversiones.

La API de conversiones permite compartir eventos del sitio web que el píxel puede pasar por alto debido a problemas de conectividad de la red o errores de carga de las páginas. La API de conversiones también se puede usar para compartir otros tipos de eventos y datos importantes que se generan fuera de internet o en un momento posterior y que no se pueden compartir con el píxel.

Asegurarse de que los eventos redundantes duplicados se pueden eliminar

Al enviar eventos redundantes mediante el píxel de Meta y la API de conversiones, debes asegurarte de que ambos eventos utilizan un valor de event_name idéntico y que se incluye el parámetro event_id o una combinación de external_id y fbp. Recomendamos incluir todos estos parámetros para ayudar a Meta a eliminar correctamente los eventos duplicados y reducir los informes dobles de eventos idénticos. Obtén más información sobre la eliminación de duplicados, cuándo es necesaria y cómo configurarla.

Enviar parámetros obligatorios y recomendados

Los siguientes parámetros de eventos del servidor e información del cliente son obligatorios:

Parámetro	Tipo	Cuándo es obligatorio
`action_source`	Evento del servidor	Todos los eventos
`event_source_url`	Evento del servidor	Todos los eventos del sitio web
`client_user_agent`	Información del cliente	Todos los eventos del sitio web

Al utilizar la API de conversiones, aceptas que el parámetro action_source es adecuado hasta donde tú sabes. También recomendamos incluir los parámetros de evento external_id y event_id para todos los eventos.

Si se envían parámetros adicionales de información del cliente, es posible que mejore la calidad de las coincidencias de eventos. Para la atribución de anuncios y la optimización de su entrega, solo se pueden usar eventos coincidentes. Ten en cuenta que cuanto mayor sea la calidad de las coincidencias, mejor. Aunque los eventos sin coincidencias no se pueden usar para la atribución de anuncios y la optimización de su entrega, se pueden usar para mediciones básicas. Entre los ejemplos de parámetros de información del cliente de alta calidad, se incluyen los siguientes:

Dirección de correo electrónico (em)
Dirección IP (client_ip_address)
Nombre (fn y ln)
Número de teléfono (ph)

Requisitos básicos para establecer coincidencias

Tras el lanzamiento de la versión 13.0 de la API Graph, actualizaremos los requisitos básicos de las combinaciones de parámetros de información del cliente que se consideran válidas con un evento de la API de conversiones. Estos cambios nos ayudarán a proporcionar mejores comentarios para situaciones en que la combinación de parámetros de información del cliente de un evento es tan amplia que, probablemente, no sea eficaz para establecer coincidencias.

Se considera que un evento no es válido si solo incluye parámetros de información del cliente que se corresponden con una de las siguientes combinaciones (o un subconjunto de estas).

ct + country + st + zp + ge + client_user_agent
db + client_user_agent
fn + ge
ln + ge

Por ejemplo, si un evento solo tiene los parámetros de información del cliente ge, ct, st y country (se podría corresponder con un hombre en Menlo Park, California, EE. UU.), se rechazará porque dichos parámetros son un subconjunto de una de las combinaciones señaladas anteriormente.

Asegurarse de que los parámetros `fbp` y `fbc` están actualizados

Los parámetros fbp y fbc son valores de cookies que normalmente se establecen en los navegadores de los visitantes de tu sitio en conexión con la solución de cookies propias de Meta. Dichos parámetros están sujetos a cambios. Si los envías como parámetros de usuario, debes actualizar los valores periódicamente.

Estos valores se establecerán como cookies propias cuando el píxel de Meta esté implementado en tu sitio web y se podrán recuperar para usarlos en las solicitudes de la API de conversiones.

Compartir los eventos en el momento en que se producen puede contribuir a que las campañas logren los mejores resultados. Puedes compartir eventos del servidor mediante la API de conversiones en tiempo real o por lotes casi en tiempo real.

Usar “Probar eventos”

Recomendamos usar la herramienta “Probar eventos” para validar la conexión de la API de conversiones. Normalmente, los desarrolladores deben usar sus propios parámetros de información del cliente (por ejemplo, nombre, dirección de correo electrónico, número de teléfono) para los eventos de prueba, ya que es posible que dichos eventos se descarten si no coinciden con ninguna cuenta de Facebook o Meta.

Puedes usar la herramienta “Probar eventos” para lo siguiente:

Verificar que has configurado correctamente los eventos del servidor y que los hemos recibido.
Verificar que has eliminado correctamente los eventos duplicados mediante la visualización de los eventos procesados y los eventos duplicados eliminados.
Depurar cualquier actividad inusual.

Obtén información sobre cómo probar los eventos del servidor con la herramienta “Probar eventos”.

Usar el asistente de carga útil

Rellena los campos de parámetros de datos obligatorios y recomendados en el asistente de carga útil para ver cómo se debe estructurar la carga útil y obtener recomendaciones sobre los parámetros que se deben incluir.

Usar nuestro Business SDK

Los ejemplos de código de nuestra documentación incluyen ejemplos del Business SDK en Python, Java, Ruby, PHP y Node. Pueden reducir el esfuerzo de desarrollo, como la aplicación de algoritmos hash a los parámetros de usuario, que se realiza automáticamente en el Business SDK.

Si no tienes previsto usar el Business SDK, te recomendamos implementar la aplicación de algoritmos hash.

Usar la API de conversiones para los eventos offline

La API de conversiones admite todos los eventos offline y se debe utilizar como contenedor general de estos tipos de eventos. Algunos ejemplos son las ventas en el negocio físico, las llamadas telefónicas, las acciones realizadas en los dispositivos (como televisores inteligentes o videoconsolas) y las suscripciones fuera de internet.

Cuando envíes eventos offline, asegúrate de incluir el parámetro de evento action_source y elegir el valor adecuado (no debe ser website). El origen de acción es necesario para determinar los objetivos de la campaña a los que se destina el evento.

Al utilizar la API de conversiones, aceptas que el parámetro action_source es adecuado hasta donde tú sabes.

Prácticas recomendadas adicionales para socios

Agencias: enviar la cadena `partner_agent`

Los socios o agencias que compartan eventos en nombre de sus anunciantes deben enviar una cadena partner_agent única que incluya el nombre de la plataforma tal y como está documentado. Si procede, puedes colaborar con tu representante especializado de Meta para elegir una cadena de agente adecuada.

Plataformas de sitio web: incorporación de anunciantes

De manera predeterminada, los socios de las plataformas de sitio web pueden considerar la posibilidad de ofrecer la API de conversiones de forma selectiva o dar la opción a los anunciantes. El píxel de Meta y la API de conversiones comparten las mismas condiciones empresariales. También recomendamos dar a los clientes la opción de compartir sus datos mediante la API de conversiones al configurar el píxel de Meta. Aunque consideramos que el uso de ambas herramientas fortalecerá y protegerá el uso compartido de datos a largo plazo, también sugerimos proporcionar información sobre la API de conversiones y el píxel de Meta a los clientes para ayudarles a tomar una decisión informada.

Proceso posterior a la implementación

Comprobar la calidad de las coincidencias de eventos

Si compartes eventos del servidor mediante la API de conversiones, puedes consultar la calidad de las coincidencias de eventos para cada evento en el Administrador de eventos. La puntuación de calidad de las coincidencias de un evento (sobre 10) indica el nivel de eficacia de la información del cliente del evento del servidor a la hora de establecer coincidencias con una cuenta de Facebook o Meta. Puedes obtener más información acerca de las prácticas recomendadas sobre la calidad de las coincidencias de eventos aquí.

Actualmente, la calidad de las coincidencias de eventos solo está disponible para los eventos web. En el caso de otros tipos de eventos (como las ventas en el negocio físico y fuera de internet, los eventos de la aplicación, los clientes potenciales de conversión o las integraciones en las fases alfa o beta), ponte en contacto con el representante de Meta para que te oriente sobre cómo mejorar la calidad de las coincidencias de eventos.

Realizar un test

Al usar la API de conversiones, recomendamos probar y optimizar la estrategia publicitaria de Meta. Entre las opciones de test, se incluyen las siguientes:

Estudio de lift en conversiones: ofrece información sobre el impacto del uso de eventos del servidor en el rendimiento incremental.
Tests A/B: ofrece información sobre la estrategia de campaña que logra los resultados más eficientes y adecuados para optimizar el rendimiento.