HubSpot verbinding

HubSpot ​ is een platform van CRM met alle software, integratie, en middelen u marketing, verkoop, inhoudsbeheer, en de klantendienst moet verbinden. Het staat u toe om uw gegevens, teams, en klanten op één platform van CRM te verbinden.

Dit Adobe Experience Platform ​ bestemmings ​ hefboomwerkingen HubSpot Contactpersonen API ​, om contacten binnen HubSpot van een bestaand publiek van Experience Platform na activering bij te werken.

De instructies om aan uw HubSpot instantie voor authentiek te verklaren zijn verder hieronder, in ​ voor authentiek verklaren aan bestemmings ​ sectie.

Gebruiksscenario’s use-cases

Om u beter te helpen begrijpen hoe en wanneer u de HubSpot bestemming zou moeten gebruiken, is hier een geval van het steekproefgebruik dat de klanten van Adobe Experience Platform kunnen oplossen door deze bestemming te gebruiken.

HubSpot slaat informatie over de individuen op die met uw zaken in wisselwerking staan. Uw team gebruikt de contactpersonen in HubSpot om het Experience Platform-publiek op te bouwen. Nadat deze doelgroepen naar HubSpot zijn verzonden, worden hun gegevens bijgewerkt en wordt aan elke contactpersoon een eigenschap toegewezen met de waarde ervan als de publieksnaam die aangeeft tot welk publiek de contactpersoon behoort.

Vereisten prerequisites

Raadpleeg de onderstaande secties voor alle voorwaarden die u in Experience Platform en HubSpot moet instellen en voor informatie die u moet verzamelen voordat u met het HubSpot -doel kunt werken.

Experience Platform-voorwaarden prerequisites-in-experience-platform

Alvorens gegevens aan de HubSpot bestemming te activeren, moet u a ​ schema ​, a ​ dataset ​ hebben, en ​ publiek ​ dat in Experience Platform wordt gecreeerd.

Verwijs naar de documentatie van Experience Platform voor ​ het schemagroep van de Details van het Lidmaatschap van de Publiek ​ als u begeleiding op publieksstatus nodig hebt.

Vereisten voor het doel HubSpot prerequisites-destination

Houd rekening met de volgende voorwaarden om gegevens van Experience Platform naar uw HubSpot -account te exporteren:

U moet een HubSpot -account hebben prerequisites-account

Als u gegevens van Experience Platform naar uw Hubspot -account wilt exporteren, hebt u een HubSpot -account nodig. Als u niet reeds hebt, bezoek de ​ Opstelling uw HubSpot rekening ​ pagina en volg de begeleiding om uw rekening te registreren en te creëren.

Het toegangstoken voor de HubSpot persoonlijke app verzamelen gather-credentials

U hebt uw HubSpot Access token nodig om de HubSpot -bestemming toe te staan API-aanroepen uit te voeren via uw HubSpot persoonlijke app in uw HubSpot -account. Access token dient als Bearer token wanneer u ​ de bestemming ​ voor authentiek verklaart.

Als u geen privé app hebt, volg de documentatie aan ​ creeer privé app in HubSpot ​.

IMPORTANT
Aan de persoonlijke app moeten de onderstaande bereiken worden toegewezen:
crm.objects.contacts.write, crm.objects.contacts.read
crm.schemas.contacts.write, crm.schemas.contacts.read
Credentials
Beschrijving
Voorbeeld
Bearer token
De Access token van uw HubSpot persoonlijke app.
om uw HubSpot te verkrijgen Access token volg de HubSpot documentatie om ​ API vraag met het toegangstoken van uw app ​ te maken.
pat-na1-11223344-abcde-12345-9876-1234a1b23456

Guardrails guardrails

HubSpot privé apps zijn onderworpen aan ​ Grenswaarden van het Tarief ​. Het aantal aanroepen dat uw persoonlijke app kan uitvoeren, is gebaseerd op uw accountabonnement van HubSpot en of u de API-invoegtoepassing hebt aangeschaft. Bovendien verwijs ook naar ​ Andere Beperkingen ​.

Ondersteunde identiteiten supported-identities

HubSpot ondersteunt het bijwerken van de identiteiten die in de onderstaande tabel worden beschreven. Leer meer over ​ identiteiten ​.

Doelidentiteit
Voorbeeld
Beschrijving
Overwegingen
email
test@test.com
E-mailadres van de contactpersoon.
Verplicht

Ondersteunde doelgroepen supported-audiences

In deze sectie worden alle soorten publiek beschreven die u naar deze bestemming kunt exporteren.

Deze bestemming steunt de activering van alle die publiek door de Dienst van de Segmentatie van Experience Platform ​ wordt geproduceerd ​.

Deze bestemming ondersteunt ook de activering van het publiek dat in de onderstaande tabel wordt beschreven.

Type publiek
Beschrijving
Aangepaste uploads
Het publiek ​ ingevoerde ​ in Experience Platform van Csv- dossiers.

Type en frequentie exporteren export-type-frequency

Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.

Item
Type
Notities
Exporttype
Profile-based
  • U exporteert alle leden van een publiek samen met de gewenste schemavelden (bijvoorbeeld: e-mailadres, telefoonnummer, achternaam) volgens uw veldtoewijzing.
  • Bovendien wordt in HubSpot een nieuwe eigenschap gemaakt met de naam van het publiek en heeft de waarde ervan de overeenkomende status van het publiek in Experience Platform voor elk geselecteerd publiek.
Exportfrequentie
Streaming
  • Streaming doelen zijn "altijd aan" API-verbindingen. Zodra een profiel in Experience Platform wordt bijgewerkt dat op publieksevaluatie wordt gebaseerd, verzendt de schakelaar de update stroomafwaarts naar het bestemmingsplatform. Lees meer over ​ het stromen bestemmingen ​.

Verbinden met de bestemming connect

IMPORTANT
Om met de bestemming te verbinden, hebt u View Destinations en Manage Destinations ​ toegangsbeheertoestemmingen ​ nodig. Lees het ​ overzicht van de toegangscontrole ​ of contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Om met deze bestemming te verbinden, volg de stappen die in het ​ leerprogramma van de bestemmingsconfiguratie ​ worden beschreven. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.

Kies in Destinations > Catalog Zoeken naar HubSpot . U kunt de locatie ook in de categorie CRM vinden.

Verifiëren voor bestemming authenticate

Vul de vereiste velden hieronder in. Verwijs naar ​ verzamelen de HubSpot privé app toegangstoken ​ sectie voor om het even welke begeleiding.

  • Bearer token: het toegangstoken voor uw HubSpot persoonlijke app.

Selecteer Connect to destination als u wilt verifiëren bij het doel.
{het schermschot van 0} Experience Platform UI die toont hoe te voor authentiek te verklaren.

Als de opgegeven gegevens geldig zijn, geeft de gebruikersinterface de status Connected weer met een groen vinkje. Vervolgens kunt u verdergaan met de volgende stap.

Doelgegevens invullen destination-details

Als u details voor de bestemming wilt configureren, vult u de vereiste en optionele velden hieronder in. Een sterretje naast een veld in de gebruikersinterface geeft aan dat het veld verplicht is.
{het schermschot van 0} Experience Platform UI die de bestemmingsdetails toont.

  • Name: Een naam waarmee u dit doel in de toekomst herkent.
  • Description: Een beschrijving die u zal helpen deze bestemming in de toekomst identificeren.

Waarschuwingen inschakelen enable-alerts

U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Voor meer informatie over alarm, zie de gids bij ​ het intekenen aan bestemmingsalarm gebruikend UI ​.

Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next .

Soorten publiek naar dit doel activeren activate

IMPORTANT
Om gegevens te activeren, hebt u View Destinations, Activate Destinations, View Profiles, en View Segments ​ toegangsbeheertoestemmingen ​ nodig. Lees het ​ overzicht van de toegangscontrole ​ of contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Lees ​ activeer profielen en publiek aan het stromen publiek uitvoerbestemmingen ​ voor instructies bij het activeren van publiek aan deze bestemming.

Kenmerken en identiteiten toewijzen map

Als u uw publieksgegevens correct vanuit Adobe Experience Platform naar de HubSpot -bestemming wilt verzenden, moet u de stap voor veldtoewijzing doorlopen. Toewijzing bestaat uit het maken van een koppeling tussen de schemavelden van uw Experience Data Model (XDM) in uw Experience Platform-account en de overeenkomstige equivalenten van de doelbestemming.

Voer de onderstaande stappen uit om uw XDM-velden correct toe te wijzen aan de HubSpot -doelvelden:

De identiteit van Email toewijzen

De identiteit van Email is een verplichte toewijzing voor dit doel. Voer de onderstaande stappen uit om deze toe te wijzen:

  1. Selecteer Add new mapping in de stap Mapping . U ziet nu een nieuwe toewijzingsrij op het scherm.
    {het schermschot van 0} Experience Platform UI met toegevoegde nieuwe benadrukte toewijzingsknoop.
  2. Kies in het Select source field -venster de Select identity namespace en selecteer een identiteit.
    {het schermschot van 0} Experience Platform UI die e-mail als bronattribuut selecteert om als identiteit in kaart te brengen.
  3. Kies in het Select target field -venster de Select attributes en selecteer email .
    {het schermschot van 0} Experience Platform UI die e-mail als doelattribuut selecteert om als identiteit in kaart te brengen.
Source-veld
Doelveld
Verplicht
IdentityMap: Email
Identity: email
Ja

Hieronder ziet u een voorbeeld met de identiteitstoewijzing:
het schermschot van Experience Platform UI met e-mailidentiteitstoewijzing.

Het in kaart brengen facultatieve attributen

Als u andere kenmerken wilt toevoegen die u tussen het XDM-profielschema en uw HubSpot -account wilt bijwerken, herhaalt u de onderstaande stappen:

  1. Selecteer Add new mapping in de stap Mapping . U ziet nu een nieuwe toewijzingsrij op het scherm.
    {het schermschot van 0} Experience Platform UI met toegevoegde nieuwe benadrukte toewijzingsknoop.
  2. Kies in het venster Select source field de categorie Select attributes en selecteer het XDM-kenmerk.
    het schermschot van Experience Platform UI die Voornaam als bronattribuut selecteert.
  3. Kies in het venster Select target field de categorie Select attributes en selecteer een van de kenmerken die automatisch worden ingevuld in uw HubSpot -account. De bestemming gebruikt HubSpot Eigenschappen ​ API om deze informatie terug te winnen. Zowel HubSpot ​ standaardeigenschappen ​ als om het even welke douaneeigenschappen worden teruggewonnen voor selectie als doelgebieden.
    {het schermschot van 0} Experience Platform UI die Voornaam als doelattribuut selecteert.

Hieronder worden enkele beschikbare toewijzingen weergegeven tussen uw XDM-profielschema en Hubspot :

Source-veld
Doelveld
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

Hieronder ziet u een voorbeeld waarin deze kenmerktoewijzingen worden gebruikt:
het schermschot van Experience Platform UI met attributenafbeeldingen.

Wanneer u klaar bent met het opgeven van de toewijzingen voor uw doelverbinding, selecteert u Next .

Gegevens exporteren valideren exported-data

Volg onderstaande stappen om te controleren of u de bestemming correct hebt ingesteld:

  1. Meld u aan bij de HubSpot -website en navigeer naar de Contacts -pagina om de status van het publiek te controleren. Deze lijst kan worden gevormd om kolommen voor de douaneeigenschappen te tonen die met de publieksnaam met hun waarde worden gecreeerd de publieksstatus zijn.
    het schermschot van HubSpot UI die de pagina van Contacten met kolomkopballen toont die de publieksnaam en de statistieken van het celpubliek tonen

  2. U kunt ook omlaag naar een afzonderlijke Person -pagina gaan en naar de eigenschappen navigeren die de publieksnaam en de publieksstatus weergeven.
    HubSpot UI het schermschot die de pagina van het Contact met douaneeigenschappen toont die de publieksnaam en de publieksstatussen tonen.

Gegevensgebruik en -beheer data-usage-governance

Alle Adobe Experience Platform -doelen zijn compatibel met het beleid voor gegevensgebruik bij het verwerken van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform gegevensbeheer afdwingt, zie het ​ overzicht van het Beleid van Gegevens ​.

Aanvullende bronnen additional-resources

Hieronder vindt u aanvullende nuttige informatie uit de documentatie van HubSpot :

Changelog

Deze sectie vangt de functionaliteit en de significante documentatieupdates aan deze bestemmingsschakelaar worden aangebracht die.

Wijzigingen weergeven
table 0-row-3 1-row-3 layout-auto
Releasedatum Type bijwerken Beschrijving
September 2023 Eerste release Oorspronkelijke doelversie en documentatie publiceren.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6