Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Datum

Änderung

14.12.2020

Veröffentlichung Dokumentation für Version 1.0.0

Beschreibung

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

Das Plugin integriert sich automatisch in die Privatsphäre-Einstellungen unseres Plugins Cookie Hinweis mit Consent-Verwaltung (Opt-In/Opt-Out)

In Kombination mit unserem Plugin Cookie Hinweis mit Consent-Verwaltung (Opt-In/Opt-Out) hat der Nutzer die Möglichkeit aktiv zu entscheiden ob er das Tracking durch Facebook gestattet oder nicht.

"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:

Beschreibung

FB-Pixel-Event

Parameter

Suche und Ajax-Suche

Search

Code Block
search_string: Eingegebener Suchtext
content_category: 'Product Search'

Inhaltsanzeige

ViewContent

Code Block
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 Warenkorb

AddToCart

Code Block
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 registriert

CompleteRegistration

Code Block
value: Warenkorbwert exkl. Versandkosten
currency: ISO-Währungskürzel des aktuellen Shops
content_name: 'Registration'
status: 'complete'

Kunde geht zur Kasse

InitiateCheckout

Code Block
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

Kauf

Purchase

Nur ein Artikel wurde bestellt:

Code Block
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:

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

Lead (Newsletteranmeldung oder Absenden des Kontaktformulars)

Lead

Newsletteranmeldung:

Code Block
content_name: 'Newsletter registration'

Kontaktformular:

Code Block
content_name: 'Contact form submitted'

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

Installation und Nutzung

Die Installation erfolgt wie gewohnt über den Administrationsbereich.

...

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 "mnd-fb-pixel" gesetzt. Die Werte lauten entsprechend "optin" oder "optout". 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: 

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

Für Opt-Out:

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

Erweiterter Datenabgleich

...

Weitere Informationen zu den übermittelnden Daten erhalten Sie in der Facebook Dokumentation.

Bitte beachten Sie die damit verbundenen Auswirkungen in Bezug auf den Datenschutz.

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

Code Block
{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

Code Block
{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#}