Connessione HubSpot
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.
Questa Adobe Experience Platform destinazione sfrutta l'API HubSpot Contatti per aggiornare i contatti in HubSpot da un pubblico Experience Platform esistente dopo l'attivazione.
Le istruzioni per l'autenticazione nell'istanza HubSpot sono riportate di seguito, nella sezione Autentica nella destinazione.
Casi d’uso use-cases
Per aiutarti a capire meglio come e quando utilizzare la destinazione HubSpot, ecco un esempio di caso d'uso che i clienti Adobe Experience Platform possono risolvere utilizzando questa destinazione.
I contatti di HubSpot memorizzano informazioni sulle persone che interagiscono con la tua azienda. Il tuo team utilizza i contatti esistenti in HubSpot per generare i tipi di pubblico Experienci Platform. Dopo aver inviato questi tipi di pubblico a HubSpot, le informazioni vengono aggiornate e a ogni contatto viene assegnata una proprietà con il relativo valore come nome del pubblico che indica a quale pubblico appartiene il contatto.
Prerequisiti prerequisites
Consultare le sezioni seguenti per eventuali prerequisiti da impostare in Experience Platform e HubSpot e per informazioni da raccogliere prima di utilizzare la destinazione HubSpot.
Experience Platform prerequisiti prerequisites-in-experience-platform
Prima di attivare i dati nella destinazione HubSpot, è necessario disporre di uno schema, un set di dati e tipi di pubblico creati in Experience Platform.
Se hai bisogno di indicazioni sugli stati del pubblico, consulta la documentazione di Experience Platform per il gruppo di campi dello schema Dettagli appartenenza pubblico.
Prerequisiti per la destinazione HubSpot prerequisites-destination
Per esportare i dati da Platform al tuo account HubSpot, tieni presente i seguenti prerequisiti:
Devi avere un account HubSpot prerequisites-account
Per esportare i dati da Platform all'account Hubspot, è necessario disporre di un account HubSpot. Se non ne hai già uno, visita la pagina Configura il tuo account HubSpot e segui le indicazioni per registrarti e creare il tuo account.
Raccogli il token di accesso all'app privata HubSpot gather-credentials
È necessario HubSpot Access token
per consentire alla destinazione HubSpot di effettuare chiamate API tramite l'app privata HubSpot all'interno dell'account HubSpot. Access token
funge da Bearer token
quando autentichi la destinazione.
Se non hai un'app privata, segui la documentazione per creare un'app privata in HubSpot.
crm.objects.contacts.write
, crm.objects.contacts.read
crm.schemas.contacts.write
, crm.schemas.contacts.read
Bearer token
Access token
dell'app privata HubSpot.Per ottenere HubSpot
Access token
, segui la documentazione di HubSpot per effettuare chiamate API con il token di accesso dell'app.pat-na1-11223344-abcde-12345-9876-1234a1b23456
Guardrail guardrails
HubSpot app private sono soggette a Limiti di frequenza. Il numero di chiamate che l'app privata può effettuare dipende dalla sottoscrizione dell'account HubSpot e dall'acquisto del componente aggiuntivo API. Inoltre, fai riferimento a Altri limiti.
Identità supportate supported-identities
HubSpot supporta l'aggiornamento delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.
email
test@test.com
Tipi di pubblico supportati supported-audiences
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 e frequenza di esportazione export-type-frequency
Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.
- 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 al mapping dei campi.
- Inoltre, in HubSpot viene creata una nuova proprietà che utilizza il nome del pubblico e il cui valore corrisponde allo stato del pubblico di Platform, per ciascuno dei tipi di pubblico selezionati.
- Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Non appena un profilo viene aggiornato in Experience Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni sulle destinazioni di streaming.
Connettersi alla destinazione connect
Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.
All'interno di Destinazioni > Catalogo, cerca HubSpot. In alternativa, è possibile individuarlo nella categoria CRM.
Autenticarsi nella destinazione authenticate
Compila i campi obbligatori di seguito. Per ulteriori informazioni, consulta la sezione Raccogliere il HubSpot token di accesso all'app privata.
- Token Bearer: il token di accesso per l'app privata HubSpot.
Per eseguire l'autenticazione nella destinazione, selezionare Connetti alla destinazione.
Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connesso con un segno di spunta verde. A questo punto è possibile procedere al passaggio successivo.
Inserire i dettagli della destinazione destination-details
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.
- Nome: un nome con cui riconoscerai questa destinazione in futuro.
- Descrizione: una descrizione che ti aiuterà a identificare questa destinazione in futuro.
Abilita avvisi enable-alerts
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 a destinazioni avvisi tramite l'interfaccia utente.
Dopo aver fornito i dettagli per la connessione di destinazione, seleziona Avanti.
Attivare tipi di pubblico in questa destinazione activate
Leggi Attivare profili e tipi di pubblico nelle destinazioni di esportazione del pubblico di streaming per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione.
Mappare attributi e identità map
Per inviare correttamente i dati sul pubblico da Adobe Experience Platform alla destinazione HubSpot, è necessario eseguire il passaggio di mappatura dei campi. 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 ai campi di destinazione HubSpot, effettua le seguenti operazioni:
Mappatura dell'identità Email
L'identità Email
è una mappatura obbligatoria per questa destinazione. Segui i passaggi seguenti per mapparla:
- Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
- Nella finestra Seleziona campo di origine, scegli Seleziona spazio dei nomi identità e seleziona un'identità.
- Nella finestra Seleziona campo di destinazione scegliere Seleziona attributi e selezionare
email
.
IdentityMap: Email
Identity: email
Di seguito è riportato un esempio con la mappatura di identità:
Mappatura degli attributi facoltativi
Per aggiungere altri attributi da aggiornare tra lo schema del profilo XDM e l'account HubSpot, ripetere i passaggi seguenti:
- Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
- Nella finestra Seleziona campo di origine, scegli la categoria Seleziona attributi e seleziona l'attributo XDM.
- Nella finestra Seleziona campo di destinazione, scegli la categoria Seleziona attributi e seleziona dall'elenco di attributi che vengono compilati automaticamente dall'account HubSpot. La destinazione utilizza l'API HubSpot Properties per recuperare queste informazioni. Sia HubSpot proprietà predefinite che eventuali proprietà personalizzate vengono recuperate per la selezione come campi di destinazione.
Di seguito sono mostrate alcune mappature disponibili tra lo schema del profilo XDM e Hubspot:
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:
Al termine della fornitura dei mapping per la connessione di destinazione, selezionare Avanti.
Convalidare l’esportazione dei dati exported-data
Per verificare di aver impostato correttamente la destinazione, segui i passaggi seguenti:
-
Accedi al sito Web HubSpot, quindi passa alla pagina 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 espandere una singola pagina di Persona e passare alle proprietà che visualizzano il nome del pubblico e gli stati del pubblico.
Utilizzo dei dati e governance data-usage-governance
Tutte le destinazioni Adobe Experience Platform 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, vedi Panoramica sulla governance dei dati.
Risorse aggiuntive additional-resources
Di seguito sono riportate ulteriori informazioni utili dalla documentazione di HubSpot:
- Metodi di autenticazione in HubSpot
- HubSpot riferimenti API per le API Contatti e Proprietà.
Changelog
Questa sezione acquisisce le funzionalità e i significativi aggiornamenti alla documentazione apportati al connettore di destinazione.
table 0-row-3 1-row-3 layout-auto | ||
---|---|---|
Mese di rilascio | Tipo di aggiornamento | Descrizione |
Settembre 2023 | Versione iniziale | Versione di destinazione iniziale e pubblicazione della documentazione. |