In dieser Anleitung finden Sie eine Liste der verschiedenen Arten von Conversion-Aktionen, die Sie mit der Google Ads API erstellen können, und Informationen dazu, wie diese der Google Ads-Weboberfläche zugeordnet sind.
Den richtigen Conversion-Aktionstyp auswählen
So wählen Sie den richtigen Conversion-Aktionstyp und die richtige Einrichtungsanleitung für Ihre Integration aus:
Wo findet das Conversion-Ereignis statt?
- Offline (z. B. in Ihrem Büro, an Ihrem Unternehmensstandort oder am Telefon): Fahren Sie mit Schritt 2 fort.
- Direkt auf Ihrer Website (z. B. Websitekä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:
- Handelt es sich um einen Anruf?
- Ja: Verwenden Sie Anruf-Conversions importieren (
UPLOAD_CALLS) , um Anrufergebnisse zu erfassen.
- Ja: Verwenden Sie Anruf-Conversions importieren (
- Handelt es sich um einen Verkauf in einem Ladengeschäft?
- Ja: Verwenden Sie Conversions in Form von Ladenverkäufen (
STORE_SALES).
- Ja: Verwenden Sie Conversions in Form von Ladenverkäufen (
- Handelt es sich um einen Offline-Verkauf oder einen Lead, der aus einem Websitebesuch resultiert?
- Ja: Verwenden Sie Erweiterte Conversions für Leads mit der Data
Manager API.
(Hinweis: Das Hochladen von Klick-Conversions mit
UPLOAD_CLICKSoderUploadClickConversionwird ab dem 15. Juni 2026 eingestellt.)
- Ja: Verwenden Sie Erweiterte Conversions für Leads mit der Data
Manager API.
(Hinweis: Das Hochladen von Klick-Conversions mit
- Handelt es sich um einen Anruf?
Online-Conversions (Website) :
- Möchten Sie Seitenaufrufe (Käufe, Belege) oder Nutzerklicks erfassen?
- Ja: Verwenden Sie Website-Conversions , wobei das Tag-Snippet auf
WEBPAGEoderWEBPAGE_ONCLICKfestgelegt ist.
- Ja: Verwenden Sie Website-Conversions , wobei das Tag-Snippet auf
- Möchten Sie Anrufe erfassen, die über eine Telefonnummer auf Ihrer
Website getätigt wurden?
- Möchten Sie die 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 Sie
Klicks auf Ihre Mobiltelefonnummer (
CLICK_TO_CALL).
- Ja: Verwenden Sie Anrufe über eine Website (
- Möchten Sie die tatsächliche Anrufdauer erfassen?
- Möchten Sie Seitenaufrufe (Käufe, Belege) oder Nutzerklicks erfassen?
Mobile 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-Analysen von
Drittanbietern?
- Ja: Verwenden Sie Firebase und App-Analysen von Drittanbietern (indem Sie
FIREBASE_*oderTHIRD_PARTY_*Conversion-Aktionen aktivieren).
- Ja: Verwenden Sie Firebase und App-Analysen von Drittanbietern (indem Sie
- Reicht es aus, Installationen oder Käufe im Google Play Store zu erfassen?
Offline-Conversions
Offline-Conversions helfen Ihnen, Conversion-Ereignisse zu erfassen, die in der Offline-Welt stattfinden, z. B. in Ihrem Büro, an Ihrem Unternehmensstandort oder am Telefon.
In der folgenden Tabelle sind die entsprechenden
ConversionActionType-API-Parameter für jede Quelle in der
Google Ads-Weboberfläche und ein Link zur Dokumentation für jeden spezifischen
Conversion-Aktionstyp aufgeführt:
| Conversion-Aktionstyp | 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 | Anleitung zum Importieren von Anruf-Conversions |
STORE_SALES |
Conversions in Form von Ladenverkäufen erfassen | Anleitung zum Importieren von Conversions in Form von Ladenverkäufen |
Online-Conversions (Website)
Mit Website-Conversions 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, ein sogenanntes
Tag , auf der Conversion-Seite
Ihrer Website hinzufügen.
Die 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 einer ConversionAction aufgeführt ist.
Ein TagSnippet enthält den Tracking-Code, der in Ihre Website eingefügt werden muss
, um Ihre Conversion-Aktionen zu erfassen.
Für Website \- und Klicks auf eine Telefonnummer \-Conversions ist das
event_snippet erforderlich, das auf Webseiten platziert werden sollte, die auf eine Conversion-Aktion hinweisen, z. B. eine Bestätigungsseite für den Kaufabschluss oder eine Seite zur Einreichung 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 dem
ConversionActionService abrufen. Weitere Informationen zum Tagging Ihrer Seiten finden Sie in der Google Ads-Hilfe.
In der folgenden Tabelle sind die entsprechenden API-Parameter für jede Quelle in der Google Ads-Weboberfläche aufgeführt:
| 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 App-Conversions können Sie Installationen mobiler Apps oder In-App-Käufe im Google Play Store erfassen.
In der folgenden Tabelle sind die entsprechenden ConversionActionType API
Parameter für jede Quelle in der Google Ads-Weboberfläche aufgeführt:
| Conversion-Aktionstyp | Google Ads-Quelle |
|---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > Installationen |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > In-App-Käufe |
Informationen zum Erfassen anderer mobiler App-Aktionen mit Google Analytics 4-Properties oder App-Analysen von Drittanbietern finden Sie unter Zusätzliche Conversion-Aktionstypen.
Anruf-Conversions
Mit dem 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 sind die entsprechenden ConversionActionType API
Parameter für jede Quelle in der Google Ads-Weboberfläche aufgeführt:
| Conversion-Aktionstyp | 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 angezeigt. Nachdem Sie
Ihre AD_CALL Conversion-Aktion erstellt haben, geben Sie ihren Ressourcennamen im
call_conversion_action Feld an, wenn Sie ein CallAsset erstellen.
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.
Im Gegensatz zu AD_CALL müssen für diesen Tracker event_snippet und
global_site_tag auf Ihrer Website hinzugefügt werden, um die
dynamische Google-Weiterleitungsnummer für das Anruf-Tracking für Telefonnummern auf
Ihrer Website abzurufen. Außerdem müssen Sie ein Anruf-Asset einrichten und
es auf Kunden-, Kampagnen- oder Anzeigengruppenebene verknüpfen.
CLICK_TO_CALL
Eine CLICK_TO_CALL-Conversion-Aktion wird in der Google Ads
-Weboberfläche als
Klicks auf Ihre Telefonnummer auf Ihrer mobilen Website-Conversion angezeigt.
Der CLICK_TO_CALL Typ unterscheidet sich vom AD_CALL Typ dadurch, dass er
keine tatsächlichen Anrufe erfasst. Stattdessen werden mit CLICK_TO_CALL nur Klicks auf eine Telefonnummer von einem Mobilgerät aus erfasst. Das ist nützlich, wenn Sie keine Google-Weiterleitungsnummer für das Tracking 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 mit selbst erhobenen Conversion-Daten wie E‑Mail-Adresse, Name, Privatadresse und Telefonnummer ergänzen.
In der folgenden Tabelle sind die entsprechenden API-Parameter für jeden Typ erweiterter Conversions aufgeführt:
| Conversion-Aktionstyp | Typ erweiterter Conversions | Einrichtungsanleitung für die API |
|---|---|---|
UPLOAD_CLICKS |
Erweiterte Conversions für Leads
Optimiert die Messung von Offlinetransaktionen, die von einem Website-Lead oder Besucher vorgenommen wurden |
Data Manager API verwenden |
WEBPAGE |
Erweiterte Conversions für das Web
Verbessert die Messung von Online-Conversions |
Einrichtungsanleitung für die API |
Zusätzliche Conversion-Aktionstypen
Die Google Ads API stellt zusätzliche Arten von Conversion-Aktionen in Berichten zur Verfügung, kann aber die Erstellung oder Änderung dieser Aktionen einschränken oder verbieten.
SKAdNetwork-Conversions
Wenn Sie iOS-App-Kampagnen ausführen und SKAdNetwork implementiert haben, können Sie auf SKAdNetwork-Daten zugreifen, die Google auf Customer und Campaign
Ebene zur Verfügung gestellt werden. Verwenden Sie dazu die folgenden Ressourcen:
| Feld im Bericht | Beschreibung |
|---|---|
metrics.sk_ad_network_installs |
Die von Apple gemeldete Anzahl der 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 Ereignistyp, der für eine bestimmte Conversion aufgetreten ist |
segments.sk_ad_network_attribution_credit |
Wie die Attribution für eine bestimmte Conversion erfolgt |
segments.sk_ad_network_fine_conversion_value |
Der von Apple gemeldete Wert einer Conversion Dieses Segment kann nur auf die Messwerte Wenn Apple einen Wert von
|
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, 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 anwendbar ist, z. B. bei einer Nicht-iOS-Kampagne, 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 anwendbar ist, z. B. bei einer Nicht-iOS-Kampagne, oder dass weder die Quelldomain noch die Quell-App in einem von Apple gesendeten Postback 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 verteilt wurden. Dieses Segment stellt die Summe der von Apple zurückgegebenen beobachteten genauen Conversion-Werte und der von Google geschätzten Nullwerte dar. |
segments.sk_ad_network_version |
Die verwendete iOS Store Kit Ad Network API-Version |
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 auch die GA4-Property-ID, den Property-Namen und den Ereignisnamen aus dem
google_analytics_4_settingsFeld abrufen.
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 die Conversion auf Gebote und Berichte in Google Ads auswirken soll. - Aktualisieren Sie
nameodervalue_settings. - Entfernen Sie die Conversion mit einem
remove-Vorgang aus Ihrem Google Ads-Konto.
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. Sie können diese Änderungen nur über die Google Ads-Benutzeroberfläche vornehmen.
Firebase und Drittanbieter-App-Analysen
Wenn Sie App-Analysen von Drittanbieter-Apps oder Firebase-Conversions importieren möchten, ändern Sie
den status der ConversionAction mit
der Methode mutate von ConversionActionService von HIDDEN in ENABLED. Das Aktualisieren der
app_id wird für diese Conversion-Aktionen nicht unterstützt.
FIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_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 STORE_SALES oder STORE_SALES_DIRECT_UPLOAD
Conversion-Aktionen mit der Google Ads API erstellen, aber die API unterstützt den Import von Laden
verkaufstransaktionen.
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
Conversion-Aktionstypen mit Lesezugriff
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 das
ConversionAction.type auf UNKNOWN festgelegt 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 zu liefern.