Die Facebook Conversion API ist ein serverseitiges Conversion-Tracking. Damit trackst du als Vendor/ Affiliate deine Facebook-Werbekampagnen zuverlässig und bleibst dabei unabhängig von Browsern und Käufer-Geräten. Bei dem API-Tracking erfasst Digistore24 Statistik-Informationen zu folgenden Events und leitet diese an Facebook weiter:
- Neue Bestellung
- Beginn eines Abonnements
- Zahlungen zu einem Abonnement
- Ende eines Abonnements
Hinweis
Um die Conversion API einzurichten, benötigst du einen Facebook-Business-Account.
1. Facebook Conversion API einrichten
a) In Facebook
- Richte ein Meta Tracking-Pixel ein.
- Generiere für dieses Pixel einen Zugriffsschlüssel. Verwende dazu die Methode "via Events Manager".
- Optional zum Testen der Events: Gehe im Events Manager zu “Events testen” und kopiere den Testcode zum Testen.
Folgendes solltest du nach Ausführung der drei Schritte erhalten:
- Facebook-API-Zugriffsschlüssel
- Facebook-Pixel-ID
- Test-Event-Code
Baue nun den Facebook Tracking-Pixel auf deiner Website ein.
b) In Digistore24
Hier richtest du zwei Dinge ein:
- Facebook-Tracking-Pixel auf dem Bestellformular
- Facebook-IPN-Anbindung
2. Facebook-Tracking-Pixel einrichten:
Als Vendor: Lege ein Facebook-Tracking-Pixel an unter: Einstellungen > Bestellformular-Tracking.
Gehe dabei vor wie hier beschrieben.
Hinweis:
- Wähle bei Tracking-Typ --> Facebook aus.
- Füge im Feld die Facebook-Pixel-ID ein.
Als Affiliate: Lege ein Facebook-Tracking-Pixel an unter: Konto > Bestellformular-Tracking.
Gehe dabei vor wie hier beschrieben und beginne ab Schritt 2.
Facebook-IPN-Anbindung einrichten:
Als Vendor: Lege eine Facebook-IPN-Anbindung an unter: Einstellungen > Anbindungen (IPN).
Gehe dabei vor wie hier beschrieben.
Tipp:
Wähle die Produkte und Sprachen aus, für die ein Event an Facebook gesendet werden soll. Füge dann den “API Zugangsschlüssel”, “Pixel-ID” und “Test-Event-Code” ein.
Verwendest du eine Digistore24-Dankeseite ist deine Einrichtung nun abgeschlossen. Verwendest du eine eigene Dankeseite, fahre mit dem nächsten Abschnitt fort.
Als Affiliate: Lege eine Facebook-IPN-Anbindung an unter: Konto > S2SPostback.
Gehe dabei vor wie hier beschrieben.
3. Optional: Tracking Pixel auf eigene Dankeseite einrichten
Verwendest du eine eigene Dankeseite, kannst du auch dort die Bestellungen nachverfolgen. Führe dazu die folgenden Schritte durch:
- Aktiviere die Übergabe aller Bestell-IDs für deine Dankeseite
Es ist wichtig, dass alle Bestell-IDs an deine eigene Dankeseite übergeben werden. So stellst du sicher, dass bereits registrierte Verkäufe, auf deiner Dankeseite nicht doppelt gezählt werden. - Füge deiner Dankeseite den Facebook Tracking-Pixel hinzu.
Diesen erhältst du aus der Facebook-Anleitung. Siehe Verlinkung. - Füge danach den unten genannten Code-Abschnitt hinzu.
Diesen fügst du unterhalb des Facebook Tracking Pixels ein. Siehe Verlinkung.
So gehst du vor:
Schritt 1: Übergabe aller Bestell-IDs für deine Dankeseite
- Aktiviere entweder die Übergabe aller Bestelldaten, sowie hier beschrieben.
- oder füge an die Dankeseite URL ?order_id=[ORDER_ID] hinzu, sowie hier beschrieben.
Schritt 2: Facebook Tracking Pixel einfügen & Code-Abschnitt hinzufügen
- Füge deiner Dankeseite den Tracking Pixel hinzu. Diesen findest du in dieser Facebook-Anleitung unter "Manually add Pixel code to website". Dort findest du auch eine Schritt-für-Schritt-Anleitung.
- Füge danach unterhalb des Tracking-Pixels folgenden Code-Abschnitt hinzu:
<!-- Unter dem Facebook Pixel Code einfügen -->
<script>
(function () {
function getParameterByName(name, url) {
url = url || window.location.href;
name = name.replace(/[\[\]]/g, "\\$&");
var regex = new RegExp("[?&]" + name + "(=([^&#]*)|&|#|$)"),
results = regex.exec(url);
if (!results) return null;
if (!results[2]) return "";
return decodeURIComponent(results[2].replace(/\+/g, " "));
}
var order_id = getParameterByName("order_id");
var queryParamToFacebookMapping = {
product_id: "content_ids",
product_name: "content_name ",
currency: "currency",
amount: "value",
quantity: "num_items"
};
var purchaseData = { content_type: 'product' };
Object.keys(queryParamToFacebookMapping).forEach(function (name) {
var value = getParameterByName(name);
if (value !== null) {
purchaseData[queryParamToFacebookMapping[name]] = value;
}
});
fbq('track', 'Purchase', purchaseData, {eventID: 'purchase.'+order_id}); })();
</script>
4. So arbeitest du mit den Events in Facebook
In Facebook kannst du nun deine Custom Conversions erstellen und idealerweise über die Content-ID dein Produkt filtern.
5. So testest du dein Event
- Wähle im Events-Manager unter Datenquelle die eingerichtete Datenquelle.
- Klicke auf Events testen.
- Öffne nun das Bestellformular deines eingerichteten Produkts.
Wenn du dein Event richtig eingerichtet hast, erhältst du Informationen zu deinen Events (siehe Screenshot).
Hinweis
Falls der Test nicht funktioniert, bitte verifiziere, ob der EventCode in Facebook mit dem EventCode deiner IPN-Anbindung übereinstimmt.
6. Übertragung von Parametern bei IPN-Anbindung
Bei der Facebook-IPN-Anbindung können diese Facebook Parameter übertragen werden. Durch diese kannst du als Vendor Metriken wie ROAS (Return on Ad Spent - Ausgaben vs. Einnahmen) einsehen und somit gezielter Werbemaßnahmen steuern. Auch andere DS24 Parameter können übertragen werden, wie z. B. content_type. Diesen Parameter übertragen wir bei allen Events mit Produkt-IDs. Damit erkennt Facebook, dass es sich bei den jeweiligen Events um tatsächliche Käufe handelt. Möchtest du, dass diese und weitere Parameter übertragen werden, gehe folgendermaßen vor:
- Richte dein Pixel im Facebook Business Manager gemäß dieser Vorgehensweise ein.
- Richte die Conversion-API am Pixel ein:
- Öffne dazu den Event Manager.
- Gehe auf Datenquellen.
- Wähle den Pixel aus und wechsle in den Reiter Einstellungen.
- Gehe unter Conversion API auf das Feld manuell Einrichten.
- Richte die API ein:
- Event Kaufen muss vorhanden sein.
- Page View auch möglich, um Seitenaufrufe zu ermitteln.
- Kategorie E-Commerce und Einzelhandel.
- Im folgenden Schritt alle Parameter auswählen, die übertragen werden sollen. Land kann nicht übertragen werden.
- Im letzten Schritt “API manuell selbst implementieren” auswählen.
- Es öffnet sich Die Conversion API anwenden. Dort ist nur der Teil Zugriffsschüssel generieren, da dieser für Digistore24 Facebook IPN gebraucht wird. Einmal generieren, kopieren und dann am Ende der Seite Implementierung beenden auswählen.
- Beende nun die Einrichtung der API, bei “Anweisungen ansehen” auf fertigstellen klicken.
- Wechsle nun zu Digistore24. a) Gehe zu Einstellungen > Anbindungen (IPN) > Neue Anbindung b) Wähle unter “Für Profis” Facebook aus.
- Hinterlege Einstellungen (Für welche Produkte in welchen Sprachen).
- Hinterlege den unter 4. generierten API Schüssel und hinterlege weiter unten die Pixel ID.
- Gehe zu Einstellungen > Bestellformular Tracking.
- Öffne Neues Tracking > Gewünschte Produkte auswählen.
- Wähle aus, wo hinterlegt > Events auswählen > Tracking Typ “Facebook” auswählen.
- Hinterlege dort die Pixel ID und klicke auf Speichern.
Die Parameter werden nun an Facebook übertragen und können in der Pixel Übersicht eingesehen werden.