Mailchimp Interest Categories conexión
Mailchimp es una popular plataforma de automatización de marketing y servicio de marketing por correo electrónico que utilizan las empresas para administrar y hablar con los contactos (clientes, clientes u otras partes interesadas) uso de listas de correo y campañas de marketing por correo electrónico. Utilice este conector para ordenar contactos según sus intereses y preferencias.
Mailchimp Interest Categories utiliza audiencias, grupos, y categorías de interés (también conocidos como nombres de grupos o títulos de grupos). Cada Mailchimp grupo es una lista de categorías de interés. Los contactos se asocian a una categoría de interés cuando se suscriben a una o más categorías de interés a través de un formulario de suscripción en el sitio web. Dentro de una audiencia, también puede organizar los contactos en grupos y asociarlos con categorías de interés, que luego se pueden utilizar para crear segmentos. Puede utilizar estas audiencias para difundir correos electrónicos de campaña segmentados a los contactos suscritos.
Esta Adobe Experience Platform destino utiliza el Mailchimp batch subscribe or unsubscribe API API para crear categorías de interés y, a continuación, añada contactos de cada una de las audiencias de Platform seleccionadas a una categoría de interés correspondiente. Puede añadir nuevos contactos o actualizar la información de Mailchimp contactos, entonces añadirlos o eliminarlos de los grupos que deseen dentro de un existente Mailchimp después de activarlos en un nuevo segmento. Mailchimp Interest Groups utiliza los nombres de audiencia seleccionados de Platform como categorías de interés dentro de Mailchimp.
Casos de uso use-cases
Para ayudarle a comprender mejor cómo y cuándo debe utilizar el Mailchimp Interest Categories Destino, este es un ejemplo de caso de uso que los clientes de Adobe Experience Platform pueden solucionar mediante este destino.
Envío de correos electrónicos a contactos para campañas de marketing use-case-send-emails
El departamento de ventas de un sitio web de artículos deportivos quiere transmitir una campaña de marketing por correo electrónico a una lista de contactos que se han identificado a sí mismos como interesados en el fútbol. Las listas de contactos se separan como lotes en la exportación de datos recibida del equipo de desarrollo del sitio web y, por lo tanto, deben rastrearse. El equipo identifica un existente Mailchimp y comienza a crear las audiencias de Experience Platform a las que se añaden los contactos de cada lista. Después de enviar estas audiencias a Mailchimp Interest Categories, si hay contactos que no existen en el seleccionado Mailchimp audiencia a la que se añaden a un grupo con el nombre de la audiencia a la que pertenece el contacto. Si ya existe algún contacto en Mailchimp audiencia o grupo y, a continuación, se actualiza su información. Una vez que los datos se hayan enviado a Mailchimp Interest Categories, el equipo de ventas puede seleccionar y enviar el correo electrónico de campaña de marketing al grupo de interés de fútbol dentro de la Mailchimp audiencia.
Requisitos previos prerequisites
Consulte las secciones siguientes para conocer todos los requisitos previos que debe configurar en Experience Platform y Mailchimp y para la información que debe recopilar antes de trabajar con Mailchimp Interest Categories destino.
Requisitos previos en Experience Platform prerequisites-in-experience-platform
Antes de activar los datos en Mailchimp Interest Categories destino, debe tener un esquema, a conjunto de datos, y segmentos creado en Experience Platform.
Requisitos previos para la Mailchimp Interest Categories destino prerequisites-destination
Tenga en cuenta los siguientes requisitos previos para exportar datos de Platform a su Mailchimp cuenta:
Debe tener un Mailchimp account prerequisites-account
Antes de crear un Mailchimp Interest Categories destino, primero debe asegurarse de que dispone de un Mailchimp cuenta. Si todavía no tiene uno, visite la Mailchimp página de suscripción para registrarse y crear su cuenta.
Reunir Mailchimp Clave de API gather-credentials
Necesita su Mailchimp Clave de API para autenticar el Mailchimp Interest Categories destino frente a su Mailchimp cuenta. El Clave de API sirve como Contraseña cuando usted autenticar el destino.
Si no tiene su Clave de API, Inicie sesión en su cuenta de y consulte la Mailchimp Genere su clave de API documentación para crear uno.
Un ejemplo de clave de API es 0123456789abcdef0123456789abcde-us14
.
Identificar Mailchimp centro de datos identify-data-center
A continuación, debe identificar su Mailchimp centro de datos. Para ello, inicie sesión en su Mailchimp y vaya a la sección de claves API de su cuenta.
El valor es la primera parte de la dirección URL que ve en el explorador. Si la dirección URL es https://us14
.mailchimp.com/account/api/, el centro de datos es us14
.
También se anexa a la clave de API en el formulario key-dc; si la clave de API es 0123456789abcdef0123456789abcde-us14
, el centro de datos es us14
.
Anote el valor del centro de datos (us14
en este ejemplo), necesita este valor cuando rellenar detalles de destino.
Si necesita más información, consulte la Mailchimp Documentación de fundamentos.
Mecanismos de protección guardrails
Cada uno de sus Mailchimp las audiencias pueden contener hasta 60 nombres de grupo (o categorías de interés) en un solo grupo o en varios grupos dentro de la misma audiencia. Consulte Mailchimp grupos para cualquier aclaración necesaria. Cuando llegue a este límite, obtendrá una 400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories)
mensaje como respuesta de error del Mailchimp API.
Además, consulte la Mailchimp límites de velocidad para obtener información detallada sobre los límites impuestos por la Mailchimp API.
Identidades admitidas supported-identities
Mailchimp admite la activación de identidades descritas en la tabla siguiente. Más información sobre identidades.
Tipo y frecuencia de exportación export-type-frequency
Consulte la tabla siguiente para obtener información sobre el tipo y la frecuencia de exportación de destino.
- Está exportando todos los miembros de un segmento, junto con los campos de esquema deseados (por ejemplo: dirección de correo electrónico, número de teléfono, apellidos), según la asignación de campo.
- Para cada audiencia seleccionada en Platform, la correspondiente Mailchimp Interest Categories El estado del segmento se actualiza con su estado de audiencia de Platform.
Conexión al destino connect
Para conectarse a este destino, siga los pasos descritos en la sección tutorial de configuración de destino. En el flujo de trabajo de configuración de destino, rellene los campos enumerados en las dos secciones siguientes.
En Destinos > Catálogo, buscar Mailchimp Interest Categories. También puede encontrarlo en la sección Marketing por email categoría.
Autenticarse en el destino authenticate
Para autenticarse en el destino, rellene los campos obligatorios a continuación y seleccione Conectar con destino.
La clave de API adopta la forma de
{KEY}-{DC}
, donde la variable {KEY}
hace referencia al valor anotado en la sección Mailchimp Clave de API y la sección {DC}
La parte hace referencia a Mailchimp centro de datos.Puede proporcionar cualquiera de las
{KEY}
parte o todo el formulario.Por ejemplo, si la clave de API es
0123456789abcdef0123456789abcde-us14
,puede proporcionar lo siguiente *
0123456789abcdef0123456789abcde
*o *0123456789abcdef0123456789abcde-us14
*como el valor.
Si los detalles proporcionados son válidos, la interfaz de usuario muestra un Conectado estado con una marca de verificación verde. A continuación, puede continuar con el paso siguiente.
Rellenar detalles de destino destination-details
Para configurar los detalles del destino, rellene los campos obligatorios y opcionales a continuación. Un asterisco junto a un campo en la interfaz de usuario indica que el campo es obligatorio.
data center
. Consulte la Identificar Mailchimp centro de datos para obtener cualquier guía.No options are available. Please verify the values selected for the following dependent fields: dataCenter
como se muestra a continuación. En este caso, no puede seleccionar un valor de la variable Nombre de audiencia (seleccione primero el centro de datos) field. Para corregir este error, proporcione los valores correctos.Habilitar alertas enable-alerts
Puede activar alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista a la que suscribirse para recibir notificaciones sobre el estado del flujo de datos. Para obtener más información sobre las alertas, consulte la guía de suscripción a alertas de destinos mediante la IU.
Cuando haya terminado de proporcionar detalles para la conexión de destino, seleccione Siguiente.
Activar públicos en este destino activate
-
Para activar los datos, necesita el Ver destinos, Activar destinos, Ver perfiles, y Ver segmentos permisos de control de acceso. Lea el información general de control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.
-
Para exportar identidades, necesita el Ver gráfico de identidad permiso de control de acceso.
img-md w-100 modal-image
Leer Activación de perfiles y audiencias en destinos de exportación de audiencia de streaming para obtener instrucciones sobre cómo activar audiencias en este destino.
Consideraciones sobre asignación y ejemplo mapping-considerations-example
Para enviar correctamente los datos de audiencia de Adobe Experience Platform a Mailchimp Interest Categories destino, debe pasar por el paso de asignación de campos. La asignación consiste en crear un vínculo entre los campos de esquema del Modelo de datos de experiencia (XDM) en la cuenta de Platform y sus equivalentes correspondientes desde el destino de destino.
Para asignar correctamente los campos XDM a Mailchimp Interest Categories campos de destino, siga los pasos a continuación:
-
En el Asignación paso, seleccione Añadir nueva asignación. Ahora puede ver una nueva fila de asignación en la pantalla.
-
En el Seleccionar campo de origen , seleccione la Seleccionar atributos y seleccione el atributo XDM o elija el Seleccionar área de nombres de identidad y seleccione una identidad.
-
En el Seleccionar campo de destino , seleccione la Seleccionar área de nombres de identidad y seleccione una identidad o elija Seleccionar atributos y seleccione de la lista de atributos rellenados desde el Mailchimp API. Cualquier atributo personalizado que haya agregado al seleccionado Mailchimp La audiencia también estará disponible para su selección como campos de destino.
Las asignaciones disponibles entre el esquema de perfil XDM y Mailchimp Interest Categories son los siguientes: | Campo de origen | Campo de destino | Notas | | — | — | — | |
IdentityMap: Email
|Identity: email
| Obligatorio: sí | |xdm: person.name.firstName
|Attribute: FNAME
| | |xdm: person.name.lastName
|Attribute: LNAME
| | |xdm: person.birthDayAndMonth
|Attribute: BIRTHDAY
| |Además,
ADDRESS
es un campo de destino especial denominadomerge field
dentro de su Mailchimp audiencia. El Mailchimp documentación define las claves necesarias comoaddr1
,city
,state
, yzip
y las claves opcionalesaddr2
ycountry
. Los valores de estos campos deben ser cadenas. Si alguna de lasADDRESS
están presentes, el destino pasa elADDRESS
objeto a Mailchimp API para actualizar. CualquieraADDRESS
los campos que no están asignados tienen su valor predeterminado deNULL
excepto para el país que toma el valor predeterminado deUS
.Las asignaciones disponibles para
ADDRESS
Estos campos son los siguientes:table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 Campo de origen Campo de destino xdm: workAddress.street1
Attribute: ADDRESS.addr1
xdm: workAddress.street2
Attribute: ADDRESS.addr2
xdm: workAddress.city
Attribute: ADDRESS.city
xdm: workAddress.state
Attribute: ADDRESS.state
xdm: workAddress.postalCode
Attribute: ADDRESS.zip
xdm: workAddress.country
Attribute: ADDRESS.country
Por ejemplo, desea actualizar el valor de
country
con el campo de dirección existente del contactoaddr1
,city
,state
, yzip
valores como132, My Street, Kingston
,New York
,New York
y12401
. Para actualizar elcountry
debe pasar los valores existentes con cambios (si procede) y el nuevo valor de país. Por lo tanto, los valores del conjunto de datos deben ser132, My Street, Kingston
,New York
,New York
,12401
, yUS
. Para reiterar, si solo pasacountry
y no proporcionan valores paraaddr1
,city
,state
, yzip
se sobrescribirán conNULL
.A continuación, se muestra un ejemplo con las asignaciones completadas:
Cuando haya terminado de proporcionar las asignaciones para la conexión de destino, seleccione Siguiente.
Validar exportación de datos exported-data
Para comprobar que ha configurado correctamente el destino, siga los pasos a continuación:
- Inicie sesión en su Mailchimp cuenta. A continuación, vaya a Audience página. A continuación, expanda el Manage Contacts y seleccione Groups.
- Seleccione el grupo y compruebe si las audiencias seleccionadas se crean como categorías con el nombre de audiencia de Platform, que puede ir seguido de un sufijo generado automáticamente.
- Este destino utiliza los nombres de los segmentos seleccionados para crear la categoría de interés utilizando Mailchimp Añadir API de categoría de interés. Si crea un nuevo destino y vuelve a activar las mismas audiencias, Mailchimp añade un sufijo para distinguir entre los segmentos existentes y los nuevos.
- Los contactos cuyos correos electrónicos no existían en el grupo se agregan a la categoría recién creada.
- Para los contactos que ya existen dentro del grupo, se actualizan los datos del campo de atributo y el contacto se agrega a la categoría recién creada.
Uso de datos y gobernanza data-usage-governance
Todo Adobe Experience Platform Los destinos de cumplen con las políticas de uso de datos al gestionar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica la gobernanza de datos. Consulte la Resumen de gobernanza de datos.
Errores y solución de problemas errors-and-troubleshooting
Error encontrado si Mailchimp Los valores de la clave API o del centro de datos son incorrectos incorrect-credentials-error
Si la clave de API proporcionada en la Contraseña o el campo Centro de datos son incorrectos, la interfaz de usuario muestra un Mailchimp Respuesta de error de API: No options are available. Please verify the values selected for the following dependent fields: dataCenter
como se muestra a continuación. En este caso, no puede seleccionar un valor de la variable Nombre de audiencia (seleccione primero el centro de datos) field.
Para corregir este error y continuar con el siguiente paso, debe proporcionar los valores correctos. Consulte la Identificar Mailchimp centro de datos y
Reunir Mailchimp Clave de API secciones si necesita orientación.
Error encontrado si Mailchimp se ha superado el límite de nombres de grupo group-name-limits-error
Al crear el destino, puede recibir los siguientes mensajes de error: Cannot have more than 60 interests per list (Across all categories)
o 400 BAD_REQUEST
. Esto sucede cuando se superan los 60 nombres de grupo (o categorías de interés) en un solo grupo o en varios grupos dentro del mismo límite de audiencia, como se describe en la sección barandas sección. Para corregir este error, asegúrese de que no supera el límite de nombres de grupo en Mailchimp.
Mailchimp Códigos de estado y error
Consulte la Mailchimp página de errores para obtener una lista completa de estados y códigos de error con explicaciones.
Recursos adicionales additional-resources
Información útil adicional del Mailchimp Esta documentación es: