> 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/faq/faq-nl/marketingoptimalisatie/shopify-shop-campaigns-en-server-side-tracking.md).

# Shopify Shop Campaigns en server-side tracking

Begrijp waarom Shop Campaign-bestellingen backend-attributie, vertraagde tagverwerking en deduplicatie op orderniveau nodig hebben.

## Hoe de twee modellen verschillen

Server-side tracking en Shopify Shop Campagnes verzamelen conversiegegevens op verschillende manieren. Traditionele tracking start in de browser van de shopper. De attributie van Shop Campaigns start in de backend van Shopify.

Dit verschil heeft invloed op attributie, ingestietiming en rapportage. Het verandert ook hoe je dubbele omzet voorkomt.

### Traditionele server-side tracking

Traditionele server-side tracking gebruikt een web-first, op gebeurtenissen gebaseerde architectuur. Een bezoeker opent je storefront, zoals `yourstore.com`. De browser laadt een webcontainer, meestal Google Tag Manager voor web.

De webcontainer legt browserniveau-identificatoren vast. Deze kunnen onder andere het volgende omvatten `_fbp`, `_ga`, IP-adres en user agent. Het stuurt gebeurtenissen via HTTP-verzoeken naar een servercontainer.

De servercontainer valideert, transformeert en stuurt die gebeurtenissen door. Bestemmingen kunnen Meta Conversions API, Google Analytics 4 en een datawarehouse zoals ClickHouse zijn.

```
[Browser van bezoeker]
        │
        ▼
[Storefront + web-GTM]
        │ HTTP-verzoek
        ▼
[Server-side GTM] ──┬──> Meta CAPI / Google Analytics
                    └──> Datawarehouse
```

### Shopify Shop Campagnes

Shopify Shop Campagnes gebruikt een off-site, pay-per-sale-model. Campagnes kunnen producten en aanbiedingen buiten je storefront tonen:

* **Shop-app en web:** Ontdekkingsfeeds, aanbiedingstabbladen, zoekresultaten en `shop.app`.
* **Shopify Product Network:** Gepromote vermeldingen in deelnemende Shopify-winkels.
* **Gegenereerde kanalen:** Plaatsingen op externe netwerken via advertentieaccounts die door Shopify worden beheerd.

De conversie kan plaatsvinden in de native Shopify-checkout of een ingesloten Shop Pay-component. De shopper hoeft je storefront of webcontainer misschien nooit te laden.

```
[Off-site plaatsing]
        │
        ▼
[Shop Pay-checkout]
        │
        ▼
[Shopify-backend] ──> [Campagnetag asynchroon toegevoegd]
        │
        ▼
[Webhooks / Admin API] ──> [Datawarehouse]
```

## Technische vergelijking

| Attribuut                       | Traditionele server-side tracking               | Shopify Shop Campagnes                                      |
| ------------------------------- | ----------------------------------------------- | ----------------------------------------------------------- |
| Locatie van conversie           | Je storefront                                   | Shop-app, `shop.app`, Product Network of native checkout    |
| Primaire trigger                | Browsergebeurtenis doorgestuurd naar server-GTM | Ordergebeurtenissen in de Shopify-backend                   |
| Veelvoorkomende identificatoren | Browsercookies, IP-adres, user agent            | Order-ID, Shopify-klant-ID, e-mail, verzendadres            |
| GTM tijdens aankoop             | Web- en servercontainers verwerken verzoeken    | De aankoop kan beide containers omzeilen                    |
| Attributiebasis                 | Klik-, impressie- of multi-touch-signalen       | Aanbiedings- of actiegebaseerde attributie                  |
| Factureringsmodel               | Meestal PPC of CPM                              | Betaling per bevestigde verkoop                             |
| Advertentieaccount              | Account van de merchant                         | Door Shopify beheerd account voor gesyndiceerde plaatsingen |
| Ingestietiming                  | Bijna realtime                                  | Asynchroon; een campagnetag kan later binnenkomen           |

## Implementatievereisten

### Ga om met vertraagde campagnetags

Shopify maakt de order onmiddellijk aan. Het kan de campagnetag die de campagne identificeert later toepassen, nadat de attributievalidatie is voltooid. De tag kan tot acht uur na aankoop verschijnen.

{% hint style="warning" %}
**Voorkom een eenmalige orderimport.** Een `orders/create` webhook kan vóór de campagnetag binnenkomen. Als je de order meteen classificeert, kan deze als direct of organisch worden gelabeld.
{% endhint %}

Gebruik een van deze benaderingen:

{% stepper %}
{% step %}

#### Abonneer je op `orders/updated`

Beoordeel de ordertags opnieuw wanneer Shopify de order bijwerkt.
{% endstep %}

{% step %}

#### Vraag de Admin API later op

Haal de order opnieuw op via de Shopify Admin API. Voer deze taak 8–12 uur na aanmaak uit.
{% endstep %}
{% endstepper %}

### Stapsgewijze server-side implementatie

Gebruik de standaard AdPage Webhook Matching-flow voor Shop Campaign-orders. De webhook is de **Trigger** zijde. Een browser `begin_checkout` gebeurtenis is de **Prepare** zijde.

{% stepper %}
{% step %}

#### Configureer de AdPage Webhook Client

Installeer en configureer de **AdPage Webhook Client** in je server-GTM-container. Deze ontvangt en parseert de Shopify-orderwebhook.

Configureer Shopify's `orders/updated` webhook om het endpoint te gebruiken dat door deze client wordt verwerkt. Routeer het ruwe Shopify-verzoek niet rechtstreeks naar GA4-, Meta CAPI- of ClickHouse-tags.

Volg [Webhook Matching](https://docs.adpage.io/optimize-your-setup/webhook-matching) om het **AdPage Event Notifier** sjabloon te installeren en de webhookclient te configureren.
{% endstep %}

{% step %}

#### Configureer Prepare en Trigger

Maak twee **AdPage Event Notifier** tags:

* **Prepare:** Laat afgaan op de storefront `begin_checkout` gebeurtenis.
* **Trigger:** Laat afgaan op de Shopify-webhookgebeurtenis die door de AdPage Webhook Client wordt verwerkt.

Stel de Trigger-transactie-ID in op de webhook's `transaction_id`. Beide tags moeten dezelfde platformvoorinstelling en BasketKey gebruiken.

Gebruik voor een native Shopify-setup de **Shopify** voorinstelling met `cart_token`. Wanneer AdPage Tagging is geïnstalleerd, gebruik **AdPage Tagging (universeel)** met `user_id`.

{% hint style="warning" %}
**Koppel de BasketKey niet aan GA4 `user_id`.** Die wordt alleen gebruikt om Prepare en Trigger te matchen. Gebruik alleen een stabiele, echte GA4 User-ID wanneer je site die al consistent instelt.
{% endhint %}
{% endstep %}

{% step %}

#### Ga om met de tagvertraging en dubbele updates

Shopify kan `Shop Cash-aanbiedingen toegepast` tot acht uur na orderaanmaak. Een `orders/updated` webhook kan ook meerdere keren voor één order afgaan.

Stel de Trigger van Event Notifier zo in dat deze alleen wordt uitgevoerd wanneer `payload.tags` bevat `Shop Cash-aanbiedingen toegepast`. Gebruik de order `transaction_id` als gebeurtenis- en deduplicatiesleutel.

Webhook Matching dedupliceert de gematchte conversie. Het combineert ook beschikbare browsercontext met de Shopify-order.
{% endstep %}

{% step %}

#### Valideer de matching vóór activering

Publiceer de Prepare- en Trigger-configuratie. Laat deze enkele dagen gegevens verzamelen en controleer vervolgens **Webhook Matching → Match health** in je AdPage-container.

Ga verder wanneer de matchrate boven 90% ligt. Is deze lager, verbeter dan de gedeelde identificator of bekijk de matchingconfiguratie voordat je downstream aankooptags inschakelt.
{% endstep %}

{% step %}

#### Routeer de gematchte aankoopgebeurtenis

Webhook Matching stuurt de gematchte payload naar het server-GTM `/mp` endpoint. Maak een **GA4 Measurement Protocol** client voor dit pad.

Blokkeer `purchase` gebeurtenissen in de reguliere GA4-trigger. Maak een nieuwe trigger voor verzoeken die door de Measurement Protocol-client worden afgehandeld. Gebruik die trigger voor GA4, Meta CAPI, ClickHouse en andere downstream-tags.

Stel `channel` in op `shop_campaigns` voor warehouse-rapportage. Gebruik `transaction_id` als Meta's `event_id` om de browser Pixel- en CAPI-gebeurtenis te dedupliceren.
{% endstep %}
{% endstepper %}

```
[Storefront `begin_checkout`]
        │
        ├──> Event Notifier Prepare
        │
[Shopify `orders/updated`]
        │
        ├──> AdPage Webhook Client
        └──> Event Notifier Trigger
                    │
                    ▼
        [AdPage Webhook Matching]
                    │ Gematchte payload
                    ▼
[Server-GTM `/mp` endpoint]
        │
        └──> GA4, Meta CAPI, ClickHouse en andere tags
```

{% hint style="warning" %}
**Shop Campaign-orders hebben mogelijk geen browser Prepare-gebeurtenis.** Daardoor kunnen ze ongematcht blijven. Beoordeel deze orders in Match health. Gebruik forwarding alleen via Trigger pas nadat je de zwakkere attributie- en toestemmingsimplicaties hebt beoordeeld.
{% endhint %}

### Server-GTM: voordelen en afwegingen

| Voordelen                                                                                                                                     | Afwegingen en vereisten                                                                                                                                                     |
| --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Uniforme architectuur:** Webgebeurtenissen, conversie-API's en levering aan het datawarehouse gebruiken dezelfde server-GTM-infrastructuur. | **Herhaalde webhooks:** `orders/updated` kunnen meerdere keren afgaan. Configureer de Trigger van Event Notifier zorgvuldig.                                                |
| **Gematchte payload:** De gematchte gebeurtenis combineert beschikbare browsercontext met de Shopify-order.                                   | **Beperkte browsersignalen:** Off-site Shop Campaign-aankopen hebben mogelijk geen Prepare-gebeurtenis of browseridentificatoren.                                           |
| **Gecontroleerde activering:** Match health laat je de kwaliteit valideren vóór het inschakelen van aankooptags.                              | **Fallbacks vereisen review:** Trigger-only- en probabilistische matching gebruiken zwakkere signalen. Schakel deze alleen in na beoordeling van attributie en toestemming. |

### Classificeer het kanaal op basis van ordertags

Native Shop Campaign-orders kunnen storefront-UTM-parameters zoals `utm_source` en `utm_medium`omzeilen. Standaardanalyseregels kunnen het kanaal daardoor niet toewijzen.

{% hint style="info" %}
**Aanbevolen regel:** Evalueer ordertags in je transformatielaag. Wanneer `Shop Cash-aanbiedingen toegepast` aanwezig is, map het kanaal naar een toegewijde waarde zoals `shop_campaigns`.
{% endhint %}

### Cross-channel rapportage dedupliceren

Shop Campaigns kunnen overlappen met andere betaalde kanalen. Een enkel klanttraject kan meerdere geldige attributieclaims opleveren.

{% stepper %}
{% step %}

#### Een shopper interacteert met een Meta-advertentie

Meta registreert een klik- of viewsignaal.
{% endstep %}

{% step %}

#### De shopper koopt via Shop

De klant ziet later een Shop Campaign-aanbieding en rondt de checkout af met Shop Pay.
{% endstep %}

{% step %}

#### Meta claimt de conversie

Meta Pixel of Conversions API schrijft de conversie toe binnen zijn attributievenster.
{% endstep %}

{% step %}

#### Shopify schrijft de aanbieding toe

Shopify schrijft de conversie toe aan de campagneaanbieding en past de pay-per-sale-vergoeding toe.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Gebruik `order_id` als primaire deduplicatiesleutel.** Pas dit toe over elke verkoopbron om omzetinflatie te voorkomen.
{% endhint %}

### Referentiepipeline

```
[Native Shopify-conversie]
        │
        ▼
[Order aangemaakt zonder campagnetag]
        │
        ▼
[Campagnetag toegevoegd binnen 0–8 uur]
        │
        ├──> `orders/updated` webhook
        │
        └──> Of vraag de Admin API na 8 uur op
                    │
                    ▼
        [AdPage Webhook Client]
        - Verwerk de orderwebhook
        - Event Notifier Trigger controleert de campagnetag
        - Match met de browser Prepare-gebeurtenis
                    │
                    ▼
        [Measurement Protocol-client]
        - Ontvang de gematchte payload op `/mp`
        - Map kanaal naar `shop_campaigns`
        - Verstuur naar ClickHouse en geselecteerde advertentieplatforms
```

### Checklist

* Verwerk `orders/updated` na de vertraging van de campagnetag.
* Configureer de Prepare- en Trigger-tags van AdPage Event Notifier.
* Controleer Match health voordat je downstream aankooptags inschakelt.
* Classificeer getagde orders als `shop_campaigns`.
* Gebruik `transaction_id` voor aankoop- en Meta-gebeurtenisdeduplicatie.


---

# 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/faq/faq-nl/marketingoptimalisatie/shopify-shop-campaigns-en-server-side-tracking.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.
