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.

NOTE
La sección sobre deduplicación de eventos más adelante en este documento se explican los pasos para garantizar que el mismo evento no se utilice dos veces, ya que puede recibirse tanto desde el explorador como desde el servidor.

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.

INFO
Si planea utilizar esta extensión con datos de aplicaciones móviles o si también trabaja con datos de eventos sin conexión en su Meta Para las campañas de, debe crear el conjunto de datos a través de una aplicación existente y seleccionar Crear a partir de un ID de píxel cuando se le solicite. Consulte el artículo Decida qué opción de creación de conjuntos de datos es la adecuada para su empresa para obtener más información. Consulte la API de conversiones para eventos de aplicación para todos los parámetros de seguimiento de aplicación opcionales y requeridos.

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.

El Instalar opción que se está seleccionando para API de metaconversiones en la IU de recopilación de datos.

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

El Pixel El ID proporcionado como elemento de datos en la vista de configuración de la extensión.

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.

El Extensión de API de metaconversiones resaltado de página de instalación Conectar con Meta.

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.

Resaltado de la IU del flujo de trabajo de inicio rápido Conectar con Meta.

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.

El Extensión de API de metaconversiones resaltado de página de configuración Ver puntuación EMQ.

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.

El reenvío de eventos Meta Regla resaltado de página de configuración Nombre del socio (alpha) y ID de socio (alpha).

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í.

NOTE
Los eventos deben ser enviado en tiempo real o lo más cerca posible del tiempo real para una mejor optimización de la campaña publicitaria.

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.

El Enviar vista de página Tipo de acción seleccionado para una regla de la IU de recopilación de datos.

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.

Sección Config
Descripción
Parámetros de evento del servidor
Información general sobre el evento, incluida la hora en que se produjo y la acción de origen que lo activó. Consulte la Meta documentación para desarrolladores para obtener más información sobre parámetros de evento estándar aceptado por el Conversions API.

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.
Parámetros de información del cliente
Datos de identidad del usuario que se utilizan para atribuir el evento a un cliente. Algunos de estos valores deben tener un cifrado hash para poder enviarlos a la API.

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.
Datos personalizados
Datos adicionales que se utilizarán para la optimización de la entrega de anuncios, proporcionados en forma de objeto JSON. Consulte la Conversions API documentación para obtener más información sobre las propiedades aceptadas para este objeto.

Si envía un evento de compra, debe utilizar esta sección para proporcionar los atributos necesarios currency y value.
Evento de prueba
Esta opción se utiliza para comprobar si la configuración está provocando que reciba eventos de servidor Meta como se esperaba. Para utilizar esta función, seleccione la Enviar como evento de prueba y, a continuación, proporcione un código de evento de prueba de su elección en la entrada siguiente. Una vez implementada la regla de reenvío de eventos, si configuró la extensión y la acción correctamente, debería ver las actividades que aparecen dentro de la variable Test Events ver en Meta Events Manager.

Cuando termine, seleccione Conservar cambios para añadir la acción a la configuración de regla.

Conservar cambios seleccionado para la configuración de acción.

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

IMPORTANT
  • 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.
NOTE
Cualquier cliente existente puede utilizar los flujos de trabajo de inicio rápido para crear una implementación de referencia que se pueda utilizar para lo siguiente:
  • 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

NOTE
Esta función está diseñada para ayudarle a empezar con una implementación de reenvío de eventos. No proporcionará una implementación integral y completamente funcional que se ajuste a todos los casos de uso.

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.

Página de inicio de la recopilación de datos que muestra las conversiones de datos a meta

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.

Pantalla de bienvenida que solicita un nombre de dominio

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.

Cuadro de diálogo Configuración inicial

Espere unos minutos para que se complete el proceso de configuración inicial y, a continuación, seleccione Siguiente.

Configuración inicial pantalla de confirmación completa

Desde el Añadir código en el sitio diálogo copie el código proporcionado utilizando la copia Copiar y péguelo en la <head> del sitio web de origen. Una vez implementada, seleccione Iniciar validación

Agregar código en el cuadro de diálogo del sitio

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.

Cuadro de diálogo de resultados de prueba que muestra resultados de implementación

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.

Cuadro de diálogo Pasos siguientes

Adición de eventos adicionales

Para añadir nuevos eventos, seleccione Editar la propiedad web de etiquetas.

Cuadro de diálogo Pasos siguientes que muestra la edición de la propiedad web de etiquetas

Seleccione la regla que corresponda al metaevento que desee editar. Por ejemplo, MetaConversion_AddToCart.

NOTE
Si no hay ningún evento, esta regla no se ejecutará. Esto es así para todas las reglas, con la variable MetaConversion_PageView regla que es la excepción.

Para añadir un evento, seleccione Añadir en el Eventos encabezado.

Página de propiedades de etiquetas que no muestra eventos

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.

Pantalla de configuración de eventos que muestra el evento de clics

Se ha guardado el nuevo evento. Seleccionar Seleccionar una biblioteca de trabajo y seleccione la biblioteca en la que desea compilar.

Seleccione una lista desplegable de la biblioteca de trabajo

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.

Seleccione Guardar en biblioteca y crear

Repita estos pasos para cualquier otro evento de metaconversión que desee configurar.

Configuración de capa de datos configuration

IMPORTANT
La forma de actualizar esta capa de datos global depende de la arquitectura del sitio web. Una aplicación de una sola página será diferente a una aplicación de procesamiento del lado del servidor. También existe la posibilidad de que esté totalmente a cargo de la creación y actualización de estos datos dentro del producto Etiquetas. En todos los casos, la capa de datos deberá actualizarse entre la ejecución de cada uno de los 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.

Metainformación de la capa de datos

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.

Actualizar información meta de la capa de datos

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.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743