Resumen de la extensión de reenvío de eventos Mailchimp
La extensión de Mailchimp reenvío de eventos envía eventos a la API de marketing de Mailchimp que puede almacenar en déclencheur correos electrónicos para campañas, recorridos o transacciones de marketing de Mailchimp.
Este documento explica cómo configurar la extensión y las reglas mediante la acción Añadir evento.
Requisitos previos
Este documento supone que está familiarizado con los productos de Mailchimp relevantes que aprovecha la extensión. Para obtener más información, consulta la documentación de ayuda de Mailchimp para campañas, recorridos y transacciones.
Se requiere una cuenta de Mailchimp para utilizar esta extensión. Puede registrarse para obtener una cuenta aquí. En el panel de cuenta de Mailchimp, anote los siguientes valores para usarlos en esta guía:
- Prefijo de dominio de Mailchimp
- Su clave de API
- El ID de audiencia
- La dirección de correo electrónico predeterminada "de"
Según el plan de cuenta de Mailchimp, es posible que tengas acceso limitado a las herramientas de Recorrido del cliente de Mailchimp.
Prefijo de dominio
Después de iniciar sesión en Mailchimp y de aterrizar en la vista del panel, la barra de direcciones del navegador debe mostrar una URL como https://us11.admin.mailchimp.com
o solo us11.admin.mailchimp.com
. En este ejemplo, el prefijo us11
es solo un marcador de posición y el valor será diferente. Registre la dirección URL con el prefijo para un paso posterior.
Clave de API
Para encontrar la clave API de tu cuenta, selecciona el icono de perfil en la interfaz de usuario de Mailchimp y, a continuación, selecciona Perfil. Debería ver una dirección URL como https://us11.admin.mailchimp.com/account/profile/
, pero con el prefijo your en lugar de us11
.
Seleccione Extras y luego claves API:
En Sus claves API, puede elegir una clave existente o seleccionar Crear una clave para crear una nueva. Puede crear una nueva clave para utilizarla específicamente con esta extensión. Copie la clave de API y guárdela para un paso posterior. Para obtener más información, consulta la documentación de Mailchimp sobre cómo generar tu clave de API.
ID de audiencia y dirección remitente
Seleccione Audiencia en el panel de navegación izquierdo, luego Panel de audiencias. A continuación, seleccione la audiencia que desee utilizar con esta extensión. Para obtener más información, consulta el documento de Mailchimp sobre creación de una audiencia.
Con la audiencia creada y seleccionada, selecciona el menú desplegable Administrar audiencia y elige Configuración. Esta pantalla muestra varias configuraciones para la audiencia.
En la parte inferior de la pantalla Configuración, debería ver Unique id for audience [audience name]
, donde [audience name]
es el nombre de la audiencia real. Copie el ID de audiencia y guárdelo para un paso posterior.
Seleccione Nombre de audiencia y valores predeterminados y confirme que Dirección de correo electrónico remitente predeterminada tiene el valor correcto para sus campañas. Tenga en cuenta que el ID de audiencia también se muestra en la parte superior de esta página y es el mismo valor que copió en el último paso.
Automatizaciones de Mailchimp
Dependiendo de tu plan de Mailchimp y de si utilizas correos electrónicos transaccionales, Recorridos del cliente u otras automatizaciones de Mailchimp, la configuración específica del recorrido puede variar.
Instalación y configuración
En esta sección se enumeran los pasos para instalar y configurar la extensión de. Para guardar de forma segura la clave de API de Mailchimp, debes usar el reenvío de eventos secret.
Crear un secreto y un elemento de datos
En una propiedad de reenvío de eventos, cree un token secreto llamado Mailchimp API Key
.
A continuación, cree un elemento de datos con la extensión Core y un tipo de elemento de datos Secret para hacer referencia al secreto Mailchimp API Key
que acaba de crear. Escriba Mailchimp Token
como nombre del elemento de datos.
Instalación y configuración de la extensión de
En la misma propiedad de reenvío de eventos, seleccione Extensiones, y Catálogo para mostrar las extensiones disponibles para la instalación. Aquí, busca la extensión Mailchimp y selecciona Instalar.
Aparece la pantalla de configuración. En Nombre de dominio del prefijo del servidor de Mailchimp, escribe el dominio que copiaste anteriormente desde tu cuenta de Mailchimp, incluido tu prefijo de dominio único.
http://
o https://
en este campo.
En Token de Mailchimp, seleccione el icono del elemento de datos y elija el elemento de datos Mailchimp Token
que creó anteriormente. Seleccione Guardar para guardar los cambios.
La extensión de ya está instalada y configurada para su uso en la propiedad.
Recopilación de datos
Al usar esta extensión en una regla, hay varios valores de datos que la extensión envía a Mailchimp con cada evento. Para una implementación típica, puede configurar la extensión del SDK web de Adobe Experience Platform para enviar esos datos a Platform Edge Network para que la utilice la extensión en la propiedad de reenvío de eventos.
Los datos requeridos por esta extensión se pueden enviar desde el SDK web como datos XDM (con el objeto xdm
) o como datos que no sean XDM (con el objeto data
).
Por ejemplo, si un cliente realiza una compra o se registra para un evento en su sitio, puede enviar un correo electrónico de confirmación a través de Mailchimp con esta extensión. Una vez que se envía la información necesaria desde el SDK web al Edge Network, la extensión almacena en déclencheur el correo electrónico con Mailchimp.
Elementos de datos
La captura de pantalla de la sección anterior muestra los datos que puedes enviar con cada evento de esta extensión a Mailchimp. Una vez configurado el SDK web para enviar estos datos al Edge Network, puede crear elementos de datos en la propiedad de reenvío de eventos para que la extensión pueda acceder a esos valores.
La tabla siguiente proporciona más detalles para cada valor posible.
email
arc.event.xdm._tenant.emailId
o
arc.event.data._tenant.emailId
listId
arc.event.xdm._tenant.listId
o
arc.event.data._tenant.listid
name
arc.event.xdm._tenant.name
o
arc.event.data._tenant.name
properties
arc.event.xdm._tenant.properties
o
arc.event.data._tenant.properties
isSyncing
arc.event.xdm._tenant.isSyncing
o
arc.event.data._tenant.isSyncing
is_syncing
establecido en true
no automatizaciones de déclencheuroccurredAt
arc.event.xdm._tenant.occuredAt
o
arc.event.data._tenant.occuredAt
En la propiedad de reenvío de eventos puede crear un elemento de datos para cada uno de los campos descritos anteriormente. Una vez creada, puede hacer referencia a los elementos de datos en la acción Agregar evento de esta extensión.
Ahora puede utilizar esta extensión y la acción Añadir evento para almacenar en déclencheur correos electrónicos de Mailchimp para sus audiencias.
Validación de datos
Al trabajar con extensiones de reenvío de eventos, el Adobe Experience Platform Debugger es muy útil. En la sección Registros, en Registros de Edge puede ver las solicitudes realizadas por las reglas de reenvío de eventos una vez activadas. Las siguientes capturas de pantalla muestran una solicitud a la API de Mailchimp realizada por la extensión.
En el panel de Mailchimp, en la vista de Fuente de actividad de tu audiencia o miembro de audiencia, se proporciona una lista de eventos para ese audiencia o miembro de audiencia. Debe coincidir con los eventos enviados por la extensión y mostrar cualquier dato opcional enviado, junto con el correo electrónico o la campaña que recibieron. Consulte las guías de ayuda de automatización de Mailchimp para obtener más información.