SendGrid conexão
Visão geral overview
O SendGrid é uma plataforma de comunicação com o cliente popular para emails transacionais e de marketing.
Este Adobe Experience Platform destino aproveita o SendGrid Marketing Contacts API para exportar seus perfis de email primários e ativá-los em um novo público do SendGrid para as suas necessidades comerciais.
O SendGrid usa tokens de portador de API como um mecanismo de autenticação para se comunicar com a API SendGrid.
Pré-requisitos prerequisites
Os itens a seguir são necessários antes de você começar a configurar o destino.
-
Você precisa ter uma conta SendGrid.
- Vá para a página inscrição do SendGrid para se registrar e criar uma conta do SendGrid, caso ainda não tenha uma.
-
Depois de fazer logon no portal SendGrid, também é necessário gerar um token de API.
-
Navegue até o site SendGrid e acesse a página Settings > API Keys. Como alternativa, consulte a documentação do SendGrid para acessar a seção apropriada no aplicativo SendGrid.
-
Finalmente, selecione o botão Create API Key.
- Consulte a documentação do SendGrid, se precisar de orientação sobre quais ações executar.
- Se você quiser gerar programaticamente sua Chave de API, consulte a documentação do SendGrid.
Antes de ativar dados para o destino SendGrid, você deve ter um esquema, um conjunto de dados e segmentos criados em Experience Platform. Consulte também a seção limites mais abaixo nesta página.
-
A API SendGrid usada para criar a lista de endereçamento a partir de perfis de email requer que endereços de email exclusivos sejam fornecidos em cada perfil. Isso é diferente se for usado como um valor para email ou email alternativo. Como a conexão SendGrid suporta mapeamentos para valores de email e de email alternativo, verifique se todos os endereços de email usados devem ser exclusivos em cada perfil do Conjunto de Dados. Caso contrário, quando os perfis de email forem enviados para o SendGrid, isso resultará em um erro e esse perfil de email não estará presente na exportação de dados.
-
Atualmente, não há nenhuma funcionalidade em vigor para remover perfis do SendGrid quando eles são removidos dos públicos-alvo no Experience Platform.
Identidades suportadas supported-identities
O SendGrid é compatível com a ativação das identidades descritas na tabela abaixo. Saiba mais sobre identidades.
Observe que SendGrid não oferece suporte a endereços de email com hash; portanto, somente dados de texto sem formatação são enviados para o destino.
Públicos-alvo compatíveis supported-audiences
Esta seção descreve quais tipos de públicos-alvo você pode exportar para esse destino.
Esta categoria inclui todas as origens de público-alvo fora dos públicos-alvo gerados pelo Segmentation Service. Leia sobre as várias origens do público-alvo. Alguns exemplos incluem:
- carregar audiências personalizadas importadas para o Experience Platform de arquivos CSV,
- públicos-alvo semelhantes,
- públicos federados,
- públicos-alvo gerados em outros aplicativos Experience Platform, como Adobe Journey Optimizer,
- e muito mais.
Públicos-alvo compatíveis por tipo de dados de público-alvo:
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.
Casos de uso use-cases
Para ajudá-lo a entender melhor como e quando você deve usar o destino SendGrid, veja a seguir exemplos de casos de uso que Experience Platform clientes podem resolver usando esse destino.
Criar uma lista de marketing para várias atividades de marketing create-marketing-list
As equipes de marketing que usam o SendGrid podem criar uma lista de endereçamento dentro do SendGrid e preenchê-la com endereços de email. A lista de endereçamento agora criada no SendGrid pode ser usada posteriormente para várias atividades de marketing.
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.
Autenticar para o destino authenticate
-
No console Adobe Experience Platform, navegue até Destinos.
-
Selecione a guia Catálogo e procure por SendGrid. Em seguida, selecione Configurar. Depois de estabelecer uma conexão com o destino, o rótulo da interface é alterado para Ativar segmentos.
-
Você verá um assistente que o auxiliará na configuração do destino do SendGrid. Crie o novo destino selecionando Configurar novo destino.
-
Selecione a opção Nova conta e preencha o valor Token do portador. Este valor é a Chave de API do SendGrid mencionada anteriormente na seção de pré-requisitos.
-
Selecione Conectar ao destino. Se a Chave de API do SendGrid fornecida for válida, a interface do usuário exibirá um status Conectado com uma marca de seleção verde, você poderá prosseguir para a próxima etapa para preencher campos de informações adicionais.
Preencher detalhes do destino destination-details
Ao configurar este destino, você deve fornecer as seguintes informações:
- Name: O nome pelo qual você reconhecerá este destino no futuro.
- Description: uma descrição opcional que ajudará você a identificar este destino no futuro.
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 Next.
Ativar públicos-alvo para esse destino activate
- Para ativar dados, você precisa das View Destinations, Activate Destinations, View Profiles e View Segments 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 View Identity Graph permissão de 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.
Consulte as imagens abaixo para obter detalhes específicos desse destino.
-
Selecione um ou mais públicos-alvo para exportar para SendGrid.
-
Na etapa Mapping, após selecionar Add new mapping, você verá a página de mapeamento para mapear os campos XDM de origem para os campos de destino da API SendGrid. As imagens abaixo demonstram como mapear namespaces de identidade entre o Experience Platform e o SendGrid. Certifique-se de que o Source field Email deve ser mapeado para a Target field external_id conforme mostrado abaixo.
-
Da mesma forma, mapeie os Adobe Experience Platform atributos desejados que você deseja exportar para o destino do SendGrid.
-
Após concluir os mapeamentos, selecione Next para avançar para a tela de revisão.
-
Selecione Finish para concluir a instalação.
A lista abrangente de mapeamentos de atributos suportados que podem ser configurados para a API de Contatos de Marketing do SendGrid > Adicionar ou Atualizar Contato está abaixo.
homeAddress.street1
address_line_1
100 caracteres
homeAddress.street2
address_line_2
100 caracteres
_extconndev.alternate_emails
alternate_emails
- Máximo: 5 itens
- Mín: 0 itens
homeAddress.city
city
60 caracteres
homeAddress.country
país
50 caracteres
external_id
254 caracteres
person.name.firstName
first_name
50 caracteres
person.name.lastName
last_name
50 caracteres
homeAddress.postalCode
postal_code
homeAddress.stateProvince
state_Province_region
50 caracteres
Validar a exportação de dados no SendGrid validate
Para validar se você configurou o destino corretamente, siga as etapas abaixo:
-
Selecione Destinations > Browse para navegar até a lista de destinos.
-
Selecione o destino e valide se o status é enabled.
-
Alterne para a guia Activation data e selecione um nome de público-alvo.
-
Monitore o resumo do público-alvo e verifique se a contagem de perfis corresponde à contagem criada no conjunto de dados.
-
A Lista de Marketing do SendGrid > Criar API de Lista cria listas de contatos exclusivas dentro do SendGrid unindo o valor do atributo list_name e o carimbo de data/hora da exportação de dados. Navegue até o site SendGrid e verifique se a nova lista de contatos em conformidade com o padrão de nome foi criada.
-
Selecione a lista de contatos recém-criada e verifique se o novo registro de email do conjunto de dados criado está sendo preenchido na nova lista de contatos.
-
Além disso, verifique alguns emails para validar se o mapeamento de campo está correto.
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.
Recursos adicionais additional-resources
Esse destino do SendGrid aproveita as APIs abaixo:
Limites limits
- Os Contatos de Marketing do SendGrid > Adicionar ou Atualizar API de Contato podem aceitar 30.000 contatos ou 6 MB de dados, o que for menor.