DokumentationExperience PlatformAnvändarhandbok om destinationer

HubSpot-anslutning

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

Skapat för:

  • Administratör
  • Användare

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

Det här Adobe Experience Platform målet använder HubSpot kontakt-API för att uppdatera kontakter inom HubSpot från en befintlig Experience Platform-målgrupp efter aktivering.

Instruktioner för autentisering till din HubSpot-instans finns längre ned i avsnittet Autentisera till mål.

Användningsfall use-cases

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

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

Förhandskrav prerequisites

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

Förutsättningar för Experience Platform prerequisites-in-experience-platform

Innan du aktiverar data till målet HubSpot måste du ha ett schema, en datamängd och målgrupper som skapats i Experience Platform.

Se Experience Platform-dokumentationen för schemafältgruppen Information om målgruppsmedlemskap om du behöver vägledning om målgruppsstatus.

Krav för målet HubSpot prerequisites-destination

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

Du måste ha ett HubSpot-konto prerequisites-account

Du måste ha ett HubSpot-konto för att kunna exportera data från Platform till ditt Hubspot-konto. Om du inte redan har en kan du gå till sidan Konfigurera ditt HubSpot-konto och följa anvisningarna för att registrera och skapa ditt konto.

Samla in åtkomsttoken för det privata programmet HubSpot gather-credentials

Du behöver din HubSpot Access token för att HubSpot-destinationen ska kunna göra API-anrop via din privata HubSpot-app i ditt HubSpot-konto. Access token fungerar som Bearer token när du autentiserar målet.

Om du inte har någon privat app följer du dokumentationen för att skapa en privat app i HubSpot.

IMPORTANT
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
Access token för din privata HubSpot-app.
Om du vill hämta din HubSpot Access token följer du HubSpot-dokumentationen för att göra API-anrop med din apps åtkomsttoken.
pat-na1-11223344-abcde-12345-9876-1234a1b23456

Guardrails guardrails

HubSpot privata appar omfattas av tariffgrä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 gränser.

Identiteter som stöds supported-identities

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 supported-audiences

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

Det här målet stöder aktivering av alla målgrupper som genereras via Experience Platform segmenteringstjänsten.

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

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

Exportera typ och frekvens export-type-frequency

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 (till exempel e-postadress, telefonnummer, efternamn), enligt fältmappningen.
  • Dessutom skapas en ny egenskap i HubSpot med målgruppsnamnet och dess värde är 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 direktuppspelningsmål.

Anslut till målet connect

IMPORTANT
Om du vill ansluta till målet behöver du behörigheterna View Destinations och Manage Destinations åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

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

I Destinations > Catalog söker du efter HubSpot. Du kan också hitta den under kategorin CRM.

Autentisera till mål authenticate

Fyll i de obligatoriska fälten nedan. Mer information finns i avsnittet Samla in HubSpot åtkomsttoken för privata appar.

  • Bearer token: Åtkomsttoken för din privata HubSpot-app.

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

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

Fyll i målinformation destination-details

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 plattformsgränssnitt 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 enable-alerts

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 prenumerera på destinationsvarningar med användargränssnittet.

Välj Next när du är klar med att ange information för målanslutningen.

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

IMPORTANT
För att aktivera data behöver du behörigheterna View Destinations, Activate Destinations, View Profiles och View Segments åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

Läs Aktivera profiler och målgrupper för att direktuppspela målgruppsexportdestinationer för instruktioner om hur du aktiverar målgrupper till det här målet.

Mappa attribut och identiteter map

Om du vill skicka målgruppsdata från Adobe Experience Platform till målet HubSpot 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.

Följ stegen nedan för att mappa dina XDM-fält korrekt till målfälten för HubSpot:

Mappar identiteten Email

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

  1. Välj Add new mapping i steget Mapping. Nu kan du se en ny mappningsrad på skärmen.
    Skärmbild för plattformsgränssnitt med knappen för att lägga till ny mappning markerad.
  2. I fönstret Select source field väljer du Select identity namespace och väljer en identitet.
    Plattformsgränssnitt, skärmbild som väljer e-post som ett källattribut att mappa som identitet.
  3. I fönstret Select target field väljer du Select attributes och sedan email.
    Plattformsgränssnitt, skärmbild som väljer e-post som målattribut att mappa som identitet.
Source Field
Målfält
Obligatoriskt
IdentityMap: Email
Identity: email
Ja

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

Mappa valfria attribut

Om du vill lägga till andra attribut som du vill uppdatera mellan XDM-profilschemat och ditt HubSpot-konto upprepar du stegen nedan:

  1. Välj Add new mapping i steget Mapping. Nu kan du se en ny mappningsrad på skärmen.
    Skärmbild för plattformsgränssnitt med knappen för att lägga till ny mappning markerad.
  2. I fönstret Select source field väljer du kategorin Select attributes och väljer XDM-attributet.
    Plattformsgränssnitt, skärmbild som väljer Förnamn som källattribut.
  3. Välj kategorin Select attributes i fönstret Select target field och välj i listan över attribut som fylls i automatiskt från ditt HubSpot-konto. Målet använder API:t HubSpot Properties för att hämta den här informationen. Både HubSpot standardegenskaper och eventuella anpassade egenskaper hämtas för markering som målfält.
    Plattformsgränssnitt, skärmbild som väljer Förnamn som målattribut.

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

Source Field
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:
Exempel på skärmbild för plattformsgränssnitt med attributmappningar.

Välj Next när du är klar med mappningarna för målanslutningen.

Validera dataexport exported-data

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

  1. Logga in på webbplatsen HubSpot och navigera sedan till sidan Contacts 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 på en enskild Person-sida och navigera till egenskaperna som visar målgruppens namn och målgruppens status.
    HubSpot UI-skärmbild som visar kontaktsidan med anpassade egenskaper som visar målgruppens namn och målgruppens status.

Dataanvändning och styrning data-usage-governance

Alla Adobe Experience Platform-mål är kompatibla med dataanvändningsprinciper när data hanteras. Mer information om hur Adobe Experience Platform använder datastyrning finns i Datastyrningsöversikten.

Ytterligare resurser additional-resources

Ytterligare användbar information från dokumentationen för HubSpot finns nedan:

Changelog

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

Visa ändringslogg
table 0-row-3 1-row-3 layout-auto
Releasamånad Uppdateringstyp Beskrivning
September 2023 Inledande version Ursprunglig målversion och dokumentationspublicering.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6