API de conversiones

Configurar la API de conversiones como plataforma

Si ofreces la configuración del píxel de Meta como parte de los servicios de administración de etiquetas, es posible que quieras considerar la posibilidad de añadir funcionalidades de la API de conversiones. La integración con la API de conversiones permite a los clientes enviar eventos web a Facebook directamente, sin tener que depender de los eventos de píxel del navegador.

Comparación de los eventos del servidor y los eventos del navegador

Antes de comenzar, es importante entender la relación entre los eventos del servidor y el píxel de Meta. Los eventos del servidor se envían mediante la API de conversiones y se usan para medir, informar y optimizar de la misma manera que los eventos de píxel del navegador.

Si el envío de eventos de píxel del navegador es como el envío de correo aéreo, el envío de eventos del servidor es como el envío de correo por flete. Los dos son mecanismos para transportar el paquete (datos sobre un evento) a una dirección de destino (el identificador de un píxel). Por lo tanto, recomendamos encarecidamente que crees la integración de la API de conversiones en la plataforma como una extensión de la oferta actual del píxel de Meta (en lugar de como un plugin o servicio independiente) por los siguientes motivos:

  • Los eventos del servidor usan el identificador del píxel como destino.
  • Los eventos del servidor se procesan de la misma manera que los eventos de píxel del navegador se envían una vez a Facebook.
  • La eliminación de duplicados será más fácil de implementar.
  • Facilidad de uso para los clientes. Por ejemplo, los eventos del servidor se pueden enviar junto con los eventos del navegador de forma predeterminada.

Cuando la plataforma esté integrada con la API de conversiones, recomendamos enviar los mismos eventos web mediante el navegador y el servidor. Esta redundancia ayuda a garantizar la fiabilidad de las señales. Los eventos que se pudieron haber perdido previamente en el navegador, debido una variedad de motivos relacionados con la red, ahora se capturan mediante la API de conversiones.

Para enviar eventos mediante el navegador y el servidor, debes establecer correctamente el mismo valor de event_id para los eventos correspondientes. Esto permite a Facebook eliminar los eventos duplicados correctamente.

Requisitos previos

  1. Una plataforma web capaz de compartir eventos en Facebook. Por ejemplo, un creador de sitios web, un administrador de etiquetas o una plataforma de tecnología publicitaria.
  2. Un aviso enviado correctamente a los usuarios, así como su consentimiento, para compartir datos de eventos con Facebook, según lo exijan las Condiciones de las herramientas empresariales de Facebook.
  3. Un representante de Facebook.
  4. Los requisitos previos de la integración de la API de conversiones estándar:

Para empezar a ofrecer la API de conversiones como plataforma, la aplicación tiene que someterse a la revisión de la aplicación. Durante este proceso, debes solicitar el nivel de acceso, la función y los permisos siguientes:

Introducción

Si es la primera vez que usas la API de conversiones, sigue estos pasos para crear una empresa, una aplicación de Meta, un píxel de Meta y un usuario del sistema. A continuación, podrás usar el identificador de acceso de usuario del sistema para enviar eventos del servidor mediante la API de conversiones.

Paso 1: crea una empresa.

Paso 2: crea una aplicación de Meta en la empresa recién creada.

Paso 3: crea un píxel de Meta en la empresa recién creada:

Paso 4: genera un identificador de acceso de usuario del sistema.

Paso 5: envía un evento del servidor al píxel de Meta.

Enviar eventos en nombre de los clientes

Cuando hayas enviado correctamente un evento del servidor a tu propio píxel de Meta, tienes varias opciones sobre cómo enviar eventos en nombre de los clientes.

En el caso de los píxeles de Meta que la cuenta de Business Manager del socio posee o administra

  1. En Business Manager, ve a la sección Usuarios y selecciona la pestaña Usuario del sistema. Haz clic en el usuario específico del sistema que uses para la API de conversiones.
  2. Ve al cuadro de diálogo Asignar activo y elige Píxeles. A continuación, selecciona los píxeles para los que quieres enviar eventos en nombre de los clientes.
  3. Para cada píxel, selecciona el permiso Administrar píxel y haz clic en Guardar cambios.
  4. Vuelve a la página de detalles del usuario del sistema. Comprueba que los píxeles seleccionados estén visibles.

En el caso de los píxeles de Facebook que no administra el socio

Primero debes pedir autorización para enviar eventos en nombre de tus clientes. Dispones de las siguientes opciones de autenticación:

Extensión de Facebook para empresas (método recomendado)

Con esta opción, la extensión de Facebook para empresas (FBE) devuelve toda la información que necesitas para enviar eventos en nombre del cliente mediante el proceso que se detalla a continuación. FBE 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 FBE, llama a este extremo para obtener el identificador de acceso de usuario del sistema cuando termines de configurar FBE. 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

Con esta opción, debe hacer que el cliente cree manualmente un identificador de acceso de usuario del sistema mediante la API de conversiones en Configuración del píxel. Después, puedes enviar 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.

Sigue nuestra documentación Introducción y solicita un identificador de usuario del sistema al anunciante. Recuerda usar tu propio píxel de Meta y tu identificador de acceso para las pruebas.

Uso compartido del cliente de un píxel de Meta con la cuenta de Business Manager del socio

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

Atribuir eventos a la plataforma con el campo partner_agent

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. Ponte en contacto con tu representante de Facebook para acordar un identificador para la plataforma. Cuando lo tengas, envíalo con cada evento del servidor.

Ejemplo de carga útil de un evento

Si el identificador de la plataforma es datapartner, este sería un ejemplo de carga útil de un evento de compra que se enviaría en nombre del cliente:

    
{
  "data": [
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "event_name": "PageView",
      "event_time": 1579645238
    },
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "custom_data": {
        "currency": "USD",
        "value": "50"
      },
      "event_name": "Purchase",
      "event_time": 1579645238
    }
  ],
  "partner_agent": "datapartner"
}

Preguntas frecuentes

Sending events sent via the Conversions API is just like sending events via Facebook Pixel. The only difference is that the event is sent via the server, instead of the browser. So, why make an effort to integrate with the Conversions API? Here are some important use cases:

Capture offline and down-funnel events

If someone uses an advertisers’ website to sign up for a credit card, they can send events such as ViewContent, Application Start, and Application Submit via the browser to the Facebook Pixel. However, the end user still needs to be approved for this credit card. The Approval event happens offline and cannot be sent via browser. To register this final step, the advertiser can send the Approval via the Conversions API.

Signal resiliency

Browser side events can be lost for many reasons:

  • The user might navigate away before the page has finished loading.
  • Ad blockers could prevent the event from firing.
  • The changing internet landscape might change the way inter-domain messages are sent.

These examples can all be mitigated by sending events via the Conversions API.

Sensitive data

Many advertisers have expressed concerns about sharing data via the browser when that data could be seen or inspected. This can be mitigated by sending data via the Conversions API.

For example, advertisers may want to send data like profit margin or lifetime value (LTV) along with a purchase event. This way, ads can be optimized towards a specific type of customer.

Enlace permanente

Since browser events are always vulnerable to obstacles, we recommend that you only send events collected from the Conversions API sources. For example, if:

  • One of the ways your customer ingests data into your platform is via a browser JavaScript tag, or
  • You send that data to Facebook via the Conversions API

the data is open to the browser-side risks.

To take full advantage of the Conversions API, no part of the data flow should be reliant on the browser.

Enlace permanente

We recommend that you provide advertisers with a way to test this connection on your own platform.

  1. Send a test event via the Conversions API to the advertiser’s pixel. Look for a 200 return code.
  2. Update the status of the connection appropriately.
Enlace permanente

Facebook tries to deduplicate identical events sent through the Facebook Pixel and the Conversions API. We determine if events are identical based on their event_id and event_name. For more information, see Handling Duplicate Pixel and Conversions API Events.

Enlace permanente

The external_id parameter is a string that represents a user on an advertiser's system. These IDs help improve ads attribution and create audiences.

You can send external_ids via browser or the Conversions API, but you must be consistent across channels. For example, if you send a browser pixel event with external_id set to 123, your server event for that same user should also have external_id set to 123.

Enlace permanente