HubSpot conexão

Última atualização em 2024-01-25
  • Tópicos
  • Destinations
    Exibir mais informações sobre este tópico
  • Criado para:
  • Developer
    User
    Admin
    Leader

HubSpot O é 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 utiliza o HubSpot API de Contatos, para atualizar contatos em HubSpot de um público-alvo Experience Platform existente após a ativação.

Instruções para autenticar em seu HubSpot exemplo, são apresentados mais abaixo, no Autenticar para destino seção.

Casos de uso

Para ajudá-lo a entender melhor como e quando você deve usar o HubSpot destino, este é um exemplo de caso de uso que os clientes do Adobe Experience Platform podem resolver usando esse destino.

HubSpot os contatos 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. Depois de enviar esses públicos-alvo para o 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 o contato pertence.

Pré-requisitos

Consulte as seções abaixo para obter os pré-requisitos que você precisa configurar no Experience Platform e HubSpot e para informações que você deve coletar antes de trabalhar com a HubSpot destino.

Pré-requisitos do Experience Platform

Antes de ativar os dados para o HubSpot destino, você deve ter um schema, um conjunto de dados, e públicos criado em Experience Platform.

Consulte a documentação do Experience Platform para Grupo de campos de esquema Detalhes da associação do público se precisar de orientação sobre os status do público-alvo.

Pré-requisitos para a HubSpot destino

Observe os seguintes pré-requisitos para exportar dados da Platform para o seu HubSpot conta:

Você deve ter um HubSpot account

Para exportar dados da Platform para o seu Hubspot conta que você precisa ter HubSpot conta. Se ainda não tiver um, visite o Configurar sua conta do HubSpot e siga as orientações para registrar e criar sua conta.

Obtenha os HubSpot token de acesso do aplicativo privado

Você precisa do seu HubSpot Access token para permitir que o HubSpot destino para fazer chamadas de API por meio de seus HubSpot aplicativo privado em seu HubSpot conta. A variável Access token serve como Bearer token quando você autenticar o destino.

Se você não tiver um aplicativo privado, siga a documentação para Criar um aplicativo privado no HubSpot.

IMPORTANTE

O aplicativo privado deve ser atribuído aos escopos abaixo:
crm.objects.contacts.write, crm.objects.contacts.read
crm.schemas.contacts.write, crm.schemas.contacts.read

Credencial Descrição Exemplo
Bearer token A variável Access token do seu HubSpot aplicativo privado.
Para obter o seu HubSpot Access token siga o HubSpot documentação para fazer chamadas de API com o token de acesso do aplicativo.
pat-na1-11223344-abcde-12345-9876-1234a1b23456

Medidas de proteção

HubSpot aplicativos privados estão sujeitos a Limites de taxa. O número de chamadas que seu aplicativo privado pode fazer se baseia em seus HubSpot conta e se você adquiriu o complemento de API. Consulte também a seção Outros limites.

Identidades suportadas

HubSpot O oferece suporte à atualização de identidades descritas na tabela abaixo. Saiba mais sobre identidades.

Identidade de destino Exemplo Descrição Considerações
email test@test.com Endereço de email do contato. Obrigatório

Públicos-alvo compatíveis

Esta seção descreve todos os públicos-alvo que você pode exportar para esse destino.

Esse destino suporta a ativação de todos os públicos-alvo gerados pelo Experience Platform Serviço de segmentação.

Esse destino também suporta a ativação dos públicos-alvo descritos na tabela abaixo.

Tipo de público Descrição
Uploads personalizados Públicos-alvo importado para o Experience Platform de arquivos CSV.

Tipo e frequência de exportação

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 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 campo.
  • Além disso, uma nova propriedade é criada no HubSpot usar o nome do público-alvo e seu valor é com o status de público-alvo correspondente da Platform, para cada um dos públicos-alvo selecionados.
Frequência de exportação Streaming
  • 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 transmissão.

Conectar ao destino

IMPORTANTE

Para se conectar ao destino, você precisa da variável Exibir destinos e Gerenciar destinos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

Para se conectar a esse 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.

Dentro de Destinos > Catálogo pesquisar HubSpot. Como alternativa, você pode localizá-lo na CRM categoria.

Autenticar para o destino

Preencha os campos obrigatórios abaixo. Consulte a Obtenha os HubSpot token de acesso do aplicativo privado para obter orientação.

  • Token de portador: O token de acesso do HubSpot aplicativo privado.

Para autenticar no destino, selecione Conectar ao destino.
Captura de tela da interface do usuário da plataforma mostrando como autenticar.

Se os detalhes fornecidos forem válidos, a interface exibirá uma Conectado com uma marca de seleção verde. Você pode prosseguir para a próxima etapa.

Preencher detalhes do destino

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 do destino.

  • Nome: um nome pelo qual você reconhecerá esse destino no futuro.
  • Descrição: uma descrição que ajudará você a identificar esse destino no futuro.

Ativar alertas

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

Quando terminar de fornecer detalhes da conexão de destino, selecione Próxima.

Ativar públicos-alvo para esse destino

IMPORTANTE

Para ativar os dados, é necessário Exibir destinos, Ativar destinos, Exibir perfis, e Exibir segmentos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

Ler Ativar perfis e públicos para destinos de exportação de público de transmissão para obter instruções sobre como ativar públicos-alvo para esse destino.

Mapear atributos e identidades

Para enviar corretamente os dados do público-alvo do Adobe Experience Platform para a HubSpot destino, você deve passar 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 o HubSpot campos de destino, siga as etapas abaixo:

Mapeamento de Email identidade

A variável Email a identidade é um mapeamento obrigatório para este destino. Siga as etapas abaixo para mapeá-la:

  1. No Mapeamento etapa, selecione Adicionar novo mapeamento. Agora você pode ver uma nova linha de mapeamento na tela.
    Captura de tela da interface do usuário da plataforma com o botão adicionar novo mapeamento realçado.
  2. No Selecionar campo de origem escolha a Selecionar namespace de identidade e selecione uma identidade.
    Captura de tela da interface do usuário da plataforma selecionando o email como um atributo de origem a ser mapeado como identidade.
  3. No Selecionar campo de destino escolha a Selecionar atributos e selecione email.
    Captura de tela da interface do usuário da plataforma selecionando o email como um atributo de destino a ser mapeado como identidade.
Campo de origem Campo de destino Obrigatório
IdentityMap: Email Identity: email Sim

Um exemplo com o mapeamento de identidade é mostrado abaixo:
Exemplo de captura de tela da interface do usuário do Platform com mapeamento de identidade de email.

Mapeamento opcional atributos

Para adicionar outros atributos que você deseja atualizar entre o esquema de perfil XDM e o HubSpot repita as etapas abaixo:

  1. No Mapeamento etapa, selecione Adicionar novo mapeamento. Agora você pode ver uma nova linha de mapeamento na tela.
    Captura de tela da interface do usuário da plataforma com o botão adicionar novo mapeamento realçado.
  2. No Selecionar campo de origem escolha a Selecionar atributos e selecione o atributo XDM.
    Captura de tela da interface do usuário da plataforma selecionando o Nome como um atributo de origem.
  3. No Selecionar campo de destino escolha Selecionar atributos categoria e selecione na lista de atributos que são automaticamente preenchidos na HubSpot conta. O destino usa o HubSpot Propriedades API para recuperar essas informações. Ambos HubSpot propriedades padrão e todas as propriedades personalizadas são recuperadas para seleção como campos de destino.
    Captura de tela da interface do usuário da plataforma selecionando o Nome como um atributo de destino.

Alguns mapeamentos disponíveis entre o esquema de perfil XDM e Hubspot são mostrados abaixo:

Campo de origem Campo de destino
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:
Exemplo de captura de tela da interface do usuário da plataforma com mapeamentos de atributo.

Quando terminar de fornecer os mapeamentos para sua conexão de destino, selecione Próxima.

Validar exportação de dados

Para validar se você configurou o destino corretamente, siga as etapas abaixo:

  1. Faça logon no HubSpot site e, em seguida, navegue até o Contatos página para verificar os 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.
    Captura de tela da interface do usuário do HubSpot mostrando a página Contatos com cabeçalhos de coluna mostrando o nome do público-alvo e os status do público-alvo das células

  2. Como alternativa, você pode detalhar uma Person e navegue até as propriedades que exibem o nome do público-alvo e os status do público.
    Captura de tela da interface do usuário do HubSpot mostrando a página Contato com propriedades personalizadas que exibem o nome do público-alvo e os status do público-alvo.

Uso e governança de dados

Todos Adobe Experience Platform os destinos estão em conformidade com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como Adobe Experience Platform fiscaliza a governança de dados, consulte o Visão geral da governança de dados.

Recursos adicionais

Informações adicionais úteis do HubSpot A documentação do está abaixo:

Changelog

Esta seção captura a funcionalidade e as atualizações de documentação significativas feitas neste conector de destino.

 Exibir changelog
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.

Nesta página