Mailchimp Interest Categories conexão
Mailchimp é uma plataforma de automação de marketing popular e um serviço de marketing por email usado pelas empresas para gerenciar e conversar com os contatos (clientes, clientes ou outros interessados) usando listas de endereçamento e campanhas de marketing por email. Use esse conector para classificar seus contatos com base em seus interesses e preferências.
Mailchimp Interest Categories usa públicos-alvo, grupos e categorias de interesse (também conhecidos como nomes de grupos ou títulos de grupos). Cada grupo Mailchimp é uma lista de categorias de interesse. Os contatos são associados a uma categoria de interesse quando assinam uma ou mais categorias de interesse por meio de um formulário de inscrição em seu site. Em um público-alvo, você também pode organizar os contatos em grupos e associá-los a categorias de interesse, que podem ser usadas para criar segmentos. Você pode usar esses públicos para transmitir emails de campanha direcionados aos contatos inscritos.
Este Adobe Experience Platform destino usa a API Mailchimp batch subscribe or unsubscribe API para criar categorias de interesse e, em seguida, adicionar contatos de cada um dos públicos-alvo selecionados da Platform a uma categoria de interesse correspondente. Você pode adicionar novos contatos ou atualizar as informações de Mailchimp contatos existentes e adicioná-los ou removê-los de seus grupos desejados em um público-alvo existente do Mailchimp depois de ativá-los em um novo segmento. Mailchimp Interest Groups usa os nomes de público selecionados da Platform como categorias de interesse em Mailchimp.
Casos de uso use-cases
Para ajudá-lo a entender melhor como e quando você deve usar o destino Mailchimp Interest Categories, veja um exemplo de caso de uso que os clientes da Adobe Experience Platform podem resolver usando esse destino.
Enviar emails para contatos de campanhas de marketing use-case-send-emails
O departamento de vendas de um site de artigos esportivos quer transmitir uma campanha de marketing por email para uma lista de contatos que se identificaram como interessados em futebol. As listas de contatos são segregadas como lotes na exportação de dados recebida da equipe de desenvolvimento do site e, portanto, precisam ser rastreadas. A equipe identifica um público-alvo Mailchimp existente e começa a criar os públicos-alvo do Experience Platform aos quais os contatos de cada lista são adicionados. Depois de enviar esses públicos-alvo para Mailchimp Interest Categories, se algum contato não existir no público-alvo Mailchimp selecionado, ele será adicionado a um grupo com o nome de público ao qual o contato pertence. Se já existirem contatos no público ou grupo Mailchimp, suas informações serão atualizadas. Depois que os dados forem enviados para Mailchimp Interest Categories, a equipe de Vendas poderá selecionar e enviar o email da campanha de marketing para o grupo de interesse de futebol dentro do público Mailchimp.
Pré-requisitos prerequisites
Consulte as seções abaixo para quaisquer pré-requisitos que você precise configurar no Experience Platform e Mailchimp e para obter informações que você deve coletar antes de trabalhar com o destino Mailchimp Interest Categories.
Pré-requisitos no Experience Platform prerequisites-in-experience-platform
Antes de ativar dados para o destino Mailchimp Interest Categories, você deve ter um esquema, um conjunto de dados e segmentos criados em Experience Platform.
Pré-requisitos para o destino Mailchimp Interest Categories prerequisites-destination
Observe os seguintes pré-requisitos para exportar dados da Platform para sua conta do Mailchimp:
Você deve ter uma conta Mailchimp prerequisites-account
Antes de criar um destino Mailchimp Interest Categories, primeiro verifique se você tem uma conta Mailchimp. Se você ainda não tiver uma, visite a Mailchimp página de inscrição para se registrar e criar sua conta.
Coletar a chave de API Mailchimp gather-credentials
Você precisa da sua Mailchimp chave de API para autenticar o destino Mailchimp Interest Categories em relação à sua conta Mailchimp. A chave de API serve como senha quando você autentica o destino.
Se você não tiver a Chave de API, entre na sua conta e consulte a documentação Mailchimp Gerar sua Chave de API para criar uma.
Um exemplo de uma chave de API é 0123456789abcdef0123456789abcde-us14.
Identificar o data center do Mailchimp identify-data-center
Em seguida, você deve identificar seu data center do Mailchimp. Para fazer isso, faça logon na sua conta do Mailchimp e navegue até a seção de chaves de API da sua conta.
O valor é a primeira parte do URL que você vê no navegador. Se a URL for https://us14.mailchimp.com/account/api/, o data center será us14.
Ele também está anexado à sua chave de API no formato key-dc; se a sua chave de API for 0123456789abcdef0123456789abcde-us14, o data center será us14.
Anote o valor do data center (us14 neste exemplo). Esse valor é necessário ao preencher os detalhes de destino.
Se você precisar de mais orientação, consulte a Mailchimp documentação sobre fundamentos.
Medidas de proteção guardrails
Cada público-alvo do Mailchimp pode conter até 60 nomes de grupo (ou categorias de interesse) em um único grupo ou em vários grupos do mesmo público-alvo. Consulte Mailchimp grupos para obter os esclarecimentos necessários. Ao atingir esse limite, você recebe uma mensagem 400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories) como resposta de erro da API Mailchimp.
Além disso, consulte os Mailchimp limites de taxa para obter informações detalhadas sobre os limites impostos pela API Mailchimp.
Identidades suportadas supported-identities
Mailchimp dá suporte à ativação das identidades descritas na tabela abaixo. Saiba mais sobre identidades.
Tipo e frequência de exportação export-type-frequency
Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.
- Você está exportando todos os membros de um segmento, juntamente com os campos de esquema desejados (por exemplo: endereço de email, número de telefone, sobrenome), de acordo com o mapeamento de campos.
- Para cada público selecionado na Platform, o status de segmento Mailchimp Interest Categories correspondente é atualizado com seu status de público da Platform.
Conectar ao destino connect
Para se conectar a este destino, siga as etapas descritas no tutorial de configuração de destino. No workflow de configuração de destino, preencha os campos listados nas duas seções abaixo.
Em Destinos > Catálogo, procure por Mailchimp Interest Categories. Como alternativa, você pode localizá-lo na categoria Email marketing.
Autenticar para o destino authenticate
Para autenticar no destino, preencha os campos obrigatórios abaixo e selecione Conectar ao destino.
Sua chave de API assume a forma de
{KEY}-{DC}, em que a parte {KEY} se refere ao valor anotado na seção Mailchimp chave de API e a parte {DC} se refere ao Mailchimp data center.Você pode fornecer a parte
{KEY} ou todo o formulário.Por exemplo, se a sua chave de API for
0123456789abcdef0123456789abcde-us14,você pode fornecer *
0123456789abcdef0123456789abcde*ou *0123456789abcdef0123456789abcde-us14*como o valor.
Se os detalhes fornecidos forem válidos, a interface exibirá um status Conectado com uma marca de seleção verde. Você pode prosseguir para a próxima etapa.
Preencher detalhes do destino destination-details
Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.
data center do Mailchimp. Consulte a seção Identificar Mailchimp data center para obter qualquer orientação.No options are available. Please verify the values selected for the following dependent fields: dataCenter, conforme mostrado abaixo. Nesse caso, você não poderá selecionar um valor do campo Nome do público-alvo (selecione primeiro o data center). Para corrigir esse erro, forneça os valores corretos.Ativar alertas enable-alerts
Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados para o seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o manual sobre assinatura de alertas de destinos usando a interface.
Quando terminar de fornecer detalhes da conexão de destino, selecione Avançar.
Ativar públicos-alvo para esse destino activate
- Para ativar dados, você precisa de Exibir Destinos, Ativar Destinos, Exibir Perfis e Exibir Segmentos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.
- Para exportar identidades, você precisa da permissão Exibir Gráfico de Identidade controle de acesso.
Leia Ativar perfis e públicos-alvo para destinos de exportação de público-alvo de streaming para obter instruções sobre como ativar públicos-alvo para este destino.
Considerações e exemplo de mapeamento mapping-considerations-example
Para enviar corretamente seus dados de público-alvo do Adobe Experience Platform para o destino Mailchimp Interest Categories, passe pela etapa de mapeamento de campos. O mapeamento consiste em criar um link entre os campos do esquema do Experience Data Model (XDM) na sua conta da Platform e seus equivalentes correspondentes no destino.
Para mapear corretamente os campos XDM para os campos de destino Mailchimp Interest Categories, siga as etapas abaixo:
-
Na etapa Mapeamento, selecione Adicionar novo mapeamento. Agora você pode ver uma nova linha de mapeamento na tela.
-
Na janela Selecionar campo de origem, escolha a categoria Selecionar atributos e selecione o atributo XDM ou escolha o Selecionar namespace de identidade e selecione uma identidade.
-
Na janela Selecionar campo de destino, escolha o Selecionar namespace de identidade e selecione uma identidade ou escolha a categoria Selecionar atributos e selecione na lista de atributos preenchida na API Mailchimp. Quaisquer atributos personalizados adicionados ao Público-alvo Mailchimp selecionado também estarão disponíveis para seleção como campos de destino.
Os mapeamentos disponíveis entre seu esquema de perfil XDM e Mailchimp Interest Categories são os seguintes:
| Campo do Source | Campo de destino | Notas |
| — | — | — |IdentityMap: Email|Identity: email| Obrigatório: Sim |xdm: person.name.firstName|Attribute: FNAME| |xdm: person.name.lastName|Attribute: LNAME| |
|xdm: person.birthDayAndMonth|Attribute: BIRTHDAY| |Além disso,
ADDRESSé um campo de destino especial conhecido comomerge fieldno público-alvo de Mailchimp. A Mailchimp documentação define as chaves necessárias comoaddr1,city,stateezip, e as chaves opcionaisaddr2ecountry. Os valores desses campos devem ser cadeias de caracteres. Se qualquer um dos mapeamentos de campoADDRESSestiver presente, o destino transmitirá o objetoADDRESSpara a API Mailchimp para atualização. Qualquer campoADDRESSque não esteja mapeado tem seu valor padrão deNULL, exceto para o país que tem o valor padrão deUS.Os mapeamentos disponíveis para o campo
ADDRESSsão os seguintes:table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 Campo de origem Campo de público alvo xdm: workAddress.street1Attribute: ADDRESS.addr1xdm: workAddress.street2Attribute: ADDRESS.addr2xdm: workAddress.cityAttribute: ADDRESS.cityxdm: workAddress.stateAttribute: ADDRESS.statexdm: workAddress.postalCodeAttribute: ADDRESS.zipxdm: workAddress.countryAttribute: ADDRESS.countryPor exemplo, você deseja atualizar o valor de
countrycom os valores do campo de endereço existente do contatoaddr1,city,stateezipcomo132, My Street, Kingston,New York,New Yorke12401. Para atualizar ocountryvocê deve passar os valores existentes com alterações (se houver) e o novo valor para o país. Portanto, os valores no seu conjunto de dados devem ser132, My Street, Kingston,New York,New York,12401eUS. Em outras palavras, se você passar apenascountrye não fornecer valores paraaddr1,city,stateezipeles serão substituídos porNULL.Um exemplo com os mapeamentos concluídos é mostrado abaixo:
Quando terminar de fornecer os mapeamentos para sua conexão de destino, selecione Avançar.
Validar exportação de dados exported-data
Para validar se você configurou o destino corretamente, siga as etapas abaixo:
- Faça logon em sua conta do Mailchimp. Navegue até a página Audience. Em seguida, expanda o menu Manage Contacts e selecione Groups.
- Selecione o Grupo e verifique se os públicos-alvo selecionados são criados como categorias com o nome do público-alvo da Platform, que pode ser seguido por um sufixo gerado automaticamente.
- Este destino usa os nomes dos segmentos selecionados para criar a categoria de interesse usando a Mailchimp API Adicionar categoria de interesse. Se você criar um novo destino e ativar os mesmos públicos novamente, o Mailchimp adicionará um sufixo para distinguir entre os segmentos existentes e os novos.
- Contatos cujos emails não existiam no grupo são adicionados à categoria recém-criada.
- Para contatos que já existem no grupo, os dados do campo de atributo são atualizados e o contato é adicionado à categoria recém-criada.
Uso e governança de dados data-usage-governance
Todos os destinos do Adobe Experience Platform são compatíveis com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como o Adobe Experience Platform impõe a governança de dados, consulte a visão geral da Governança de Dados.
Erros e solução de problemas errors-and-troubleshooting
Erro encontrado se os valores de Mailchimp da chave de API ou do data center estiverem incorretos incorrect-credentials-error
Se a chave de API fornecida no campo Senha ou o valor de Data center estiver incorreto, a interface exibirá uma resposta de erro de API Mailchimp: No options are available. Please verify the values selected for the following dependent fields: dataCenter, conforme mostrado abaixo. Nesse caso, você não pode selecionar um valor do campo Nome do público-alvo (selecione primeiro o data center).
Para corrigir esse erro e prosseguir para a próxima etapa, você deve fornecer os valores corretos. Consulte o Identify Mailchimp data center e
Colete Mailchimp a chave de API seções se precisar de orientação.
Erro encontrado se o limite de nome de grupo Mailchimp for excedido group-name-limits-error
Ao criar o destino, você poderá receber as seguintes mensagens de erro: Cannot have more than 60 interests per list (Across all categories) ou 400 BAD_REQUEST. Isso acontece quando você excede os 60 nomes de grupo (ou categorias de interesse) em um único grupo ou em vários grupos dentro do mesmo limite de público, conforme descrito na seção medidas de proteção. Para corrigir esse erro, verifique se você não está excedendo o limite de nomes de grupo em Mailchimp.
Mailchimp Códigos de status e erro
Consulte a Mailchimp página de erros para obter uma lista abrangente do status e dos códigos de erro com explicações.
Recursos adicionais additional-resources
Informações adicionais úteis da documentação do Mailchimp estão abaixo: