Resumen de la extensión de reenvío de eventos Mailchimp
El Mailchimp reenvío de eventos Esta extensión envía eventos a la API de marketing de Mailchimp que pueden almacenar en déclencheur correos electrónicos para campañas de marketing, recorridos o transacciones 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, consulte 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 aterrizar en la vista del panel, la barra de direcciones del navegador debe mostrar una URL como https://us11.admin.mailchimp.com
o simplemente us11.admin.mailchimp.com
. En este ejemplo, el prefijo us11
es solo un marcador de posición y su valor será diferente. Registre la dirección URL con el prefijo para un paso posterior.
Clave de API
Para buscar la clave API de tu cuenta, selecciona el icono de tu perfil en la interfaz de usuario de Mailchimp y luego selecciona Perfil. Debería ver una dirección URL como https://us11.admin.mailchimp.com/account/profile/
pero con su prefijo en lugar de us11
.
Seleccionar Extras, entonces Claves de API:
En Sus claves API, puede elegir una clave existente o puede seleccionar Crear Una Clave para crear uno nuevo. 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, consulte la documentación de Mailchimp sobre cómo genere su clave de API.
ID de audiencia y dirección remitente
Seleccionar Audiencia en el panel de navegación izquierdo, Tablero de audiencias. A continuación, seleccione la audiencia que desee utilizar con esta extensión. Para obtener más información, consulte el documento de Mailchimp sobre creación de una audiencia.
Con la audiencia creada y seleccionada, seleccione la Administrar audiencia y elija Configuración. Esta pantalla muestra varias configuraciones para la audiencia.
En la parte inferior de la pantalla Configuración, debería ver lo siguiente 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.
Seleccionar 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 API de Mailchimp, debes usar el reenvío de eventos secretos.
Crear un secreto y un elemento de datos
En una propiedad de reenvío de eventos, crear un Token secreto llamado Mailchimp API Key
.
Siguiente, creación de un elemento de datos uso del Núcleo extensión y a Secreto tipo de elemento de datos para hacer referencia a Mailchimp API Key
secreto que acaba de crear. Entrar 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, entonces Catálogo para mostrar las extensiones disponibles para la instalación. Desde aquí, busque la extensión Mailchimp y seleccione Instalar.
Aparece la pantalla de configuración. En Nombre de dominio del prefijo del servidor Mailchimp, introduce el dominio que has copiado 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 de elemento de datos y elija el Mailchimp Token
elemento de datos que ha creado anteriormente. Seleccionar Guardar para guardar los cambios.
La extensión de ya está instalada y configurada para su uso en la propiedad.
Recopilación de datos
Cuando se utiliza esta extensión en una reglaSin embargo, hay varios valores de datos que la extensión envía a Mailchimp con cada evento. Para una implementación típica, puede configurar las variables Extensión de SDK web de Adobe Experience Platform para enviar esos datos a Platform Edge Network para su uso por 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 (mediante el xdm
objeto) o datos no XDM (con el objeto data
objeto).
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 envía la información necesaria desde el SDK web a la red perimetral, 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 a la red perimetral, 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
establezca 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 variable Añadir evento acción 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, la variable 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 la Guías de ayuda de Automatización Mailchimp para obtener más información.