ConversionAction

Eine Conversion-Aktion.

JSON-Darstellung 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname der Conversion-Aktion. Ressourcennamen von Conversion-Aktionen haben folgendes Format:

customers/{customerId}/conversionActions/{conversionActionId}
status

enum (ConversionActionStatus)

Der Status dieser Conversion-Aktion für Conversion-Ereignisse-Ansammlung.
type

enum (ConversionActionType)

Nicht veränderbar. Der Typ dieser Conversion-Aktion.
origin

enum (ConversionOrigin)

Nur Ausgabe. Der Conversion-Ursprung dieser Conversion-Aktion.
category

enum (ConversionActionCategory)

Die Kategorie der Conversions, die für diese Conversion-Aktion erfasst wurden.
valueSettings

object (ValueSettings)

Einstellungen für den Wert von Conversion-Ereignissen, die mit dieser Conversion-Aktion verknüpft sind.
countingType

enum (ConversionActionCountingType)

So werden Conversion-Ereignisse für die Conversion-Aktion gezählt.
attributionModelSettings

object (AttributionModelSettings)

Einstellungen für das Attributionsmodell dieser Conversion-Aktion.
tagSnippets[]

object (TagSnippet)

Nur Ausgabe. Die Snippets, die für das Conversion-Tracking verwendet werden.
mobileAppVendor

enum (MobileAppVendor)

Nur Ausgabe. Anbieter der mobilen App für eine App-Conversion-Aktion.
firebaseSettings

object (FirebaseSettings)

Nur Ausgabe. Firebase-Einstellungen für Firebase-Conversion-Typen.
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

Nur Ausgabe. Einstellungen für App-Analysen von Drittanbietern für Conversion-Typen von Drittanbietern.
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

Nur Ausgabe. Google Analytics 4-Einstellungen für Google Analytics 4-Conversion-Typen.
id

string (int64 format)

Nur Ausgabe. ID der Conversion-Aktion.
name

string

Der Name der Conversion-Aktion.

Dieses Feld ist erforderlich und darf beim Erstellen neuer Conversion-Aktionen nicht leer sein.
primaryForGoal

boolean

Wenn das Bit „primaryForGoal“ einer Conversion-Aktion auf „false“ gesetzt ist, können für die Conversion-Aktion keine Gebote für alle Kampagnen abgegeben werden, unabhängig vom Conversion-Zielvorhaben des Kunden oder vom Conversion-Zielvorhaben der Kampagne. Bei benutzerdefinierten Conversion-Zielvorhaben wird „primaryForGoal“ jedoch nicht berücksichtigt. Wenn für eine Kampagne ein benutzerdefiniertes Conversion-Zielvorhaben mit der Conversion-Aktion „primaryForGoal = false“ konfiguriert ist, kann für diese Conversion-Aktion weiterhin geboten werden. Wenn „primaryForGoal“ nicht festgelegt ist, wird standardmäßig „true“ verwendet. In Version 9 kann „primaryForGoal“ erst nach dem Erstellen über einen „update“-Vorgang auf „false“ gesetzt werden, da es nicht als optional deklariert ist.
ownerCustomer

string

Nur Ausgabe. Der Ressourcenname des Kunden, der Inhaber der Conversion-Aktion ist, oder „null“, wenn es sich um eine systemdefinierte Conversion-Aktion handelt.
includeInConversionsMetric

boolean

Gibt an, ob diese Conversion-Aktion in den Messwert „Conversions“ einbezogen werden soll.
clickThroughLookbackWindowDays

string (int64 format)

Die maximale Anzahl von Tagen, die zwischen einer Interaktion (z. B. einem Klick) und einem Conversion-Ereignis verstreichen darf.
viewThroughLookbackWindowDays

string (int64 format)

Die maximale Anzahl von Tagen, die zwischen einer Impression und einer Conversion ohne Interaktion vergehen kann.
phoneCallDurationSeconds

string (int64 format)

Die Dauer des Anrufs in Sekunden, nach der eine Conversion für diese Conversion-Aktion erfasst werden soll.

Der Wert muss zwischen 0 und 10.000 liegen.
appId

string

App-ID für eine App-Conversion-Aktion.

ConversionActionStatus

Mögliche Status einer Conversion-Aktion.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
ENABLED Conversions werden erfasst.
REMOVED Conversions werden nicht erfasst.
HIDDEN Conversions werden nicht erfasst und die Conversion-Aktion wird nicht in der Benutzeroberfläche angezeigt.

ConversionActionType

Mögliche Typen einer Conversion-Aktion.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
AD_CALL Conversions, die erfasst werden, wenn ein Nutzer auf die Anruferweiterung einer Anzeige klickt.
CLICK_TO_CALL Conversions, die auftreten, wenn ein Nutzer auf einem Mobilgerät auf eine Telefonnummer klickt.
GOOGLE_PLAY_DOWNLOAD Conversions, die auftreten, wenn ein Nutzer eine mobile App aus dem Google Play Store herunterlädt.
GOOGLE_PLAY_IN_APP_PURCHASE Conversions, die auftreten, wenn ein Nutzer über die Android-Abrechnung einen Kauf in einer App tätigt.
UPLOAD_CALLS Anruf-Conversions, die vom Werbetreibenden erfasst und hochgeladen werden.
UPLOAD_CLICKS Conversions, die vom Werbetreibenden erfasst und mit zugeordneten Klicks hochgeladen werden.
WEBPAGE Conversions, die auf einer Webseite erfolgen.
WEBSITE_CALL Conversions, die erfasst werden, wenn ein Nutzer eine dynamisch generierte Telefonnummer von der Website eines Werbetreibenden aus anruft.
STORE_SALES_DIRECT_UPLOAD Conversion vom Typ „Ladenverkäufe“, die auf selbst erhobenen oder von Händlern hochgeladenen Daten basieren. Nur Kunden auf der Zulassungsliste können die Typen für den direkten Upload von Ladenverkäufen verwenden.
STORE_SALES Conversion vom Typ „Ladenverkäufe“, die auf selbst erhobenen oder von Händlern hochgeladenen Daten und/oder auf Käufen im Geschäft mit Karten von Zahlungsnetzwerken basiert. Nur Kunden auf der Zulassungsliste können Arten von Ladenverkäufen verwenden. Schreibgeschützt.
FIREBASE_ANDROID_FIRST_OPEN Conversions vom Typ „Erstes Öffnen“ von Android-Apps, die über Firebase erfasst werden.
FIREBASE_ANDROID_IN_APP_PURCHASE In-App-Käufe in Android-Apps, die über Firebase erfasst werden
FIREBASE_ANDROID_CUSTOM Benutzerdefinierte Conversions für Android-Apps, die über Firebase erfasst werden
FIREBASE_IOS_FIRST_OPEN Conversions vom Typ „Erstes Öffnen“ von iOS-Apps, die über Firebase erfasst werden
FIREBASE_IOS_IN_APP_PURCHASE In-App-Kauf-Conversions von iOS-Apps, die über Firebase erfasst werden
FIREBASE_IOS_CUSTOM Benutzerdefinierte Conversions für iOS-Apps, die über Firebase erfasst werden
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversions vom Typ „Erstes Öffnen“ von Android-Apps, die über App-Analysen von Drittanbietern erfasst werden.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversions für In-App-Käufe in Android-Apps, die über App-Analysetools von Drittanbietern erfasst werden
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Benutzerdefinierte Conversions für Android-Apps, die über App-Analysen von Drittanbietern erfasst werden
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversions vom Typ „Erstes Öffnen“ von iOS-Apps, die über App-Analysen von Drittanbietern erfasst werden.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE In-App-Kauf-Conversions von iOS-Apps, die über App-Analysetools von Drittanbietern erfasst werden.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Benutzerdefinierte Conversions für iOS-Apps, die über App-Analysen von Drittanbietern erfasst werden
ANDROID_APP_PRE_REGISTRATION Conversions, die auftreten, wenn sich ein Nutzer im Google Play Store für eine mobile App vorregistriert. Schreibgeschützt.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversions, bei denen alle Google Play-Downloads erfasst werden, die nicht über einen app-spezifischen Typ erfasst werden. Schreibgeschützt.
FLOODLIGHT_ACTION Floodlight-Aktivität, mit der gezählt wird, wie oft Nutzer eine bestimmte Webseite besucht haben, nachdem sie eine Anzeige eines Werbetreibenden gesehen oder darauf geklickt haben. Schreibgeschützt.
FLOODLIGHT_TRANSACTION Floodlight-Aktivität, mit der die Anzahl der Verkäufe oder der gekauften Artikel erfasst wird. Außerdem kann der Gesamtwert jedes Verkaufs erfasst werden. Schreibgeschützt.
GOOGLE_HOSTED Conversions, bei denen lokale Aktionen über Produkte und Dienste von Google erfasst werden, nachdem Nutzer mit einer Anzeige interagiert haben. Schreibgeschützt.
LEAD_FORM_SUBMIT Conversions, die erfasst werden, wenn ein Nutzer ein Lead-Formular einreicht. Schreibgeschützt.
SALESFORCE

Eingestellt: Die Salesforce-Verknüpfung wird eingestellt und durch eine verbesserte Möglichkeit zum Importieren von Conversions aus Salesforce ersetzt. https://support.google.com/google-ads/answer/14728349
SEARCH_ADS_360 Conversions, die aus Floodlight-Daten in Search Ads 360 importiert wurden. Schreibgeschützt.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Anruf-Conversions, die über Anzeigen in smarten Kampagnen ohne eingerichtetes Anruf-Tracking mit benutzerdefinierten Kriterien für smarte Kampagnen erfolgen Schreibgeschützt.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Der Nutzer klickt in Google Maps auf ein Anrufelement. Nur für smarte Kampagnen. Schreibgeschützt.
SMART_CAMPAIGN_MAP_DIRECTIONS Der Nutzer ruft in Google Maps eine Wegbeschreibung zu einem Unternehmensstandort ab. Nur für smarte Kampagnen. Schreibgeschützt.
SMART_CAMPAIGN_TRACKED_CALLS Anruf-Conversions, die bei Anzeigen in intelligenten Kampagnen mit eingerichtetem Anruf-Tracking mit benutzerdefinierten Kriterien für intelligente Kampagnen erfolgen. Schreibgeschützt.
STORE_VISITS Conversions, die auftreten, wenn ein Nutzer das Ladengeschäft eines Werbetreibenden besucht. Schreibgeschützt.
WEBPAGE_CODELESS Conversions, die aus Websiteereignissen wie Formulareinreichungen oder Seitenladevorgängen erstellt wurden und für die keine individuell codierten Ereignis-Snippets verwendet werden. Schreibgeschützt.
UNIVERSAL_ANALYTICS_GOAL Conversions, die auf verknüpfte Universal Analytics-Zielvorhaben zurückzuführen sind.
UNIVERSAL_ANALYTICS_TRANSACTION Conversions, die aus verknüpften Universal Analytics-Transaktionen stammen.
GOOGLE_ANALYTICS_4_CUSTOM Conversions, die aus verknüpften Google Analytics 4-Conversion-Ereignissen stammen
GOOGLE_ANALYTICS_4_PURCHASE Conversions, die aus verknüpften Google Analytics 4-Kauf-Conversions stammen.

ValueSettings

Einstellungen für den Wert von Conversion-Ereignissen, die mit dieser Conversion-Aktion verknüpft sind.

JSON-Darstellung 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Felder
defaultValue

number

Dieser Wert wird verwendet, wenn Conversion-Ereignisse für diese Conversion-Aktion mit einem ungültigen, nicht zulässigen oder fehlenden Wert gesendet werden oder wenn für diese Conversion-Aktion festgelegt ist, dass immer der Standardwert verwendet werden soll.
defaultCurrencyCode

string

Der Währungscode, der verwendet werden soll, wenn Conversion-Ereignisse für diese Conversion-Aktion mit einem ungültigen oder fehlenden Währungscode gesendet werden oder wenn für diese Conversion-Aktion konfiguriert ist, dass immer der Standardwert verwendet werden soll.
alwaysUseDefaultValue

boolean

Hier legen Sie fest, ob der Standardwert und der Standardwährungscode anstelle des Werts und des Währungscodes verwendet werden, die in Conversion-Ereignissen für diese Conversion-Aktion angegeben sind.

ConversionActionCountingType

Gibt an, wie Conversions für diese Aktion gezählt werden. Weitere Informationen finden Sie unter https://support.google.com/google-ads/answer/3438531.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
ONE_PER_CLICK Es wird nur eine Conversion pro Klick gezählt.
MANY_PER_CLICK Alle Conversions pro Klick zählen

AttributionModelSettings

Einstellungen für das Attributionsmodell dieser Conversion-Aktion.

JSON-Darstellung 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Felder
attributionModel

enum (AttributionModel)

Der Attributionsmodelltyp dieser Conversion-Aktion.
dataDrivenModelStatus

enum (DataDrivenModelStatus)

Nur Ausgabe. Der Status des datengetriebenen Attributionsmodells für die Conversion-Aktion.

AttributionModel

Das Attributionsmodell, das beschreibt, wie der Beitrag zu einer bestimmten Conversion auf potenziell viele vorherige Interaktionen verteilt wird.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
EXTERNAL Es wird die externe Attribution verwendet.
GOOGLE_ADS_LAST_CLICK Der gesamte Wert einer Conversion wird dem letzten Klick zugeordnet.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Ordnet eine Conversion mithilfe der Attribution für die Google Suche dem ersten Klick zu.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Der Wert einer Conversion wird mithilfe der Attribution für die Google Suche gleichmäßig auf alle Klicks verteilt.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Bei der Attribution für die Google Suche wird den neueren Klicks ein exponentiell höherer Wert für eine Conversion zugeordnet (Halbwertszeit: 1 Woche).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Ordnet eine Conversion zu 40% dem ersten und letzten Klick zu. Die verbleibenden 20% werden gleichmäßig auf alle anderen Klicks verteilt. Dabei wird die Attribution für die Google Suche verwendet.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Ein flexibles Modell, bei dem mithilfe von maschinellem Lernen die richtige Verteilung der Beiträge zu Conversions auf Klicks mit der Google Suche-Attribution ermittelt wird.

DataDrivenModelStatus

Listet die Status datengetriebener Modelle auf.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
AVAILABLE Das datengetriebene Modell ist verfügbar.
STALE Das datengetriebene Modell ist veraltet. Es wurde mindestens 7 Tage lang nicht aktualisiert. Er wird noch verwendet, läuft aber ab, wenn er 30 Tage lang nicht aktualisiert wird.
EXPIRED Das datengetriebene Modell ist abgelaufen. Es wurde mindestens 30 Tage lang nicht aktualisiert und kann nicht verwendet werden. In den meisten Fällen liegt das daran, dass in den letzten 30 Tagen nicht die erforderliche Anzahl an Ereignissen erfasst wurde.
NEVER_GENERATED Das datengetriebene Modell wurde noch nie generiert. In den meisten Fällen liegt das daran, dass in keinem 30-Tage-Zeitraum die erforderliche Anzahl an Ereignissen erreicht wurde.

FirebaseSettings

Einstellungen für eine Firebase-Conversion-Aktion.

JSON-Darstellung 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
Felder
propertyId

string (int64 format)

Nur Ausgabe. Die GA4-Property-ID der Conversion.
propertyName

string

Nur Ausgabe. Der Name der Google Analytics-Property der Conversion.
eventName

string

Nur Ausgabe. Der Ereignisname einer Firebase-Conversion.
projectId

string

Nur Ausgabe. Die Firebase-Projekt-ID der Conversion.

ThirdPartyAppAnalyticsSettings

Einstellungen für eine Conversion-Aktion mit App-Analysen von Drittanbietern.

JSON-Darstellung 
{
  "providerName": string,
  "eventName": string
}
Felder
providerName

string

Nur Ausgabe. Name des Anbieters von App-Analysetools.
eventName

string

Nur Ausgabe. Der Ereignisname einer Conversion aus einem App-Analysetool eines Drittanbieters.

GoogleAnalytics4Settings

Einstellungen für eine Google Analytics 4-Conversion-Aktion.

JSON-Darstellung 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
Felder
eventName

string

Nur Ausgabe. Der Name des GA4-Ereignisses.
propertyName

string

Nur Ausgabe. Der Name der GA4-Property.
propertyId

string (int64 format)

Nur Ausgabe. Die ID der GA4-Property.