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.
Richtigen Typ der Conversion-Aktion auswählen
Anhand des folgenden Entscheidungspfads können Sie den richtigen Conversion-Aktionstyp und die passende Einrichtungsanleitung für Ihre Integration auswählen:
Wo findet das Conversion-Ereignis statt?
- Offline (z. B. in Ihrem Büro, an Ihrem Geschäftsstandort oder am Telefon): Fahren Sie mit Schritt 2 fort.
- Direkt auf Ihrer Website (z. B. Käufe, Registrierungen oder Formulareinreichungen): Fahren Sie mit Schritt 3 fort.
- In einer mobilen App: Weiter mit Schritt 4.
- Über einen Anruf, der direkt über Ihre Anzeigen getätigt wird: Verwenden Sie Anrufe über Anzeigen (
AD_CALL) (mitCallAsset).
Offline-Conversions:
Ist es ein Telefonat?
Ja: Verwenden Sie
Import von Anruf-Conversions (
UPLOAD_CALLS), um die Ergebnisse von Anrufen zu erfassen.
Ist es ein Ladenverkauf?
Ja: Verwenden Sie
Handelt es sich um einen Offlineverkauf oder einen Lead-Fortschritt, der auf einen Websitebesuch zurückzuführen ist?
- Ja: Verwenden Sie erweiterte Conversions für Leads mit der Data Manager API (empfohlen) oder lesen Sie den Hilfeartikel Offline-Klick-Conversions verwalten für bestehende Google Ads API-Integrationen. (Hinweis: Ab dem 15. Juni 2026 ist das Hochladen von Klick-Conversions mit
UploadClickConversionsauf Entwicklertokens beschränkt, mit denen zuvor Offline-Klick-Conversions hochgeladen wurden.)
- Ja: Verwenden Sie erweiterte Conversions für Leads mit der Data Manager API (empfohlen) oder lesen Sie den Hilfeartikel Offline-Klick-Conversions verwalten für bestehende Google Ads API-Integrationen. (Hinweis: Ab dem 15. Juni 2026 ist das Hochladen von Klick-Conversions mit
Online-Conversions (Website):
- Möchten Sie Seitenaufbauten (Käufe, Belege) oder Nutzerklicks erfassen?
- Ja: Verwenden Sie Website-Conversions mit dem Tag-Snippet
WEBPAGEoderWEBPAGE_ONCLICK.
- Ja: Verwenden Sie Website-Conversions mit dem Tag-Snippet
Möchten Sie Anrufe erfassen, die über eine Telefonnummer auf Ihrer Website erfolgen?
Tatsächliche Anrufdauer erfassen?
Ja: Verwenden Sie
Anrufe über eine Website (
WEBSITE_CALL) mit einer dynamischen Google-Weiterleitungsnummer und einem Tag-Ereignis-Snippet.Nein (nur Klicks auf Schaltflächen/Links auf der mobilen Website erfassen)? Verwenden
- Möchten Sie Seitenaufbauten (Käufe, Belege) oder Nutzerklicks erfassen?
App-Conversions:
- Reicht es aus, Installationen oder Käufe im 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 Sie
Firebase und Drittanbieter-App-Analysen (durch Aktivieren der Conversion-Aktionen
FIREBASE_*oderTHIRD_PARTY_*)
- Reicht es aus, Installationen oder Käufe im 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 Geschäftsstandort oder am Telefon.
In der folgenden Tabelle finden Sie die entsprechenden ConversionActionType-API-Parameter, die für die einzelnen Quellen in der Google Ads-Weboberfläche verwendet werden, sowie einen Link zur Dokumentation für die einzelnen Conversion-Aktionstypen:
| Typ der Conversion-Aktion | Google Ads-Quelle | Anleitung zur API-Einrichtung |
|---|---|---|
UPLOAD_CLICKS |
Klick-Conversions und erweiterte Conversions für Leads erfassen | Verwenden Sie die Data Manager API (empfohlen) oder lesen Sie den Hilfeartikel Offline-Klick-Conversions verwalten, wenn Sie bereits die Google Ads API verwenden. |
UPLOAD_CALLS |
Anruf-Conversions erfassen | Leitfaden zum Importieren von Anruf-Conversions |
STORE_SALES |
Conversions in Form von Ladenverkäufen erfassen | Weitere Informationen finden Sie unter Ladenverkäufe: Import in Conversion-Aktion mit Berichten. |
Online-Conversions (Website)
Mit einer Website-Conversion können Sie Website-Aktionen wie Onlineverkäufe, Linkklicks, Seitenaufrufe und Anmeldungen erfassen.
Wenn Sie Conversions auf Ihrer Website erfassen möchten, müssen Sie eine ConversionAction erstellen, bei der ConversionActionType auf WEBPAGE festgelegt ist. Außerdem müssen Sie ein Code-Snippet, das als Tag bezeichnet wird, auf der Conversion-Seite Ihrer Website einfügen.
Die ConversionAction umfasst mehrere Arten von Website-Conversions, die in der API durch das Feld type in jeder TagSnippet unterschieden werden, die im Feld tag_snippets einer ConversionAction aufgeführt ist.
Ein TagSnippet enthält den Tracking-Code, der auf Ihrer Website eingefügt werden muss, damit Ihre Conversion-Aktionen erfasst werden können.
Für Website- und Klick auf Telefonnummer-Conversions sind das event_snippet, das auf Webseiten platziert werden sollte, die auf eine Conversion-Aktion hinweisen, z. B. eine Bestätigungsseite für den Bezahlvorgang oder eine Seite zum Senden eines Lead-Formulars, und das global_site_tag erforderlich, das auf jeder Seite Ihrer Website installiert werden muss. Sie können beide Attribute mit ConversionActionService abrufen. Weitere Informationen zum Taggen von Seiten finden Sie in der Google Ads-Hilfe.
In der folgenden Tabelle sind die entsprechenden API-Parameter aufgeführt, die für die einzelnen Quellen in der Google Ads-Weboberfläche verwendet werden:
| Tracking-Code-Typ | Google Ads-Quelle |
|---|---|
WEBPAGE |
Website, Website (Google Analytics (GA4)) |
WEBPAGE_ONCLICK |
Website, Website (Google Analytics (GA4)) |
CLICK_TO_CALL |
Klicks auf eine Telefonnummer |
App-Conversions
Mit einer App-Conversion können Sie App-Installationen oder In-App-Käufe aus dem Google Play Store erfassen.
In der folgenden Tabelle sind die entsprechenden ConversionActionType-API-Parameter aufgeführt, die für die einzelnen Quellen in der Google Ads-Weboberfläche verwendet werden sollen:
| 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, finden Sie weitere Informationen unter Zusätzliche Conversion-Aktionstypen.
Anruf-Conversions
Mit dem Conversion-Tracking für Anrufe können Sie Anrufe über Anzeigen, Anrufe über eine Nummer auf Ihrer Website und Klicks auf Nummern auf mobilen Websites erfassen.
In der folgenden Tabelle sind die entsprechenden ConversionActionType-API-Parameter aufgeführt, die für die einzelnen Quellen in der Google Ads-Weboberfläche verwendet werden sollen:
| 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 im Feld call_conversion_action an, wenn Sie eine CallAsset erstellen.
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 Conversion-Aktion vom Typ WEBSITE_CALL wird in der Google Ads-Weboberfläche als Conversion vom Typ Anrufe über eine Website angezeigt.
Im Gegensatz zu AD_CALL müssen bei diesem Tracker event_snippet und global_site_tag auf Ihrer Website hinzugefügt werden, um die dynamische Google-Weiterleitungsnummer für das Anruf-Tracking von Nummern auf Ihrer Website abzurufen. Außerdem müssen Sie ein Anruf-Asset einrichten und
auf Kunden-, Kampagnen- oder Anzeigengruppenebene verknüpfen.
CLICK_TO_CALL
Eine Conversion-Aktion vom Typ CLICK_TO_CALL wird in der Google Ads-Weboberfläche als Conversion vom Typ Klicks auf Ihre Telefonnummer auf der mobilen Website angezeigt.
Der Typ CLICK_TO_CALL unterscheidet sich vom Typ AD_CALL dadurch, dass keine tatsächlichen Anrufe erfasst werden. Stattdessen werden in CLICK_TO_CALL nur Klicks auf eine Telefonnummer von einem Mobilgerät aus erfasst. Das ist nützlich, wenn Sie keine Google-Weiterleitungsnummer zum Erfassen von Anrufen verwenden können.
Erweiterte Conversions
Mit erweiterten Conversions können Sie die Genauigkeit Ihrer Conversion-Analyse verbessern, indem Sie Ihre vorhandenen Conversion-Tags um selbst erhobene Conversion-Daten wie E‑Mail-Adresse, Name, Privatadresse und Telefonnummer ergänzen.
In der folgenden Tabelle sind die entsprechenden API-Parameter für die einzelnen Typen von erweiterten Conversions aufgeführt:
| Typ der Conversion-Aktion | Typ der erweiterten Conversion | Anleitung zur API-Einrichtung |
|---|---|---|
UPLOAD_CLICKS |
Erweiterte Conversions für Leads
Verbessert die Analyse von Offlinetransaktionen, die auf Website-Leads oder Websitebesuche zurückzuführen sind. |
Verwenden Sie die Data Manager API (empfohlen) oder lesen Sie den Hilfeartikel Offline-Klick-Conversions verwalten, wenn Sie bereits die Google Ads API verwenden. |
WEBPAGE |
Erweiterte Conversions für das Web
Verbessert die Messung von Online-Conversions |
API-Einrichtungsleitfaden |
Zusätzliche Arten von Conversion-Aktionen
In der 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 unzulässig sein. Sie können Ihre Conversion-Aktionen und deren Typen mit GoogleAdsService abfragen:
SELECT
conversion_action.id,
conversion_action.name,
conversion_action.type,
conversion_action.status
FROM conversion_action
SKAdNetwork-Conversions
Wenn Sie iOS-App-Kampagnen ausführen und SKAdNetwork implementiert haben, können Sie über die folgenden Ressourcen auf SKAdNetwork-Daten zugreifen, die Google auf Customer- und Campaign-Ebene zur Verfügung gestellt werden:
| Feld im Bericht | 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 Segmenten 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 zugeordnet wird. |
segments.sk_ad_network_fine_conversion_value |
Der Wert einer von Apple gemeldeten 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 ID der App, in 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 zutreffend ist, z. B. bei einer Kampagne, die nicht für iOS bestimmt ist, oder dass es in keinem von Apple gesendeten Postback 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 zutreffend ist, z. B. bei einer Nicht-iOS-Kampagne, oder dass weder die Quelldomain noch die Quell-App in den von Apple gesendeten Postbacks vorhanden waren. |
segments.sk_ad_network_user_type |
Der Typ des Nutzers, 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 feinen Conversion-Werte und der von Google geschätzten Nullwerte dar. |
segments.sk_ad_network_version |
Die verwendete Version der iOS Store Kit Werbenetzwerk API. |
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 Conversion in einer GA4-Property 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 die Conversion auf Google Ads-Gebote und -Berichte auswirken soll. - Aktualisieren Sie
nameodervalue_settings. - Entfernen Sie die Conversion mit einem
remove-Vorgang aus Ihrem Google Ads-Konto.
Wenn Sie versuchen, andere Attribute einer importierten GA4-Conversion oder beliebige Attribute einer importierten Universal Analytics-Conversion zu ändern, wird der Fehler MUTATE_NOT_ALLOWED zurückgegeben. Diese Änderungen können nur über die Google Ads-Benutzeroberfläche vorgenommen werden.
Firebase und Drittanbieter-App-Analysen
Wenn Sie App-Analysen von Drittanbietern oder Firebase-Conversions importieren möchten, ändern Sie den status des ConversionAction mit der Methode mutate von ConversionActionService von HIDDEN in ENABLED. Das Aktualisieren von 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 Berichten
Sie können zwar keine Conversion-Aktionen vom Typ STORE_SALES oder STORE_SALES_DIRECT_UPLOAD mit der Google Ads API erstellen, aber die API unterstützt den Import von Transaktionen aus 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 Berichtszwecke 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 bei Abfragen und in Berichten möglicherweise Conversion-Aktionen zurückgegeben, bei denen der ConversionAction.type UNKNOWN ist. Die API unterstützt die Verwaltung dieser Conversion-Aktionen nicht, gibt sie aber in Berichten zurück, um vollständige Ergebnisse für wichtige Conversion-Messwerte wie metrics.conversions und metrics.conversions_value bereitzustellen.