HubSpot connessione

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 use-cases

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 prerequisites

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 prerequisites-in-experience-platform

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 prerequisites-destination

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

È necessario disporre di HubSpot account prerequisites-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 gather-credentials

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.

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
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 guardrails

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 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 importato in Experienci 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 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 connect

IMPORTANT
Per connettersi alla destinazione, è necessario Visualizza destinazioni e Gestire le destinazioni autorizzazioni di 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 authenticate

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 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 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 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 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 activate

IMPORTANT
Per attivare i dati, è necessario Visualizza 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à map

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:

  1. In Mappatura passaggio, seleziona Aggiungi nuova mappatura. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
    Schermata dell’interfaccia utente di Platform con il pulsante Aggiungi nuova mappatura evidenziato.
  2. In Seleziona campo di origine finestra, scegli la Seleziona lo spazio dei nomi dell’identità e seleziona un’identità.
    Schermata dell’interfaccia utente di Platform che seleziona l’e-mail come attributo sorgente da mappare come identità.
  3. In Seleziona campo di destinazione finestra, scegli la Seleziona attributi e seleziona email.
    Schermata dell’interfaccia utente di Platform che seleziona le e-mail come attributo di destinazione da mappare come identità.
Campo di origine
Campo di destinazione
Obbligatorio
IdentityMap: Email
Identity: email

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:

  1. In Mappatura passaggio, seleziona Aggiungi nuova mappatura. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
    Schermata dell’interfaccia utente di Platform con il pulsante Aggiungi nuova mappatura evidenziato.
  2. In Seleziona campo di origine finestra, scegli la Seleziona attributi e selezionare l'attributo XDM.
    Schermata dell’interfaccia utente di Platform che seleziona First Name come attributo sorgente.
  3. 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.
    Schermata dell’interfaccia utente di Platform che seleziona First Name come attributo 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 exported-data

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

  1. 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.
    Schermata dell’interfaccia utente HubSpot che mostra la pagina Contatti con intestazioni di colonna che mostrano il nome del pubblico e le celle e gli stati del pubblico

  2. In alternativa, puoi eseguire un drill-down in un singolo Persona e passa alle proprietà che visualizzano il nome e gli stati del pubblico.
    La schermata dell’interfaccia utente di HubSpot mostra la pagina dei contatti con proprietà personalizzate che mostrano il nome e lo stato del pubblico.

Utilizzo dei dati e governance data-usage-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 additional-resources

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

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