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 Adobe Experience Platform Edge Network. 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 interfaz de usuario de recopilación de datos o de Experience Platform y seleccione Event Forwarding 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 Extensions en el panel de navegación izquierdo y, a continuación, seleccione la pestaña Catalog. Busque la tarjeta Meta Conversions API y después seleccione Install.
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 Save
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 e Instagram facebook
La integración con la extensión de Facebook e Instagram le permite autenticarse rápidamente en su cuenta empresarial de Meta. A continuación, se rellenan automáticamente Pixel ID y la API de conversiones de Meta Access Token, lo que facilita la instalación y configuración de la API de conversiones de Meta.
Aparece un mensaje de diálogo para autenticarse en Facebook e Instagram al instalar la extensión Meta Conversions API.
También aparece un mensaje de diálogo para autenticarse en Facebook e 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 Meta. Estas puntuaciones de eventos aparecen en la pantalla de configuración de Meta Conversions API extension.
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 para 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 para la regla, seleccione Meta Conversions API Extension para la extensión y, a continuación, seleccione Send Conversions API Event 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 Event Name (
event_name) y Event ID (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 Enable Limited Data Use 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 Keep Changes para agregar la acción a la configuración de regla.
Cuando esté satisfecho con la regla, seleccione Save to Library. 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 conversiones de Meta (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 su representante de 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 Meta y las extensiones de píxeles de Meta. 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 Meta y las extensiones de píxeles de Meta en una propiedad de etiquetas y reenvío de eventos recién generada automáticamente con las reglas y los elementos de datos necesarios. Además, también instala y configura automáticamente Experience Platform Web SDK y Datastream. 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 Experience Platform Edge Network.
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 conversiones de Meta y las extensiones de píxeles de Meta. 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, seleccione Get Started para Send Conversions Data to Meta en la página Recopilación de datos de Adobe Experience Platform Home.
Escriba su Domain y después seleccione Next. 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 Initial Setup, escriba sus Meta Pixel ID, Meta Conversion API Access Token y Data Layer Path y, a continuación, seleccione Next.
Espere unos minutos para que se complete el proceso de configuración inicial y, a continuación, seleccione Next.
En el cuadro de diálogo Add Code on Your Site, copie el código proporcionado mediante la función Copiar
<head> del sitio web de origen. Una vez implementado, seleccione Start Validation
El cuadro de diálogo Validation Results muestra los resultados de la implementación de la extensión Meta. Seleccione Next. También puede ver resultados de validación adicionales seleccionando el vínculo Assurance.
La pantalla Next Steps 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 Close.
Adición de eventos adicionales
Para agregar nuevos eventos, seleccione Edit Your Tags Web Property.
Seleccione la regla que corresponda al metaevento que desee editar. Por ejemplo, MetaConversion_AddToCart.
Para agregar un evento, seleccione Add bajo el encabezado Events.
Seleccione el Event Type. En este ejemplo, se ha seleccionado el evento Click y se ha configurado para que se almacene en déclencheur cuando se seleccione .add-to-cart-button. Seleccione Keep Changes.
Se ha guardado el nuevo evento. Seleccione Select a working library y la biblioteca en la que desea compilar.
A continuación, seleccione el menú desplegable junto a Save to Library y seleccione Save to Library and Build. 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.
Próximos pasos
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.