DocumentazioneExperience PlatformGuida alle destinazioni

Connessione HubSpot

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

Creato per:

  • Amministratore
  • Utente

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.

IMPORTANT
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
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à.

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

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 di pubblico
Descrizione
Caricamenti personalizzati
Tipi di pubblico importati in Experience Platform da file CSV.

Tipo e frequenza di esportazione export-type-frequency

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 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.
Frequenza di esportazione
Streaming
  • 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

IMPORTANT
Per connettersi alla destinazione, sono necessarie le Destinazioni visualizzazione e le Autorizzazioni di gestione delle destinazioni per il controllo degli accessi. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

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.
Schermata dellinterfaccia utente di Platform che mostra come eseguire lautenticazione.

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.
Schermata dellinterfaccia utente di Platform che mostra i dettagli della destinazione.

  • 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

IMPORTANT
Per attivare i dati, è necessario Visualizza destinazioni, Attiva destinazioni, Visualizza profili e Visualizza segmenti Autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

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:

  1. Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
    Schermata dellinterfaccia utente di Platform con il pulsante Aggiungi nuova mappatura evidenziato.
  2. Nella finestra Seleziona campo di origine, scegli Seleziona spazio dei nomi identità e seleziona un'identità.
    Schermata dellinterfaccia utente di Platform che seleziona e-mail come attributo di origine da mappare come identità.
  3. Nella finestra Seleziona campo di destinazione scegliere Seleziona attributi e selezionare email.
    Schermata dellinterfaccia utente di Platform che seleziona le e-mail come attributo di destinazione da mappare come identità.
Campo origine
Campo di destinazione
Obbligatorio
IdentityMap: Email
Identity: email
Sì

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

Mappatura degli attributi facoltativi

Per aggiungere altri attributi da aggiornare tra lo schema del profilo XDM e l'account HubSpot, ripetere i passaggi seguenti:

  1. Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
    Schermata dellinterfaccia utente di Platform con il pulsante Aggiungi nuova mappatura evidenziato.
  2. Nella finestra Seleziona campo di origine, scegli la categoria Seleziona attributi e seleziona l'attributo XDM.
    Schermata dellinterfaccia utente di Platform che seleziona First Name come attributo di origine.
  3. 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.
    Schermata dellinterfaccia utente di Platform che seleziona First Name come attributo di destinazione.

Di seguito sono mostrate alcune mappature disponibili tra lo schema del profilo XDM e Hubspot:

Campo 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 dellinterfaccia utente di Platform con 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:

  1. 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.
    Schermata dellinterfaccia utente HubSpot che mostra la pagina Contatti con intestazioni di colonna che mostrano il nome del pubblico e le celle e lo stato del pubblico

  2. In alternativa, puoi espandere una singola pagina di Persona e passare alle proprietà che visualizzano il nome del pubblico e gli stati del pubblico.
    Schermata dellinterfaccia utente di HubSpot che mostra la pagina dei contatti con proprietà personalizzate che mostra 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:

Changelog

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

Visualizza changelog
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.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6