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.
- Opsætning
- 10–30 min
- Sporing via
- Google Tag Manager eller script + salgslinje
- Det skal I bruge
- Google Tag Manager med GA4 – eller en udvikler til temaet og kvitteringen
Det melder integrationen
- SalgVia GA4 eller en salgslinje (kræver en udvikler)
- RefusionerKun fra jeres server med API-nøgle
- Personlige rabatkoderNår GA4 eller salgslinjen sender koden
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.
Før du starter
- Kodestumperne fra Program → Opsætning, hvor jeres butiks-id er sat ind. Her i guiden står
DIN_BUTIKi 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:
- 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. - Hent containeren Kun sporing under Bruger I Google Tag Manager? i Opsætning, og importer den med Flet – se Google Tag Manager.
- 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 egencommon/header.twig)
<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'])) {:
// 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:
{% 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. 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. 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) elleraddHistory(OpenCart 4) i modellencheckout/order. Trigger-syntaksen for events er forskellig mellem versionerne – se OpenCarts dokumentation for jeres version. Tjek ordrensorder_status_idmod 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.
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. På server-vejen kan jeres server melde refusionen.
Mangler du noget?
Skriv til os – vi svarer hurtigt, og siden bliver rettet.