# PrestaShop

> Sporing på PrestaShop via Google Analytics 4 – sporingskoden i temaet og det officielle ps_googleanalytics-modul. Intet modul fra os endnu.

PrestaShop spores gennem [Google Analytics-vejen](https://www.affilyflow.com/docs/reference/google-analytics): sporingskoden ligger på alle sider, og PrestaShops officielle Google Analytics-modul sender købet til Google Analytics 4 fra ordrebekræftelsen – med ordre-id, beløb, moms og fragt. Det læser sporingskoden, og vi regner provisionen af varerne uden moms og fragt.

> [!NOTE]
> Vi har endnu ikke et PrestaShop-modul. Guiden kræver, at butikken har Google Analytics 4 slået til – og Google Analytics sender intet, når kunden siger nej til statistik-cookies. Det køb mistes. Guiden er skrevet efter PrestaShops dokumentation og modulets kildekode og er endnu ikke efterprøvet på en rigtig PrestaShop-butik: test med et testkøb, før I regner med den.

## Før du starter

- Adgang til temaet (eller et "custom code"-modul) og til **Moduler**.
- Kodestumperne fra **Program → Opsætning**, hvor jeres butiks-id er sat ind. Her i guiden står `DIN_BUTIK` i stedet.
- Opsætning genkender som regel PrestaShop selv. Står den ikke valgt, så vælg **PrestaShop** under *Andre systemer*.

## 1. Sporingskoden på alle sider

PrestaShop har intet felt til head-kode i selve administrationen. Der er to veje:

- **Et custom code-modul** fra Addons, der lægger kode i head på alle sider. Den letteste vej uden udvikler.
- **Temaet:** sæt koden i head-skabelonen (i Classic-temaet `templates/_partials/head.tpl`) eller registrer scriptet i temaets `theme.yml` under `assets`. Ændringer i temaet kan blive overskrevet ved en temaopdatering – et child-tema holder bedre.

```html title="Sporingskode – skal på alle sider"
<script src="https://app.affilyflow.com/t/DIN_BUTIK.js" async></script>
```

Tjek i Opsætning efter hver temaopdatering, at sporingskoden stadig findes. Har I ikke adgang til temaet, så send guiden til jeres udvikler med **Send til udvikler** i Opsætning.

## 2. Slå Google Analytics 4 til

Installer og slå PrestaShops officielle modul **Google Analytics** (`ps_googleanalytics`) til under **Moduler → Modulkatalog**, og skriv jeres **Measurement ID** (G-…). Modulet sender `purchase` til Google Analytics 4 fra ordrebekræftelsen med `transaction_id`, `value`, `tax`, `shipping` og `currency`. Et andet GA4-modul virker også, hvis det sender `purchase`-hændelsen.

**Sådan regner vi:** PrestaShop sender fragten *med* moms og `tax` som al moms. Grundlaget er derfor `value − shipping` (varerne med moms) ganget med `(value − tax) / value` – varerne uden moms og fragt, efter rabat. Opsætning gemmer reglen på butikken, når I vælger PrestaShop – I skal ikke indstille noget.

> [!NOTE]
> **Ordrenummeret:** PrestaShops modul sender ordrens interne id (`id_order`) – tallet i kolonnen **ID** under *Ordrer* – ikke referencen (fx `XKBKNABJK`), som står på mails og i ordredetaljen. Det er det nummer, I ser på salget hos os. Søg på id'et under *Ordrer*, når I skal finde et salg.

Uden samtykke til statistik-cookies sender Google Analytics intet, og det køb kan vi ikke se.

### For udviklere: uden Google Analytics

Vil I ikke bruge Google Analytics, kan en udvikler sætte [salgslinjen](https://www.affilyflow.com/docs/reference/salgslinje) i temaets `order-confirmation.tpl`. Her er ordrenummeret referencen, som I kender den. Beløbet er totalen minus fragt (variabler fra Classic-temaets ordre-presenter), og `data-affilyflow-vat` trækker momsen ud – 25 er den danske sats, ret den til jeres.

```html title="order-confirmation.tpl · kun kvitteringen"
<div hidden data-affilyflow-order="{$order.details.reference}" data-affilyflow-total="{$order.totals.total.amount - $order.subtotals.shipping.amount}" data-affilyflow-vat="25" data-affilyflow-currency="{$currency.iso_code}"></div>
```

Variabelnavnene er ikke efterprøvet på en rigtig butik – tjek beløbet i live-testen. Brug kun en vej: linjen *eller* Google Analytics – ellers kan samme køb blive meldt to gange med hvert sit ordrenummer (reference og id).

## 3. Test

Gå til trinnet **Test sporingen** i Opsætning, tryk **Åbn testlink**, og læg en testordre i den fane, der åbner – sig ja til statistik-cookies i banneret. Bliv i Opsætning – live-testen viser testklikket og købet med ordre-id og beløb og spørger, om beløbet passer. Et testkøb giver ingen provision og intet gebyr. Et køb uden klik fra et link tælles ikke.

Betaler I med omdirigering (MobilePay, Quickpay …), så tjek, at kunden lander på ordrebekræftelsen bagefter – kommer kunden ikke tilbage til `order-confirmation`, sendes købet ikke. Se også [Test og fejlfinding](https://www.affilyflow.com/docs/butik/test-og-fejlfinding).

## Typiske fejl

| Det ser I | Årsag |
|---|---|
| Opsætning finder ikke sporingskoden | Temaet er opdateret, og ændringen i head er væk. Brug et child-tema eller et custom code-modul. |
| Klik, men aldrig salg | Google Analytics 4 er ikke slået til, kunden sagde nej til statistik-cookies, eller kunden landede aldrig på ordrebekræftelsen efter betalingen. |
| Kan ikke finde salget i admin | Vi viser `id_order`, ikke referencen. Søg på id'et under *Ordrer*. |

## Refusioner

PrestaShop melder ikke refusioner eller kreditnotaer til os. Et refunderet køb skal I selv afvise inden for godkendelsesperioden – se [Godkendelse og refusioner](https://www.affilyflow.com/docs/butik/godkendelse-og-refusioner).

Kilde: https://www.affilyflow.com/docs/butik/prestashop