In diesem Leitfaden finden Sie eine Liste der verschiedenen Arten von Conversion-Aktionen, die Sie mit der Google Ads API erstellen können, sowie Informationen dazu, wie diese der Google Ads-Weboberfläche zugeordnet werden.
Den richtigen Typ der Conversion-Aktion auswählen
Der folgende Entscheidungsbaum hilft Ihnen bei der Auswahl des richtigen Conversion-Aktionstyps und der richtigen Einrichtungsanleitung für Ihre Integration:
Wo findet das Conversion-Ereignis statt?
- Offline (z. B. in Ihrem Büro, an Ihrem Unternehmensstandort oder telefonisch): Fahren Sie mit Schritt 2 fort.
- Direkt auf Ihrer Website (z. B. Website-Käufe, Anmeldungen oder Formulareinreichungen): Fahren Sie mit Schritt 3 fort.
- In einer mobilen App: Fahren Sie mit Schritt 4 fort.
- Über einen Anruf, der direkt über Ihre Anzeigen getätigt wurde: Verwenden Sie Anrufe über Anzeigen (
AD_CALL) (mitCallAsset).
Offline-Conversions:
Is it a phone call?
Ja:Verwenden
Import von Anruf-Conversions (
UPLOAD_CALLS) zum Erfassen von Anrufergebnissen.
Handelt es sich um einen Ladenverkauf?
Ja:Verwenden
Handelt es sich um einen Offlineverkauf oder einen Lead, der aus einem Websitebesuch resultiert?
- Ja:Verwenden Sie erweiterte Conversions für Leads über die Data Manager API.
Hinweis: Das Hochladen von Klick-Conversions mit
UPLOAD_CLICKSoderUploadClickConversionwird ab dem 15. Juni 2026 nicht mehr unterstützt.
- Ja:Verwenden Sie erweiterte Conversions für Leads über die Data Manager API.
Hinweis: Das Hochladen von Klick-Conversions mit
Online-Conversions (Website):
- Möchten Sie Seitenaufrufe (Käufe, Belege) oder Nutzerklicks erfassen?
- Ja:Verwenden Sie Website-Conversions mit dem Tag-Snippet, das auf
WEBPAGEoderWEBPAGE_ONCLICKfestgelegt ist.
- Ja:Verwenden Sie Website-Conversions mit dem Tag-Snippet, das auf
Möchten Sie Anrufe erfassen, die über eine Telefonnummer auf Ihrer Website initiiert werden?
Tatsächliche Anrufdauer erfassen?
Ja:Verwenden
Anrufe über eine Website (
WEBSITE_CALL) mit einer dynamischen Google-Weiterleitungsnummer und einem Tag-Ereignis-Snippet.Nein (nur Button-/Linkklicks auf mobiler Website erfassen)? Verwenden
- Möchten Sie Seitenaufrufe (Käufe, Belege) oder Nutzerklicks erfassen?
App-Conversions:
- Reicht es aus, Installationen oder Käufe aus dem Google Play Store zu erfassen?
- Ja:Verwenden Sie App-Conversions (
GOOGLE_PLAY_DOWNLOADoderGOOGLE_PLAY_IN_APP_PURCHASE).
- Ja:Verwenden Sie App-Conversions (
Erfassen Sie App-Aktionen mit Google Analytics (GA4) oder App- Analysetools von Drittanbietern?
Ja:Verwenden
Firebase und App-Analysetools von Drittanbietern (durch Aktivieren von
FIREBASE_*- oderTHIRD_PARTY_*-Conversion-Aktionen).
- Reicht es aus, Installationen oder Käufe aus dem Google Play Store zu erfassen?
Offline-Conversions
Mit Offline-Conversions können Sie Conversion-Ereignisse erfassen, die offline stattfinden, z. B. in Ihrem Büro, an Ihrem Unternehmensstandort oder am Telefon.
In der folgenden Tabelle finden Sie die entsprechenden ConversionActionType-API-Parameter für jede Quelle in der Google Ads-Weboberfläche sowie einen Link zur Dokumentation für die einzelnen Conversion-Aktionstypen:
| Typ der Conversion-Aktion | Google Ads-Quelle | Einrichtungsanleitung für die API |
|---|---|---|
UPLOAD_CLICKS |
Klick-Conversions und erweiterte Conversions für Leads erfassen | Data Manager API verwenden |
UPLOAD_CALLS |
Anruf-Conversions erfassen | Anruf-Conversions importieren |
STORE_SALES |
Conversions in Form von Ladenverkäufen erfassen | Weitere Informationen finden Sie unter Ladenverkäufe: Import in Conversion-Aktion mit Berichterstellung. |
Online-Conversions (Website)
Mit Website-Conversions können Sie Website-Aktionen wie Onlineverkäufe, Linkklicks, Seitenaufrufe und Registrierungen erfassen.
Wenn Sie Conversions auf Ihrer Website erfassen möchten, müssen Sie ein ConversionAction mit dem ConversionActionType auf WEBPAGE erstellen und ein Code-Snippet namens Tag auf der Conversion-Seite Ihrer Website einfügen.
Der ConversionAction umfasst verschiedene Arten von Website-Conversions, die in der API durch das Feld type in jedem TagSnippet unterschieden werden, das im Feld tag_snippets eines ConversionAction aufgeführt ist.
Ein TagSnippet enthält den Tracking-Code, der in Ihre Website eingefügt werden muss, damit Ihre Conversion-Aktionen erfasst werden können.
Für Website- und Klick auf Telefonnummer-Conversions ist das event_snippet erforderlich. Es sollte auf Webseiten platziert werden, die eine Conversion-Aktion angeben, z. B. auf einer Seite zur Bestätigung des Bezahlvorgangs oder zum Senden eines Lead-Formulars. Außerdem ist das global_site_tag erforderlich, das auf jeder Seite Ihrer Website installiert sein muss. Sie können beide Attribute mit ConversionActionService abrufen. Weitere Informationen zum Taggen von Seiten finden Sie in der Hilfe.
In der folgenden Tabelle sind die entsprechenden API-Parameter für die einzelnen Quellen in der Google Ads-Weboberfläche aufgeführt:
| Tracking-Code-Typ | Google Ads-Quelle |
|---|---|
WEBPAGE |
Website, Website (Google Analytics 4) |
WEBPAGE_ONCLICK |
Website, Website (Google Analytics 4) |
CLICK_TO_CALL |
Klicks auf eine Telefonnummer |
App-Conversions
Mit einer App-Conversion können Sie Installationen mobiler Apps oder In-App-Käufe im Google Play Store erfassen.
In der folgenden Tabelle finden Sie die entsprechenden ConversionActionType-API-Parameter für jede Quelle in der Google Ads-Weboberfläche:
| Typ der Conversion-Aktion | Google Ads-Quelle |
|---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > Installationen |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > In-App-Käufe |
Wenn Sie andere Aktionen in mobilen Apps mit Google Analytics 4-Properties oder App-Analysen von Drittanbietern erfassen möchten, lesen Sie den Abschnitt Zusätzliche Conversion-Aktionstypen.
Anruf-Conversions
Mit Anruf-Conversion-Tracking können Sie Anrufe über Anzeigen, Anrufe bei einer Telefonnummer auf Ihrer Website und Klicks auf Telefonnummern auf mobilen Websites erfassen.
In der folgenden Tabelle finden Sie die entsprechenden ConversionActionType-API-Parameter für jede Quelle in der Google Ads-Weboberfläche:
| Typ der Conversion-Aktion | Google Ads-Quelle |
|---|---|
AD_CALL |
Anrufe über Nur-Anrufanzeigen oder Anzeigen mit Anruferweiterungen |
WEBSITE_CALL |
Anrufe bei einer Telefonnummer auf Ihrer Website |
CLICK_TO_CALL |
Klicks auf eine Telefonnummer auf Ihrer mobilen Website |
AD_CALL
Eine AD_CALL-Conversion-Aktion wird in der Google Ads-Weboberfläche als Anrufe über Anzeigen-Conversion angezeigt.
Nachdem Sie die AD_CALL-Conversion-Aktion erstellt haben, geben Sie ihren Ressourcennamen beim Erstellen einer CallAsset im Feld call_conversion_action an.
Mit Anruf-Assets können Sie eine Telefonnummer direkt in Ihren Anzeigen einblenden.
Ein Anruf wird als Conversion erfasst, wenn er eine festgelegte Mindestdauer übersteigt. Diese liegt standardmäßig bei 60 Sekunden.
WEBSITE_CALL
Eine WEBSITE_CALL-Conversion-Aktion wird in der Google Ads-Weboberfläche als Anrufe über eine Website-Conversion angezeigt.
Anders als bei AD_CALL müssen event_snippet und global_site_tag auf Ihrer Website hinzugefügt werden, um die dynamische Google-Weiterleitungsnummer für das Anruf-Tracking bei Telefonnummern auf Ihrer Website abzurufen. Außerdem müssen Sie ein Anruf-Asset einrichten.
Verknüpfen Sie sie auf Kunden-, Kampagnen- oder Anzeigengruppenebene.
CLICK_TO_CALL
Eine CLICK_TO_CALL-Conversion-Aktion wird in der Google Ads-Weboberfläche als Klicks auf Ihre Telefonnummer auf der mobilen Website-Conversion angezeigt.
Der Typ CLICK_TO_CALL unterscheidet sich vom Typ AD_CALL dadurch, dass keine tatsächlichen Anrufe erfasst werden. Stattdessen werden mit CLICK_TO_CALL nur Klicks auf eine Telefonnummer über ein Mobilgerät erfasst. Das ist nützlich, wenn Sie keine Google-Weiterleitungsnummer zum Tracking von Anrufen verwenden können.
Erweiterte Conversions
Mit erweiterten Conversions können Sie die Genauigkeit Ihrer Conversion-Analyse verbessern. Dazu werden Ihre vorhandenen Conversion-Tags mit selbst erhobenen Conversion-Daten wie E‑Mail-Adresse, Name, Privatadresse und Telefonnummer ergänzt.
In der folgenden Tabelle sind die entsprechenden API-Parameter für die einzelnen Typen erweiterter Conversions aufgeführt:
| Typ der Conversion-Aktion | Typ der erweiterten Conversion | Einrichtungsanleitung für die API |
|---|---|---|
UPLOAD_CLICKS |
Erweiterte Conversions für Leads
Verbessert die Messung von Offlinetransaktionen, die auf Website-Leads oder Websitebesuche zurückzuführen sind |
Data Manager API verwenden |
WEBPAGE |
Erweiterte Conversions für das Web
Verbessert die Analyse von Online-Conversions |
Einrichtungsleitfaden für die API |
Zusätzliche Typen von Conversion-Aktionen
Über die Google Ads API sind zusätzliche Arten von Conversion-Aktionen in Berichten verfügbar. Das Erstellen oder Ändern dieser Aktionen kann jedoch eingeschränkt oder untersagt sein.
SKAdNetwork-Conversions
Wenn Sie iOS-App-Kampagnen schalten und SKAdNetwork implementiert haben, können Sie mit den folgenden Ressourcen auf SKAdNetwork-Daten zugreifen, die Google auf Customer- und Campaign-Ebene zur Verfügung gestellt werden:
| Berichtsfeld | Beschreibung |
|---|---|
metrics.sk_ad_network_installs |
Die Anzahl der von Apple gemeldeten Installationen. Dieser Messwert kann nur nach einer beliebigen Kombination aus segments.sk_ad_network_conversion_value und datumsbezogenen Segmenten segmentiert werden.
|
metrics.sk_ad_network_total_conversions |
Die Gesamtzahl der Conversions, einschließlich Installationen und anderer von Apple gemeldeter Conversion-Typen. Dieser Messwert kann nur nach SKAdNetwork-bezogenen und datumsbezogenen Segmenten segmentiert werden. |
segments.sk_ad_network_ad_event_type |
Der Typ des Ereignisses, das für eine bestimmte Conversion aufgetreten ist. |
segments.sk_ad_network_attribution_credit |
Wie die Attribution für eine bestimmte Conversion berücksichtigt wird. |
segments.sk_ad_network_fine_conversion_value |
Der von Apple erfasste Wert einer Conversion. Dieses Segment kann nur auf die Messwerte Der Wert |
segments.sk_ad_network_coarse_conversion_value |
Der grobe Wert für eine einzelne Conversion. |
segments.sk_ad_network_postback_sequence_index |
Die Position des Postbacks in der Sequenz für eine bestimmte Conversion. |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id |
Die App-ID, unter der die Anzeige ausgeliefert wurde, die zur von iOS SKAdNetwork erfassten Installation geführt hat. |
segments.sk_ad_network_source_domain |
Die Website, auf der die Anzeige ausgeliefert wurde, die zur von iOS SKAdNetwork erfassten Installation geführt hat. Ein Nullwert bedeutet, dass dieses Segment nicht anwendbar ist, z. B. bei einer Kampagne, die nicht für iOS bestimmt ist, oder dass es in keinem der von Apple gesendeten Postbacks vorhanden war. |
segments.sk_ad_network_source_type |
Der Quelltyp, in dem die Anzeige ausgeliefert wurde, die zur von iOS SKAdNetwork erfassten Installation geführt hat. Ein Nullwert bedeutet, dass dieses Segment nicht anwendbar ist, z. B. bei einer Kampagne, die nicht für iOS bestimmt ist, oder dass weder die Quelldomain noch die Quell-App in den von Apple gesendeten Postbacks vorhanden waren. |
segments.sk_ad_network_user_type |
Der Nutzertyp, der eine bestimmte Conversion generiert hat. |
segments.sk_ad_network_redistributed_fine_conversion_value |
Die Conversion-Werte in diesem Segment enthalten Nullwerte, die auf Conversion-Werte umverteilt wurden. Dieses Segment stellt die Summe der von Apple zurückgegebenen beobachteten detaillierten Conversion-Werte und der von Google geschätzten Nullwerte dar. |
segments.sk_ad_network_version |
Die Version der iOS Store Kit Ad Network API, die verwendet wurde. |
Google Analytics
Conversions aus einer verknüpften Google Analytics-Property haben einen der folgenden type-Werte:
GA4-Property-Conversion:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_ANALYTICS_4_PURCHASE
Sie können die GA4-Property-ID, den Property-Namen und den Ereignisnamen auch aus dem Feld
google_analytics_4_settingsabrufen.
Sie können die folgenden Änderungen an einer GA4-Property-Conversion vornehmen:
- Importieren Sie die Conversion aus Ihrer GA4-Property in Ihr Google Ads-Konto, indem Sie das Feld
statusvonHIDDENinENABLEDändern. - Ändern Sie die Felder
primary_for_goalundcategory, um anzugeben, wie sich das auf Google Ads-Gebote und -Berichte auswirken soll. - Die
nameodervalue_settingseiner App soll aktualisiert werden. - Entfernen Sie die Conversion aus Ihrem Google Ads-Konto mit einem
remove-Vorgang.
Jeder Versuch, andere Attribute einer importierten GA4-Conversion oder beliebige Attribute einer importierten Universal Analytics-Conversion zu ändern, führt zu einem MUTATE_NOT_ALLOWED-Fehler. Diese Änderungen können nur über die Google Ads-Benutzeroberfläche vorgenommen werden.
Firebase und Drittanbieter-App-Analysen
Wenn Sie App-Analysen von Drittanbieter-Apps oder Firebase-Conversions importieren möchten, ändern Sie die status des ConversionAction von HIDDEN in ENABLED mit der mutate-Methode von ConversionActionService. Die Aktualisierung der app_id wird für diese Conversion-Aktionen nicht unterstützt.
FIREBASE_ANDROID_APP_AD_IMPRESSIONFIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_APP_AD_IMPRESSIONFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
Ladenverkäufe: Import in Conversion-Aktion mit Berichterstellung
Sie können zwar keine STORE_SALES- oder STORE_SALES_DIRECT_UPLOAD-Conversion-Aktionen über die Google Ads API erstellen, aber die API unterstützt den Import von Transaktionen zu Ladenverkäufen.
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
Schreibgeschützte Conversion-Aktionstypen
Die folgenden Conversion-Aktionstypen sind in der Google Ads API schreibgeschützt und werden für Berichte bereitgestellt.
ANDROID_APP_PRE_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_CODELESS
Unbekannt
Wenn Ihr Google Ads-Konto andere Arten von Conversion-Aktionen enthält, werden in Abfragen und Berichten möglicherweise Conversion-Aktionen zurückgegeben, bei denen ConversionAction.type UNKNOWN ist. Die API unterstützt nicht die Verwaltung dieser Conversion-Aktionen, gibt sie aber in Berichten zurück, um vollständige Ergebnisse für wichtige Conversion-Messwerte wie metrics.conversions und metrics.conversions_value zu liefern.