Google Ads, Conversion-Tracking und CAPI

Server-Side-Conversion-Uploads via Google-Ads-API, abstrahiert durch Beaconrys Phase-2-Broker. Du sparst dir die vier- bis sechswöchige Developer-Token-Approval und gehst am selben Tag live.

Warum ein Broker

Google Ads verlangt einen Developer-Token bei jedem API-Call, der Conversions hochlädt. Den genehmigen zu lassen verlangt eine Basic-Access-Bewerbung bei Google plus eine Aufstufung auf Standard-Access. Üblich sind vier bis sechs Wochen Hin-und-Her.

Beaconry betreibt einen zentralen Cloudflare-Worker (den "Phase-2-Broker"), der Beaconrys eigenen genehmigten Developer-Token hält. Kunden verbinden ihren eigenen Ad-Account per OAuth. Der Broker proxied Upload-Calls, sieht aber nie deine Conversion-Daten: er leitet den verschlüsselten Body weiter und rate-limitet pro Kunde. Refresh-Tokens bleiben verschlüsselt in deiner WordPress-Datenbank.

Resultat: du verbindest in zwei Minuten via OAuth, statt über einen Monat auf die Google-Approval zu warten.

Voraussetzungen

• Google-Ads-Account, auf den du Admin- oder "Bearbeiten"-Zugriff hast.
• Etwa 5 bis 10 Minuten (das meiste davon entfällt auf das Anlegen der Conversion Actions im Campaign Manager).

1. Mit Google verbinden

WordPress-Admin → Beaconry → Tracking → Google Ads. Klick Mit Google verbinden. Du wirst auf Googles OAuth-Consent-Screen weitergeleitet.

Den geforderten Scope (adwords) genehmigen. Google leitet dich zurück auf den Tracking-Tab, Access-Token und Refresh-Token werden automatisch (verschlüsselt) gespeichert.

2. Customer-ID finden

• Google Ads öffnen (ads.google.com).
• Oben rechts steht deine Customer-ID, z. B. 123-456-7890.
• In Beaconry → Customer-ID einfügen. Beaconry entfernt die Bindestriche automatisch.

3. Conversion Actions im Campaign Manager anlegen

Du brauchst eine Conversion Action pro Event-Typ, den du tracken willst. Beaconry mappt GA4-Event-Namen auf Google-Ads-Kategorien.

Für jeden Event-Typ:

• Tools und Einstellungen → Messung → Conversions → Neue Conversion-Action.
• Quelle: Website.
• Kategorie: passende auswählen (siehe Tabelle unten).
• Wert, Anzahl, Click-through-Window nach Googles Empfehlung setzen.
• Speichern. Die Detail-URL der Conversion-Action enthält die Action-ID und Customer-ID, z. B. ...#?conversionTypeId=1234567890&ocid=98765.
• Komplette URL in den passenden Slot in Beaconry einfügen.

Event-Typ → Kategorie:

4. (Shortcut) Aus GA4 importieren

Wenn deine GA4-Property die Events bereits als Conversions markiert hat, kannst du sie in Google Ads importieren statt jede einzeln neu anzulegen:

• Tools → Conversions → + Neue Conversion-Action.
• Auf der nächsten Seite (Schritt 2 des Wizards) nach unten scrollen und Zurück klicken. Du landest auf Schritt 1 "Datenquellen wählen".
• Google Analytics 4 wählen.
• Zurück auf Schritt 2 erscheint unten der Abschnitt "Mehrere Conversion-Actions aus einer bestehenden Google-Analytics-Property importieren". Property wählen und Events importieren (purchase, generate_lead, sign_up, contact).

5. Test-Event versenden

Speichern, klick Google-Ads-Test-Event senden. Der Broker validiert OAuth-Token und Customer-ID. HTTP 200 heißt: Verbindung steht. Die Conversion erscheint im Campaign Manager innerhalb von ~3 Stunden. Google hat keine Echtzeit-Test-Ansicht für die API.

6. (Optional) Enhanced Conversions

Beaconry hashed E-Mail und Telefon server-side und sendet sie als Enhanced-Conversions-Daten neben jedem Upload mit. Hebt die Match-Rate deutlich, wenn der Besucher das Google-Werbe-Cookie nicht akzeptiert hat. Kein zusätzliches Setup nötig, das passiert automatisch, sobald Token und Customer-ID gesetzt sind.

Was automatisch versendet wird

• WooCommerce: AddToCart, InitiateCheckout, Purchase. Bestellwert und Währung werden weitergegeben.
• Forms: generate_lead, submit_application, subscribe, book, sign_up, contact (per Form-Type gemappt).
• gclid / wbraid / gbraid aus URL-Parametern gefangen und im nl_ext-Cookie persistiert. Pflicht für Googles Click-zu-Conversion-Attribution.

Troubleshooting

• "PERMISSION_DENIED": dein Google-Account hat keine Berechtigung auf der Customer-ID. Verwende einen Account mit Admin- oder "Standard"-Rolle.
• "INVALID_ARGUMENT, conversion_action": die Conversion-Action-URL wurde falsch eingefügt. URL muss conversionTypeId enthalten.
• "Conversion hochgeladen, aber nicht sichtbar": Google Ads hat bis zu 3 Stunden Conversion-Latenz. Warten, dann Campaign Manager → Tools → Conversions → Status-Spalte prüfen.
• "User-rejected token": Refresh-Token wurde vom User revoked (klickte Disconnect oder hat Google-Passwort rotiert). Nochmal Mit Google verbinden, der Rest der Konfiguration bleibt erhalten.