> 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/adpage-feed-je-eigen-api.md).

# AdPage Feed (je eigen API)

Lever wekelijkse omzet en retouren uit je eigen ERP- of bronsysteem via drie read-only eindpunten.

Als je echte omzet ergens zit waarvoor AdPage geen integratie heeft — een maatwerk-ERP, een groothandelsysteem, een kassa in een fysieke winkel — kun je het zelf aanbieden. **AdPage Feed v1** is een klein contract: drie GET-endpoints, één sleutel, alleen wekelijkse totalen.

{% hint style="info" %}
Deze integratie wordt per klant vrijgegeven. Als je de tegel niet ziet, vraag <support@adpage.io> om het te activeren.
{% endhint %}

### Waarom dit bestaat

Het Marketing Mix Model draait op één omzetcijfer per week: het getal dat je advertentiebudget moet verklaren. Hoe dichter dat getal bij je werkelijke omzet ligt, hoe betrouwbaarder de conclusies van het model zijn.

Tracking meet iets dat iets afwijkt van je boekhouding, en het meet winkelomzet helemaal niet. Dat doet je bronsysteem. Met deze koppeling kun je dat getal aanleveren zonder dat AdPage ooit in je ERP hoeft te kijken.

### Wat AdPage vraagt, en wat het niet vraagt

| Gevraagd                                     | Nooit gevraagd                        |
| -------------------------------------------- | ------------------------------------- |
| Omzet per ISO-week per verkoopkanaal         | Bestellingen, orderregels, klanten    |
| Retourwaarde per week per kanaal (optioneel) | Persoonsgegevens                      |
| Leesrechten via één sleutel                  | Schrijftoegang van welke aard dan ook |
| Eén keer ophalen per week                    | Realtime of dagelijkse polling        |

Een statische sleutel op drie alleen-lezen endpoints is bewust zo klein mogelijk gehouden. Hij doorstaat de meeste securityreviews zonder discussie.

### Drie manieren om te koppelen

**Route A — jij bouwt de feed (aanbevolen).** Implementeer de drie endpoints uit de [technische specificatie](https://docs.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/adpage-feed-je-eigen-api/technical-specification.md). Voor een ontwikkelaar met toegang tot de data is dit een halve dag tot een dag werk. Geen maatwerk aan AdPage-zijde, dus niets om op te wachten.

**Route B — je hebt al een API.** Stuur je documentatie plus één voorbeeldresponse en AdPage laat weten of het zo past. Andere paden, een andere headernaam, andere kanaalnamen en bedragen inclusief btw kunnen aan onze kant worden ingesteld. Als je veldnamen of de vorm van de response afwijken van de specificatie, vertellen we je wat moet veranderen. De voorwaarden die niet omzeild kunnen worden: data per week, onderscheidbaar per verkoopkanaal, en stabiel — twee keer om dezelfde week vragen moet hetzelfde antwoord opleveren.

**Route C — geen API beschikbaar.** De wekelijkse CSV-upload blijft beschikbaar. Het werkt, maar iemand moet het elke week doen, en dat is precies de stap die wordt overgeslagen als het druk wordt.

### Het contract

```
GET {base}/livez                                      → {"status":"ok"}, geen authenticatie
GET {base}/adpage/v1/weekly-revenue?date_from&date_to  → omzet per ISO-week per kanaal
GET {base}/adpage/v1/weekly-returns?date_from&date_to  → retouren per ISO-week per kanaal (optioneel)
```

Vier regels bepalen het contract:

1. Retourneer **hele ISO-weken**, ook wanneer het bereik midden in de week begint of eindigt.
2. De **dezelfde week levert altijd hetzelfde cijfer op**, welk bereik er ook om vroeg.
3. Wanneer een cijfer wordt herzien, **`modified_at` loopt op**.
4. **Eén rij per week per kanaal** — en per locatie of postcodegebied, als je die meestuurt. Geen duplicaten.

Regel 2 is de belangrijkste. Een feed die telkens iets andere cijfers teruggeeft wanneer erom gevraagd wordt, maakt het model op manieren instabiel die later heel moeilijk te diagnosticeren zijn.

Velden, voorbeelden, foutafhandeling en een testscript voor je ontwikkelaar staan in de [technische specificatie](https://docs.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/adpage-feed-je-eigen-api/technical-specification.md).

### Koppel de feed in AdPage

{% stepper %}
{% step %}

#### Open de tegel

Ga naar **Integraties**, selecteer de container en open de **Je eigen API (AdPage Feed)** tegel.
{% endstep %}

{% step %}

#### Vul de basis-URL en de sleutel in

Vul de **bedrijfsnaam**, de **basis-URL** (alleen https, zonder pad), hoe je API de sleutel verwacht — **Authorization: Bearer …** of een **aangepaste header** met die naam — en de **sleutel** zelf. Onder **Geavanceerde instellingen** kun je verschillende paden invoeren voor de revenue- en returns-endpoints.

Een paar instellingen staan niet in de tegel: een btw-tarief anders dan 21% voor een feed die alleen bedragen inclusief btw levert, kanaalnamen anders dan de standaardnamen, en retouren van het doel aftrekken. Vraag support om die in te stellen.
{% endstep %}

{% step %}

#### Testen, dan opslaan

**Alleen testen** vraagt je API echt aan en laat zien wat er zou binnenkomen: hoeveel weken, hoeveel webshop- en winkelomzet, hoeveel retourregels, en welke kanalen buiten het doel blijven. **Testen & koppelen** doet hetzelfde en slaat alleen op als het werkt.

Een koppeling die voor de laatste vier weken geen bruikbare wekelijkse omzet teruggeeft, wordt nooit opgeslagen — anders zou die in de wekelijkse job blijven staan en stilletjes falen. De sleutel gaat naar de server en komt nooit terug.
{% endstep %}

{% step %}

#### De historie komt vanzelf binnen

Direct na het koppelen haalt AdPage de laatste twee jaar op. Als die run tegen zijn tijdslimiet aanloopt, zegt de tegel dat: klik **Haal historie nu op** voor de rest. Wat is opgehaald is compleet, en een herhaling kan nooit dubbel tellen: de blokken overlappen op hun grensweek en de tabellen dedupliceren zichzelf.

Daarna haalt AdPage elke dinsdagochtend opnieuw de laatste twee jaar op, zodat late boekingen en correcties worden meegenomen.
{% endstep %}
{% endstepper %}

### De sleutel roteren

Maak een primaire en een secundaire sleutel aan, zodat je zonder onderbreking kunt roteren. Open de tegel, kies **Sleutel vervangen**, plak de nieuwe sleutel en sla op. De nieuwe sleutel wordt eerst getest; als de test mislukt, blijft de oude sleutel staan. Alle andere instellingen blijven zoals ze zijn.

### Probleemoplossing

**`/livez` mislukt.** De basis-URL is verkeerd of het endpoint is niet bereikbaar vanaf internet. Het gebruikt bewust geen authenticatie; als het toch een sleutel vraagt, ligt het daaraan.

**Authenticatie mislukt op de data-endpoints.** Controleer hoe de sleutel wordt verzonden. `Authorization: Bearer …` en een aangepaste header zoals `X-API-Key` zonder prefix zijn beide gebruikelijk, en ze verwarren is meestal de oorzaak.

**AdPage meldt een omleiding.** Vul de uiteindelijke URL in. Omleidingen worden niet gevolgd.

**De test bereikt de API, maar vindt geen bruikbare omzet.** Er is geen data voor de laatste vier weken, `date_from` en `date_to` worden niet toegepast, of de kanaalwaarden zijn niet wat AdPage herkent. Het bericht somt de ontvangen kanalen op.

**Je cijfers wijken ongeveer met het btw-tarief af van de eigen meting van AdPage.** Dat is meestal correct: het model draait op omzet exclusief btw, terwijl tracking deze inclusief btw meet. De tegel zegt dat wanneer het verschil klopt. Zo niet, controleer dan of `revenue_excl_vat` echt exclusief btw is.

**Het model gaat na verloop van tijd vreemd gedrag vertonen.** Controleer regel 2 — of dezelfde week nog steeds hetzelfde cijfer oplevert. Een feed die uit een live tabel leest zonder cut-offdatum, gaat driften.

Nog steeds vastgelopen? Neem contact op met <support@adpage.io> met de container en de basis-URL — nooit de sleutel.


---

# 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/adpage-feed-je-eigen-api.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.
