Lädt Offline-/Enhanced-Conversions an Google Ads via Data Manager API hoch.
Für Conversions, die außerhalb der Website entstehen (z.B. CRM-Abschlüsse,
Telefon-Leads) oder zur Anreicherung bestehender Conversions mit gehashten
Kundendaten (Enhanced Conversions). E-Mail/Telefon werden server-seitig
normalisiert und mit SHA-256 gehasht — Klartext wird nicht gesendet.
Voraussetzung: Google-Verbindung des Workspace mit Data-Manager-Scope.
conversion_action: numerische 'id' aus 'ads_list_conversion_actions' oder
resource_name/conversion_action_id aus 'ads_create_conversion_action'.
events: Liste von Ereignissen. Pro Ereignis (Dict) möglich:
- 'gclid'/'gbraid'/'wbraid': Klick-IDs (für Offline-Conversions),
- 'email'/'phone': Kundendaten (für Enhanced Conversions, werden gehasht);
'phone' nur im E.164-Format (+43…), sonst wird die Nummer ohne Fehler
verworfen, sobald ein anderer Identifikator (E-Mail/Klick-ID) dabei ist,
- 'address': {given_name, family_name, region_code, postal_code} optional
(alle vier nötig, Namen werden gehasht),
- 'value' + 'currency': Conversion-Wert (z.B. 49.9, 'EUR'),
- 'event_time': Zeitpunkt RFC 3339 (Default: jetzt),
- 'event_source': WEB (Default) / APP / IN_STORE / PHONE / OTHER,
- 'transaction_id': eindeutige ID zur Deduplizierung,
- 'consent': {'adUserData','adPersonalization'} je 'CONSENT_GRANTED'/
'CONSENT_DENIED' — für EEA/UK pro Ereignis dringend empfohlen.
validate_only: True für einen Probelauf (Dry-Run) ohne Schreiben — Antwort
enthält requestId + validated: True, Fehler kommen als {'error': …}.
Rückgabe: {requestId, events, conversion_action}. Erfolg heißt nur „angenommen"
(asynchrone Verarbeitung) — Verbuchung mit ads_conversion_performance prüfen
(Import-Nachlauf; dort zählt das Conversion-Datum). Ab 2000 Events werden mehrere
Batches gesendet
('batches'/'request_ids'); bei einem Teilfehler nennt die Antwort submitted_events —
beim Wiederholen nur die restlichen Events senden.
workspace: Slug des Kunden-Workspace (optional bei nur einem Workspace).