Visão geral da extensão de encaminhamento de eventos do Mailchimp
O Mailchimp encaminhamento de eventos A extensão envia eventos para a API de marketing do Mailchimp que podem acionar emails para campanhas de marketing, jornadas ou transações do Mailchimp.
Este documento aborda como definir a extensão e configurar regras usando a ação Adicionar evento.
Pré-requisitos
Este documento supõe que você esteja familiarizado com os produtos Mailchimp relevantes aproveitados pela extensão. Para obter mais informações, consulte a documentação de ajuda do Mailchimp para campanhas, jornadas, e transações.
Uma conta do Mailchimp é necessária para usar esta extensão. Você pode se inscrever para uma conta aqui. No painel de contas do Mailchimp, anote os seguintes valores para uso neste guia:
- Seu prefixo de domínio do Mailchimp
- Sua chave de API
- A ID do público-alvo
- O endereço de email padrão "de"
Dependendo do seu plano de conta do Mailchimp, você pode ter acesso limitado às ferramentas de Jornada ao cliente do Mailchimp.
Prefixo do domínio
Depois de fazer logon no Mailchimp e acessar a exibição do Painel, a barra de endereços do navegador deve exibir um URL como https://us11.admin.mailchimp.com
ou apenas us11.admin.mailchimp.com
. Neste exemplo, o prefixo us11
é apenas um espaço reservado e seu valor será diferente. Registre seu URL com seu prefixo para uma etapa posterior.
Chave de API
Para localizar a chave de API da sua conta, selecione o ícone do perfil na interface do usuário do Mailchimp e, em seguida, selecione Perfil. Você deve ver um URL como https://us11.admin.mailchimp.com/account/profile/
mas com seu prefixo em vez de us11
.
Selecionar Extras, depois Chaves de API:
Em Suas chaves de API, você pode escolher uma chave existente ou selecionar Criar Uma Chave para criar um novo. Você pode criar uma nova chave para usar especificamente com essa extensão. Copie a chave de API e salve-a para uma etapa posterior. Para obter mais detalhes, consulte a documentação do Mailchimp sobre como gerar sua chave de API.
ID de público-alvo e endereço do remetente
Selecionar Público na navegação à esquerda, Painel de público-alvo. Em seguida, selecione o público-alvo que deseja usar com essa extensão. Para saber mais, consulte o documento Mailchimp em criação de um público.
Com seu público criado e selecionado, selecione Gerenciar público-alvo selecione Configurações. Esta tela mostra várias configurações para o seu público-alvo.
Na parte inferior da tela Configurações, você deverá ver Unique id for audience [audience name]
onde [audience name]
é o nome do público-alvo real. Copie a ID de público-alvo e salve-a para uma etapa posterior.
Selecionar Nome e padrões do público-alvo e confirmar que Padrão do endereço de email tem o valor correto para suas campanhas. Observe que a ID de público-alvo também está listada na parte superior desta página e tem o mesmo valor copiado na última etapa.
Automações do Mailchimp
Dependendo do seu plano do Mailchimp e se você usa emails transacionais, Jornadas do cliente ou outras automações do Mailchimp, suas configurações específicas de jornada podem variar.
Instalação e configuração
Esta seção lista as etapas para instalar e configurar a extensão. Para salvar com segurança a chave de API do Mailchimp, você deve usar o encaminhamento de eventos segredos.
Criar um segredo e um elemento de dados
Em uma propriedade de encaminhamento de eventos, criar um Token segredo chamado Mailchimp API Key
.
Em seguida, criar um elemento de dados usando o Núcleo extensão e um Segredo tipo de elemento de dados para fazer referência ao Mailchimp API Key
segredo que acabou de criar. Enter Mailchimp Token
como o nome do elemento de dados.
Instalar e configurar a extensão
Na mesma propriedade de encaminhamento de eventos, selecione Extensões, depois Catálogo para exibir as extensões disponíveis para instalação. Aqui, pesquise a extensão Mailchimp e selecione Instalar.
A tela de configuração é exibida. Em Nome de Domínio de Prefixo do Servidor Mailchimp, insira o domínio que você copiou anteriormente da sua conta do Mailchimp, incluindo o prefixo de domínio exclusivo.
http://
ou https://
neste campo.
Em Token do Mailchimp, selecione o ícone de elemento de dados e escolha o Mailchimp Token
elemento de dados criado anteriormente. Selecionar Salvar para salvar as alterações.
A extensão agora está instalada e configurada para uso na propriedade.
Coleção de dados
Ao usar essa extensão em uma regra, há vários valores de dados que a extensão envia para o Mailchimp com cada evento. Para uma implementação típica, é possível configurar o Extensão SDK da Web do Adobe Experience Platform para enviar esses dados ao Platform Edge Network para uso pela extensão na propriedade de encaminhamento de eventos.
Os dados necessários para essa extensão podem ser enviados do SDK da Web como dados XDM (usando o xdm
objeto) ou dados não XDM (usando o método data
objeto).
Por exemplo, se um cliente fizer uma compra ou se registrar para um evento em seu site, você poderá enviar um email de confirmação por meio do Mailchimp com essa extensão. Depois de enviar as informações necessárias do SDK da Web para a Rede de borda, a extensão acionará o email com o Mailchimp.
Elementos de dados
A captura de tela na seção anterior mostra os dados que você pode enviar com cada evento desta extensão para o Mailchimp. Depois de configurar o SDK da Web para enviar esses dados para a Rede de borda, você pode criar elementos de dados na propriedade de encaminhamento de eventos para que a extensão possa acessar esses valores.
A tabela abaixo fornece mais detalhes para cada valor possível.
email
arc.event.xdm._tenant.emailId
ou
arc.event.data._tenant.emailId
listId
arc.event.xdm._tenant.listId
ou
arc.event.data._tenant.listid
name
arc.event.xdm._tenant.name
ou
arc.event.data._tenant.name
properties
arc.event.xdm._tenant.properties
ou
arc.event.data._tenant.properties
isSyncing
arc.event.xdm._tenant.isSyncing
ou
arc.event.data._tenant.isSyncing
is_syncing
definir como true
não automações de acionadoroccurredAt
arc.event.xdm._tenant.occuredAt
ou
arc.event.data._tenant.occuredAt
Na propriedade de encaminhamento de eventos, você pode criar um elemento de dados para cada um dos campos descritos acima. Depois de criado, você pode fazer referência aos elementos de dados na Adicionar evento ação dessa extensão.
Agora você pode usar essa extensão e a ação Adicionar evento para acionar emails do Mailchimp para seus públicos.
Validação de dados
Ao trabalhar com extensões de encaminhamento de eventos, a variável Adobe Experience Platform Debugger é muito útil. Na seção Logs, em Logs de borda, você pode ver as solicitações feitas pelas regras de encaminhamento de eventos depois que elas são acionadas. As capturas de tela a seguir mostram uma solicitação que está sendo feita à API do Mailchimp pela extensão.
No painel do Mailchimp, na exibição Feed de atividades do seu Público ou Membro de público, uma lista de eventos é fornecida para esse Público ou Membro de público. Ele deve corresponder aos eventos enviados pela extensão e mostrar todos os dados opcionais enviados, juntamente com o email ou a campanha recebida. Consulte a Guias de ajuda do Mailchimp Automation para obter mais detalhes.