M0042 Facebook-Pixel für Gambio
Handbuch
1. Was das Modul leistet
Das Modul verbindet Ihren Gambio-Shop mit dem Facebook-Pixel (Meta-Pixel) und meldet das Verhalten Ihrer Besucher an Meta zurück. Damit lassen sich Werbekampagnen auswerten, Zielgruppen bilden und der Erfolg Ihrer Anzeigen bis zum Kaufabschluss nachverfolgen.
Im Einzelnen übernimmt das Modul:
- das Einbinden des Facebook-Pixels in Ihren Shop, ohne dass Sie selbst Code einfügen müssen;
- das Melden aussagekräftiger Ereignisse – von der Seitenansicht über das Hinzufügen zum Warenkorb bis zum abgeschlossenen Kauf – jeweils mit dem passenden Wert;
- die Kopplung an das Gambio-Consent-Tool, sodass nur mit Einwilligung des Besuchers getrackt wird;
- die Bereitstellung eines Produktkatalog-Feeds für Meta, mit dem Sie dynamische Anzeigen (Advantage+ Katalogwerbung) mit Ihren Produkten bespielen können;
- einen zusätzlichen Deltafeed für schnelle Preis- und Bestandsaktualisierungen.
Die eigentliche Auswertung findet in Ihrem Meta-Konto statt – das Modul liefert die Daten, die Meta dort anzeigt und für Ihre Kampagnen nutzt.
2. Wo Sie das Modul einrichten
Die Einstellungen finden Sie im Adminbereich Ihres Shops unter Module → Xycons-Module. Öffnen Sie dort den Eintrag zum Facebook-Pixel und wechseln Sie auf den Reiter Kundenkonto / Setups. Auf dieser Seite nehmen Sie alle im folgenden Kapitel beschriebenen Einstellungen vor.
3. Das Setup
Das Setup ist in drei Bereiche gegliedert: die Grundeinstellungen, den Produktkatalog-Feed und den Deltafeed. Jeder Wert wird nachstehend erklärt.
3.1 Grundeinstellungen
| Einstellung | Bedeutung |
|---|---|
| Modulstatus | Schaltet das Modul insgesamt ein oder aus. Im ausgeschalteten Zustand werden weder der Pixel eingebunden noch Ereignisse gemeldet und auch die Feeds sind nicht abrufbar. (Standard: ausgeschaltet) |
| Ihr Lizenzschlüssel | Der zu Ihrem Shop gehörende Schlüssel. Ohne gültigen Schlüssel arbeitet das Modul nicht. |
| Ihre Lizenz | Zeigt die erkannte Lizenzart an. Dieses Feld ist nur eine Anzeige. |
| Facebook-Pixel | Hier tragen Sie die Pixel-ID ein, die Sie in Ihrem Meta-Konto erzeugt haben. Ohne diese ID meldet das Modul nichts. Siehe Kapitel 4. |
| Conversion bei Registrierung | Der Wert in Euro, der beim Anlegen eines neuen Kundenkontos als Conversion-Wert an Meta übermittelt wird. So können Sie einer Registrierung einen kalkulatorischen Wert für Ihre Kampagnenauswertung geben. (Standard: 1,00) |
| Consent-Purpose | Die Purpose-ID aus dem Gambio-Consent-Tool, die das Tracking steuert. Solange dieses Feld leer ist, findet kein Tracking statt. Siehe Kapitel 5. |
3.2 Produktkatalog-Feed
| Einstellung | Bedeutung |
|---|---|
| Produktkatalog-Feed aktiv | Schaltet den Export-Feed für Meta-Produktkataloge frei. Erst wenn dieser Schalter aktiv ist, liefert die Feed-Adresse Daten. (Standard: ausgeschaltet) |
| Feed-Token | Ein selbst gewähltes Kennwort, das an die Feed-Adresse angehängt wird. Nur wer den Token kennt, kann den Feed abrufen. Wählen Sie eine ausreichend lange, nicht erratbare Zeichenfolge. |
| Feed-Währung | Der Währungscode nach ISO 4217 (zum Beispiel EUR oder USD), in dem die Preise im Feed ausgewiesen werden. (Standard: EUR) |
3.3 Deltafeed
| Einstellung | Bedeutung |
|---|---|
| Deltafeed aktiv | Schaltet den zusätzlichen Deltafeed für schnelle Preis- und Bestandsaktualisierungen frei. (Standard: ausgeschaltet) |
| Deltafeed-Token | Das Kennwort für den Abruf des Deltafeeds. Lassen Sie das Feld leer, wird für den Deltafeed der Token des Produktkatalog-Feeds verwendet. |
4. Die Facebook-Pixel-ID hinterlegen
Der Facebook-Pixel ist eine Zählmarke, die Meta Ihrem Werbekonto zuordnet. Sie erzeugen ihn im Meta-Business-Bereich (Events-Manager). Bei vorhandenem Konto erreichen Sie die Pixel-Verwaltung unter folgender Adresse:
https://www.facebook.com/ads/manager/pixel/facebook_pixel
Kopieren Sie die dort angezeigte Pixel-ID – eine lange Ziffernfolge – und tragen Sie sie im Setup in das Feld Facebook-Pixel ein. Sobald das Modul aktiviert und die Pixel-ID hinterlegt ist, nimmt es seine Arbeit auf.
5. Tracking nur mit Einwilligung (Consent-Tool)
Das Modul arbeitet mit dem Gambio-Consent-Tool zusammen. Damit steuert die Einwilligung Ihrer Besucher, ob der Facebook-Pixel geladen und Ereignisse gemeldet werden.
So richten Sie die Kopplung ein:
- Legen Sie im Gambio-Consent-Tool unter Zwecke einen Eintrag an, der das Facebook-Tracking beschreibt.
- Öffnen Sie zu diesem Eintrag „Integration anzeigen". Im Integrationscode finden Sie die Angabe
data-purposes="X". Das X ist die Purpose-ID. - Tragen Sie diese ID im Setup in das Feld Consent-Purpose ein.
Danach richtet sich das Tracking nach der Auswahl des jeweiligen Besuchers: Erst wenn er dem zugeordneten Zweck zustimmt, wird der Pixel geladen und es werden Daten übermittelt. Lehnt er ab, bleibt das Modul für ihn stumm.
Die Einwilligungslösungen anderer oder externer Anbieter sind nicht Bestandteil des Moduls.
6. Welche Ereignisse übermittelt werden
Bei zugestimmtem Tracking meldet das Modul die folgenden Standard-Ereignisse an Meta – jeweils mit den passenden Zusatzangaben wie Produktkennung, Anzahl und Wert:
| Ereignis | Wann es ausgelöst wird |
|---|---|
| Seitenansicht (PageView) | Bei jedem Seitenaufruf im Shop. |
| Produktansicht (ViewContent) | Beim Aufruf einer Artikeldetailseite, mit Artikel, Name, Kategorie und Preis. |
| Suche (Search) | Bei einer Suche im Shop, inklusive des eingegebenen Suchbegriffs. |
| In den Warenkorb (AddToCart) | Wenn ein Artikel in den Warenkorb gelegt wird, mit dem Wert der hinzugefügten Menge. |
| Auf den Merkzettel (AddToWishlist) | Wenn ein Artikel auf den Merkzettel gesetzt wird. |
| Kasse begonnen (InitiateCheckout) | Beim Wechsel in den Bestellvorgang, mit dem Warenkorbwert. |
| Zahlungsart gewählt (AddPaymentInfo) | Bei der Auswahl der Zahlungsart im Bestellvorgang. |
| Registrierung (CompleteRegistration) | Beim Anlegen eines Kundenkontos, mit dem im Setup hinterlegten Conversion-Wert. |
| Kaufabschluss (Purchase) | Auf der Bestellbestätigungsseite, mit den gekauften Artikeln, der Stückzahl und dem Bestellwert. |
Die Werte werden als Nettobeträge übermittelt. Das entspricht dem im Marketing üblichen Vorgehen und macht die Auswertung über verschiedene Kundengruppen und Steuersätze hinweg vergleichbar.
7. Der Produktkatalog-Feed für Meta
Für dynamische Anzeigen benötigt Meta einen Produktkatalog. Das Modul stellt diesen Katalog als laufend aktuellen Feed bereit. Sie hinterlegen die Feed-Adresse einmalig im Meta-Commerce-Manager; Meta ruft sie dann regelmäßig ab.
Aktivieren Sie im Setup den Produktkatalog-Feed und vergeben Sie einen Feed-Token. Die Adresse des Feeds lautet:
https://IHR-SHOP.de/GXModules/Xycons/M0042/ModuleData/M0042_CATALOG_FEED.php?token=IHR_TOKEN
Ersetzen Sie IHR-SHOP.de durch Ihre Shop-Adresse und IHR_TOKEN durch den im Setup vergebenen Token. Ohne gültigen Token wird der Abruf abgewiesen.
Der Feed enthält alle aktiven Artikel mit Bild und Preis und liefert je Artikel diese Angaben:
| Spalte | Inhalt |
|---|---|
| id | Die Artikelnummer, über die Meta den Artikel eindeutig zuordnet. |
| title | Der Artikelname. |
| description | Die Artikelbeschreibung als reiner Text. |
| availability | Verfügbarkeit – „in stock" bei Lagerbestand, sonst „out of stock". |
| condition | Zustand, hier stets „new". |
| price | Der reguläre Preis inklusive Währung. |
| sale_price | Der Aktionspreis, falls für den Artikel ein Sonderangebot aktiv ist – andernfalls leer. |
| link | Die Adresse der Artikeldetailseite in Ihrem Shop. |
| image_link | Die Adresse des Produktbilds. |
| brand | Der Hersteller; ist keiner hinterlegt, wird der Shopname verwendet. |
Die Preise entsprechen den Bruttopreisen, die auch Ihre Besucher im Shop sehen; ein aktives Sonderangebot erscheint zusätzlich als Aktionspreis. Artikel ohne Bild oder ohne gültigen Preis werden nicht in den Feed aufgenommen, da Meta sie ohnehin ablehnen würde.
8. Der Deltafeed für Preise und Bestände
Ein vollständiger Katalog kann groß sein und wird von Meta nur in größeren Abständen abgerufen. Damit Preis- und Bestandsänderungen schneller ankommen, gibt es zusätzlich den Deltafeed. Er enthält nur die häufig veränderlichen Angaben und lässt sich in Meta als sogenannte „update_schedule" häufiger abrufen.
Aktivieren Sie im Setup den Deltafeed. Die Adresse lautet:
https://IHR-SHOP.de/GXModules/Xycons/M0042/ModuleData/M0042_CATALOG_DELTA_FEED.php?token=IHR_TOKEN
Als Token verwenden Sie den Deltafeed-Token; ist dieser leer, gilt der Token des Produktkatalog-Feeds. Der Deltafeed liefert je Artikel die Artikelnummer, den regulären Preis, den Aktionspreis sowie die Verfügbarkeit.
9. Ergebnisse prüfen
Ob die Ereignisse korrekt gesendet werden, prüfen Sie am einfachsten mit dem Meta-Pixel-Helper, einer kostenlosen Browser-Erweiterung von Meta. Sie zeigt beim Besuch Ihres Shops an, welcher Pixel geladen wurde und welche Ereignisse mit welchen Werten ausgelöst werden.
Die eigentliche Auswertung Ihrer Daten – Reichweite, Conversions, Umsatz – finden Sie im Events-Manager Ihres Meta-Kontos im Bereich für das Facebook-Pixel.
10. Modultexte ändern
Modultexte können Sie – wie bei allen Modulen von uns – über die Shopfunktion „Texte ändern" im Admin-Bereich an eigene Bedürfnisse anpassen, ohne dass ein Eingriff in Dateien nötig ist. Suchen Sie dort nach dem gewünschten Text und tragen Sie Ihre eigene Formulierung ein.
Nach Änderungen über „Texte ändern" leeren Sie bitte den Shop-Cache, damit die neue Formulierung im Shop erscheint.
11. Shopupdate und Modulpflege
Ein Shopupdate betrifft immer auch das Modul. Beachten Sie deshalb:
- Vor einem geplanten Servicepack oder Masterupdate prüfen Sie auf der Xycons-Seite, ob das Modul für die neue Shopversion freigegeben ist.
- Aktualisieren Sie beim Shopupdate immer die neueste Version des Moduls und der Modulumgebung – nicht nur den Shop selbst.
Ein älteres Modul passt sich nicht von allein an eine neue Shopversion an. Wenn Sie die Aktualisierung Ihres Shops durch uns durchführen lassen, aktualisieren wir vorhandene Xycons-Module und die Modulumgebung mit, sofern sie für die Shop-Masterversion verfügbar sind.
12. Wenn etwas nicht wie erwartet läuft
| Beobachtung | Ursache und Abhilfe |
|---|---|
| Der Pixel-Helper zeigt gar keinen Pixel an. | Prüfen Sie, ob das Modul aktiv ist, eine Pixel-ID hinterlegt wurde und – vor allem – eine Purpose-ID im Feld Consent-Purpose eingetragen ist. Ohne Purpose-ID wird bewusst nicht getrackt. Stimmen Sie außerdem dem Zweck im Consent-Banner zu. |
| Es werden keine Ereignisse gemeldet, obwohl der Pixel lädt. | Der Besucher hat dem zugeordneten Consent-Zweck nicht zugestimmt. Erst mit Zustimmung werden Ereignisse übertragen. |
| Der Feed lässt sich nicht abrufen (Zugriff abgewiesen). | Der Feed muss im Setup aktiv sein und der in der Adresse angehängte Token muss exakt dem hinterlegten Token entsprechen. |
| Meta bemängelt Preise oder fehlende Bilder im Katalog. | Der Feed übernimmt nur aktive Artikel mit Bild und gültigem Preis. Pflegen Sie zu den betroffenen Artikeln ein Bild und einen Preis, dann erscheinen sie im nächsten Abruf. |
| Ein Suchbegriff oder Artikelname erscheint in Meta mit Sonderzeichen verfremdet. | Nach Anpassungen am Erscheinungsbild leeren Sie den Shop-Cache, damit die aktuelle Fassung ausgeliefert wird. |
Wir wünschen Ihnen viel Erfolg beim Einsatz dieses Moduls!
