Conversions APIs

1. Warum überhaupt serverseitig?

Ein Browser-Pixel muss drei Dinge überstehen, bevor es eine Conversion melden kann: einen Adblocker, eine Einstellung zur Tracking-Vermeidung, und einen Besucher, der den Tab schließt, bevor das Pixel auslöst. Ein Aufruf von unserem Server übersteht alle drei - weil er gar nicht im Browser stattfindet.

MousePlayer weiß ohnehin, wann eines Ihrer Ziele erreicht wurde; dafür sind Ziele da. Die Conversions APIs reichen diese Tatsache lediglich an das Werbenetz weiter.

2. Was wir senden - und was nie

Das Einzige, was den Besucher in diesen Aufrufen benennt, ist die Kennung, die das Netzwerk selbst gesetzt hat. Nichts anderes über die Person verlässt unseren Server.

Netzwerk	Verwendete Kennung	Woher sie kommt
Meta	_fbp, _fbc	First-Party-Cookies des Meta-Pixels
LinkedIn	li_fat_id	First-Party-Cookie des LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp ist ein Cookie, ttclid kommt aus der Adresse des Anzeigenklicks
Google Ads	gclid, wbraid, gbraid	Aus der Adresse des Anzeigenklicks, danach aus dem Cookie _gcl_aw
Microsoft Advertising	msclkid	Aus der Adresse des Anzeigenklicks, oder aus dem Cookie _uetmsclkid, das das UET-Tag schreibt

Nur mit Einwilligung

Jeder dieser Aufrufe steht hinter demselben Einwilligungs-Riegel wie die Aufzeichnung selbst. Eine Sitzung ohne Einwilligung erzeugt keine Conversion-Meldung, unabhängig davon, was in Ihren Projekteinstellungen steht.

3. Google Ads hat drei Kennungen, nicht eine

Das überrascht regelmäßig, deshalb ausdrücklich: Google benutzt gclid für einen einzelnen Anzeigenklick. Wenn Apples Tracking-Vermeidung diesen Klick nicht einzeln zuordenbar macht, schickt Google stattdessen wbraid oder gbraid - beide stehen für eine Gruppe von Klicks.

Die drei schließen einander aus; Google lehnt eine Conversion ab, die zwei davon trägt. Wir senden genau eine, und bei mehreren gewinnt gclid, weil sie die genaueste ist.

In der Adresse stehen sie nur einmal

Die Kennung steht nur auf der ersten Seite nach dem Anzeigenklick in der Adresse. Das Google-Tag legt sie danach im Cookie _gcl_aw ab. Wir lesen dieses Cookie als Rückfall - ohne ihn fände eine Conversion auf der dritten Seite des Besuchs überhaupt keine Kennung mehr.

4. Einrichten

Meta, LinkedIn und TikTok

Je zwei Felder: die ID des Pixels beziehungsweise der Conversion-Regel, und ein Zugriffstoken, das Sie in der Oberfläche des Netzwerks selbst erzeugen. Beides wird AES-256-GCM verschlüsselt gespeichert und nach dem Speichern nie wieder angezeigt.

Google Ads braucht sechs

Google ist die Ausnahme, und der Grund gehört an den Anfang: anders als die übrigen drei gibt Google kein einfaches Zugriffstoken aus. Der Zugang läuft über OAuth mit einem Refresh-Token, und die Ads API verlangt zusätzlich einen Developer-Token.

Feld	Wo Sie es finden
Kundennummer	Rechts oben in Google Ads. Nur Ziffern, ohne die Bindestriche.
ID der Conversion-Aktion	Ziele und Conversions, dann die Aktion, auf die gebucht werden soll.
Developer-Token	Ihr Google-Ads-Verwaltungskonto, API-Center.
OAuth-Client-ID und -Secret	Google Cloud Console, Anmeldedaten, OAuth-Client vom Typ "Desktop-App".
Refresh-Token	Den erzeugen Sie einmalig selbst für den Bereich adwords.

LinkedIn hat zwei Wege, und Sie wollen den kurzen

Im Campaign Manager: Daten, Signals Manager, Direct API, Zugriffstoken erzeugen. Das ist der Weg für Werbetreibende, die ihre eigenen Daten senden - keine Entwickler-App, keine Prüfung. Der Token läuft nicht ab, und der Campaign Manager zeigt ihn kein zweites Mal; kopieren Sie ihn also gleich.

Der andere Weg, eine über LinkedIns Developer Portal beantragte Entwickler-App, ist für Plattformen gedacht, die für viele Werbetreibende senden. Er verlangt eine verifizierte Unternehmensseite und einen genehmigten Anwendungsfall - nichts davon brauchen Sie hier.

Microsoft Advertising ist das einfachste

Nach Google Ads erwartet man dieselbe Schwere - OAuth, einen Developer-Token, eine Freischaltung. Es ist das Gegenteil: zwei Felder. Die UET-Tag-ID, die Sie im Browser ohnehin verwenden, und ein Token, den Sie in Microsoft Advertising unter dem UET-Tag kopieren ("Use Conversions API", "Copy Token"). Nichts zu beantragen.

Nehmen Sie dieselbe Tag-ID wie im Browser-Tag. Nur daran erkennt Microsoft das serverseitige und das Browser-Ereignis als EINE Konversion statt als zwei.

5. Wann eine Conversion gemeldet wird

Genau einmal je Ziel und Sitzung. MousePlayer entprellt das, bevor der Aufruf hinausgeht, und die Nutzlast trägt zusätzlich eine Kennung, mit der das Netzwerk ein zweites Mal entprellen kann. Ein Besucher, der fünf Artikel in den Warenkorb legt, erzeugt eine Conversion und nicht fünf.

Was Sie in Ihrem Werbekonto sehen

Die Conversion trägt den Namen Ihres Ziels, dazu Wert und Währung, falls Sie welche hinterlegt haben, und den Zeitpunkt. Im Normalbetrieb kommt sie binnen einer Minute an.

Wenn nichts ankommt

• Keine Klick-Kennung. Der Besucher kam nicht über eine Anzeige dieses Netzwerks, oder er war da, bevor das Pixel sein Cookie gesetzt hatte. Dann wird nichts gesendet - das ist der erwartete Fall und kein Fehler.
• Keine Einwilligung. Der Riegel kam zuerst.
• Das Netzwerk hat den Aufruf angenommen und die Conversion abgelehnt. Google, TikTok und andere antworten mit HTTP 200 und einem Fehler im Antwortrumpf. Wir lesen den Rumpf und nicht nur den Status; der Grund steht dann im Zustellprotokoll.