Importbestanden instellen
Laatst bijgewerkt: december 3, 2024
Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:
Alle producten en plannen |
Bekijk de volgende limieten en vereisten voordat je gegevens importeert in HubSpot. Je kunt ook voorbeeldbestanden openen of genereren om je op weg te helpen.
Raadpleeg dit artikel voor meer informatie over de importeertool. Als je bestand klaar is, lees je hoe je importeert.
Technische vereisten en beperkingen
Alle bestanden die worden geïmporteerd in HubSpot moeten:- Een .csv-, .xlsx- of .xls-bestand zijn.
- Slechts één sheet hebben.
- Een header-rij bevatten waarin elke kolomkop overeenkomt met een eigenschap in HubSpot. De kolomkoppen kunnen in willekeurige volgorde worden geplaatst zonder dat dit invloed heeft op het importeren. Je kunt controleren of er al een standaard eigenschap bestaat die overeenkomt met je koptekst of een aangepaste eigenschap maken voordat je importeert. Meer informatie over vereisten voor eigenschappen.
- Minder dan 1000 kolommen bevatten.
- UTF-8-gecodeerd zijn als er vreemde taaltekens in staan.
- Als je een Excel-bestand importeert:
- Gegevens bevatten die onder de maximale limieten van Excel voor werkbladen en werkmappen blijven.
- Cellen in getalnotatie bevatten bij het importeren van eigenschappen van datum- en tijdkiezers.
Er zijn extra technische limieten voor de importeertool, afhankelijk van je HubSpot abonnement. Deze limieten zijn onder andere de limiet voor de grootte en het aantal rijen van een importbestand en het aantal bestanden en rijen dat je per dag kunt importeren.
- Als je de gratis tools van HubSpot gebruikt, kun je dat doen:
- Bestanden tot 20 MB importeren.
- Tot 50 imports per dag voltooien.
- Tot 500.000 rijen per dag importeren. Als je een bestand importeert dat meer dan 500.000 rijen bevat, duurt het meerdere dagen om het te voltooien.
- Als je account een Starter, Professional of Enterprise abonnement heeft, kun je:
- Bestanden tot 512 MB importeren.
- Tot 500 imports per dag voltooien.
- Tot 10.000.000 rijen per dag importeren, met een limiet van 1.048.576 rijen per bestand. Als je importeert via de import-API, kun je tot 80.000.000 rijen per dag importeren.
Deze limieten zijn van toepassing op een voortschrijdende periode van 24 uur en worden niet gereset op een specifiek tijdstip. Meer informatie over uw HubSpot abonnement en de bijbehorende beperkingen.
Waarden opmaken
Voor elke rij van je importbestand kun je waarden toevoegen voor de kolommen met eigenschappen. De opmaak van een waarde hangt af van het type eigenschapveld en het doel van de import.
Waarden opmaken op basis van veldtype eigenschap
Afhankelijk van het type eigenschap zijn er specifieke opmaakvereisten:
Veldtype | Vereisten |
Datumkiezer Datum- en tijdkiezer |
Maanden kunnen een getal, drie letters of een volledige naam zijn (10, OCT, Oct, OCTOBER, October), jaren kunnen twee cijfers of vier zijn (2023, 23) en scheidingstekens kunnen een forward slash, koppelteken of punt zijn (10/28/2023, 10-28-2023, 10.28.2023). Geldige datumnotaties zijn dag maand jaar (bijv. 28/10/2023), maand dag jaar (bijv. 10-28-23) of jaar maand dag (bijv. 2023.OCT.28). Als je validatieregels hebt ingesteld, moeten je geïmporteerde waarden de regels volgen, anders worden ze niet geïmporteerd. |
Datum- en tijdkiezer |
Tijdstempels kunnen worden toegevoegd als hh:mm (28/10/2020 14:30) in alle bestandstypen of als een UNIX-tijdstempel in milliseconden in CSV-bestanden of een Excel-bestand met cellen in de indeling Tekstnummer. Als je geen tijdstempel toevoegt, wordt de tijd standaard ingesteld op middernacht. |
Duur |
Voor eigenschappen die een duur bevatten, zoals de eigenschap Call duration, moeten uw waarden worden opgemaakt als een UNIX-tijdstempel in milliseconden. Leer meer over hoe u tijdstempelwaarden opmaakt en hoe u een datum converteert naar de UNIX-notatie. |
Enumeratie |
De waarden in je importbestand moeten overeenkomen met het label of de interne waarde van de gedefinieerde opties van de eigenschap. Voor Hubspot standaard opsommingseigenschappen (bijv. Levenscyclusfase, Industrie), moeten de waarden overeenkomen met de interne waarde of het label in het Engels. |
Bestand |
Om bestaande bestanden toe te voegen aan een eigenschap van een bestand, moet je de bestands-ID als waarde opgeven. Je kunt de bestands-ID vinden in het gedeelte Algemeen van de bestandsdetails. |
Meerdere selectievakjes |
Om meerdere waarden te importeren, voeg je een puntkomma toe tussen elke waarde zonder spaties (waarde 1;waarde 2). Deze eigenschap opties moeten worden gemaakt voordat u importeert. Om waarden toe te voegen of toe te voegen, voeg je een puntkomma toe voor de eerste waarde (;waarde 3;waarde 4). Hierdoor wordt de waarde toegevoegd in plaats van de bestaande waarde van de eigenschap te overschrijven. |
Aantal |
Formatteer de waarde op basis van het type eigenschap dat voor het getal is gemaakt:
|
Enkel selectievakje |
Maak een kolom voor het veld met één selectievakje en stel de waarde op elke regel in op Waar of Ja om weer te geven als Ja of aangevinkt in Hubspot of Vals of Nee om weer te geven als Nee of niet aangevinkt in Hubspot. |
Tekst |
Als je validatieregelshebt ingesteld , moeten je geïmporteerde waarden aan de regels voldoen, anders worden ze niet geïmporteerd. |
Gebruiker (Verantwoordelijke) |
Om een verantwoordelijke toe te wijzen aan een record of activiteit tijdens het importeren:
|
Extra contactpersonen of e-maildomeinen van bedrijven
Als je contactpersonen importeert met meer dan één e-mailadres, voeg dan een kolom Extra e-mailadressen toe met hun secundaire e-mailadressen. Als je bedrijven importeert met meer dan één domeinnaam, voeg dan een kolomExtra domeinen toe met hun secundaire domeinen. Als je meerdere e-mails of domeinen in een cel wilt opnemen, scheid je de waarden met puntkomma's (bijv. email@email. com; emailtwo@email.com).
Als u importeert om contactpersonen of bedrijven te maken, kunt u het e-mailadres van een nieuwe contactpersoon of het bedrijfsrecord van een nieuw bedrijf niet instellen op een e-mailadres of domein dat een bestaand extra e-mailadres/domein is voor een ander record.
Blanco cellen
De importeertool negeert lege cellen in een spreadsheet, dus laat bij het importeren van nieuwe eigenschapgegevens cellen leeg voor records zonder waarde voor de eigenschap. Als een bestaande record al een waarde heeft voor de eigenschap binnen HubSpot, zullen lege cellen de bestaande waarde van de eigenschap niet wissen. Om bestaande waarden van eigenschappen in bulk te wissen, kunt u de waarden handmatig bewerken of gebruik de WorkflowactieWaarde eigenschap wissen .Deal medewerkers
Als je medewerkers aan een deal toevoegt via import, voeg dan een Deal medewerker koptekst. Voor elke cel moet je twee of meer gebruikers opnemen, gescheiden door puntkomma's (bijv. user1@example.com;user2@example.com).Productduur en factureringsfrequentie
Bij het importeren van een eigenschap Termijn kunt u de waarde in de kolom Termijn opmaken als een getal in maanden (bijv. 10 voor 10 maanden), als PXM waarbij X het aantal maanden is (bijv. P6M, voor een termijn van 6 maanden) of PXY waarbij X het aantal jaren is (bijv. P1Y, voor een termijn van 1 jaar).
Als u een waarde voor de eigenschap Factureringsfrequentie importeert, gebruik dan maandelijks, jaarlijks of per kwartaal als het product een terugkerende prijssoort heeft. Laat de cel leeg als het product een eenmalige prijs heeft.
Vereiste eigenschappen
Afhankelijk van welke objecten of activiteiten u importeert, zijn de volgende eigenschappen vereist om records te maken en moeten ze als kolomkoppen in uw bestanden worden opgenomen. Als u bedrijfsrecords bijwerkt, moet u een unieke identificatie opnemen (bijv. Record-ID, E-maildomein, bedrijfsnaam).
Hoeweldit niet vereist is, kunt u extra eigenschappen voor elk object importeren, waaronder aangepaste en standaardeigenschappen. Raadpleeg de standaardeigenschappen voor contactpersonen, bedrijven, deals, tickets, oproepen, e-mails, vergaderingen, notities en taken. U kunt ook alle eigenschappen en hun waarden bekijken in uw instellingen voor eigenschappen.
- Contactpersonen: ten minste één van Voornaam, Achternaam of E-mail.
- Bedrijven: ten minste één van Naam of Bedrijfsdomeinnaam.
- Deals: als je nieuwe deals aanmaakt, Dealnaam, Pijplijn en Dealfase.
- Tickets: als je nieuwe tickets aanmaakt, Ticketnaam, Pijplijn en Ticketstatus.
- Afspraken: Afspraakstart. De start van de afspraak moet worden geformatteerd als een eigenschap voor datum en tijd.
- Cursussen: Cursusnaam.
- Advertenties: Naam.
- Diensten: Naam, Pijplijn en Pijplijnfase.
- Producten: als je producten maakt, Prijs per eenheid en Naam.
- Posten: Naam, Hoeveelheid, Prijs en de Record ID of Dealnaam van de bijbehorende deals. Voeg de Product-ID van het product toe als u het poststuk ook koppelt aan een product, dat tijdens het importeren zal worden toegewezen als een eigenschap van de post.
Let op: wanneer je post met deals importeert, wordt het dealbedrag niet bijgewerkt. Om het bijbehorende dealbedrag bij te werken, kun je de posten handmatig bewerken of de posten koppelen aan een deal in HubSpot.
- Calls: Gespreksnotities. Bij het importeren van nieuwe calls is het ook aan te raden om de activiteitendatum op te nemen.
- E-mails: E-mail body en E-mail richting.
- Vergaderingen: Beschrijving vergadering, Begintijd vergadering en Eindtijd vergadering. Bij het importeren van nieuwe vergaderingen wordt het ook aanbevolen om de activiteitendatum op te nemen. De begin- en eindtijd en de activiteitendatum moeten worden geformatteerd als eigenschappen voor datum en tijd.
- Notities: Notitie body.
- Taken: Taaktitel en Vervaldatum. De vervaldatum moet worden opgemaakt als een eigenschap met datum en tijd.
Let op: hoewel het niet verplicht is, wordt het aanbevolen om Activiteitsdatum op te nemen bij het importeren van nieuwe activiteiten om de datum en tijd te specificeren waarop een activiteit plaatsvond. Als je deze eigenschap niet opneemt, worden de activiteitdatumwaarden automatisch ingesteld op de datum en tijd van de import.
Vereisten om bestaande records bij te werken of duplicaten te vermijden
Om bestaande records bij te werken en dubbele records te voorkomen, moeten uw bestanden voor elk object een eigenschap met unieke identificatie bevatten. Voor alle objecten kun je bestaande records exporteren en de Record ID gebruiken als unieke identificatie, of een aangepaste object eigenschap gebruiken die unieke waarden vereist. Voor contactpersonen kunt u ook E-mail gebruiken. Voor bedrijven kun je ook de domeinnaam Bedrijf gebruiken.
Als je meerdere objecten importeert en Record ID's opneemt, is het aan te raden om de kolomkoppen van het bestand te differentiëren zodat de ID overeenkomt met het juiste object (bijv. een kolom met de naam Record ID - Contactpersonen en een andere met de naam Record ID - Bedrijven).
Let op: het volgende gedrag is van toepassing als E-maildomein of bedrijfsnaam zijn opgenomen in je bestand:
- Als u een aangepaste unieke waarde-eigenschap gebruikt om contactpersonen te ontdubbelen, vereist de eigenschap E-mail nog steeds unieke waarden.
- Als u een aangepaste unieke waarde-eigenschap gebruikt om bedrijven te ontdubbelen, vereist de eigenschap Bedrijfsdomeinnaam geen unieke waarden. Dit betekent dat je dubbele bedrijfsdomeinen kunt importeren. Als je niet wilt dat meerdere bedrijven hetzelfde domein hebben, moet je dubbele domeinen uit je bestand verwijderen voordat je importeert, of in plaats daarvan de domeinnaam Bedrijf gebruiken als unieke identificatie.
- Je kunt een tweede e-mailadres gebruiken als unieke identificatie voor bestaande contactpersonen die een tweede e-mailadres hebben in Hubspot. Als je een secundair e-mailadres gebruikt en de kolom Record ID niet in je bestand opneemt, zal het secundaire e-mailadres het primaire e-mailadres niet vervangen. Als je echter zowel de secundaire e-mail als Record ID als kolommen in je bestand opneemt, vervangt de secundaire e-mail de primaire e-mail.
Vereisten om records te associëren
Importeer associaties in één bestand
In één bestand kunt u twee of meer records per rij koppelen. Neem informatie over geassocieerde records en/of activiteiten op in dezelfde rij en neem een unieke identificatie op voor elk object. Als u een record wilt koppelen aan meerdere activiteiten of records van een ander object, neemt u de unieke identificatie van het record op in meerdere rijen voor elk record dat u wilt koppelen.
Luke Danes is bijvoorbeeld manager bij Luke's Diner, maar aannemer bij The Dragonfly Inn. Om hem aan beide bedrijven te koppelen, moet u twee rijen voor Luke Danes opnemen met de kolommen E-mail (of Record ID) en Bedrijfsnaam (of Record ID) voor elk bedrijf.
Let op: als je geen unieke identifiers toevoegt (bijv. E-maildomein, Bedrijfsnaam, Record ID), zal de import dubbele records aanmaken in plaats van ze aan hetzelfde record te koppelen.
Als je dezelfde associaties van objecten importeert, zijn er extra vereisten.
Importeer associaties in twee bestanden
Om records van twee objecten in twee bestanden te associëren, gebruik je een gemeenschappelijke kolom om de records in elk bestand te verbinden. U kunt de voorbeeldbestanden raadplegen voor meer hulp bij het importeren en associëren van records.
Zelfde object associaties
Je kunt één bestand importeren om records van hetzelfde object in bulk te koppelen. Tijdens het importeren moet je een selectievakje inschakelen om dezelfde objectassociaties op te nemen.
Neem bij het opzetten van je bestand informatie op over de gekoppelde records in dezelfde rij en neem een unieke identificatie op voor elk record. De volgende aanvullende vereisten zijn specifiek voor het importeren van hetzelfde object:
- Ten minste één record in een recordpaar moet al bestaan in HubSpot voordat je importeert. Je kunt bijvoorbeeld een nieuw contactpersoon importeren en deze koppelen aan een bestaand contactpersoon, maar je kunt niet importeren om twee nieuwe contactpersonen te maken en te koppelen.
- Wanneer je bestaande contactpersonen/bedrijven associeert, kun je alleen het primairee-maildomein/bedrijfsdomein als unieke identificatie gebruiken. Secundaire e-mails of domeinen worden niet ondersteund.
- Als u meerdere records aan één record koppelt, scheidt u de unieke identificatiewaarden van de records met een puntkomma in dezelfde cel (bijvoorbeeld luke@lukesdiner.com; rory@yale.edu; sookie@dragonfly.com).
In het onderstaande voorbeeldbestand zijn Rory en Jackson nieuwe contactpersonen die worden gekoppeld aan bestaande contactpersonen met unieke labels, waarbij hun e-mailwaarden als unieke identificatie worden gebruikt. Sookie is een bestaande contactpersoon die wordt gekoppeld aan twee bestaande contactpersonen met hetzelfde label. In de eerste rij is het koppelingslabel onderdeel van een labelpaar, wat betekent dat zodra het importeren is voltooid, het gekoppelde record het label Ouder heeft en Rory het gekoppelde label Kind.
Ouder/kind verenigingen
Lees meer over het importeren van dochterondernemingen als u kind-ouder-bedrijf associaties wilt maken via import.
Aangepaste associatielabels (alleenProfessional en Enterprise )
Als je associatielabels wilt importeren, voeg je een kolom Associatielabel toe. Je moet de associatielabels in HubSpot maken voordat je ze importeert.
- Om een bedrijfsassociatie als primair in te stellen, neemt u de waarde Primair op in de kolom Associatie-label voor die rij.
- Als u meerdere labels wilt instellen om de relatie tussen twee records te beschrijven, kunt u meerdere labelwaarden voor associaties in één cel opnemen, gescheiden door een puntkomma (bijvoorbeeld Manager; Contactpersoon facturering).
- Als u associatielabels importeert in een import van meerdere bestanden, moet u de kolom Associatielabel en een unieke identificatie voor het object dat u associeert in hetzelfde bestand opnemen .
- Als je gekoppelde labels importeert:
- Neem voor meerdere objecten associaties slechts een van de labels op in de kolom Associatielabel. De labels worden tijdens het importeren toegewezen aan het juiste object.
- Voor associaties met hetzelfde object krijgt het record in de kolom Gekoppeld [unieke identificatie] het label dat is toegevoegd tijdens het importeren of dat is opgenomen in de labelkolom van het bestand. Het andere record in de rij krijgt het andere label in het paar.
Voorbeeldbestanden
Aan het begin van het importproces kun je een voorbeeldbestand genereren met de vereiste eigenschappen voor de geselecteerde objecten en activiteiten. Als je meer voorbeelden met aanvullende eigenschappen wilt bekijken, raadpleeg dan dit artikel met voorbeeldbestanden.