Integrations - Mailchimp
Miguel Giraldo avatar
Escrito por Miguel Giraldo
Actualizado hace más de una semana

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

email

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

email

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

¿Ha quedado contestada tu pregunta?