DocumentaciónExperience PlatformGuía de destinos

HubSpot conexión

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Administrador
  • Usuario

HubSpot es una plataforma CRM con todo el software, las integraciones y los recursos que necesita para conectar el marketing, las ventas, la administración de contenido y el servicio al cliente. Permite conectar los datos, los equipos y los clientes en una plataforma CRM.

Este Adobe Experience Platform destino aprovecha la API HubSpot Contactos para actualizar los contactos de HubSpot de una audiencia de Experience Platform existente después de la activación.

Las instrucciones para autenticarse en su instancia de HubSpot se encuentran más abajo, en la sección Autenticar en destino.

Casos de uso use-cases

Para ayudarle a comprender mejor cómo y cuándo debe utilizar el destino HubSpot, aquí tiene un ejemplo de uso que los clientes de Adobe Experience Platform pueden solucionar mediante este destino.

HubSpot contactos almacenan información sobre las personas que interactúan con su negocio. Su equipo usa los contactos que existen en HubSpot para crear las audiencias de Experience Platform. Después de enviar estas audiencias a HubSpot, su información se actualiza y a cada contacto se le asigna una propiedad con su valor como nombre de audiencia que indica a qué audiencia pertenece el contacto.

Requisitos previos prerequisites

Consulte las secciones siguientes para conocer todos los requisitos previos que necesita configurar en Experience Platform y HubSpot, así como la información que debe recopilar antes de trabajar con el destino HubSpot.

Requisitos previos del Experience Platform prerequisites-in-experience-platform

Antes de activar datos en el destino HubSpot, debe tener un esquema, un conjunto de datos y audiencias creados en Experience Platform.

Consulte la documentación del Experience Platform para el grupo de campos de esquema Detalles de pertenencia a audiencias si necesita instrucciones sobre los estados de audiencia.

Requisitos previos para el destino HubSpot prerequisites-destination

Tenga en cuenta los siguientes requisitos previos para exportar datos de Platform a su cuenta de HubSpot:

Debe tener una cuenta de HubSpot prerequisites-account

Para exportar datos de Platform a su cuenta de Hubspot, necesita tener una cuenta de HubSpot. Si todavía no tiene una, visite la página Configurar su cuenta de HubSpot y siga las instrucciones para registrarse y crear su cuenta.

Recopilar el token de acceso privado a la aplicación HubSpot gather-credentials

Necesita su HubSpot Access token para permitir que el destino HubSpot realice llamadas API a través de su aplicación privada HubSpot en su cuenta de HubSpot. Access token sirve como Bearer token cuando autentica el destino.

Si no tiene una aplicación privada, siga la documentación para Crear una aplicación privada en HubSpot.

IMPORTANT
A la aplicación privada se le deben asignar los ámbitos siguientes:
crm.objects.contacts.write, crm.objects.contacts.read
crm.schemas.contacts.write, crm.schemas.contacts.read
Credencial
Descripción
Ejemplo
Bearer token
El Access token de su aplicación privada HubSpot.
Para obtener tu HubSpot Access token, sigue la documentación de HubSpot para hacer llamadas a la API con el token de acceso de tu aplicación.
pat-na1-11223344-abcde-12345-9876-1234a1b23456

Mecanismos de protección guardrails

HubSpot aplicaciones privadas están sujetas a límites de tarifas. El número de llamadas que puede realizar su aplicación privada depende de la suscripción a la cuenta de HubSpot y de si ha adquirido el complemento de la API. Además, consulte Otros límites.

Identidades admitidas supported-identities

HubSpot admite la actualización de las identidades descritas en la tabla siguiente. Más información sobre identidades.

Identidad de destino
Ejemplo
Descripción
Consideraciones
email
test@test.com
Dirección de correo electrónico del contacto.
Obligatorio

Audiencias compatibles supported-audiences

Esta sección describe todas las audiencias que puede exportar a este destino.

Este destino admite la activación de todas las audiencias generadas a través del Experience Platform Servicio de segmentación.

Este destino también admite la activación de las audiencias que se describen en la tabla siguiente.

Tipo de público
Descripción
Cargas personalizadas
Las audiencias importadas en el Experience Platform desde archivos CSV.

Tipo y frecuencia de exportación export-type-frequency

Consulte la tabla siguiente para obtener información sobre el tipo y la frecuencia de exportación de destino.

Elemento
Tipo
Notas
Tipo de exportación
Basado en perfil
  • Va a exportar todos los miembros de una audiencia, junto con los campos de esquema deseados (por ejemplo: dirección de correo electrónico, número de teléfono, apellidos), según la asignación de campos.
  • Además, se crea una nueva propiedad en HubSpot con el nombre de audiencia y su valor se asigna con el estado de audiencia correspondiente de Platform, para cada una de las audiencias seleccionadas.
Frecuencia de exportación
Transmisión
  • Los destinos de streaming son conexiones basadas en API "siempre activadas". Tan pronto como se actualiza un perfil en Experience Platform según la evaluación de audiencias, el conector envía la actualización de forma descendente a la plataforma de destino. Más información sobre destinos de streaming.

Conexión al destino connect

IMPORTANT
Para conectarse al destino, necesita los permisos de control de acceso de Ver destinos] y Administrar destinos[5}. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.

Para conectarse a este destino, siga los pasos descritos en el tutorial de configuración de destino. En el flujo de trabajo de configuración de destino, rellene los campos enumerados en las dos secciones siguientes.

En destinos > catálogo, busque HubSpot. También puede ubicarlo en la categoría CRM.

Autenticarse en el destino authenticate

Rellene los campos obligatorios siguientes. Consulte la sección Recopilar el HubSpot token privado de acceso a la aplicación para obtener instrucciones.

  • Token de portador: El token de acceso para su aplicación privada HubSpot.

Para autenticarse en el destino, seleccione Conectarse al destino.
Captura de pantalla de IU de Platform que muestra cómo autenticarse.

Si los detalles proporcionados son válidos, la interfaz de usuario mostrará el estado Conectado con una marca de verificación verde. A continuación, puede continuar con el paso siguiente.

Rellenar detalles de destino destination-details

Para configurar los detalles del destino, rellene los campos obligatorios y opcionales a continuación. Un asterisco junto a un campo en la interfaz de usuario indica que el campo es obligatorio.
Captura de pantalla de IU de Platform que muestra los detalles del destino.

  • Nombre: Un nombre por el cual reconocerá este destino en el futuro.
  • Descripción: Una descripción que le ayudará a identificar este destino en el futuro.

Habilitar alertas enable-alerts

Puede activar alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista a la que suscribirse para recibir notificaciones sobre el estado del flujo de datos. Para obtener más información sobre las alertas, consulte la guía sobre suscripción a alertas de destinos mediante la interfaz de usuario.

Cuando termine de proporcionar detalles para la conexión de destino, seleccione Siguiente.

Activar públicos en este destino activate

IMPORTANT
Para activar los datos, necesita los permisos de control de acceso, Activar destinos, Ver perfiles y Ver segmentos ​para. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.

Lea Activar perfiles y audiencias en destinos de exportación de audiencias de streaming para obtener instrucciones sobre cómo activar audiencias en este destino.

Asignar atributos e identidades map

Para enviar correctamente los datos de audiencia de Adobe Experience Platform al destino HubSpot, debe pasar por el paso de asignación de campos. La asignación consiste en crear un vínculo entre los campos de esquema del Modelo de datos de experiencia (XDM) en la cuenta de Platform y sus equivalentes correspondientes desde el destino de destino.

Para asignar correctamente los campos XDM a los campos de destino HubSpot, siga los pasos a continuación:

Asignando la identidad Email

La identidad Email es una asignación obligatoria para este destino. Siga los pasos a continuación para asignarlo:

  1. En el paso Asignación, seleccione Agregar nueva asignación. Ahora puede ver una nueva fila de asignación en la pantalla.
    Captura de pantalla de la interfaz de usuario de Platform con el botón Agregar nueva asignación resaltado.
  2. En la ventana Seleccionar campo de origen, elija Seleccionar área de nombres de identidad y seleccione una identidad.
    Captura de pantalla de la IU de Platform seleccionando correo electrónico como atributo de origen para asignar como identidad.
  3. En la ventana Seleccionar campo de destino, elija Seleccionar atributos y seleccione email.
    Captura de pantalla de la IU de Platform seleccionando correo electrónico como atributo de destino para asignar como identidad.
Campo de origen
Campo de destino
Obligatorio
IdentityMap: Email
Identity: email
Sí

A continuación, se muestra un ejemplo con la asignación de identidad:
Ejemplo de captura de pantalla de IU de Platform con asignación de identidad de correo electrónico.

Asignando atributos optional

Para agregar cualquier otro atributo que desee actualizar entre el esquema de perfil XDM y la cuenta HubSpot, repita los pasos a continuación:

  1. En el paso Asignación, seleccione Agregar nueva asignación. Ahora puede ver una nueva fila de asignación en la pantalla.
    Captura de pantalla de la interfaz de usuario de Platform con el botón Agregar nueva asignación resaltado.
  2. En la ventana Seleccionar campo de origen, elija la categoría Seleccionar atributos y seleccione el atributo XDM.
    Captura de pantalla de IU de Platform seleccionando Nombre como atributo de origen.
  3. En la ventana Seleccionar campo de destino, elija la categoría Seleccionar atributos y seleccione en la lista de atributos que se rellenan automáticamente desde su cuenta de HubSpot. El destino usa la API HubSpot Properties para recuperar esta información. Se recuperarán HubSpot propiedades predeterminadas y todas las propiedades personalizadas para seleccionarlas como campos de destino.
    Captura de pantalla de IU de Platform seleccionando Nombre como atributo de destino.

A continuación se muestran algunas asignaciones disponibles entre su esquema de perfil XDM y Hubspot:

Campo de origen
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

A continuación, se muestra un ejemplo con estas asignaciones de atributos:
Ejemplo de captura de pantalla de IU de plataforma con asignaciones de atributos.

Cuando termine de proporcionar las asignaciones para la conexión de destino, seleccione Siguiente.

Validar exportación de datos exported-data

Para comprobar que ha configurado correctamente el destino, siga los pasos a continuación:

  1. Inicie sesión en el sitio web de HubSpot y luego vaya a la página Contactos para comprobar los estados de audiencia. Esta lista se puede configurar para que muestre columnas para las propiedades personalizadas creadas con el nombre de la audiencia cuyo valor sean los estados de audiencia.
    Captura de pantalla de la interfaz de usuario HubSpot que muestra la página Contactos con encabezados de columna que muestran el nombre de la audiencia y las celdas y los estados de audiencia

  2. También puede explorar en profundidad una página individual de Persona y navegar a las propiedades que muestran el nombre de la audiencia y los estados de audiencia.
    Captura de pantalla de la interfaz de usuario HubSpot que muestra la página Contacto con propiedades personalizadas que muestran el nombre de la audiencia y sus estados.

Uso de datos y gobernanza data-usage-governance

Todos los destinos de Adobe Experience Platform cumplen con las políticas de uso de datos al administrar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica el control de datos, consulte la Información general sobre el control de datos.

Recursos adicionales additional-resources

A continuación encontrará información útil adicional de la documentación de HubSpot:

Changelog

Esta sección recoge la funcionalidad y las actualizaciones significativas de la documentación realizadas en este conector de destino.

Ver registro de cambios
table 0-row-3 1-row-3 layout-auto
Mes de lanzamiento Tipo de actualización Descripción
Septiembre de 2023 Versión inicial Versión de destino inicial y publicación de documentación.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6