Integraciones
Mailchimp
Agrega a las personas que convierten a una audiencia de Mailchimp, etiquetadas con el evento y el enlace corto, con un evento en su cronología.
La integración de Mailchimp agrega a la persona detrás de una conversión aprobada a tu audiencia de Mailchimp, la etiqueta con el tipo de conversión y el enlace corto que la trajo, y registra un evento personalizado en la cronología de su perfil. Los clics no se envían: un clic no tiene dirección de email. Disponible en Growth y Ultimate.
Lo que necesitas
- Una clave de API de Mailchimp (Profile → Extras → API keys → Create A Key). Termina con tu centro de datos, por ejemplo
-us21. - El ID de audiencia (Audience → All contacts → Settings → Audience name and defaults).
- Conversiones que incluyen un
email. Las que no lo tienen se omiten.
Conéctalo a Letlink
- Ve a Integraciones → Mailchimp. Solo propietarios y administradores.
- Pega la clave de API y el ID de audiencia.
- Elige cómo se agregan los contactos nuevos: doble opt-in (la opción predeterminada: Mailchimp les envía un email de confirmación y quedan pendientes hasta que confirman), suscribir directamente (solo si ya tienes su consentimiento) o transaccional (en la audiencia, pero sin recibir marketing).
- Si quieres, cambia el prefijo de etiqueta (
letlinkpor defecto) y guarda.
Qué enviamos
Una solicitud por conversión al endpoint de lotes de Mailchimp (POST https://<dc>.api.mailchimp.com/3.0/batches) con tres operaciones sobre el miembro, identificado por el hash MD5 del email en minúsculas:
| Operación | Qué hace |
|---|---|
PUT /lists/<audience>/members/<hash> |
Agrega a la persona con el estado que elijas, o la actualiza si ya existe. Los miembros existentes conservan su estado. |
POST …/members/<hash>/tags |
Agrega las etiquetas <prefix>-<event> (sale, lead, signup o el nombre de tu evento personalizado) y <prefix>-<short code>. |
POST …/members/<hash>/events |
Registra el evento <prefix>_<event> con short_code, value, currency y order_id como propiedades. |
Usa las etiquetas para crear segmentos —todos los que compraron a través de spring-sale, por ejemplo— y el evento para activar un Customer Journey.
No llega nada: ¿qué debo revisar?
- Mailchimp acepta los lotes de inmediato y los procesa en segundo plano, así que un error en una operación (una dirección no válida o dada de baja anteriormente, por ejemplo) no se nos notifica. Revisa Audience → All contacts y los resultados del lote en la API de Mailchimp si necesitas más detalle.
- Con el doble opt-in, las personas nuevas aparecen como pendientes hasta que hacen clic en el email de confirmación.
- Mailchimp no garantiza el orden de las operaciones en un lote. El miembro siempre se crea con sus etiquetas; para alguien completamente nuevo, el evento de la cronología puede omitirse ocasionalmente.
- Un
401significa que la clave de API es incorrecta o fue revocada; un404en todas las conversiones suele significar que el ID de audiencia es incorrecto.