Implementación integral de la API de conversiones

La API de conversiones refuerza los esfuerzos de los anunciantes por proporcionar a los consumidores un control y una transparencia adecuados de los datos, a la vez que les ayuda a seguir ofreciéndoles experiencias personales. Con esta API, puedes compartir datos directamente desde tu servidor, en vez de tener que hacerlo mediante un navegador.

Ventajas de la integración

• Mayor visibilidad del embudo: con la API de conversiones, puedes compartir una mayor variedad de datos que con el píxel de Meta. Gracias a ella, puedes tomar decisiones fundamentadas en una mayor cantidad de información, como datos de CRM, eventos de la parte inferior del embudo (clientes potenciales cualificados incluidos) y rutas de conversión de varios sitios tanto en un sitio web como en una ubicación física.

• Control de los datos: si la usas mediante una implementación de solo servidor (por ejemplo, sin el píxel de Meta), la API de conversiones te ofrece más control sobre los datos que compartes. Puedes decidir añadir insights a tus eventos, entre los que se pueden encontrar datos como márgenes de productos o información histórica (por ejemplo, las puntuaciones de valor de los clientes).

• Resiliencia y fiabilidad de las señales: compartir datos mediante la API de conversiones puede ser más fiable que hacerlo solo mediante métodos basados en el navegador (como el píxel de Meta). La API está diseñada para ser menos susceptible a incidencias como bloqueos del navegador o problemas de conectividad. Las nuevas restricciones de transmisión de datos del sector pueden limitar la eficacia de las cookies y el seguimiento del píxel, por lo que la API de conversiones te ayuda a tener el control al compartir las señales que el píxel puede que ya no sea capaz de captar.

Información general

Se puede considerar que la integración de la API de conversiones se divide en dos etapas principales:

• Preparación: selecciona el tipo de integración que encaje en tu caso, define los eventos que quieras enviar y revisa las opciones de optimización disponibles.

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

A continuación, se incluye un resumen del proceso de integración completo:

Usuarios existentes del píxel

Si ya tienes una integración existente del píxel de Meta, conviene crear la integración de la API de conversiones como una extensión de dicha integración del píxel, y no como una conexión completamente distinta.

Consentimiento general

Si dispones de lógica para controlar el consentimiento relativo al uso compartido de datos del píxel, usa esa misma lógica para compartir datos mediante la API de conversiones.

Alternativas

• Si quieres optimizar los anuncios para eventos de la aplicación, utiliza la API de eventos de la aplicación.

Preparación

Elegir el tipo de integración

Para empezar, selecciona la opción de integración que te gustaría implementar:

Definir los eventos que se van a enviar

Tras elegir el enfoque de integración, puedes definir los eventos que quieres enviar. Las señales son más útiles si coinciden con identificadores de usuario de Meta, de modo que es importante detenerse a pensar qué parámetros vas a enviarnos con un evento y con qué frecuencia pretendes enviarlos.

Opciones de eventos

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

Parámetros de eventos

Dentro de cada evento se pueden enviar varios parámetros. Consulta los parámetros que se usan en la API de conversiones para obtener más información sobre esos campos.

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

Actualidad de los datos

Te recomendamos que envíes los eventos en tiempo real o por lotes según unos plazos concretos mediante la API de conversiones. Si envías los eventos en tiempo real o en el transcurso de una hora, garantizas que se puedan usar para la atribución y optimizar para la entrega de anuncios.

Si los envías cuando hayan transcurrido más de dos horas desde que sucedieron, el rendimiento de los anuncios optimizados para esos eventos puede reducirse considerablemente. Los eventos enviados con una demora de 24 horas o más pueden experimentar problemas significativos relacionados con la atribución y la entrega de anuncios optimizados.

Si envías eventos que tienen intervalos de conversión prolongados, hazlo con la máxima inmediatez posible respecto al momento en el que la conversión completa haya finalizado.

Avanza al siguiente paso cuando dispongas de lo siguiente:

• Una lista de eventos que enviar.
• Los campos concretos que quieres enviar con cada evento.
• Una frecuencia establecida de envío de los eventos.

Tipos de optimización disponibles

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

Ejecución

Hay dos formas de implementar la integración:

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

Integración directa

Paso 1: Configurar los requisitos

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

Avanza al paso Implementar la API cuando tengas los activos listos. No olvides guardar los identificadores de los activos, ya que los usarás en las llamadas a la API.

Paso 2: Implementar la API

Cuando termines con los requisitos, inicia el proceso de implementación. Cuando implementes la API de conversiones, consulta en todo momento la documentación para desarrolladores.

Llamadas de prueba (opcionales)

Si es la primera vez que usas la API, empieza con una llamada de prueba. Para ello, necesitas una carga útil y un método para hacer llamadas a la API. Una vez finalizada la llamada, consulta el Administrador de eventos para verificar si la llamada ha funcionado según lo previsto.

{
  "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>
}

Tras completar la primera llamada, verifica los eventos en el Administrador de eventos > tu píxel > Información general.

Avanza al paso Enviar y verificar eventos cuando hayas comprobado los eventos de prueba en el Administrador de eventos.

Enviar y verificar eventos

Para empezar a enviar eventos, realiza una solicitud POST al perímetro /events de la API. Adjunta una carga útil a la llamada (consulta la información sobre el asistente de carga útil si necesitas ayuda para generar una carga útil). Consulta los siguientes recursos para obtener más información y ver ejemplos de código:

• Uso de la API > Envío de solicitudes
• Eventos omitidos
• Hora de subida frente a hora de transacción del evento
• Solicitudes por lotes
• Algoritmos hash

Cuando empieces a enviar eventos, accede al Administrador de eventos y confirma que hemos recibido los eventos que nos has enviado. Obtén más información sobre cómo verificar los eventos.

Si la implementación complementa a un píxel del navegador, avanza al paso para configurar la eliminación de duplicados. Si no es así, ya has acabado. Consulta la sección Asistencia si sigues teniendo preguntas.

Paso 3: Añadir parámetros para eliminar duplicados

Si envías eventos idénticos desde el píxel y mediante la API de conversiones, debes configurar la eliminación de duplicados de los eventos enviados por ambos canales. En primer lugar, lee la documentación para desarrolladores a fin de entender la lógica de la eliminación de duplicados.

Eliminación de duplicados basada en eventos

Si vemos que la misma combinación de claves del servidor (event_id, event_name) y la misma combinación de claves del navegador (eventID, event) se han enviado al mismo identificador de píxel en un plazo de 48 horas, descartamos el evento duplicado que se haya enviado en último lugar.

Haz lo siguiente para garantizar que se eliminen los eventos duplicados:

• Asegúrate de que los eventos en cuestión tengan los siguientes parámetros establecidos con el mismo valor:

  • El valor de event_id del evento del servidor y el valor de eventID del evento del navegador.
  • El valor de event_name de los eventos del servidor y del navegador.
• Tras enviar eventos duplicados, consulta el Administrador de eventos para ver si se están omitiendo los eventos correctos.
• Asegúrate de que cada evento único enviado mediante el píxel y la API de conversiones tenga su propio valor de event_id. Este identificador no debe compartirse con otros eventos.

Alternativa a la eliminación de duplicados basada en eventos

Si bien es cierto que el identificador de evento es la mejor forma de eliminar eventos duplicados, se trata de una implementación bastante compleja. Así pues, puedes usar los parámetros fbp o external_id para recurrir a soluciones alternativas. Si has configurado los parámetros fbp o external_id para pasarlos mediante el navegador y el servidor, eliminaremos los eventos duplicados automáticamente si vemos el mismo evento con los mismos parámetros fbp o external_id en un plazo de 48 horas.

Paso 4 (opcional): Explorar las funciones del SDK de Meta Business

El Meta Business SDK cuenta con funciones avanzadas diseñadas expresamente para los usuarios de la API de conversiones:

• Solicitudes asíncronas: usa esta función si no quieres que tu programa deje de ejecutarse mientras una solicitud se completa. Con este método, realizas una solicitud y obtienes una señal del servidor cuando dicha solicitud se complete. Mientras esperas la respuesta, el programa puede seguir ejecutándose.
• Lotes simultáneos: usa las solicitudes asíncronas para aumentar el rendimiento haciendo un uso más eficaz de los recursos. Crea solicitudes por lotes con cabida para casos de uso como trabajos de solicitudes de eventos o trabajos cron, entre otros.
• Interfaz de servicio HTTP: anula el servicio HTTP predeterminado del SDK para empresas e implementa tu propio servicio personalizado con la biblioteca o método de tu elección.

Integración como plataforma

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

Paso 1: Configurar los requisitos

La aplicación debe obtener los siguientes permisos y funciones:

• 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

En primer lugar, sigue los pasos de integración directa y prueba la integración. Tras ello, puedes pedir autorización para enviar eventos en nombre de tus clientes. Dispones de las siguientes opciones de autenticación:

Método de la extensión de Meta Business (recomendado)

La extensión de Meta Business devuelve toda la información que necesitas para enviar eventos en nombre de un cliente por medio del proceso que se detalla a continuación. La extensión de Meta para empresas proporciona un extremo para recuperar los identificadores de acceso de usuario del sistema creados en la cuenta de Business Manager del cliente. Este proceso incluye permisos para enviar eventos del servidor y se realiza de forma automática y segura.

El extremo necesita un identificador de acceso de usuario como parámetro de entrada. Respecto a los nuevos usuarios de la extensión de Meta para empresas, llama a este extremo para obtener el identificador de acceso de usuario del sistema cuando termines de configurar dicha extensión. Los usuarios existentes deben solicitar una nueva autenticación para poder llamar al nuevo extremo de la API.

Identificador de acceso de usuario del sistema del cliente

Pide a tu cliente que cree manualmente un identificador de acceso de usuario del sistema con la API de conversiones en la configuración del píxel. Después, envía eventos al píxel del anunciante con dicho identificador.

Un usuario del sistema o un usuario administrador del sistema debe instalar la aplicación con la que se generará el identificador de acceso. Con esta configuración, la aplicación puede realizar llamadas a las API en nombre de dichos usuarios.

El cliente comparte el píxel con la cuenta de Business Manager del socio

Con esta opción, el cliente comparte su píxel con el socio mediante la configuración de Business Manager o la API; tras ello, puedes asignar el usuario del sistema del socio al píxel del cliente y generar un identificador de acceso para enviar eventos de servidor.

Paso 3: Atribuir eventos a tu plataforma

Para atribuir eventos de la API de conversiones a tu plataforma, usa el campo partner_agent. De este modo, puedes establecer tu propio identificador de plataforma cuando envíes eventos en nombre de un cliente. Si eres un socio administrado, acude a tu representante de Meta para acordar un identificador para tu plataforma. Este valor debe tener menos de 23 caracteres e incluir como mínimo dos caracteres alfabéticos. Cuando lo tengas, envíalo con cada evento del servidor.

Asistencia

Para todos los socios

Obtén información sobre la depuración y consulta los artículos del Servicio de ayuda para empresas.

Para los socios administrados

Proporciona la siguiente información a tu representante de Meta para que pueda ayudarte a probar las integraciones y a solucionar los problemas: identificador de Business Manager, identificador de la aplicación e identificadores de los píxeles.

Documentación de la API

• Introducción: prueba la API desde tu cuenta de Business Manager.
• 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 útil
• Opciones de tratamiento de datos de la API de conversiones y la API de conversiones offline
• Si quieres optimizar para eventos de la aplicación, usa la API de eventos de la aplicación.
• Si los eventos son ventas en el negocio, usa la API de conversiones offline: los eventos offline que no sean ventas en el negocio son aptos para la API de conversiones.