Información general sobre la extensión Meta Conversions API
Meta Conversions API le permite conectar los datos de marketing del lado del servidor a las tecnologías Meta para optimizar la segmentación de anuncios, reducir el coste por acción y medir los resultados. Los eventos están vinculados a un ID Meta Pixel y se procesan de manera similar a los eventos del lado del cliente.
Con la extensión Meta Conversions API, puede aprovechar las capacidades de la API en sus reglas de reenvío de eventos para enviar datos a Meta desde el Edge Network de Adobe Experience Platform. Este documento explica cómo instalar la extensión y utilizar sus funcionalidades en una regla de reenvío de eventos rule.
Demostración
El siguiente vídeo pretende facilitar su comprensión de Meta Conversions API.
Requisitos previos
Se recomienda encarecidamente usar Meta Pixel y Conversions API para compartir y enviar los mismos eventos del lado del cliente y del lado del servidor, respectivamente, ya que esto puede ayudar a recuperar eventos que Meta Pixel no captó. Antes de instalar la extensión Conversions API, consulte la guía de la extensión Meta Pixel extension para ver los pasos necesarios para integrarla en las implementaciones de etiquetas del lado del cliente.
Para usar la extensión Conversions API, debe tener acceso al reenvío de eventos y una cuenta de Meta válida con acceso a Ad Manager y Event Manager. Específicamente, debe copiar el ID de un(a) Meta Pixel existente(o crear un(a) Pixel nuevo(a) en su lugar) para que la extensión se pueda configurar en su cuenta.
Instalación de la extensión
Para instalar la extensión Meta Conversions API, vaya a la IU de recopilación de datos o a la IU del Experience Platform y seleccione Reenvío de eventos en el panel de navegación izquierdo. Aquí, seleccione una propiedad a la que añadir la extensión o cree una nueva propiedad.
Una vez que haya seleccionado o creado la propiedad deseada, seleccione Extensiones en el panel de navegación izquierdo y, a continuación, seleccione la pestaña Catálogo. Busque la tarjeta API de metaconversiones y, a continuación, seleccione Instalar.
En la vista de configuración que aparece, debe proporcionar el ID de Pixel que copió anteriormente para vincular la extensión a su cuenta. Puede pegar el ID directamente en la entrada o utilizar un elemento de datos en su lugar.
También debe proporcionar un token de acceso para usar específicamente Conversions API. Consulte la documentación de Conversions API sobre generación de un token de acceso para ver los pasos sobre cómo obtener este valor.
Cuando termine, seleccione Guardar
La extensión está instalada y ahora puede utilizar sus funcionalidades en las reglas de reenvío de eventos.
Integración con la extensión de Facebook y Instagram facebook
La integración con la extensión Facebook y Instagram le permite autenticarse rápidamente en su cuenta de Meta Business. Esto rellena automáticamente su ID de píxel y el token de acceso del token de acceso de la API de metaconversiones, lo que facilita la instalación y configuración de la API de metaconversiones.
Aparecerá un mensaje de diálogo para autenticarse en Facebook y Instagram al instalar la extensión Meta Conversions API.
También aparece un mensaje de diálogo para autenticarse en Facebook y Instagram en la interfaz de usuario del flujo de trabajo de inicio rápido dentro del reenvío de eventos.
Integración con la puntuación de coincidencia de calidad de evento (EMQ) emq
La integración con la puntuación de coincidencia de calidad de evento (EMQ) le permite ver fácilmente la eficacia de su implementación mostrando puntuaciones EMQ. Esta integración minimiza el cambio de contexto y le ayuda a mejorar el éxito de las implementaciones de la API de conversiones de metadatos. Estas puntuaciones de eventos aparecen en la pantalla de configuración Extensión de API de metaconversiones.
Integración con LiveRamp (Alpha) alpha
Los clientes de LiveRamp que tienen la solución de tráfico autenticado (ATS) de LiveRamp implementada en sus sitios pueden optar por compartir RampID como parámetro de información del cliente. Trabaje con el equipo de su cuenta de Meta para unirse al programa de Alpha de esta función.
Configuración de una regla de reenvío de eventos rule
Esta sección explica cómo usar la extensión Conversions API en una regla genérica de reenvío de eventos. En la práctica, debe configurar varias reglas para enviar todos los eventos estándar aceptados a través de Meta Pixel y Conversions API. Para los datos de aplicaciones móviles, consulte los campos obligatorios, los campos de datos de aplicaciones, los parámetros de información de clientes y los detalles de datos personalizados aquí.
Comience a crear una nueva regla de reenvío de eventos y configure sus condiciones como desee. Al seleccionar las acciones de la regla, seleccione Extensión de API de metaconversiones para la extensión y, a continuación, seleccione Enviar evento de API de conversiones para el tipo de acción.
Aparecen controles que le permiten configurar los datos de evento que se enviarán a Meta mediante Conversions API. Estas opciones se pueden introducir directamente en las entradas proporcionadas o puede seleccionar elementos de datos existentes para representar los valores. Las opciones de configuración se dividen en cuatro secciones principales, como se describe a continuación.
Si usa Meta Pixel y Conversions API para enviar eventos, asegúrese de incluir Nombre del evento (
event_name) y Id. del evento (event_id) con cada evento, ya que estos valores se usan para anulación de duplicación de eventos.También tiene la opción de Habilitar el uso limitado de datos para ayudar a cumplir con las exclusiones de los clientes. Consulte la documentación de Conversions API sobre opciones de procesamiento de datos para obtener detalles sobre esta característica.
Para garantizar una buena conexión de API común y una alta calidad de coincidencia de eventos (EMQ), se recomienda que envíe todos los parámetros de información de clientes aceptados junto con los eventos del servidor. Estos parámetros también deben tener una prioridad en función de su importancia e impacto en EMQ.
Si está enviando un evento de compra, debe utilizar esta sección para proporcionar los atributos necesarios
currency y value.Cuando termine, seleccione Conservar cambios para agregar la acción a la configuración de regla.
Cuando esté satisfecho con la regla, seleccione Guardar en biblioteca. Por último, publique un nuevo reenvío de eventos build para habilitar los cambios realizados en la biblioteca.
Deduplicación de eventos deduplication
Como se menciona en la sección de requisitos previos, se recomienda usar tanto la extensión de etiqueta Meta Pixel como la extensión de reenvío de eventos Conversions API para enviar los mismos eventos desde el cliente y el servidor en una configuración redundante. Esto puede ayudar a recuperar eventos que no fueron recogidos por una extensión u otra.
Si envía diferentes tipos de eventos desde el cliente y el servidor sin superposición entre los dos, la anulación de duplicación no es necesaria. Sin embargo, si Meta Pixel y Conversions API comparten un solo evento, debe asegurarse de que se dedupliquen estos eventos redundantes para que la creación de informes no se vea afectada negativamente.
Al enviar eventos compartidos, asegúrese de incluir un ID y un nombre de evento con cada evento que envíe desde el cliente y el servidor. Cuando se reciben varios eventos con el mismo ID y nombre, Meta emplea automáticamente varias estrategias para anular la duplicación y conservar los datos más relevantes. Consulte la documentación de Meta sobre la anulación de duplicación para Meta Pixel y Conversions API eventos para obtener más información sobre este proceso.
Flujo de trabajo de inicio rápido: Extensión de la API de metaconversiones (Beta) quick-start
- La función de inicio rápido está disponible para los clientes que han adquirido el paquete Real-Time CDP Prime y Ultimate. Póngase en contacto con el representante del Adobe para obtener más información.
- Esta función es para nuevas implementaciones de red y, actualmente, no admite la instalación automática de extensiones y configuraciones en propiedades de etiquetas y reenvío de eventos existentes.
- Utilícelo como el inicio de una implementación completamente nueva.
- Aproveche esta implementación como referencia que puede examinar para ver cómo se ha configurado y luego duplicarla en las implementaciones de producción actuales.
La función de inicio rápido le ayuda a configurarse con facilidad y eficacia con la API de conversiones de metadatos y las extensiones de píxeles. Esta herramienta automatiza varios pasos que se realizan en las etiquetas de Adobe y en el reenvío de eventos, lo que reduce significativamente el tiempo de configuración.
Esta función instala y configura automáticamente la API de conversiones de metadatos y las extensiones de píxeles en una propiedad de etiquetas y reenvío de eventos generada automáticamente con las reglas y los elementos de datos necesarios. Además, también instala y configura automáticamente el SDK web de Experience Platform y el conjunto de datos. Por último, la función de inicio rápido publica automáticamente la biblioteca en la dirección URL designada en un entorno de desarrollo, lo que permite la recopilación de datos del lado del cliente y el reenvío de eventos del lado del servidor en tiempo real mediante el reenvío de eventos y el Edge Network del Experience Platform.
El siguiente vídeo proporciona una introducción a la función de inicio rápido.
Instalar función de inicio rápido
Este programa de instalación instala automáticamente la API de metaconversiones y las extensiones de metapíxeles. Meta recomienda esta implementación híbrida para recopilar y reenviar conversiones de eventos del lado del servidor.
La función de configuración rápida está diseñada para ayudar a los clientes a empezar con una implementación de reenvío de eventos y no pretende ofrecer una implementación integral y funcional que se adapte a todos los casos de uso.
Para instalar la característica, selecciona Introducción para Send Conversions Data to Meta en la página de recopilación de datos de Adobe Experience Platform Inicio.
Escribe tu dominio y selecciona Siguiente. Este dominio se utilizará como convención de nombres para las propiedades, reglas, elementos de datos, flujos de datos, etc. de etiquetas y reenvío de eventos generados automáticamente.
En el cuadro de diálogo Configuración inicial, escriba su Id. de metapíxel, Token de acceso a la API de metaconversión y Ruta de la capa de datos; a continuación, seleccione Siguiente.
Espere unos minutos para que se complete el proceso de configuración inicial y, a continuación, seleccione Siguiente.
Desde el cuadro de diálogo Agregar código en su sitio copie el código proporcionado mediante la función Copiar
<head> del sitio web de origen. Una vez implementada, seleccione Iniciar validación
El cuadro de diálogo Resultados de validación muestra los resultados de la implementación de la extensión Meta. Seleccione Siguiente. También puede ver resultados de validación adicionales seleccionando el vínculo Garantía.
La pantalla Pasos siguientes confirma la finalización de la instalación. Desde aquí tiene la opción de optimizar la implementación añadiendo nuevos eventos, que se muestran en la siguiente sección.
Si no desea agregar más eventos, seleccione Cerrar.
Adición de eventos adicionales
Para agregar nuevos eventos, seleccione Editar la propiedad web de etiquetas.
Seleccione la regla que corresponda al metaevento que desee editar. Por ejemplo, MetaConversion_AddToCart.
Para agregar un evento, seleccione Agregar bajo el encabezado Eventos.
Seleccione Tipo de evento. En este ejemplo, se ha seleccionado el evento Click y se ha configurado en déclencheur cuando se selecciona .add-to-cart-button. Seleccione Conservar cambios.
Se ha guardado el nuevo evento. Seleccione Seleccionar una biblioteca en funcionamiento y seleccione la biblioteca en la que desea compilar.
A continuación, seleccione el menú desplegable junto a Guardar en biblioteca y seleccione Guardar en biblioteca y crear. Esto publicará el cambio en la biblioteca.
Repita estos pasos para cualquier otro evento de metaconversión que desee configurar.
Configuración de capa de datos configuration
MetaConversion_* rules. Si no actualiza los datos entre reglas, también podría encontrarse con un caso en el que esté enviando datos antiguos de los últimos MetaConversion_* rule en el MetaConversion_* rule actual.Durante la configuración, se le preguntó dónde reside su capa de datos. De manera predeterminada, sería window.dataLayer.meta y, dentro del objeto meta, se esperarían los datos como se muestra a continuación.
Esto es importante de entender, ya que cada regla de MetaConversion_* utiliza esta estructura de datos para pasar los datos relevantes a la extensión Meta Pixel y a Meta Conversions API. Consulte la documentación de eventos estándar para obtener más información sobre los datos que requieren los distintos metaeventos.
Por ejemplo, si desea utilizar la regla MetaConversion_Subscribe, debe actualizar window.dataLayer.meta.currency, window.dataLayer.meta.predicted_ltv y window.dataLayer.meta.value según las propiedades de objeto descritas en la documentación sobre eventos estándar.
A continuación se muestra un ejemplo de lo que sería necesario ejecutar en un sitio web para actualizar la capa de datos antes de ejecutar la regla.
De manera predeterminada, <datalayerpath>.conversionData.eventId se generará aleatoriamente mediante la acción "Generar nuevo identificador de evento" en cualquiera de las MetaConversion_* rules.
Para obtener una referencia local del aspecto que debería tener la capa de datos, puede abrir el editor de código personalizado en el elemento de datos MetaConversion_DataLayer de su propiedad.
Pasos siguientes
En esta guía se explica cómo enviar datos de evento del lado del servidor a Meta mediante la extensión Meta Conversions API. A partir de aquí, se recomienda ampliar la integración conectando más Pixels y compartiendo más eventos cuando corresponda. Realizar cualquiera de las siguientes acciones puede ayudar a mejorar aún más el rendimiento de su anuncio:
- Conecte cualquier otro(a) Pixels que aún no esté conectado a una integración de Conversions API.
- Si está enviando ciertos eventos exclusivamente a través de Meta Pixel en el lado del cliente, envíe también estos mismos eventos al Conversions API desde el lado del servidor.
Consulte la documentación de Meta sobre las prácticas recomendadas para Conversions API para obtener más información sobre cómo implementar de forma eficaz su integración. Para obtener información más general sobre las etiquetas y el reenvío de eventos en Adobe Experience Cloud, consulte información general sobre etiquetas.