A partir da plataforma, é possível enviar metadados via API para a conta do Mailchimp, a fim de segmentar conteúdos e enviar, neste caso, e-mails em massa para um grupo específico de pessoas. Os dados fornecidos correspondem ao módulo Clientes > Clientes; por esse motivo, os campos de registro devem coincidir com os metadados solicitados durante a configuração.
Como integrar o Mailchimp na plataforma
1- Acesse o módulo Settings>Integrations. A integração deve estar ativa comercialmente e no módulo será exibida da seguinte forma.
Platform requer as seguintes informações da conta do Mailchimp para sua ativação:
Token (API key)
Server Prefix
List ID
2- Os dados são obtidos da conta do Mailchimp do usuário da seguinte maneira::
Token: Acesse o perfil do usuário e abra o menu 'Extras', lá você encontrará a seção Chaves de API
Depois de entrar na seção e caso não tenha uma chave de API criada previamente, clique na opção Crie uma chave. Isso abrirá imediatamente uma interface onde será solicitado o nome da chave. Basta digitar o nome desejado e indicar Gerar Chave.
A tela seguinte estará visível apenas uma vez; portanto, a chave fornecida deve ser copiada e salva imediatamente, pois ela é bloqueada completamente
Depois de copiar a chave, atribua-a imediatamente à seção de Token na plataforma
Server Prefix: Este é obtido do próprio token e equivale aos 4 últimos caracteres depois do traço ou aos 4 primeiros caracteres vistos no navegador na página da web do Mailchimp.
List ID: Isso é obtido na seção Público > Todos os contatos. Geralmente, a interface estará vazia, mas isso faz parte da integração necessária e da segmentação desejada. Dentro da interface, devemos ir para Configurações e, em seguida, acessar a primeira opção Nome e padrões do público.:
Ao entrar, será exibido o ID do público, único para cada conta
Com os dados do Mailchimp prontos, só precisamos ativar a integração e salvar as alterações no módulo.
Com o Mailchimp ativo, é necessário ativar o webhook correspondente selecionando os módulos que você deseja segmentar, por padrão os dados de cliente e compra.
A configuração da segmentação dentro da conta do Mailchimp é diretamente relacionada ao cliente e suas necessidades específicas
Mapeamento de dados entre Mediastream Platform e Mailchimp.
Esta seção explica como o Mediastream Platform mapeia os dados de seus modelos para que correspondam ao modelo de dados necessário do Mailchimp para um registro correto.
Members
Corresponde ao que na plataforma seria a coleção de Customers. Aqui são adicionados ou atualizados os membros da audiência.
Ponto 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) |
* Os valores entre aspas não correspondem a um dado, mas a uma cadeia de caracteres (string).
Store
Esta coleção permite adicionar ou atualizar clientes no Mailchimp. A loja de cada cliente corresponde ao seguinte ID: mediastream-store-{conta-da-platform}. Isso é criado ao conectar o Mediastream Platform ao Mailchimp e nela são inseridos registros com a seguinte estrutura::
Ponto 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
Esta coleção armazena os produtos para segmentação no Mailchimp, sendo importante considerar que os produtos são atualizados na loja mencionada anteriormente. Para atualizar ou criar, coletamos os metadados necessários em cada compra realizada. Dessa forma, temos:
Ponto 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
Aqui são gerenciadas todas as operações realizadas em termos de compras, e o mapeamento é feito com a coleção de compras da 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 |
Se você tiver alguma pergunta relacionada, por favor, não hesite em nos contatar através do chat.
Atte. Equipe da Mediastream