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.

IMPORTANT
Se você gerar a chave de API, anote-a, pois não será possível acessá-la após a geração.

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.

Identidade de destino
Descrição
Considerações
Email
Endereço de email do contato
Obrigatório

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.

Item
Tipo
Notas
Tipo de exportação
Baseado em perfil
  • 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.
Frequência de exportação
Streaming
Os destinos de transmissão são conexões baseadas em API "sempre ativas". Quando um perfil é atualizado em Experience Platform com base na avaliação do público-alvo, o conector envia a atualização downstream para a plataforma de destino. Leia mais sobre destinos de streaming.

Conectar ao destino connect

IMPORTANT
Para se conectar ao destino, você precisa de Exibir Destinos e Gerenciar Destinos 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 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.

Campo
Descrição
Nome de usuário
Seu nome de usuário Mailchimp Interest Categories.
Password
Sua Mailchimp chave de API, que você anotou na seção Coletar Mailchimp credenciais.
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.

Captura de tela da interface do usuário da plataforma mostrando como autenticar.

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.

Captura de tela da Interface do Usuário da Plataforma mostrando os detalhes de destino.

Campo
Descrição
Nome
Um nome pelo qual você reconhecerá este destino no futuro.
Descrição
Uma descrição que ajudará você a identificar esse destino no futuro.
Data center
Sua conta data center do Mailchimp. Consulte a seção Identificar Mailchimp data center para obter qualquer orientação.
Nome do público-alvo (Selecione primeiro o data center)
Após selecionar o Data center, essa lista suspensa é preenchida automaticamente com os nomes de público-alvo da sua conta do Mailchimp. Selecione o público que deseja atualizar com os dados da Platform.
Categoria de interesse (Selecione primeiro o Centro de dados e o Nome do público-alvo)
Após selecionar o Nome do Público-Alvo, esta lista suspensa é preenchida automaticamente com os nomes de categorias do grupo de interesse da sua conta Mailchimp. Selecione o nome da categoria que você deseja atualizar com os dados da Platform.
TIP
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 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

IMPORTANT

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:

  1. Na etapa Mapeamento, selecione Adicionar novo mapeamento. Agora você pode ver uma nova linha de mapeamento na tela.

  2. 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.

  3. 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 como merge field no público-alvo de Mailchimp. A Mailchimp documentação define as chaves necessárias como addr1, city, state e zip, e as chaves opcionais addr2 e country. Os valores desses campos devem ser cadeias de caracteres. Se qualquer um dos mapeamentos de campo ADDRESS estiver presente, o destino transmitirá o objeto ADDRESS para a API Mailchimp para atualização. Qualquer campo ADDRESS que não esteja mapeado tem seu valor padrão de NULL, exceto para o país que tem o valor padrão de US.

    Os mapeamentos disponíveis para o campo ADDRESS sã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.street1 Attribute: ADDRESS.addr1
    xdm: workAddress.street2 Attribute: ADDRESS.addr2
    xdm: workAddress.city Attribute: ADDRESS.city
    xdm: workAddress.state Attribute: ADDRESS.state
    xdm: workAddress.postalCode Attribute: ADDRESS.zip
    xdm: workAddress.country Attribute: ADDRESS.country

    Por exemplo, você deseja atualizar o valor de country com os valores do campo de endereço existente do contato addr1, city, state e zip como 132, My Street, Kingston, New York, New York e 12401. Para atualizar o country você 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 ser 132, My Street, Kingston, New York, New York, 12401 e US. Em outras palavras, se você passar apenas country e não fornecer valores para addr1, city, state e zip eles serão substituídos por NULL.

    Um exemplo com os mapeamentos concluídos é mostrado abaixo:
    Exemplo de captura de tela da interface do usuário da plataforma mostrando mapeamentos de campo.

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.

Captura de tela da interface do usuário do Mailchimp mostrando a página Grupo de público-alvo.

  • 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.

Captura de tela da interface do usuário do Mailchimp mostrando as categorias do grupo de público-alvo.

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).

Captura de tela da interface do usuário da Platform mostrando erro se os valores da chave da API do Mailchimp ou do data center estiverem incorretos.

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:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6