HubSpot conexão
HubSpot é uma plataforma de CRM com todos os softwares, integrações e recursos necessários para conectar marketing, vendas, gerenciamento de conteúdo e atendimento ao cliente. Ele permite conectar seus dados, equipes e clientes em uma plataforma de CRM.
Este Adobe Experience Platform destino aproveita a HubSpot API de Contatos para atualizar contatos em HubSpot de um público-alvo Experience Platform existente após a ativação.
As instruções para autenticar na sua instância do HubSpot estão mais abaixo, na seção Autenticar no destino.
Casos de uso use-cases
Para ajudá-lo a entender melhor como e quando você deve usar o destino HubSpot, veja um exemplo de caso de uso que os clientes da Adobe Experience Platform podem resolver usando esse destino.
Os contatos do HubSpot armazenam informações sobre as pessoas físicas que interagem com sua empresa. Sua equipe usa os contatos existentes no HubSpot para criar os públicos-alvo do Experience Platform. Após enviar esses públicos-alvo para HubSpot, suas informações são atualizadas e cada contato recebe uma propriedade com seu valor como o nome do público-alvo que indica a qual público-alvo o contato pertence.
Pré-requisitos prerequisites
Consulte as seções abaixo para quaisquer pré-requisitos que você precise configurar no Experience Platform e HubSpot e para obter informações que você deve coletar antes de trabalhar com o destino HubSpot.
Pré-requisitos do Experience Platform prerequisites-in-experience-platform
Antes de ativar dados para o destino HubSpot, você deve ter um esquema, um conjunto de dados e públicos-alvo criados em Experience Platform.
Consulte a documentação do Experience Platform para Grupo de campos do esquema de Detalhes da associação do público-alvo se precisar de orientação sobre os status do público-alvo.
Pré-requisitos para o destino HubSpot prerequisites-destination
Observe os seguintes pré-requisitos para exportar dados da Platform para sua conta do HubSpot:
Você deve ter uma conta HubSpot prerequisites-account
Para exportar dados da Platform para sua conta Hubspot, é necessário ter uma conta HubSpot. Se você ainda não tiver uma, visite a página Configurar sua conta HubSpot e siga as orientações para registrar e criar sua conta.
Colete o token de acesso do aplicativo privado HubSpot gather-credentials
Você precisa do HubSpot Access token
para permitir que o destino HubSpot faça chamadas de API por meio do aplicativo privado HubSpot na sua conta HubSpot. O Access token
serve como Bearer token
quando você autentica o destino.
Se você não tiver um aplicativo privado, siga a documentação para Criar um aplicativo privado HubSpot.
crm.objects.contacts.write
, crm.objects.contacts.read
crm.schemas.contacts.write
, crm.schemas.contacts.read
Bearer token
Access token
do seu aplicativo privado HubSpot.Para obter o HubSpot
Access token
, siga a documentação do HubSpot para fazer chamadas de API com o token de acesso do seu aplicativo.pat-na1-11223344-abcde-12345-9876-1234a1b23456
Medidas de proteção guardrails
HubSpot aplicativos privados estão sujeitos a Limites de Taxa. O número de chamadas que seu aplicativo privado pode fazer se baseia na sua assinatura de conta do HubSpot e se você adquiriu o complemento API. Consulte também Outros limites.
Identidades suportadas supported-identities
HubSpot oferece suporte à atualização de identidades descritas na tabela abaixo. Saiba mais sobre identidades.
email
test@test.com
Públicos-alvo compatíveis supported-audiences
Esta seção descreve todos os públicos-alvo que você pode exportar para esse destino.
Este destino dá suporte à ativação de todos os públicos-alvo gerados pelo Serviço de Segmentação da Experience Platform.
Esse destino também suporta a ativação dos públicos-alvo descritos na tabela abaixo.
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 público-alvo, 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.
- Além disso, uma nova propriedade é criada em HubSpot usando o nome do público-alvo e seu valor é com o status do público-alvo correspondente da Platform, para cada um dos públicos selecionados.
- Os destinos de transmissão são conexões baseadas em API "sempre ativas". Assim que 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
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, pesquise por HubSpot. Como alternativa, você pode localizá-lo na categoria CRM.
Autenticar para o destino authenticate
Preencha os campos obrigatórios abaixo. Consulte a seção Coletar o HubSpot token de acesso ao aplicativo privado para obter qualquer orientação.
- Token de portador: o token de acesso do seu aplicativo privado HubSpot.
Para autenticar no destino, selecione Conectar ao destino.
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.
- Nome: um nome pelo qual você reconhecerá este destino no futuro.
- Descrição: uma descrição 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 Avançar.
Ativar públicos-alvo para esse destino activate
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.
Mapear atributos e identidades map
Para enviar corretamente seus dados de público-alvo do Adobe Experience Platform para o destino HubSpot, 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 HubSpot, siga as etapas abaixo:
Mapeando a identidade Email
A identidade Email
é um mapeamento obrigatório para este destino. Siga as etapas abaixo para mapeá-la:
- 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 o Selecionar namespace de identidade e selecione uma identidade.
- Na janela Selecionar campo de destino, escolha Selecionar atributos e selecione
email
.
IdentityMap: Email
Identity: email
Um exemplo com o mapeamento de identidade é mostrado abaixo:
Mapeando atributos opcionais
Para adicionar outros atributos que você deseja atualizar entre o esquema de perfil XDM e a conta HubSpot, repita 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.
- Na janela Selecionar campo de destino, escolha a categoria Selecionar atributos e selecione na lista de atributos que são preenchidos automaticamente na sua conta HubSpot. O destino usa a API HubSpot Propriedades para recuperar essas informações. As HubSpot propriedades padrão e qualquer propriedade personalizada são recuperadas para seleção como campos de destino.
Alguns mapeamentos disponíveis entre seu esquema de perfil XDM e Hubspot são mostrados abaixo:
xdm: person.name.firstName
Attribute: firstname
xdm: person.name.lastName
Attribute: lastname
xdm: workAddress.street1
Attribute: address
xdm: workAddress.city
Attribute: city
xdm: workAddress.country
Attribute: country
Um exemplo usando esses mapeamentos de atributos é 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 no site HubSpot e navegue até a página Contatos para verificar o status do público-alvo. Esta lista pode ser configurada para exibir colunas para as propriedades personalizadas criadas com o nome do público-alvo, cujo valor são os status do público-alvo.
-
Como alternativa, você pode detalhar uma página individual de Pessoa e navegar até as propriedades que exibem o nome do público-alvo e os status do 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.
Recursos adicionais additional-resources
Informações adicionais úteis da documentação do HubSpot estão abaixo:
- Métodos de autenticação no HubSpot
- Referências de API HubSpot para as APIs Contatos e Propriedades.
Changelog
Esta seção captura a funcionalidade e as atualizações de documentação significativas feitas neste conector de destino.
table 0-row-3 1-row-3 layout-auto | ||
---|---|---|
Mês de lançamento | Tipo de atualização | Descrição |
Setembro de 2023 | Versão inicial | Versão inicial de destino e publicação da documentação. |