Connessione HubSpot

Ultimo aggiornamento: 2023-11-04

Argomenti:
Destinations
Visualizza ulteriori informazioni su questo argomento

Creato per:
Developer

User

Admin

Leader

HubSpot è una piattaforma CRM con tutti i software, le integrazioni e le risorse necessarie per collegare marketing, vendite, content management e servizio clienti. Ti consente di collegare dati, team e clienti su un’unica piattaforma di gestione delle relazioni con i clienti.

Questo Adobe Experience Platform destinazione sfrutta HubSpot API Contatti, per aggiornare i contatti in HubSpot da un pubblico Experience Platform esistente dopo l’attivazione.

Istruzioni per l’autenticazione HubSpot sono riportati di seguito, nella Autentica nella destinazione sezione.

Casi d’uso

Per aiutarti a capire meglio come e quando utilizzare il HubSpot destinazione: ecco un caso d’uso di esempio che i clienti di Adobe Experience Platform possono risolvere utilizzando questa destinazione.

HubSpot I contatti memorizzano informazioni sulle persone che interagiscono con la tua azienda. Il tuo team utilizza i contatti esistenti in HubSpot per generare il pubblico Experienci Platform. Dopo aver inviato questi tipi di pubblico a HubSpot, le loro informazioni vengono aggiornate e a ogni contatto viene assegnata una proprietà il cui valore è il nome del pubblico che indica a quale pubblico appartiene il contatto.

Prerequisiti

Consulta le sezioni seguenti per eventuali prerequisiti da impostare in Experienci Platform e HubSpot e per le informazioni che è necessario raccogliere prima di lavorare con HubSpot destinazione.

Experience Platform prerequisiti

Prima di attivare i dati in HubSpot destinazione, è necessario disporre di un schema, a set di dati, e audience creato in Experience Platform.

Consulta la documentazione di Experienci Platform per Gruppo di campi schema Dettagli appartenenza pubblico per informazioni sugli stati del pubblico.

Prerequisiti per HubSpot destinazione

Prendi nota dei seguenti prerequisiti per esportare i dati da Platform al tuo HubSpot account:

È necessario disporre di HubSpot account

Per esportare i dati da Platform al tuo Hubspot account necessario disporre di HubSpot account. Se non ne hai già uno, visita il Configurare l’account HubSpot e seguire le istruzioni per registrarsi e creare il proprio account.

Raccogliere il HubSpot token di accesso all’app privata

Hai bisogno del tuo HubSpot Access token per consentire HubSpot destinazione per effettuare chiamate API tramite il HubSpot app privata all’interno del tuo HubSpot account. Il Access token funge da Bearer token quando autentica la destinazione.

Se non disponi di un’app privata, consulta la documentazione per Creare un’app privata in HubSpot.

IMPORTANTE

All'app privata devono essere assegnati gli ambiti seguenti:
crm.objects.contacts.write, crm.objects.contacts.read
crm.schemas.contacts.write, crm.schemas.contacts.read

Credenziali	Descrizione	Esempio
`Bearer token`	Il `Access token` del tuo HubSpot app privata. Per ottenere HubSpot `Access token` seguire la HubSpot documentazione per effettuare chiamate API con il token di accesso dell'app.	`pat-na1-11223344-abcde-12345-9876-1234a1b23456`

Guardrail

HubSpot le app private sono soggette a Limiti di velocità. Il numero di chiamate che l’app privata può effettuare è basato sul tuo HubSpot l’abbonamento all’account e se hai acquistato il componente aggiuntivo API. Inoltre, fai riferimento a Altri limiti.

Identità supportate

HubSpot supporta l’aggiornamento delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.

Identità di destinazione	Esempio	Descrizione	Considerazioni
`email`	`test@test.com`	Indirizzo e-mail del contatto.	Obbligatorio

Tipi di pubblico supportati

Questa sezione descrive tutti i tipi di pubblico che puoi esportare in questa destinazione.

Questa destinazione supporta l’attivazione di tutti i tipi di pubblico generati tramite l’Experience Platform Servizio di segmentazione.

Questa destinazione supporta anche l’attivazione dei tipi di pubblico descritti nella tabella seguente.

Tipo di pubblico	Descrizione
Caricamenti personalizzati	Tipi di pubblico importato in Experienci Platform da file CSV.

Tipo e frequenza di esportazione

Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.

Elemento	Tipo	Note
Tipo di esportazione	Basato su profilo	Stai esportando tutti i membri di un pubblico, insieme ai campi di schema desiderati ad esempio: indirizzo e-mail, numero di telefono, cognome, in base alla mappatura del campo. Inoltre, viene creata una nuova proprietà in HubSpot l’utilizzo del nome e del valore del pubblico avviene con il corrispondente stato del pubblico da Platform, per ciascuno dei tipi di pubblico selezionati.
Frequenza di esportazione	Streaming	Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Non appena un profilo viene aggiornato in Experienci Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni su destinazioni di streaming.

Connettersi alla destinazione

IMPORTANTE

Per connettersi alla destinazione, è necessario Gestire le destinazioni autorizzazione per il controllo degli accessi. Leggi le panoramica sul controllo degli accessi oppure contatta l’amministratore del prodotto per ottenere le autorizzazioni necessarie.

Per connettersi a questa destinazione, seguire i passaggi descritti in esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.

Entro Destinazioni > Catalogo cerca HubSpot. In alternativa, è possibile posizionarlo sotto il CRM categoria.

Autenticarsi nella destinazione

Compila i campi obbligatori di seguito. Consulta la sezione Raccogliere il HubSpot token di accesso all’app privata sezione per eventuali indicazioni.

Token Bearer: token di accesso per HubSpot app privata.

Per eseguire l’autenticazione nella destinazione, seleziona Connetti alla destinazione.
Schermata dell’interfaccia utente di Platform che mostra come eseguire l’autenticazione.

Se i dettagli forniti sono validi, nell’interfaccia utente viene visualizzato un Connesso con un segno di spunta verde. A questo punto è possibile procedere al passaggio successivo.

Inserire i dettagli della destinazione

Per configurare i dettagli per la destinazione, compila i campi obbligatori e facoltativi seguenti. Un asterisco accanto a un campo nell’interfaccia utente indica che il campo è obbligatorio.
Schermata dell’interfaccia utente di Platform che mostra i dettagli della destinazione.

Nome: nome con cui riconoscerai questa destinazione in futuro.
Descrizione: descrizione che ti aiuterà a identificare questa destinazione in futuro.

Abilita avvisi

Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento agli avvisi sulle destinazioni tramite l’interfaccia utente.

Una volta completate le informazioni sulla connessione di destinazione, seleziona Successivo.

Attivare tipi di pubblico in questa destinazione

IMPORTANTE

Per attivare i dati, è necessario Gestire le destinazioni, Attivare le destinazioni, Visualizza profili, e Visualizzare segmenti autorizzazioni di controllo degli accessi. Leggi le panoramica sul controllo degli accessi oppure contatta l’amministratore del prodotto per ottenere le autorizzazioni necessarie.

Letto Attiva profili e tipi di pubblico nelle destinazioni di esportazione del pubblico in streaming per istruzioni sull’attivazione dei tipi di pubblico in questa destinazione.

Mappare attributi e identità

Per inviare correttamente i dati sul pubblico da Adobe Experience Platform a HubSpot destinazione, devi passare attraverso il passaggio di mappatura campo. La mappatura consiste nella creazione di un collegamento tra i campi dello schema Experience Data Model (XDM) nell’account Platform e i corrispondenti equivalenti dalla destinazione.

Per mappare correttamente i campi XDM su HubSpot campi di destinazione, segui i passaggi seguenti:

Mappatura di `Email` identità

Il Email identity è una mappatura obbligatoria per questa destinazione. Segui i passaggi seguenti per mapparla:

In Mappatura passaggio, seleziona Aggiungi nuova mappatura. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
In Seleziona campo di origine finestra, scegli la Seleziona lo spazio dei nomi dell’identità e seleziona un’identità.
In Seleziona campo di destinazione finestra, scegli la Seleziona attributi e seleziona email.

Campo di origine	Campo di destinazione	Obbligatorio
`IdentityMap: Email`	`Identity: email`	Sì

Di seguito è riportato un esempio con la mappatura di identità:
Esempio di schermata dell’interfaccia utente di Platform con mappatura identità e-mail.

Mappatura facoltativo attributi

Per aggiungere altri attributi che desideri aggiornare tra lo schema del profilo XDM e il HubSpot ripeti i passaggi seguenti:

In Mappatura passaggio, seleziona Aggiungi nuova mappatura. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
In Seleziona campo di origine finestra, scegli la Seleziona attributi e selezionare l'attributo XDM.
In Seleziona campo di destinazione finestra, scegli Seleziona attributi e selezionarli dall'elenco di attributi che vengono compilati automaticamente HubSpot account. La destinazione utilizza HubSpot Proprietà API per recuperare queste informazioni. Entrambi HubSpot proprietà predefinite ed eventuali proprietà personalizzate vengono recuperate per la selezione come campi di destinazione.

Alcune mappature disponibili tra lo schema del profilo XDM e Hubspot sono mostrati di seguito:

Campo di origine	Campo di destinazione
`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`

Di seguito è riportato un esempio che utilizza queste mappature di attributi:
Esempio di schermata dell’interfaccia utente di Platform con mappature di attributi.

Una volta completate le mappature per la connessione di destinazione, seleziona Successivo.

Convalidare l’esportazione dei dati

Per verificare di aver impostato correttamente la destinazione, segui i passaggi seguenti:

Accedi a HubSpot , quindi passare al Contatti per verificare gli stati del pubblico. Questo elenco può essere configurato in modo da visualizzare le colonne per le proprietà personalizzate create con il nome del pubblico, il cui valore corrisponde agli stati del pubblico.
In alternativa, puoi eseguire un drill-down in un singolo Persona e passa alle proprietà che visualizzano il nome e gli stati del pubblico.

Utilizzo dei dati e governance

Tutti Adobe Experience Platform le destinazioni sono conformi ai criteri di utilizzo dei dati durante la gestione dei dati. Per informazioni dettagliate su come Adobe Experience Platform applica la governance dei dati, consulta la sezione Panoramica sulla governance dei dati.

Risorse aggiuntive

Ulteriori informazioni utili da HubSpot la documentazione è riportata di seguito:

Metodi di autenticazione in HubSpot
HubSpot Riferimenti API per Contatti e Proprietà API.

Changelog

Questa sezione acquisisce le funzionalità e i significativi aggiornamenti alla documentazione apportati al connettore di destinazione.

Visualizza changelog

Mese di rilascio	Tipo di aggiornamento	Descrizione
Settembre 2023	Versione iniziale	Versione di destinazione iniziale e pubblicazione della documentazione.

Pagina precedente

Connessione HubSpot

Casi d’uso