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.
Offline-Conversions
Mit Offline-Conversions können Sie Conversion-Ereignisse erfassen, die offline stattfinden, z. B. in Ihrem Büro, an Ihrem Unternehmensstandort oder per 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 jeden Conversion-Aktionstyp:
Typ der Conversion-Aktion | Google Ads-Quelle | Anleitung zur API-Einrichtung |
---|---|---|
UPLOAD_CLICKS |
Klick-Conversions und erweiterte Conversions für Leads erfassen | Leitfaden zum Verwalten von Offline-Klick-Conversions
Leitfaden zu erweiterten Conversions für Leads |
UPLOAD_CALLS |
Anruf-Conversions erfassen | Anruf-Conversions importieren |
STORE_SALES |
Conversions in Form von Ladenverkäufen erfassen | Leitfaden 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
mit ConversionActionType
auf WEBPAGE
erstellen und ein Code-Snippet namens Tag 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 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, damit Ihre Conversion-Aktionen erfasst werden können.
Für Website- und Klick auf Telefonnummer-Conversions sind das event_snippet
-Tag, das auf Webseiten platziert werden sollte, die auf eine Conversion-Aktion hinweisen, z. B. auf einer Seite mit einer Bestätigung für den Check-out oder einer Seite mit einem eingereichten Lead-Formular, und das global_site_tag
-Tag erforderlich, das auf jeder Seite Ihrer Website installiert sein muss. Sie können beide Attribute mit der ConversionActionService
abrufen. Weitere Informationen zum Taggen von Seiten finden Sie in der Hilfe.
In der folgenden Tabelle finden Sie die entsprechenden API-Parameter für jede Quelle in der Google Ads-Weboberfläche:
Tracking-Code-Typ | Google Ads-Quelle |
---|---|
WEBPAGE |
Website, Website (Google Analytics (GA4)) |
WEBPAGE_ONCLICK |
Website, Website (Google Analytics 4 (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 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 an eine 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 eines 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.
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 bei Telefonnummern 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 CLICK_TO_CALL
-Conversion-Aktion wird in der Google Ads-Weboberfläche als Klicks auf Ihre Telefonnummer auf Ihrer 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 Telefonanrufen verwenden können.
Erweiterte Conversions
Erweiterte Conversions können dazu beitragen, die Genauigkeit der Conversion-Analyse zu 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 finden Sie die entsprechenden API-Parameter für die einzelnen Typen erweiterter Conversions:
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 von einem Website-Lead oder Besucher vorgenommen wurden |
API-Einrichtungsanleitung |
WEBPAGE |
Erweiterte Conversions für das Web
Verbessert die Analyse von Online-Conversions |
API-Einrichtungsanleitung |
Zusätzliche Conversion-Aktionstypen
Ü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 über die 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 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 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 zutrifft, z. B. bei einer Kampagne, die nicht für iOS gilt, oder dass es in keinen 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 zutrifft, 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 verteilt wurden. Dieses Segment enthält die Summe der von Apple zurückgegebenen beobachteten detaillierten Conversion-Werte und der von Google geschätzten Nullwerte. |
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_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
Sie können die GA4-Property-ID, den Property-Namen und den Ereignisnamen auch aus dem Feld
google_analytics_4_settings
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
status
vonHIDDEN
inENABLED
ändern. - Ändern Sie die Felder
primary_for_goal
undcategory
, um anzugeben, wie sich das auf Gebote und Berichte in Google Ads auswirken soll. - Aktualisieren Sie die
name
odervalue_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. Diese Änderungen können Sie nur über die Google Ads-Benutzeroberfläche vornehmen.
Firebase und App-Analysen von Drittanbietern
Wenn Sie Conversions aus App-Analysen von Drittanbietern oder Firebase importieren möchten, ändern Sie die status
des ConversionAction
von HIDDEN
zu ENABLED
. Verwenden Sie dazu die mutate
-Methode von ConversionActionService
. Das Aktualisieren von app_id
wird für diese Conversion-Aktionen nicht unterstützt.
FIREBASE_ANDROID_FIRST_OPEN
FIREBASE_ANDROID_IN_APP_PURCHASE
FIREBASE_ANDROID_CUSTOM
FIREBASE_IOS_FIRST_OPEN
FIREBASE_IOS_IN_APP_PURCHASE
FIREBASE_IOS_CUSTOM
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
Ladenverkäufe: Import in Conversion-Aktion mit Berichterstellung
STORE_SALES
- oder STORE_SALES_DIRECT_UPLOAD
-Conversion-Aktionen können nicht über die Google Ads API erstellt werden. Die API unterstützt jedoch den Import von Transaktionen für Ladenverkäufe.
STORE_SALES
STORE_SALES_DIRECT_UPLOAD
Schreibgeschützte Conversion-Aktionstypen
Die folgenden Conversion-Aktionstypen sind in der Google Ads API schreibgeschützt und werden zu Berichtszwecken bereitgestellt.
ANDROID_APP_PRE_REGISTRATION
ANDROID_INSTALLS_ALL_OTHER_APPS
FLOODLIGHT_ACTION
FLOODLIGHT_TRANSACTION
GOOGLE_HOSTED
LEAD_FORM_SUBMIT
SALESFORCE
SEARCH_ADS_360
SMART_CAMPAIGN_AD_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS
SMART_CAMPAIGN_TRACKED_CALLS
STORE_VISITS
WEBPAGE_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
gleich 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.