> 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/magento.md).

# Magento

Koppel Magento 2 met integratiegegevens voor bestellingen, omzet, producten en voorraad.

Koppel Magento 2 zodat AdPage rechtstreeks bestellingen en productgegevens uit je winkel kan ophalen. Magento heeft geen OAuth-flow voor consumenten, dus dit is een verbinding met inloggegevens: je maakt een integratie aan in de Magento-beheeromgeving en plakt vier waarden in AdPage.

AdPage leest alleen gegevens. Het schrijft nooit een bestelling, product of prijs weg.

### Voordat je begint

Je hebt nodig **beheerdersrechten voor de Magento-beheeromgeving**, en de REST API van je winkel moet bereikbaar zijn via internet. Een stagingomgeving achter een IP-allowlist of basisauthenticatie doorstaat de verbindingstest niet — terecht, want AdPage kan er daadwerkelijk geen verbinding mee maken.

Je maakt een Magento- *integratie* aan, die vier waarden oplevert:

| Waarde                | Naam in Magento     |
| --------------------- | ------------------- |
| Consumentensleutel    | Consumer Key        |
| Consumentengeheim     | Consumer Secret     |
| Toegangstoken         | Access Token        |
| Geheime toegangstoken | Access Token Secret |

{% hint style="warning" %}
**Magento toont deze waarden maar één keer.** Nadat je de integratie hebt geactiveerd, worden de vier waarden op één scherm weergegeven, en daarna nooit meer. Kopieer ze alle vier voordat je het scherm sluit. Ben je ze kwijt, dan moet je de integratie verwijderen en een nieuwe maken.
{% endhint %}

### Maak de integratie aan in Magento

{% stepper %}
{% step %}

#### Open het scherm met integraties

Ga in de Magento-beheeromgeving naar **Systeem → Extensies → Integraties** en selecteer **Nieuwe integratie toevoegen**. Geef de integratie een herkenbare naam, zoals `AdPage`.
{% endstep %}

{% step %}

#### Geef de juiste bronnen leestoegang

Stel onder **API**bij Resource Access de toegang in en selecteer minimaal **Verkoop → Bewerkingen → Bestellingen** (inclusief **Acties → Bekijken**), **Catalogus → Producten**, en **Winkels → Instellingen → Alle winkels** (de verbindingstest leest de winkelconfiguratie, en voor [de volledige Magento-omzet](https://docs.adpage.io/data-and-insights/data-and-insights-nl/data-studio/full-magento-revenue.md) zijn de namen van je winkelweergaven nodig). Volledige toegang verlenen werkt ook, als je beleid dat toestaat.
{% endstep %}

{% step %}

#### Activeer de integratie en kopieer de vier waarden

Sla op, selecteer vervolgens **Activeren** op de integratieregel en bevestig. Magento toont de vier waarden — kopieer ze nu allemaal.
{% endstep %}
{% endstepper %}

### Koppel Magento in AdPage

{% stepper %}
{% step %}

#### Open de tegel

Ga naar **Integraties**, selecteer de container en open de **Magento** tegel.

<figure><img src="https://3085749494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5kjEu8mwstNkOrvFl6S%2Fuploads%2F7PIGMqu7n9IEfh38r7Rr%2Fintegrations-magento-tile-en.webp?alt=media" alt="Magento tile opened with the connection fields"><figcaption><p>De Magento-tegel op de pagina Integraties.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Vul de basis-URL en de vier waarden in

De **basis-URL** is je REST-eindpunt, inclusief het API-pad — bijvoorbeeld `https://yourshop.nl/rest/V1`. Een afsluitende slash wordt automatisch verwijderd.

Plak de consumersleutel, het consumergeheim, het toegangstoken en het geheim van het toegangstoken.
{% endstep %}

{% step %}

#### Opslaan

AdPage maakt verbinding met je winkel voordat er iets wordt opgeslagen en leest de winkelconfiguratie uit om te controleren of de inloggegevens werken. Inloggegevens die niet werken, worden nooit opgeslagen. Zo kan de tegel niet aangeven dat de verbinding actief is terwijl alle widgets leeg blijven.

Na een geslaagde verbinding toont de tegel de naam van je winkel, rechtstreeks uit Magento — zo weet je ook zeker dat je de juiste winkel hebt verbonden.
{% endstep %}
{% endstepper %}

### Wat je krijgt

Bestellingen, omzet en productgegevens in **Bedrijfsvoering en omzet** en **Productprestaties**, plus voorraadgegevens voor de Data Assistant: voorraadniveaus, overzichten van niet-voorradige producten en de vraag in verhouding tot de beschikbaarheid.

**De volledige omzet, inclusief bestellingen die in de beheeromgeving zijn aangemaakt.** AdPage bewaart een eigen kopie van je Magento-bestellingen en toont **Omzet (Magento, totaal)** op het dashboard Blended ROAS, uitgesplitst naar webshop, offline, B2B en marketplace. Offertes en telefonische bestellingen waarvoor nooit een orderwebhook wordt verstuurd, zijn inbegrepen. Zie [Volledige Magento-omzet](https://docs.adpage.io/data-and-insights/data-and-insights-nl/data-studio/full-magento-revenue.md).

De omzet uit bestellingen wordt ook gebruikt in het **Marketingmixmodel**, waarvoor een betrouwbare omzetreeks veel belangrijker is dan bijgehouden conversies.

### De cijfers lezen

**De bestelstatus is van belang.** Magento bewaart bestellingen met de status in behandeling, in verwerking, voltooid, geannuleerd en gesloten op dezelfde plek. Een omzetcijfer dat te hoog lijkt, bevat vaak statussen die je niet als verkoop zou tellen. Omzet (Magento, totaal) laat geannuleerde bestellingen buiten beschouwing en trekt terugbetalingen af.

**Meerdere winkelweergaven delen één eindpunt.** Een Magento-installatie met meerdere winkelweergaven retourneert ze allemaal. Als een container maar één winkelweergave moet omvatten, laat dit dan aan de support weten, zodat het bereik kan worden ingesteld.

**De belastingweergave verschilt.** Afhankelijk van de configuratie kan Magento totalen inclusief of exclusief belasting rapporteren. Controleer welke instelling voor jouw winkel geldt voordat je de cijfers met een andere bron vergelijkt.

### Problemen oplossen

**De verbindingstest mislukt direct.** Controleer eerst de basis-URL — deze moet `/rest/V1`bevatten en moet de openbare URL zijn. `http://` in plaats van `https://`, of een staginghost die AdPage niet kan bereiken, leidt hier allebei tot een mislukking.

**‘Unauthorized’ of een 401.** Een van de vier waarden is onjuist, of de integratie is nooit geactiveerd. Een opgeslagen maar niet geactiveerde integratie levert tokens op die niet werken.

**‘Forbidden’ of een 403.** De inloggegevens zijn geldig, maar de integratie heeft geen toegang tot de resources. Bewerk de integratie in Magento en verleen toegang tot de hierboven vermelde resources. Als Magento vraagt om de integratie opnieuw te autoriseren, geeft het een nieuw toegangstoken en geheim uit: plak die opnieuw in de Magento-tegel.

**Omzet (Magento, totaal) meldt dat de bestellingen niet konden worden opgehaald.** De integratie heeft mogelijk geen toegang om bestellingen te lezen. Verleen **Verkoop → Bewerkingen → Bestellingen → Acties → Bekijken**, zoals hierboven.

**Het werkte en is er toen mee gestopt.** Iemand heeft de integratie in Magento verwijderd of opnieuw geactiveerd — bij opnieuw activeren worden nieuwe tokens uitgegeven en de oude ongeldig gemaakt. Maak nieuwe inloggegevens aan en plak ze opnieuw.

**Bestellingen ontbreken voor één winkelweergave.** Zie hierboven bij meerdere winkels.

Kom je er nog steeds niet uit? Neem contact op met <support@adpage.io> en vermeld de container en de basis-URL — nooit de sleutels.


---

# 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/magento.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.
