Implementierung der Pricerunner-Verfolgung

Um Ihre Verkäufe in Pricerunner zu verfolgen, müssen Sie ein Conversion-Pixel auf Ihrer Bestellbestätigungsseite implementieren. Hier finden Sie eine Anleitung, wie Sie dies in Shoporama korrekt einrichten, damit Pricerunner den korrekten Bestellwert einschließlich Versandkosten erhält.

Der Code

Füge den folgenden Code in deine thanks.html-Datei im Theme ein (oder an die Stelle, an der du dein Tracking zentral verwaltest). Ersetze [MERCHANTID] durch deine Pricerunner-Händler-ID:

<{if $order && !$order->getTrackingCalled()}>
<img width="1" height="1" style="display:none"
  src="https://www.pricerunner.dk/track/pixel/[MERCHANTID]?OrderTotalInclVat=<{$order->getTotalPrice()|number_format:2:".":""}>&OrderCurrencyISO=<{$webshop->getCurrency()}>"
  alt="" />
<{/if}>

Was bewirkt der Code?

• {if $order && !$order->getTrackingCalled()} stellt sicher, dass das Pixel nur einmal pro Bestellung ausgelöst wird. Verwendet dein Theme den integrierten Tracking-Code von Shoporama (das tun alle Standard-Themes, bei denen das Tracking aktiviert ist), markiert das Theme die Bestellung selbst am Ende der Seite als getrackt, und das Pixel wird beim erneuten Laden nicht erneut gesendet. Verfügt dein Theme nicht über diesen Code, musst du <{$order->setTrackingCalled()}> direkt vor <{/if}> selbst hinzufügen, da die Schutzmaßnahme sonst keine Wirkung zeigt.
• $order->getTotalPrice() ruft den Gesamtbetrag der Bestellung inkl. MwSt. UND inkl. Versandkosten ab. Diesen Wert erwartet Pricerunner im Feld „OrderTotalInclVat“.
• $webshop->getCurrency() ruft die Währung des Shops ab (z. B. DKK).

Wo finde ich meine Merchant-ID?

Deine Merchant-ID findest du in deinem Pricerunner-Dashboard unter den Integrations- oder Tracking-Einstellungen. Wende dich direkt an Pricerunner, wenn du sie nicht finden kannst.

Platzierung im Theme

Der Code wird in die Datei „thanks.html“ Ihres Themes oder in das gemeinsame Tracking-Snippet eingefügt, das auf der Bestellbestätigungsseite eingebunden wird. Die Variablen $order und $webshop sind nur dort verfügbar.

Testen des Pixels

1. Erstelle eine Testbestellung in deinem Shop und rufe die Bestätigungsseite auf.
2. Öffne die Entwicklertools des Browsers (F12) und schau unter dem Reiter „Netzwerk“ nach.
3. Suchen Sie den Aufruf an pricerunner.dk/track/pixel/... und überprüfen Sie, ob „OrderTotalInclVat“ mit dem Gesamtbetrag inkl. Versandkosten übereinstimmt.
4. Vergewissere dich, dass der Status „200 OK“ lautet.

Häufig gestellte Fragen

Was ist der Unterschied zwischen „getPrice()“ und „getTotalPrice()“?

getPrice() gibt den Preis der Artikel inkl. MwSt., jedoch ohne Versandkosten an. getTotalPrice() gibt den Gesamtbetrag an, den der Kunde bezahlt hat, also inkl. MwSt. und Versandkosten. Pricerunner erwartet den Gesamtbetrag.

Warum weichen die Zahlen von Pricerunner von meiner eigenen Buchhaltung ab?

Der häufigste Grund ist entweder die Verwendung von getPrice() anstelle von getTotalPrice(), Rücksendungen, die bei Pricerunner nicht abgezogen werden, oder fehlende Pixel, z. B. bei einem Checkout über einen Drittanbieter. Vergleichen Sie eine Testbestellung in beiden Systemen.

Soll der Betrag mit oder ohne Mehrwertsteuer angegeben werden?

Das Feld heißt „OrderTotalInclVat“, es muss also inklusive Mehrwertsteuer sein. „getTotalPrice()“ gibt immer den Betrag inklusive Mehrwertsteuer zurück.

Werden Rückerstattungen und Umtauschvorgänge berücksichtigt?

Das Pixel übermittelt den Bestellwert zu dem Zeitpunkt, zu dem der Kunde den Kauf abschließt. Spätere Rückerstattungen oder Teilrücksendungen müssen im System von Pricerunner abgewickelt werden. Vereinbaren Sie mit Pricerunner, wie Sie diese melden möchten.

Was ist, wenn ich mehrere Webshops oder mehrere Sprachen habe?

Jeder Shop und jede Sprachversion benötigt in der Regel eine eigene Merchant-ID bei Pricerunner. $webshop->getCurrency() übernimmt automatisch die Währungsumrechnung, aber Sie müssen selbst sicherstellen, dass die richtige Merchant-ID für den jeweiligen Shop eingefügt wird.

Wie schnell sieht Pricerunner meine Konversionen?

Das Pixel wird sofort aufgerufen, sobald der Kunde auf der Bestätigungsseite landet, aber es kann bis zu einem Tag dauern, bis die Zahlen im Pricerunner-Dashboard angezeigt werden. Führen Sie immer eine Testbestellung durch und warten Sie etwas ab, bevor Sie nach Fehlern suchen.

Muss ich die DSGVO und die Einwilligung für das Pixel berücksichtigen?

Ja. Das Pricerunner-Pixel ist ein Marketing-Cookie und erfordert die Einwilligung des Kunden, bevor es geladen werden darf. Binde den {if}-Block in eine zusätzliche Überprüfung deiner Cookie-Einwilligung ein (z. B. $consent.marketing oder eine Variable aus deiner Cookie-Banner-Lösung), damit das Pixel nur für Kunden gesetzt wird, die ihre Einwilligung erteilt haben.

Kann ich stattdessen eine serverseitige Integration verwenden?

Ja, sofern Pricerunner dies anbietet. Serverseitiges Tracking ist robuster, da es nicht davon abhängt, dass der Kunde die Bestätigungsseite lädt. Erfahre mehr über serverseitiges Tracking und die Tracking-Engine von Shoporama.

Wenn Sie Hilfe bei der Implementierung benötigen, schreiben Sie bitte an support@shoporama.dk.