Implementación de extremo a extremo de la API de conversiones

La API de conversiones respalda las iniciativas de los anunciantes de proporcionar a los consumidores un nivel adecuado de transparencia y control de datos, mientras se les continúa brindando experiencias personales. Con la API, puedes compartir datos directamente desde tu servidor, en lugar de hacerlo a través de un navegador.

Ventajas de la integración

• Visibilidad del embudo más amplia: la API de conversiones te permite compartir una mayor colección de datos que el píxel de Facebook. Con la API, puedes tomar decisiones teniendo en cuenta más información, como los datos del CRM, los eventos de la parte baja del embudo (incluidos los clientes potenciales calificados) y las rutas de conversión de varios sitios que incluyan un sitio web y un establecimiento físico.

• Control de datos: si se implementa solo del lado del servidor (por ejemplo, sin el píxel de Meta), la API de conversiones te da más control sobre los datos que compartes. Puedes optar por agregar estadísticas a los eventos y proporcionar datos como márgenes de productos o información histórica, por ejemplo, puntuaciones del valor de los clientes.

• Confiabilidad de la señal y capacidad de adaptación: el uso de los datos compartidos mediante la API de conversiones puede ser más confiable que usar solo métodos basados en navegadores, como el píxel de Meta. La API está diseñada para ser menos susceptible a cuestiones como el bloqueo de un navegador o problemas de conectividad. Las nuevas restricciones del sector respecto de la transmisión de datos podrían limitar la eficacia del seguimiento mediante las cookies y el píxel, de modo que la API de conversiones te ayuda a tener control sobre la captación de señales que el píxel podría dejar de capturar.

Información general

A fines prácticos, digamos que la integración de la API de conversiones se divide en dos etapas principales:

• Preparación: selecciona el tipo de integración más adecuado para ti, define los eventos que se enviarán y revisa las opciones de optimización disponibles.

• Ejecución: obtén información sobre cómo implementar la API. En esta etapa, también puedes usar una integración con socios.

En la siguiente tabla, se resume todo el proceso de integración:

Usuarios de píxeles preexistentes

Si ya usas una integración del píxel de Meta, debes agregar la integración de la API de conversiones como una extensión de la integración del píxel, no como una conexión completamente distinta.

Consentimiento general

Si tienes lógica para controlar el consentimiento con respecto al envío de los datos del píxel, usa esa misma lógica para el envío de datos a través de la API de conversiones.

Alternativas

• Si quieres optimizar tus anuncios para los eventos de una app, usa la API de eventos de la app.

Preparación

Selecciona el tipo de integración

Para empezar, selecciona la opción de integración que quieras implementar:

Define los eventos que quieres enviar

Una vez que hayas elegido un enfoque de integración, puedes definir los eventos que quieres enviar. Las señales se aprovechan al máximo si están asociadas a identificadores de usuario de Meta, de modo que es importante pensar con detenimiento cuáles son los parámetros que nos enviarás con un evento y con qué frecuencia se harán esos envíos.

Opciones de eventos

Envía los eventos que sean más relevantes para tu negocio. Consulta la lista completa de eventos estándar y personalizados de Meta que se admiten.

Parámetros de eventos

Puedes enviar varios parámetros en cada evento. Consulta cuáles son los parámetros que usa la API de conversiones si quieres obtener más información sobre esos campos.

Puedes agregar varios tipos de identificadores a los eventos, como event_id, external_id y order_id. Es importante conocer la diferencia entre estos parámetros:

Antigüedad de los datos

Te recomendamos enviar los eventos en tiempo real o por lotes siguiendo una línea de tiempo específica a través de la API de conversiones. Enviar los eventos en tiempo real o en un plazo de una hora desde que se registraron ayuda a garantizar que se puedan usar para la atribución y la entrega de anuncios optimizada.

Si envías los eventos más de dos horas después de que hayan ocurrido, se puede producir una disminución importante del rendimiento de los anuncios optimizados de esos eventos. Los eventos enviados con un retraso de 24 horas o más podrían sufrir problemas importantes de atribución y entrega de anuncios optimizada.

Si envías eventos con períodos de conversión prolongados, hazlo lo más cercano al envío en tiempo real que te sea posible, a partir del momento en el que se completa la conversión.

Avanza al siguiente paso cuando:

• Tengas una lista de eventos para enviar.
• Tengas los campos específicos que quieres enviar con cada evento.
• Hayas definido con qué frecuencia enviarás eventos.

Tipos de optimización disponibles

La API de conversiones ofrece los siguientes tipos de optimización:

Ejecución

Existen dos formas de implementar la integración:

• Integración directa: tú, en calidad de anunciante, implementas la API de conversiones.
• Integración como plataforma: tú, en calidad de socio de marketing, ofreces a tus clientes el servicio de integración de la API de conversiones.

Integración directa

Paso 1: Configurar los requisitos

Antes de usar la API de conversiones, configura los siguientes recursos:

Cuando tengas los recursos listos, procede a implementar la API. Recuerda guardar los identificadores de los recursos, ya que se usan en las llamadas a la API.

Paso 2: Implementar la API

Cuando termines de preparar los requisitos, inicia el proceso de implementación. Cuando compiles la API de conversiones, consulta siempre la documentación para desarrolladores.

Llamadas de prueba (opcional)

Si es la primera vez que usas la API, empieza con una llamada de prueba. Para hacerla, necesitas una carga y un método para hacer llamadas a la API. Una vez completada la llamada, consulta el administrador de eventos para verificar que la llamada haya funcionado según lo esperado.

{
  "data": [
   {
    "event_name": "Purchase",
    "event_time": 1601673450,
    "user_data": {
      "em": "7b17fb0bd173f625b58636fb796407c22b3d16fc78302d79f0fd30c2fc2fc068",
      "ph": null
     },
    "custom_data": {
      "currency": "USD",
      "value": "142.52"
    }
   }
  ]
}

{
  "events_received": 1,
  "messages": [],
  "fbtrace_id": <FB-TRACE-ID>
}

Después de completar la primera llamada, verifica los eventos en Administrador de eventos > Tu píxel > Información general.

Cuando hayas comprobado los eventos de prueba en el administrador de eventos, avanza a Enviar y verificar eventos.

Enviar y verificar eventos

Para empezar a enviar eventos, envía una solicitud POST al perímetro /events de la API. Adjunta una carga a la llamada. Si necesitas ayuda para generar la carga, consulta el asistente de carga. Consulta los siguientes recursos para obtener más información y muestras de código:

• Usar la API > Enviar solicitudes
• Eventos descartados
• Comparación del tiempo de subida con el tiempo de transacción del evento
• Solicitudes por lotes
• Cifrado

Una vez que empieces a enviar eventos, ve al administrador de eventos y confirma que hayamos recibido los eventos que enviaste. Obtén información sobre cómo verificar tus eventos.

Si usas tu implementación en combinación con un píxel de navegador, avanza a la configuración de deduplicación. Si no, ya terminaste. Consulta Soporte técnico si tienes más preguntas.

Paso 3: Agregar parámetros para la deduplicación

Si usas el píxel y la API de conversiones para enviar eventos idénticos, debes configurar la deduplicación para los eventos que se envían por ambos canales. Primero, lee la documentación para desarrolladores a fin de comprender la lógica de la deduplicación.

Deduplicación basada en eventos

Si detectamos que se envió la misma combinación de clave de servidor (event_id y event_name) y la misma combinación de clave de navegador (eventID y event) al mismo identificador de píxel en un plazo de 48 horas, descartaremos los eventos duplicados que se envíen más tarde.

Para ayudar a garantizar que tus eventos se dedupliquen:

• En los eventos correspondientes, asegúrate de que los siguientes parámetros estén configurados con el mismo valor:

  • event_id del evento del servidor y eventID del evento del navegador
  • event_name del evento del servidor y de los eventos del navegador
• Después de enviar eventos duplicados, consulta en el administrador de eventos si se descartan los eventos correctos.
• Asegúrate de que cada evento único enviado a través del píxel y de la API de conversiones tenga su propio event_id. Este identificador no debe usarse en ningún otro evento.

Alternativa de la deduplicación basada en eventos

Si bien el identificador del evento siempre será la mejor manera de deduplicar eventos, es una implementación bastante compleja. Puedes aprovechar soluciones alternativas si usas los parámetros "external_id" o "fbp". Si configuraste uno de estos parámetros para que se pase a través del navegador y el servidor, deduplicaremos los eventos automáticamente si registramos el mismo evento con el mismo parámetro ("external_id" o "fbp") en un plazo de 48 horas.

Paso 4 (opcional): Explorar las funciones del SDK para empresas

El SDK de Meta para empresas tiene funciones avanzadas, diseñadas especialmente para usuarios de la API de conversiones:

• Solicitudes asincrónicas: usa esta función si no quieres bloquear la ejecución del programa para esperar a que se complete una solicitud. Con este enfoque, realizas la solicitud y recibes una señal del servidor cuando se completa. Mientras esperas la respuesta, el programa puede seguir ejecutándose.
• Envío por lotes concurrentes: aprovecha las solicitudes asincrónicas para aumentar el rendimiento, ya que te permiten utilizar los recursos de manera más eficiente. Crea solicitudes por lote para que admitan casos de uso, como trabajadores de solicitudes de eventos, tareas de cron y más.
• Interfaz de servicio HTTP: sustituye el servicio HTTP predeterminado del SDK para empresas e implementa tu propio servicio personalizado con el método o la biblioteca de tu preferencia.

Integración como plataforma

Las siguientes instrucciones están dirigidas a socios que ofrecen la API de conversiones como un servicio a los anunciantes.

Paso 1: Configurar los requisitos

Tu app debe tener las siguientes funciones y permisos:

• Nivel de acceso: Acceso avanzado
• Función: Acceso estándar a la administración de anuncios
• Permisos: ads_management, pages_read_engagement y ads_read.

Paso 2: Enviar eventos en nombre de los clientes

Primero, sigue los pasos de la integración directa y prueba la integración. Luego, puedes solicitar autorización para enviar eventos en nombre de tus clientes. Tienes las siguientes opciones de autenticación:

Enfoque de la extensión Meta Business (recomendado)

Esta extensión devuelve toda la información necesaria para enviar eventos en nombre del cliente mediante el siguiente proceso. La extensión Meta Business proporciona un punto de conexión para recuperar tokens de acceso del usuario del sistema creados en el administrador comercial del cliente. Este proceso incluye permisos para enviar eventos del servidor y se lleva a cabo de manera automática y segura.

El punto de conexión requiere un token de acceso de usuario como parámetro de entrada. En el caso de usuarios nuevos de la extensión Meta Business, llama a este punto de conexión para recuperar el token de acceso del usuario del sistema cuando termines de configurar la extensión. Los usuarios preexistentes deben solicitar una nueva autenticación antes de llamar al nuevo punto de conexión de la API.

Token de acceso de usuario del sistema del cliente

Pide a tu cliente que cree manualmente un token de acceso de usuario del sistema mediante la API de conversiones, en la sección de configuración del píxel. Luego, envía eventos al píxel del anunciante con ese token.

Un usuario o un administrador del sistema debe instalar la app que se usará para generar el token de acceso. Con esta configuración, la app puede hacer llamadas a la API en nombre de ese usuario o administrador del sistema.

El cliente comparte el píxel en el administrador comercial del socio

Con esta opción, el cliente comparte su píxel con el socio mediante la configuración del administrador comercial o a través de la API. Una vez compartido, puedes asignar el usuario del sistema del socio al píxel del cliente y generar un token de acceso para enviar eventos de servidor.

Paso 3: Atribuir eventos a tu plataforma

Para atribuir los eventos de la API de conversiones a tu plataforma, usa el campo partner_agent (agente del socio). De esta manera, puedes definir el identificador de tu plataforma cuando envías eventos en nombre de un cliente. Si eres un socio administrado, trabaja con tu representante de Meta para definir de mutuo acuerdo un identificador para tu plataforma. Este valor debe tener menos de 23 caracteres, de los cuales al menos dos deben ser alfabéticos. Luego, envíalo con cada evento de servidor.

Asistencia

Para todos los socios

Consulta información sobre depuración y artículos del servicio de ayuda para empresas.

Para socios administrados

Proporciona la siguiente información a tu representante de Meta para que pueda ayudarte a probar las integraciones y solucionar problemas: identificador del administrador comercial, identificador de la app e identificadores del píxel.

Documentación sobre la API

• Primeros pasos: prueba la API desde tu administrador comercial
• Uso de la API
• Prácticas recomendadas: API de conversiones
• Configuración de la API de conversiones como plataforma
• Eventos estándar de Meta
• Eventos personalizados de Meta
• Parámetros
• Asistente de carga
• Opciones de procesamiento de datos para la API de conversiones y la API de conversiones offline.
• Si quieres optimizar en función de los eventos de una app, usa la API de eventos de la app.
• Si los eventos son ventas en el negocio, usa la API de conversiones offline. En cuanto a los eventos offline que no sean ventas en el negocio, se puede usar la API de conversiones.