v1.x.x Facebook Pixel (MndFacebookPixel)

Achtung

Diese Dokumentation bezieht sich auf eine ältere Software-Version. Die aktuelle Dokumentation finden Sie hier: Facebook Pixel (MndFacebookPixel)

URL im Shopware Storehttp://store.shopware.com/mnd5298432986837/mnd-facebook-pixel.html
Shopware Versionen5.0.0 +
DatumÄnderung
21.06.2016Erste öffentliche Version der Dokumentation für Version 1.0.0
25.07.2016

Aktualisierung der Dokumentation für Version 1.0.2

  • Das Plugin ist nun Subshop-fähig
08.08.2016

Aktualisierung der Dokumentation für Version 1.0.3

  • Konfiguration Artikel-ID
15.08.2016

Aktualisierung der Dokumentation für Version 1.0.4

  • Hinweis zu Datenschutzerklärung ergänzt
  • Verwendete Parameter für Facebook-Events ergänzt


In Version 1.0.4 wurde die Einstellung der Währung aus der Plugin-Konfiguration entfernt. Diese wird nun automatisch aus der Währung des jeweils aktiven Shops bezogen.

26.01.2017Beispiel für Facebook Produkt-Feed (Shopware Produktexporte) in Dokumentation aufgenommen
31.05.2017

Aktualisierung der Dokumentation für Version 1.0.11

  • Neue Tracking-Events: AddToWishlist und Lead
  • Konfiguration Formular-IDs für Lead-Tracking
14.11.2017

Aktualisierung der Dokumentation für Version 1.0.13

  • Opt-In und Opt-Out Funktionalität
23.01.2018

Aktualisierung der Dokumentation für Version 1.1.0

  • MwSt. Konfiguration
  • Versandkosten Konfiguration
  • Integration "Erweiterter Datenabgleich"


Beschreibung

Das Facebook Pixel Plugin integriert das Facebook-eigene Tracking in Shopware. Es ermöglicht vordefinierte Ereignisse(Events) zur Auswertung
an Facebook zu senden. Dies ermöglicht z.B. die Analyse einer Werbemaßnahme.

Erklärung "facebook for business"

"Beim Facebook-Pixel handelt es sich um JavaScript-Code für deine Webseite, mit dem du für deine Werbekampagnen Zielgruppen messen, optimieren und erstellen kannst. Mit dem Facebook-Pixel kannst du die Handlungen nutzen, die Menschen geräteübergreifend auf deiner Webseite durchgeführt haben, um deine Werbekampagnen auf diese Weise noch effizienter zu gestalten."

Weitere Informationen bei Facebook: https://de-de.facebook.com/business/help/651294705016616

Bitte denken Sie daran, dass Sie gegebenenfalls die Datenschutzerklärung Ihres Shops um die von Facebookpixel übertragenen Daten erweitern.


Merkmale des Plugins

Das Plugin Integriert den Facebook Pixel Tracking Code. Das Plugin kann für unterschiedliche Subshops konfiguriert und aktiviert/deaktiviert werden.

Folgende Events werden getrackt:

BeschreibungFB-Pixel-EventRelevante Shopware Events / ActionsParameter
Suche und Ajax-SucheSearch

controller: search

method: defaultSearch

search_string: Eingegebener Suchtext
content_category: 'Product Search'
InhaltsanzeigeViewContent

controller: detail

method: index

content_name: Artikelname
content_category: Name der Kategorie (kein Kategoriepfad
content_ids: Artikel-ID oder Bestellnummer (seihe Plugin Konfiguration)
content_type: 'product'
value: Artikelpreis
currency: ISO-Währungskürzel des aktuellen Shops
Hinzufügen zum WarenkorbAddToCartKlick auf Kaufen-Button
content_name: Artikelname
content_ids: Artikel-ID oder Bestellnummer (siehe Plugin Konfiguration)
content_type: 'product'
value: Artikelpreis
currency: ISO-Währungskürzel des aktuellen Shops
Kunde hat sich registriertCompleteRegistration

bei abgeschlossener Regsitrierung

controller: account

value: Warenkorbwert exkl. Versandkosten
currency: ISO-Währungskürzel des aktuellen Shops
content_name: 'Registration'
status: 'complete'
Kunde geht zur KasseInitiateCheckout

controller: checkout

method: confirm

value: Warenkorbwert
currency: ISO-Währungskürzel des aktuellen Shops
content_name: 'Checkout',
content_ids: Artikel-IDs oder Bestellnummern (siehe Plugin Konfiguration)
content_type: 'product' oder 'product_group'
num_items: Anzahl der Artikel im Warenkorb
KaufPurchase

controller: checkout

method: finish

Nur ein Artikel wurde bestellt:

content_name: Artikelname
content_category: Kategoriename des Artikels
content_ids: Artikel-ID oder Bestellnummer (siehe Plugin Konfiguration)
content_type: 'product',
value: Bestellwert
currency: ISO-Währungskürzel des aktuellen Shops

Mehrere Artikel bestellt:

content_ids: Artikel-IDs oder Bestellnummern (siehe Plugin Konfiguration)
content_type: 'product',
value: Warenkorbwert
currency: ISO-Währungskürzel des aktuellen Shops
Hinzufügen zum MerkzettelAddToWishlist

controller: newsletter

method: finish

value: Bestellwert,
currency: ISO-Währungskürzel des aktuellen Shops,
content_name: Artikelname,
content_ids: Artikel-ID oder Bestellnummer (siehe Plugin Konfiguration),
content_type: 'product'
Lead (Newsletter Registrierung oder Absenden eines oder mehrerer definierten Formulare)Lead

controller: newsletter

method: index

controller: forms

method: index

Newsletter Registrierung:

content_name: 'Newsletter registration'

Formular Versand:

content_name: 'Contact form submitted'

Mehr Informationen zu den einzelnen Events erfahren Sie hier: https://de-de.facebook.com/business/help/402791146561655

Die verwendeten Werte können bei Bedarf in den Template Dateien angepasst werden.


Installation und Nutzung

Die Installation erfolgt wie gewohnt über den Shopware Plugin Manager.

Nach der Installation sollten Sie zur Sicherheit den Shopware Cache (Frontend und HTTP-Proxy) leeren.


Weiterführende Informationen zum Installationsvorgang in Shopware:

Plugin-Installation: http://community.shopware.com/Lizenzierung-und-Installation-von-lizenzpflichtigen-Plugins_detail_1340.html
Plugin-Manager: http://community.shopware.com/Plugin-Manager-ab-Shopware-5_detail_1856.html)


Plugin-Konfiguration

 

Stellen Sie sicher, dass Ihre Währungseinstellungen korrekte ISO-Kürzel nach ISO 4217 enthalten.


Hier müssen Sie festlegen ob Facebook Pixel aktiviert werden soll, ihre Facebook Pixel-ID eingeben.
Falls Sie Ihren Produktkatalog bei Facebook importiert haben, können Sie außerdem festlegen welche Artikel-ID das Plugin an Facebook übermitteln soll:

  • die interne Shopware Artikel-ID
  • die offizielle Artikelnummer bzw. Bestellnummer

Um das Lead-Tracking für bestimmte Formulare zu aktivieren/deaktivieren ändern Sie bitte die vordefinierten Formular-IDs (Kontaktformular und Anfrageformular).
Falls Sie einen Opt-In bzw. Opt-Out anbieten möchten müssen sie hier festlegen welche Funktion sie verwenden möchten. Um festzulegen ob die
MwSt. und/oder Versandkosten an Facebook übermittelt werden setzen Sie bitte die entsprechenden Optionsfelder auf ja oder nein. 

Facebook Statistik

Opt-In und Opt-Out

Opt-In

Das Tracking ist solange für den Benutzer deaktiviert bis dieser den Opt-In durch das Klicken des Links (siehe unten) aktiviert.

Opt-Out

Das Tracking ist aktiv und der Benutzer hat die Möglichkeit das Tracking durch das Klicken des Opt-Out Links zu deaktivieren.


In beiden Fällen wird ein Cookie bestehend aus dem Hostnamen des jeweiligen Shops + dem Suffix "-pixel-opt-in" bzw. "-pixel-opt-out" gesetzt. Das Cookie hat eine Laufzeit von 100 Jahren.


Falls Sie in der Plugin-Konfiguration Opt-In bzw. Opt-Out aktiviert haben nutzen Sie bitte folgende Links (z.B. in Ihren Datenschutzbestimmungen) um die jeweiligen Funktionalität zu integrieren:

Für Opt-In: 

<a href="javascript:mndCookie.mndSetPixelOptIn();" onclick="alert('Facebook Pixel Tracking aktiviert.');">Facebook Pixel aktivieren</a>

Für Opt-Out:

<a href="javascript:mndCookie.mndSetPixelOptOut();" onclick="alert('Facebook Pixel Tracking deaktiviert.');">Facebook Pixel deaktivieren</a>

Erweiterter Datenabgleich

Der erweiterte Datenabgleich ermöglicht die bessere Zuordnung eines Facebook-Benutzers durch zusätzlich übertragene Informationen wie Name, E-Mail-Adresse oder Telefonnummer.
Weitere Informationen zu den übermittelnden Daten erhalten Sie in der Facebook Dokumentation.

Produktexport

Um die Produkte in den eigenen Facebook Produkt Katalog zu importieren wird ein Facebook Produkt-Feed (Shopware Produktexporte) benötigt. Folgendes Beispiel können Sie als Startpunkt verwenden.

Für Ihren Shop sind ggf. Anpassungen notwendig. Gerne unterstützen wir Sie hierbei.
Weitere Informationen zu den Shopware Produktexporten finden Sie hier: http://community.shopware.com/Produktexporte_detail_814.html 

Kopfzeile

{strip}
id{#S#}
title{#S#}
description{#S#}
image_link{#S#}
link{#S#}
gtin{#S#}
mpn{#S#}
brand{#S#}
condition{#S#}
product_type{#S#}
price{#S#}
shipping{#S#}
google_product_category{#S#}
availability
{/strip}{#L#}

Template

{strip}
{$sArticle.ordernumber|escape}{#S#}
{$sArticle.name|strip_tags|strip|trim|truncate:150:"...":true|escape|regex_replace:"#[^\w\.%&\-+ \|]#iu":""|replace:";":","}{#S#}
{$sArticle.description_long|strip_tags|strip|trim|truncate:150:"...":true|escape|regex_replace:"#[^\w\.%&\-+ \|]#iu":""|replace:";":","}{#S#}
{$sArticle.image|image}{#S#}
{$sArticle.articleID|link:$sArticle.name|escape}{#S#}{$sArticle.ean|escape}{#S#}
{$sArticle.suppliernumber|escape}{#S#}
{$sArticle.supplier|replace:"|":""}{#S#}
new{#S#}
{$sArticle.articleID|category:">"|escape|replace:"|":""}{#S#}
{$sArticle.price|escape:"number"}{#S#}
DE::Standardversand:{if $sArticle.shippingfree==1}0.00{else}{$sArticle|@shippingcost:"prepayment":"de":"Standard Versand (DE)"|escape:"number"|replace:",":"."}{/if}{#S#}
{$sArticle.articleID|category|escape}{#S#}
"{if $sArticle.instock>0}in stock
{elseif $sArticle.releasedate && $sArticle.releasedate|strtotime > $smarty.now}preorder
{elseif $sArticle.shippingtime}in stock
{else}out of stock{/if}"
{/strip}{#L#}


Deinstallation

Das Plugin wird auch über den Plugin Manager deinstalliert.