Meta Conversions API información general sobre extensiones
El Meta Conversions API le permite conectar los datos de marketing del lado del servidor a Meta para optimizar la segmentación de anuncios, reducir el coste por acción y medir los resultados. Los eventos están vinculados a una Meta Pixel Los ID y se procesan de forma similar a los eventos del lado del cliente.
Uso del Meta Conversions API , puede aprovechar las capacidades de la API en su reenvío de eventos reglas para enviar datos a Meta de Adobe Experience Platform Edge Network. Este documento explica cómo instalar la extensión y utilizar sus funcionalidades en un reenvío de eventos regla.
Demostración
El siguiente vídeo tiene como objetivo ayudarle a comprender el Meta Conversions API.
Requisitos previos
Se recomienda encarecidamente utilizar Meta Pixel y el 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 no recogieron Meta Pixel. Antes de instalar el Conversions API extensión, consulte la guía de la Meta Pixel extensión para ver los pasos necesarios para integrarlo en las implementaciones de etiquetas del lado del cliente.
Para utilizar la variable Conversions API extensión, debe tener acceso al reenvío de eventos y tener un válido Meta cuenta con acceso a Ad Manager y Event Manager. Específicamente, debe copiar el ID de un Meta Pixel (o crear un nuevo Pixel en su lugar) para que la extensión se pueda configurar en su cuenta de.
Instalar la extensión
Para instalar el Meta Conversions API extensión, 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 seleccionada o creada la propiedad deseada, seleccione Extensiones en el panel de navegación izquierdo, seleccione la opción Catálogo pestaña. Busque la variable API de metaconversiones y, a continuación, seleccione Instalar.
En la vista de configuración que aparece, debe proporcionar el Pixel ID 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 utilizar Conversions API específicamente. Consulte la Conversions API documentación sobre generación de un token de acceso para ver los pasos para 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 Meta Business (MBE) mbe
La integración con la mejora de Meta Business Extensions (MBE) le permite autenticarse rápidamente en su cuenta de Meta Business. A continuación, rellena automáticamente su ID de píxel y la API de metaconversiones Token de acceso, lo que facilita la instalación y configuración de la API de conversiones de metadatos.
Aparecerá un mensaje de diálogo para autenticarse en MBE al instalar el API de metaconversiones extensión.
También aparece un mensaje de diálogo para autenticarse en MBE 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 variable Extensión de API de metaconversiones pantalla de configuración.
Integración con LiveRamp (Alpha) alpha
LiveRamp clientes que tienen LiveRampLa solución de tráfico autenticado (ATS) de implementada en sus sitios puede optar por compartir RampID como parámetro de información del cliente. Trabaje con su Meta equipo de cuenta 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 el Conversions API en una regla genérica de reenvío de eventos. En la práctica, debe configurar varias reglas para enviar todos los mensajes aceptados eventos estándar mediante 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 del cliente 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 Extensión de API de metaconversiones para la extensión, seleccione Enviar evento de API de conversiones para el tipo de acción.
Aparecen controles que permiten configurar los datos de evento que se envían a Meta a través de 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 utiliza ambos Meta Pixel y el Conversions API para enviar eventos, asegúrese de incluir un Nombre del evento (
event_name
) y ID de evento (event_id
) con cada evento, ya que estos valores se utilizan para deduplicación de eventos.También tiene la opción de Habilitar uso limitado de datos para ayudar a cumplir con las exclusiones de los clientes. Consulte la Conversions API documentación sobre opciones de procesamiento de datos para obtener más información sobre esta función.
Para garantizar una buena conexión API común y una alta calidad de coincidencia de eventos (EMQ), se recomienda enviar todos los parámetros de información de cliente aceptados junto con eventos de servidor. Estos parámetros también deben ser priorizadas en función de su importancia e impacto en EMQ.
Si envía un evento de compra, debe utilizar esta sección para proporcionar los atributos necesarios
currency
y value
.Cuando termine, seleccione Conservar cambios para añadir 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 generar para habilitar los cambios realizados en la biblioteca.
Deduplicación de eventos deduplication
Como se menciona en el sección de requisitos previos, se recomienda utilizar tanto la variable Meta Pixel extensión de etiquetas y Conversions API extensión de reenvío de eventos 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 un solo evento lo comparten ambos Meta Pixel y el Conversions API, debe asegurarse de que estos eventos redundantes se dedupliquen 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 deduplicarlas y conservar los datos más relevantes. Consulte la Meta documentación sobre deduplicació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 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 la red perimetral 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 función, seleccione Primeros pasos para Send Conversions Data to Meta en la recopilación de datos de Adobe Experience Platform Inicio página.
Introduzca su Dominio, luego seleccione 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 Configuración inicial diálogo introduzca su ID de metapíxel, Token de acceso a API de metaconversión, y Ruta de capa de datos, luego seleccione Siguiente.
Espere unos minutos para que se complete el proceso de configuración inicial y, a continuación, seleccione Siguiente.
Desde el Añadir código en el sitio diálogo copie el código proporcionado utilizando la copia
y péguelo en la <head>
del sitio web de origen. Una vez implementada, seleccione Iniciar validación
El Resultados de validación muestra los resultados de la implementación de la extensión Meta. Seleccionar Siguiente. También puede ver resultados de validación adicionales seleccionando la variable Assurance vínculo.
El Pasos siguientes la pantalla confirma la finalización de la configuració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 añadir eventos adicionales, seleccione Cerrar.
Adición de eventos adicionales
Para añadir nuevos eventos, seleccione Editar la propiedad web de etiquetas.
Seleccione la regla que corresponda al metaevento que desee editar. Por ejemplo, MetaConversion_AddToCart.
Para añadir un evento, seleccione Añadir en el Eventos encabezado.
Seleccione el Tipo de evento. En este ejemplo, se ha seleccionado la variable Clic y lo configuró en déclencheur cuando el .add-to-cart-button está seleccionado. Seleccione Conservar cambios.
Se ha guardado el nuevo evento. Seleccionar Seleccionar una biblioteca de trabajo y seleccione la biblioteca en la que desea compilar.
A continuación, seleccione el menú desplegable situado 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 puede encontrar un caso en el que esté enviando datos antiguos desde el último MetaConversion_* rule
en el actual MetaConversion_* rule
.Durante la configuración, se le preguntó dónde reside su capa de datos. De forma predeterminada, sería window.dataLayer.meta
, y dentro de meta
objeto, sus datos serían esperados como se muestra abajo.
Esto es importante entenderlo como cada MetaConversion_*
utiliza esta estructura de datos para pasar los fragmentos de datos relevantes al Meta Pixel y a la Meta Conversions API. Consulte la documentación sobre eventos estándar para obtener más información sobre los datos que requieren los distintos metaeventos.
Por ejemplo, si desea utilizar la variable MetaConversion_Subscribe
regla, debería actualizar window.dataLayer.meta.currency
, window.dataLayer.meta.predicted_ltv
, y window.dataLayer.meta.value
según las propiedades del 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 forma predeterminada, la variable <datalayerpath>.conversionData.eventId
se generará aleatoriamente mediante la acción "Generar nuevo ID 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 MetaConversion_DataLayer
elemento de datos de su propiedad.
Pasos siguientes
En esta guía se explica cómo enviar datos de eventos del lado del servidor a Meta uso del Meta Conversions API extensión. Desde aquí, se recomienda ampliar la integración conectando más Pixels y compartir más eventos cuando corresponda. Realizar cualquiera de las siguientes acciones puede ayudar a mejorar aún más el rendimiento de su anuncio:
- Conectar cualquier otro Pixels que aún no están conectados a un Conversions API integración.
- Si envía ciertos eventos exclusivamente a través de Meta Pixel en el lado del cliente, envíe estos mismos eventos a Conversions API también desde el lado del servidor.
Consulte la Meta documentación sobre 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.