> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/hubspot.md).

# HubSpot

Koppel HubSpot zodat deals die een fase bereiken die jij kiest, zoals een geaccepteerde offerte, als offline conversies naar Google Ads kunnen worden gestuurd.

Koppel HubSpot zodat AdPage de deals kan zien die je salesteam buiten de webshop sluit. Met **Offline conversies** aan **Databoosts**, gaat een deal die een door jou gekozen fase bereikt (*Offerte geaccepteerd*, bijvoorbeeld) naar Google Ads als conversie. Google Ads leert dan welke klikken klanten opleverden, en niet alleen welke klikken een formulier hebben ingevuld.

AdPage leest alleen: het kan geen deal of contact aanmaken, wijzigen of verwijderen, en er wordt nooit iets teruggeschreven naar HubSpot.

{% hint style="info" %}
**HubSpot maakt deel uit van Offline conversies, dat in een pilot zit.** De tegel verschijnt alleen voor accounts waarvoor deze is ingeschakeld. Als je hem niet ziet, vraag <support@adpage.io> om het in te schakelen.
{% endhint %}

### Voordat je begint

De persoon die koppelt heeft twee dingen tegelijk nodig:

* Een **AdPage-login met toegang tot de container** waartoe de deals behoren. De verbinding wordt per container opgeslagen, en één container koppelt aan één HubSpot-account. Later een ander HubSpot-account koppelen vervangt het eerste.
* Een **HubSpot-gebruiker die apps mag installeren** in dat HubSpot-account: een Super Admin, of een gebruiker met toestemming om apps uit de App Marketplace te installeren. Zonder die toestemming vraag je een beheerder van je HubSpot-account om de koppeling te maken, of om je de toestemming te geven.

AdPage vraagt HubSpot om twee machtigingen, beide alleen-lezen:

| Machtiging in HubSpot       | Wat AdPage ermee doet                                                                                 |
| --------------------------- | ----------------------------------------------------------------------------------------------------- |
| `crm.objects.deals.read`    | Leest de deals die de door jou gekozen fase bereiken, en de pipelines en fasen waaruit je kunt kiezen |
| `crm.objects.contacts.read` | Leest het contact bij zo'n deal, zodat Google de conversie kan koppelen aan een advertentieklik       |

Niets anders: geen toegang tot e-mails, notities, oproepen, tickets, bedrijven of bestanden, en geen schrijfrechten voor iets.

### HubSpot koppelen

{% stepper %}
{% step %}

#### Open de tegel

Ga naar **Integraties** en selecteer de container bovenaan de pagina. Open vervolgens de **HubSpot** tegel in de groep e-mail en lifecycle. Zoeken naar "crm" of "deals" vindt hem ook.
{% endstep %}

{% step %}

#### Verbinden

Selecteer **HubSpot koppelen**. Je wordt doorgestuurd naar HubSpot. Als je HubSpot-gebruiker toegang heeft tot meer dan één HubSpot-account, vraagt HubSpot eerst welk account: kies het account waarin de deals staan.
{% endstep %}

{% step %}

#### AdPage goedkeuren in HubSpot

HubSpot toont de naam van de app, **AdPage**, en de twee bovenstaande machtigingen. Keur ze goed.

{% hint style="warning" %}
**De HubSpot-app van AdPage is nieuw.** HubSpot vraagt je daarom te bevestigen dat je AdPage als integratie vertrouwt voordat je deze kunt koppelen. Dat is normaal: bevestig en ga verder.
{% endhint %}
{% endstep %}

{% step %}

#### Terug in AdPage

Je keert terug naar **Integraties**. De tegel toont je HubSpot-account (het domein en portal-ID) en de HubSpot-gebruiker die het heeft gekoppeld.
{% endstep %}
{% endstepper %}

### Wat je krijgt

HubSpot toont op zichzelf niets in Data Studio. Het is een bron voor **Offline conversies**:

1. Ga naar **Databoosts**, open de **Boosts** tab en open **Offline conversies**.
2. Selecteer **Nieuwe flow**, kies **Deals uit HubSpot die een fase bereiken** en selecteer **Aanmaken**.
3. Kies de **Pipeline** en de **Fase die de deal bereikt**, bijvoorbeeld *Offerte geaccepteerd* of *Gesloten gewonnen*.

Daarna, in de flow:

* **Wat meegaat**: regels voor het dealbedrag, het dealtype, de eigenaar, of het contact een e-mailadres heeft. Brent kan de regels naast de regels in gewone taal voor je instellen, bijvoorbeeld "Alleen deals boven 1.000 euro". Wijzigingen blijven een concept totdat je selecteert **Opslaan**.
* **Waarde en matching**: de conversiewaarde is het bedrag van de deal. Google matcht op het e-mailadres, altijd gehasht; het telefoonnummer en de naam en het adres kunnen ook worden toegevoegd, eveneens gehasht. Kies waarop het delen met Google rust: zonder basis gaat er niets naar Google, zelfs niet voor een controle.
* **Naar welk Google Ads-account**: een Google Ads-account en per pipeline een conversieactie. AdPage kan de conversieactie voor je aanmaken, als secundaire importactie.
* **Proefrun**: wat er gedurende een periode van maximaal 31 dagen zou worden meegestuurd. Er gaat niets naar Google.
* **Laat Google het controleren**: Google controleert de login, het account, de conversieactie en de gegevens van de laatste proefrun, zonder iets vast te leggen.

{% hint style="info" %}
**Een flow inschakelen komt in een volgende stap.** Voor nu kun je flows opzetten, proefruns doen en ze door Google laten controleren. Er gaat nog niets als conversie naar Google Ads.
{% endhint %}

### Wat AdPage uit HubSpot leest

Zolang een flow niet is ingeschakeld, leest AdPage HubSpot alleen terwijl je aan een flow werkt: om je pipelines en fasen te tonen, en wanneer je een proefrun doet of Google het laat controleren. Het leest dan, voor de deals die in de gekozen periode de geselecteerde fase hebben bereikt:

* van de deal: het bedrag, de valuta, het dealtype, de eigenaar, de pipeline, de sluitdatum en wanneer deze de fase heeft bereikt;
* van het eerste contact dat aan de deal is gekoppeld: e-mailadres, telefoon- of mobiel nummer, voor- en achternaam, adres, postcode, stad en land.

Geen van die klantgegevens wordt met de flow opgeslagen. Een proefrun bewaart aantallen, dealnummers, datums en waarden, en welke waarden voorkomen in de regelvelden (zoals je dealtypes), zodat je ze in een regel kunt kiezen. Namen, e-mailadressen of telefoonnummers worden niet bewaard. Alles wat naar Google gaat, wordt eerst gehasht (SHA-256), zoals Google vereist.

### De cijfers lezen

**Het conversietijdstip is wanneer de deal de fase bereikte**, niet de sluitdatum of de aanmaakdatum.

**Alleen het eerste contact bij een deal telt mee.** Een deal zonder contact, of waarvan het contact geen e-mailadres heeft, geeft Google niets om op te matchen. De proefrun telt die als **Zonder e-mailadres**.

**De waarde is het dealbedrag zoals ingevoerd in HubSpot.** HubSpot heeft geen btw, dus of de waarde btw bevat, hangt af van hoe je team het bedrag invult.

**Een lange periode kan te veel zijn voor één proefrun.** De proefrun geeft dan aan dat een deel van de deals wordt getoond. Kies een kortere periode.

### Probleemoplossing

**De HubSpot-tegel ontbreekt.** Offline conversies wordt per klant ingeschakeld; zie de opmerking bovenaan deze pagina.

**HubSpot laat je niet goedkeuren.** Je HubSpot-gebruiker mag mogelijk geen apps installeren. Vraag een Super Admin van je HubSpot-account om te koppelen, of om je die toestemming te geven.

**Je keert met een fout terug naar Integraties.** De goedkeuring is geannuleerd of niet voltooid. Selecteer **HubSpot koppelen** opnieuw.

**De tegel toont Toegang verlopen.** AdPage is verwijderd uit de verbonden apps in HubSpot, of de HubSpot-gebruiker die heeft gekoppeld verloor de toegang. Selecteer **Opnieuw verbinden**, bij voorkeur als een HubSpot-gebruiker die bij het bedrijf blijft.

**Een flow kan de HubSpot-pipelines niet laden.** Meestal is de verbinding verlopen: controleer de HubSpot-tegel onder **Integraties**.

**Verbinding verbreken.** Selecteer **Verbreken** in de tegel. AdPage trekt zijn toegang bij HubSpot in en verwijdert zijn kopie ervan. Flows met HubSpot als bron lezen dan niets meer. Je kunt AdPage ook in HubSpot zelf verwijderen, via je verbonden apps.

{% hint style="warning" %}
**HubSpot valt niet onder de dagelijkse verbindingscontrole**, dus bij een verbroken verbinding krijg je geen e-mail. Als je gebruikers of apps wijzigt in HubSpot, controleer daarna de tegel.
{% endhint %}

Nog steeds vastgelopen? Neem contact op met <support@adpage.io> en vermeld de container en wat de tegel liet zien.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/hubspot.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
