# OpenCart

> Sporing på OpenCart 3 og 4 – via Google Tag Manager og Google Analytics 4, med sporingskoden i temaet og en salgslinje på kvitteringen, eller fra jeres server. Intet modul fra os.

OpenCart har ingen integration fra os, men sporingen kan sættes op på tre måder. Den nemmeste er Google Tag Manager med vores færdige container og købet fra Google Analytics 4. Har butikken ikke det, lægger en udvikler sporingskoden i temaet og en salgslinje på kvitteringen – eller melder klikket og salget fra jeres server.

> [!NOTE]
> Vi har ikke et OpenCart-modul og har ikke efterprøvet guiden på en rigtig OpenCart-butik. Fil- og funktionsnavnene nedenfor er fra OpenCart 3.0 og 4.0's egen kildekode, og kodestumperne er generisk PHP og Twig. Temaer og udvidelser kan ændre dem – test altid med et testkøb, før I regner med sporingen.

## Før du starter

- Kodestumperne fra **Program → Opsætning**, hvor jeres butiks-id er sat ind. Her i guiden står `DIN_BUTIK` i stedet.
- Vælg **Andet** under **Hvor sælger du?** i Opsætning. Vi genkender ikke OpenCart automatisk.

## Anbefalet: Google Tag Manager og Google Analytics 4

Mange OpenCart-butikker har Google Tag Manager og en Google Analytics 4-udvidelse, der sender `purchase` til datalaget fra kvitteringen. Så skal der ingen kode i temaet:

1. Tryk **Scan jeres site** i Opsætning. Finder scanningen Google Analytics 4 med e-handel, vælges **Automatisk fra Google Analytics** under **Sådan meldes salget**, og momsen sættes ud fra jeres priser. Finder den kun Tag Manager, så vælg **Automatisk fra Google Analytics** selv, hvis jeres udvidelse sender `purchase`.
2. Hent containeren **Kun sporing** under **Bruger I Google Tag Manager?** i Opsætning, og importer den med **Flet** – se [Google Tag Manager](https://www.affilyflow.com/docs/butik/google-tag-manager#hurtigst-en-faerdig-container).
3. Udgiv containeren, og test (nederst).

Sender jeres udvidelse ikke købet til Google Analytics 4, kan I bruge containeren **Med købs-tag**, hvis datalaget har `purchase` med `ecommerce.transaction_id` og `ecommerce.value`. GA4-udvidelser til OpenCart sender beløbet forskelligt – med eller uden moms og fragt. Tjek beløbet i live-testen, og ret **Moms i beløbet** og **Fragt i beløbet** i Opsætning (eller i købs-tagget), hvis det ikke passer.

## Alternativ A: sporingskoden i temaet og en salgslinje

Kræver en udvikler med adgang til butikkens filer. Ret helst gennem en OCMOD-udvidelse eller et child-tema, så en opdatering af OpenCart eller temaet ikke sletter ændringerne.

### 1. Sporingskoden på alle sider

Sæt koden lige før `</head>` i temaets header:

- OpenCart 3: `catalog/view/theme/<tema>/template/common/header.twig`
- OpenCart 4: `catalog/view/template/common/header.twig` (eller temaudvidelsens egen `common/header.twig`)

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

Ryd temaets cache bagefter (i OpenCart 3: tandhjulet på kontrolpanelet → **Theme** og **SASS**).

### 2. Ordren til kvitteringen

OpenCarts kvittering (`checkout/success`) får ikke ordrenummeret med: controlleren tømmer sessionen og viser den fælles `common/success.twig`. Derfor skal controlleren læse ordren, *før* den tømmes. Øverst i `index()` i `catalog/controller/checkout/success.php` – før linjen `if (isset($this->session->data['order_id'])) {`:

```php title="OpenCart 3 · catalog/controller/checkout/success.php"
// Affilyflow: ordren til salgslinjen – læses, før OpenCart tømmer sessionen nedenfor.
$data['affilyflow'] = false;
if (isset($this->session->data['order_id'])) {
	$this->load->model('checkout/order');
	$af_order = $this->model_checkout_order->getOrder($this->session->data['order_id']);
	if ($af_order) {
		$af_base = 0;
		foreach ($this->model_checkout_order->getOrderTotals($af_order['order_id']) as $af_total) {
			// Varerne uden moms (sub_total) minus rabatkoden (coupon er negativ). Ikke fragt, moms eller gavekort.
			if ($af_total['code'] == 'sub_total' || $af_total['code'] == 'coupon') {
				$af_base += $af_total['value'];
			}
		}
		$data['affilyflow'] = array(
			'order'    => $af_order['order_id'],
			'total'    => number_format(max(0, $af_base), 2, '.', ''),
			// Ordrens beløb står i butikkens standardvaluta.
			'currency' => $this->config->get('config_currency'),
			'coupon'   => isset($this->session->data['coupon']) ? $this->session->data['coupon'] : '',
		);
	}
}
```

I OpenCart 4 hedder funktionen `getTotals` i stedet for `getOrderTotals` (samme model, `checkout/order`).

### 3. Salgslinjen

Sæt linjen i `common/success.twig` (OpenCart 3: `catalog/view/theme/<tema>/template/common/success.twig`, OpenCart 4: `catalog/view/template/common/success.twig`). Filen bruges også af andre "tak"-sider, så linjen står inde i en betingelse og vises kun efter et køb:

```twig title="common/success.twig · inde i <body>"
{% if affilyflow %}<div hidden data-affilyflow-order="{{ affilyflow.order|e }}" data-affilyflow-total="{{ affilyflow.total|e }}" data-affilyflow-currency="{{ affilyflow.currency|e }}"{% if affilyflow.coupon %} data-affilyflow-coupon="{{ affilyflow.coupon|e }}"{% endif %}></div>{% endif %}
```

Sporingskoden læser linjen og melder købet. Beløbet er varerne efter rabat, uden moms og fragt, med punktum som decimaltegn. Mere om felterne i [Salgslinjen](https://www.affilyflow.com/docs/reference/salgslinje). Brug kun en vej – linjen *eller* Google Analytics – så samme køb ikke regnes på to måder.

## Alternativ B: fra jeres server

Vil I have klikket som en cookie fra jeres egen server (det holder længere i Safari) og salget meldt, når ordren er betalt, så brug PHP-kodestumperne i [Sporing fra jeres server](https://www.affilyflow.com/docs/butik/server-sporing). De er generisk PHP og kræver en API-nøgle fra **Indstillinger → API-nøgler**. I OpenCart hører de hjemme:

- **Klikket:** i kode, der kører på alle sider, før siden sendes – fx en event før controllerne eller en fil under `catalog/controller/startup/`.
- **Salget:** når ordren får en betalt status, fx som en event efter `addOrderHistory` (OpenCart 3) eller `addHistory` (OpenCart 4) i modellen `checkout/order`. Trigger-syntaksen for events er forskellig mellem versionerne – se OpenCarts dokumentation for jeres version. Tjek ordrens `order_status_id` mod jeres "betalt"-statusser, og send ordrenummeret, varerne uden moms og fragt og valutaen. Samme ordrenummer tæller kun en gang, så en status, der skifter flere gange, er ikke et problem.
- **Refusioner:** samme vej, når ordren får en refunderet status – kun server-vejen melder refusioner til os.

## Test

Gå til trinnet **Test sporingen** i Opsætning, tryk **Åbn testlink**, og læg en testordre i den fane, der åbner. Bliv i Opsætning – live-testen viser testklikket og købet med ordrenummer og beløb og spørger, om beløbet passer. Et testkøb giver ingen provision og intet gebyr.

Kommer salget ikke frem: tjek, at sporingskoden (eller GTM-tagget) også er med på kvitteringen, at temaets cache er ryddet, og – på GTM-vejen – at I sagde ja til cookies i banneret. Se også [Test og fejlfinding](https://www.affilyflow.com/docs/butik/test-og-fejlfinding).

## Refusioner

På GTM- og salgslinjevejen melder OpenCart ikke refusioner 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). På server-vejen kan jeres server melde refusionen.

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