Desde platform es posible enviar la metadata mediante API hacia la cuenta de Mailchimp con el fin de realizar segmentación de contenidos y enviar en este caso correos masivos a determinado grupo de personas, la data entregada es la correspondiente al módulo Customers>Customers, por tal razón, los campos de registro deben coincidir con la metadata solicitada durante la configuración.
Cómo integrar mailchimp en platform:
1- Dirigirse al módulo Settings>Integrations, la integración debe estar activa comercialmente, en el módulo se verá de la siguiente forma:
Platform requiere para su activación la siguiente información desde la cuenta de Mailchimp:
Token (API key)
Server Prefix
List ID
2- Los datos se obtienen desde la cuenta mailchimp del usuario de la siguiente manera:
Token: Dirigirse al perfil del usuario y desplegar el menú Extras, allí se encuentra la sección Api Key (Claves de usuario)
Una vez dentro de la sección, y si no se tiene una api key previamente creada, se hace click en la opción Crear una clave, esto abre de inmediato una interfaz en donde se solicita el nombre de la clave, basta con escribir el nombre deseado e indicar Generar Clave
La pantalla que viene a continuación, solo estará visible una sola vez por consiguiente la clave entregada debe ser copiada y guardada de inmediato, ya que se bloquea totalmente
Una vez se copia la clave, asignarla de inmediato al apartado Token en platform.
Server Prefix: este se obtiene desde el mismo token, y equivale a los 4 últimos caracteres después del guión o, a las 4 primeros caracteres que se ven desde el navegador en la web de mailchimp
List ID: este se obtiene desde el apartado Audiencia>Todos los contactos, generalmente la interfaz estará vacía, pero esto ya hace parte de la integración requerida y de la segmentación que se desea hacer, dentro de la interfaz, debemos dirigirnos a Settings (Configuración) y allí ingresar a la primera opción Nombre de la audiencia y valores predeterminados:
Al ingresar, se mostrará el Audience ID, único por cuenta
Con la data de mailchimp lista, solo debemos activar la integración y guardar los cambios del módulo.
Ya con mailchimp activo se debe activar el webhook correspondiente seleccionando los módulos que se requiera segmentar, por defecto los datos de customer y purchase
La configuración de la segmentación dentro de la cuenta de mailchimp corresponde directamente al cliente y sus necesidades.
Mapeo de datos entre Mediastream Platform y Mailchimp
En este apartado se explica la manera en que Mediastream Platform mapea los datos de sus modelos para que coincidan con el modelo de datos requerido desde mailchimp para un correcto registro.
Members
Corresponde a lo que en platform sería la colección de Customers, acá se añaden o actualizan los miembros de la audiencia.
Punto de Api:
/lists/${audienceId}/members/${customer.email}
Mailchimp Field | Platform Customer Field |
email_address | |
status_if_new | “subscribed” |
status | “subscribed” |
merge_fields.BIRTHDAY | birthday (en formato mm / dd) |
merge_fields.FNAME | first_name |
merge_fields.LNAME | last_name |
merge_fields.GENDER | gender |
merge_fields.PHONE | phone |
merge_fields.STATUS | status |
merge_fields.DATE_C | date_created |
merge_fields.PAYMENT_C | payment_count |
merge_fields.PURCHASE_C | purchase_count |
merge_fields.ADDRESS_1 | address_line1 |
merge_fields.ADDRESS_2 | address_line2 |
merge_fields.CITY | address_city |
merge_fields.STATE | address_state |
merge_fields.COUNTRY | address_country |
tags | address_country (lowercase) |
* Los valores que están entre comillas no corresponden a un dato sino a un string.
Store
Esta colección permite agregar o actualizar clientes en mailchimp. La store de cada cliente corresponde al siguiente id, mediastream-store-{cuenta-platform} esta se crea al momento de conectar Mediastream Platform con Mailchimp y en ella se insertan registros con la siguiente estructura:
Punto de Api:
/ecommerce/stores/mediastream-store-${account_id}/customers/${customer.id}
Mailchimp Field | Platform Customer Field |
id | _id |
email_address | |
opt_in_status | false |
first_name | birthday (en formato mm / dd) |
last_name | first_name |
address.address1 | address_line1 |
address.address2 | address_line2 |
address.city | address_city |
address.province | address_state |
address.country | address_country |
Products
En esta colección se almacenan los productos para segmentar en mailchimp, importante considerar que los productos se actualizan sobre la store mencionada anteriormente. Lo que hacemos para actualizar o crear es que en cada purchase que se realiza obtenemos la metadata necesaria para hacer el update. Siendo así tenemos:
Punto de Api:
/ecommerce/stores/mediastream-store-${purchase.account}/products
Mailchimp Field | Platform Purchase Field |
id | product.id |
title | product_name |
type | type |
variants | [{ id: product_id, title: product_name }] |
Orders
Acá se gestionan todas las operaciones que se realizan a nivel de compras, el mapeo se hace con la colección purchases de Platform.
Punto de Api:
/ecommerce/stores/mediastream-store-${purchase.account}/orders
Mailchimp Field | Platform Purchase Field |
id | _id |
order_total | product_name |
currency_code | type |
customer | [{ id: product_id, title: product_name }] |
lines | [{ product_variant_id: product_id, product_id: product.id, id: _id, price: amount, quantity: 1 }] |
billing_address.country | metadata.origin_country_name |
billing_address.country_code | metadata.origin_country |
Si tienes alguna pregunta relacionada por favor no dudes en escribirnos a través del chat.
Atte. El Equipo de Mediastream