HubSpot anslutning

Senaste uppdatering: 2023-11-01
  • Skapat för:
  • Developer
    User
    Admin
    Leader

HubSpot är en CRM-plattform med all programvara, alla integreringar och resurser ni behöver för att koppla samman marknadsföring, försäljning, innehållshantering och kundservice. Ni kan koppla samman data, team och kunder på en och samma CRM-plattform.

Detta Adobe Experience Platform mål utnyttjar HubSpot Kontakt-API, för att uppdatera kontakter i HubSpot från en befintlig Experience Platform-publik efter aktiveringen.

Instruktioner för hur du autentiserar HubSpot -instansen är längre ned, i Autentisera till mål -avsnitt.

Användningsfall

För att du bättre ska förstå hur och när du ska använda HubSpot mål, här är ett exempel på användning som Adobe Experience Platform-kunder kan lösa genom att använda den här destinationen.

HubSpot kontakter lagrar information om de personer som interagerar med ert företag. Ditt team använder de kontakter som finns i HubSpot för att bygga målgrupper i Experience Platform. När dessa målgrupper har skickats till HubSpot, uppdateras deras information och varje kontakt tilldelas en egenskap med ett värde som målgruppsnamn som anger vilken målgrupp kontakten tillhör.

Förutsättningar

I avsnitten nedan finns information om alla krav som du måste ställa in i Experience Platform och HubSpot och för information som du måste samla in innan du arbetar med HubSpot mål.

Förutsättningar för Experience Platform

Innan du aktiverar data för HubSpot mål, du måste ha schema, a datauppsättningoch målgrupper som Experience Platform.

Se Experience Platform dokumentation för Schemafältgrupp för målgruppsmedlemskapsdetaljer om ni behöver vägledning om målgruppsstatus.

Krav för HubSpot mål

Observera följande krav för att kunna exportera data från Platform till HubSpot konto:

Du måste ha en HubSpot konto

För att kunna exportera data från Platform till Hubspot konto du behöver ha HubSpot konto. Om du inte redan har en går du till Konfigurera ditt HubSpot-konto och följ anvisningarna för att registrera och skapa ditt konto.

Samla HubSpot åtkomsttoken för privat app

Du behöver dina HubSpot Access token för att HubSpot mål för att göra API-anrop via HubSpot privat app i din HubSpot konto. The Access token fungerar som Bearer token när du autentisera målet.

Om du inte har någon privat app följer du dokumentationen till Skapa en privat app i HubSpot.

VIKTIGT

Det privata programmet bör tilldelas följande omfång:
crm.objects.contacts.write, crm.objects.contacts.read
crm.schemas.contacts.write, crm.schemas.contacts.read

Autentiseringsuppgifter Beskrivning Exempel
Bearer token The Access token på HubSpot privat app.
För att få HubSpot Access token följer HubSpot dokumentation till göra API-anrop med appens åtkomsttoken.
pat-na1-11223344-abcde-12345-9876-1234a1b23456

Guardrails

HubSpot privata appar är beroende av Hastighetsgränser. Antalet samtal som din privata app kan ringa baseras på din HubSpot kontoprenumeration och om du har köpt API-tillägget. Se även Andra begränsningar.

Identiteter som stöds

HubSpot har stöd för uppdatering av identiteter som beskrivs i tabellen nedan. Läs mer om identiteter.

Målidentitet Exempel Beskrivning Överväganden
email test@test.com Kontaktens e-postadress. Obligatoriskt

Målgrupper

I det här avsnittet beskrivs alla målgrupper som du kan exportera till det här målet.

Detta mål stöder aktivering av alla målgrupper som genererats via Experience Platform Segmenteringstjänst.

Detta mål stöder även aktivering av målgrupperna som beskrivs i tabellen nedan.

Målgruppstyp Beskrivning
Anpassade överföringar Målgrupper importerad till Experience Platform från CSV-filer.

Exportera typ och frekvens

Se tabellen nedan för information om exporttyp och frekvens för destinationen.

Objekt Typ Anteckningar
Exporttyp Profile-based
  • Du exporterar alla medlemmar i en målgrupp tillsammans med de önskade schemafälten (t.ex. e-postadress, telefonnummer, efternamn), enligt fältmappningen.
  • Dessutom skapas en ny egenskap i HubSpot med målgruppsnamnet och dess värde med motsvarande målgruppsstatus från Platform, för var och en av de valda målgrupperna.
Exportfrekvens Streaming
  • Direktuppspelningsmål är alltid på API-baserade anslutningar. Så snart en profil uppdateras i Experience Platform baserat på målgruppsutvärdering skickar anslutningsprogrammet uppdateringen nedströms till målplattformen. Läs mer om mål för direktuppspelning.

Anslut till målet

VIKTIGT

Om du vill ansluta till målet behöver du Manage Destinations behörighet för åtkomstkontroll. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.

Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekurs om destinationskonfiguration. I arbetsflödet för att konfigurera mål fyller du i fälten som listas i de två avsnitten nedan.

Inom Destinations > Catalog sök efter HubSpot. Du kan även hitta den under CRM kategori.

Autentisera till mål

Fyll i de obligatoriska fälten nedan. Se Samla HubSpot åtkomsttoken för privat app för vägledning.

  • Bearer token: Åtkomsttoken för HubSpot privat app.

Om du vill autentisera mot målet väljer du Connect to destination.
Skärmbild av användargränssnittet för plattformen som visar hur man autentiserar.

Om den angivna informationen är giltig visas en Connected status med en grön bockmarkering. Du kan sedan gå vidare till nästa steg.

Fyll i målinformation

Om du vill konfigurera information för målet fyller du i de obligatoriska och valfria fälten nedan. En asterisk bredvid ett fält i användargränssnittet anger att fältet är obligatoriskt.
Skärmbild för användargränssnittet för plattformen som visar målinformationen.

  • Name: Ett namn som du känner igen det här målet med i framtiden.
  • Description: En beskrivning som hjälper dig att identifiera det här målet i framtiden.

Aktivera aviseringar

Du kan aktivera varningar för att få meddelanden om dataflödets status till ditt mål. Välj en avisering i listan om du vill prenumerera och få meddelanden om statusen för ditt dataflöde. Mer information om varningar finns i guiden på prenumerera på destinationsvarningar med användargränssnittet.

När du är klar med informationen för målanslutningen väljer du Next.

Aktivera målgrupper till det här målet

VIKTIGT

För att aktivera data behöver du Manage Destinations, Activate Destinations, View Profiles och View Segments behörigheter för åtkomstkontroll. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.

Läs Aktivera profiler och målgrupper för att strömma målgruppernas exportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.

Mappa attribut och identiteter

Så här skickar du målgruppsdata från Adobe Experience Platform till HubSpot mål måste du gå igenom fältmappningssteget. Mappningen består av att skapa en länk mellan XDM-schemafälten (Experience Data Model) i ditt plattformskonto och motsvarande motsvarigheter från målmålet.

Mappa XDM-fälten korrekt till HubSpot målfält, följ stegen nedan:

Mappa Email identity

The Email Identitet är en obligatorisk mappning för det här målet. Följ stegen nedan för att mappa den:

  1. I Mapping steg, välja Add new mapping. Nu kan du se en ny mappningsrad på skärmen.
    Skärmbild för plattformsgränssnitt med knappen Lägg till ny mappning markerad.
  2. I Select source field väljer du Select identity namespace och välj en identitet.
    Skärmbild för plattformsgränssnitt som väljer e-post som ett källattribut att mappa som identitet.
  3. I Select target field väljer du Select attributes och markera email.
    Skärmbild för plattformsgränssnitt som väljer e-post som ett målattribut att mappa som identitet.
Källfält Målfält Obligatoriskt
IdentityMap: Email Identity: email Ja

Ett exempel med identitetsmappning visas nedan:
Exempel på skärmavbild för plattformsgränssnitt med mappning av e-postidentitet.

Mappning valfri attributes

Lägga till andra attribut som du vill uppdatera mellan XDM-profilschemat och HubSpot upprepa stegen nedan:

  1. I Mapping steg, välja Add new mapping. Nu kan du se en ny mappningsrad på skärmen.
    Skärmbild för plattformsgränssnitt med knappen Lägg till ny mappning markerad.
  2. I Select source field väljer du Select attributes och välj XDM-attributet.
    Skärmbild för plattformsgränssnitt där förnamn väljs som källattribut.
  3. I Select target field fönster, välja Select attributes och välj i listan över attribut som automatiskt fylls i från HubSpot konto. Målet använder HubSpot Egenskaper API för att hämta den här informationen. Båda HubSpot standardegenskaper och anpassade egenskaper hämtas för markering som målfält.
    Skärmbild för plattformsgränssnitt där förnamn väljs som målattribut.

Några tillgängliga mappningar mellan XDM-profilschemat och Hubspot visas nedan:

Källfält Målfält
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

Ett exempel som använder dessa attributmappningar visas nedan:
Skärmbild för plattformsgränssnitt med attributmappningar.

När du är klar med mappningarna för målanslutningen väljer du Next.

Validera dataexport

Följ stegen nedan för att verifiera att du har konfigurerat målet korrekt:

  1. Logga in på HubSpot webbplatsen och sedan navigera till Contacts sida för att kontrollera målgruppsstatus. Den här listan kan konfigureras för att visa kolumner för anpassade egenskaper som har skapats med målgruppens namn och deras värde är målgruppsstatus.
    HubSpot UI, skärmbild som visar sidan Kontakter med kolumnrubriker som visar målgruppsnamnet och cellernas målgruppsstatus

  2. Du kan även gå ned i en individ Person och navigera till egenskaperna som visar målgruppsnamnet och målgruppsstatus.
    HubSpot-användargränssnittet visar kontaktsidan med anpassade egenskaper som visar målgruppsnamnet och målgruppsstatus.

Dataanvändning och styrning

Alla Adobe Experience Platform destinationerna är kompatibla med dataanvändningsprinciper när data hanteras. Detaljerad information om hur Adobe Experience Platform använder datastyrning, se Datastyrning - översikt.

Ytterligare resurser

Ytterligare användbar information från HubSpot dokumentationen nedan:

Changelog

I det här avsnittet beskrivs funktionaliteten och viktiga dokumentationsuppdateringar för den här målanslutningen.

 Visa ändringslogg
Releasamånad Uppdateringstyp Beskrivning
September 2023 Inledande version Ursprunglig målversion och dokumentationspublicering.

På denna sida