Todas as coleções
Integrations - Mailchimp
Integrations - Mailchimp
Miguel Giraldo avatar
Escrito por Miguel Giraldo
Atualizado há mais de uma semana

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

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)

* 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

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

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

Respondeu à sua pergunta?