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 das folgende Format:

customers/{customerId}/conversionActions/{conversion_action_id}
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 zum Wert für Conversion-Ereignisse, die mit dieser Conversion-Aktion verknüpft sind.
countingType

enum (ConversionActionCountingType)

Conversion-Ereignisse für die Conversion-Aktion zählen
attributionModelSettings

object (AttributionModelSettings)

Einstellungen, die sich auf das Attributionsmodell dieser Conversion-Aktion beziehen.
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 Die 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 „primaryForGoal“-Bit einer Conversion-Aktion falsch ist, ist die Conversion-Aktion für alle Kampagnen unabhängig vom Conversion-Zielvorhaben des Kunden oder des Conversion-Zielvorhabens der Kampagne nicht gebotsfähig. Bei benutzerdefinierten Conversion-Zielvorhaben wird „primaryForGoal“ aber nicht berücksichtigt. Wenn also für eine Kampagne ein benutzerdefiniertes Conversion-Zielvorhaben mit einer „primaryForGoal = false“ Conversion-Aktion konfiguriert ist, ist diese Conversion-Aktion trotzdem gebotsfähiger. Wenn für „primaryForGoal“ nicht festgelegt ist, ist standardmäßig „true“ festgelegt. In Version 9 kann „primaryForGoal“ nur nach der Erstellung durch einen „update“-Vorgang auf „false“ gesetzt werden, da es nicht als optional deklariert ist.
ownerCustomer

string

Nur Ausgabe Der Ressourcenname des Inhabers der Conversion-Aktion 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 dürfen.
viewThroughLookbackWindowDays

string (int64 format)

Die maximale Anzahl von Tagen, die zwischen einer Impression und einer Conversion ohne Interaktion liegen dürfen.
phoneCallDurationSeconds

string (int64 format)

Die Dauer des Anrufs in Sekunden, nach der für diese Conversion-Aktion eine Conversion 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 in dieser Version unbekannten Wert dar.
ENABLED Conversions werden erfasst.
REMOVED Conversions werden nicht erfasst.
HIDDEN Es werden keine Conversions erfasst und die Conversion-Aktion wird nicht auf der Benutzeroberfläche angezeigt.

ConversionActionType

Mögliche Arten einer Conversion-Aktion.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
AD_CALL Conversions, die auftreten, 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 im Google Play Store herunterlädt.
GOOGLE_PLAY_IN_APP_PURCHASE Conversions, die auftreten, wenn ein Nutzer einen Kauf in einer App mit Abrechnung über Android 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 stattfinden.
WEBSITE_CALL Conversions, die auftreten, wenn ein Nutzer eine dynamisch generierte Telefonnummer über die Website eines Werbetreibenden anruft.
STORE_SALES_DIRECT_UPLOAD Conversions in Form von Ladenverkäufen basieren auf hochgeladenen Daten von Erst- oder Drittanbietern. Nur Kunden auf der Zulassungsliste können die Uploadtypen „Ladenverkäufe (direkter Upload)“ verwenden.
STORE_SALES Conversions in Form von Ladenverkäufen basieren auf Uploads von Erst- oder Drittanbieterdaten und/oder Käufen im Geschäft mit Karten aus Zahlungsnetzwerken. Nur Kunden auf der Zulassungsliste können Typen von Ladenverkäufen verwenden. Schreibgeschützt.
FIREBASE_ANDROID_FIRST_OPEN Conversions vom Typ „Erstes Öffnen“ in Android-Apps, die über Firebase erfasst werden
FIREBASE_ANDROID_IN_APP_PURCHASE Conversions vom Typ „In-App-Kauf“ für Android-Apps, die über Firebase erfasst werden
FIREBASE_ANDROID_CUSTOM Über Firebase erfasste benutzerdefinierte Conversions für Android-Apps
FIREBASE_IOS_FIRST_OPEN Conversions vom Typ „Erstes Öffnen“ in iOS-Apps, die über Firebase erfasst werden
FIREBASE_IOS_IN_APP_PURCHASE Conversions vom Typ „In-App-Kauf“ für iOS-Apps, die über Firebase erfasst werden
FIREBASE_IOS_CUSTOM Über Firebase erfasste benutzerdefinierte Conversions für iOS-Apps
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversions vom Typ „Erstes Öffnen“ in einer Android-App, die mit 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 mit App-Analysen 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“ in iOS-Apps, die mit App-Analysen von Drittanbietern erfasst werden
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversions für In-App-Käufe in iOS-Apps, die mit App-Analysen von Drittanbietern erfasst werden
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Benutzerdefinierte Conversions für iOS-Apps, die mit App-Analysen von Drittanbietern erfasst werden
ANDROID_APP_PRE_REGISTRATION Conversions, die auftreten, wenn sich ein Nutzer für eine mobile App im Google Play Store vorregistriert. Schreibgeschützt.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversions, mit denen alle Google Play-Downloads erfasst werden, die nicht von einem 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 der Anzeigen eines Werbetreibenden gesehen oder angeklickt haben. Schreibgeschützt.
FLOODLIGHT_TRANSACTION Floodlight-Aktivität, mit der die Anzahl der Verkäufe oder gekauften Artikel verfolgt wird. Sie können auch den Gesamtwert jedes Verkaufs erfassen. Schreibgeschützt.
GOOGLE_HOSTED Conversions, mit denen lokale Aktionen aus den Produkten und Dienstleistungen von Google nach der Interaktion mit einer Anzeige erfasst werden. Schreibgeschützt.
LEAD_FORM_SUBMIT Conversions, die erfasst werden, wenn ein Nutzer ein Lead-Formular sendet. Schreibgeschützt.
SALESFORCE Conversions, die aus Salesforce stammen. Schreibgeschützt.
SEARCH_ADS_360 Conversions, die aus Search Ads 360-Floodlight-Daten importiert wurden Schreibgeschützt.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Anruf-Conversions, die mit Anzeigen in smarten Kampagnen erzielt werden, bei denen aufgrund benutzerdefinierter Kriterien kein Anruf-Tracking eingerichtet wurde Schreibgeschützt.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Der Nutzer klickt in Google Maps auf ein Anrufelement. Nur smarte Kampagne. Schreibgeschützt.
SMART_CAMPAIGN_MAP_DIRECTIONS Der Nutzer fordert eine Wegbeschreibung zu einem Unternehmensstandort in Google Maps an. Nur smarte Kampagne. Schreibgeschützt.
SMART_CAMPAIGN_TRACKED_CALLS Anruf-Conversions, die über Anzeigen in smarten Kampagnen erfolgen, für die Anruf-Tracking unter Verwendung benutzerdefinierter Kriterien eingerichtet wurde Schreibgeschützt.
STORE_VISITS Conversions, die auftreten, wenn ein Nutzer das Geschäft eines Werbetreibenden besucht. Schreibgeschützt.
WEBPAGE_CODELESS Conversions, die durch Websiteereignisse wie das Senden von Formularen oder das Laden von Seiten generiert werden und für die keine individuell codierten Ereignis-Snippets verwendet werden Schreibgeschützt.
UNIVERSAL_ANALYTICS_GOAL Conversions aus verknüpften Universal Analytics-Zielvorhaben
UNIVERSAL_ANALYTICS_TRANSACTION Conversions, die aus verknüpften Universal Analytics-Transaktionen stammen.
GOOGLE_ANALYTICS_4_CUSTOM Conversions, die aus verknüpften benutzerdefinierten Google Analytics 4-Ereignis-Conversions stammen.
GOOGLE_ANALYTICS_4_PURCHASE Conversions, die aus verknüpften Google Analytics 4-Kauf-Conversions stammen.

ValueSettings

Einstellungen zum Wert für Conversion-Ereignisse, die mit dieser Conversion-Aktion verknüpft sind.

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

number

Wert, der verwendet werden soll, wenn Conversion-Ereignisse für diese Conversion-Aktion mit einem ungültigen, unzulässigen oder fehlenden Wert gesendet werden oder wenn für diese Conversion-Aktion immer der Standardwert verwendet wird.
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 immer der Standardwert verwendet wird.
alwaysUseDefaultValue

boolean

Steuert, ob der Standardwert und der Standardwährungscode anstelle des Werts und Währungscodes verwendet werden, der in den Conversion-Ereignissen für diese Conversion-Aktion angegeben wurde.

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 in dieser Version unbekannten Wert dar.
ONE_PER_CLICK Nur eine Conversion pro Klick zählen.
MANY_PER_CLICK Alle Conversions pro Klick zählen.

AttributionModelSettings

Einstellungen, die sich auf das Attributionsmodell dieser Conversion-Aktion beziehen.

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 werden soll.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
EXTERNAL Verwendet externe Attribution.
GOOGLE_ADS_LAST_CLICK Der gesamte Wert einer Conversion wird dem letzten Klick zugeordnet.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Der gesamte Wert einer Conversion wird mithilfe der Attribution in der Google Suche dem ersten Klick zugeordnet.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Der Wert einer Conversion wird mithilfe des Attributionsmodells für die Google Suche allen Klicks gleich zugeordnet.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Den neueren Klicks wird mithilfe der Attribution in der Google Suche ein exponentieller höherer Wert zugeordnet (Halbwertszeit beträgt 1 Woche).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED 40% des Werts für eine Conversion werden den ersten und letzten Klicks zugeordnet. Die verbleibenden 20% werden gleichmäßig auf alle anderen Klicks verteilt. Hierfür wird die Attribution in der Google Suche verwendet.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Flexibles Modell, bei dem mithilfe von Machine Learning anhand der Attribution für die Google Suche die angemessene Zuordnung des Beitrags unter den Klicks ermittelt wird.

DataDrivenModelStatus

Listet Status des datengetriebenen Modells auf.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
AVAILABLE Das datengetriebene Modell ist verfügbar.
STALE Das datengetriebene Modell ist veraltet. Sie wurde seit mindestens sieben Tagen nicht mehr aktualisiert. Sie wird noch verwendet, läuft aber ab, wenn sie 30 Tage lang nicht aktualisiert wird.
EXPIRED Das datengetriebene Modell ist abgelaufen. Sie wurde seit mindestens 30 Tagen nicht mehr aktualisiert und kann daher nicht verwendet werden. Das liegt meistens daran, dass in den letzten 30 Tagen nicht die erforderliche Anzahl von Ereignissen stattgefunden hat.
NEVER_GENERATED Das datengetriebene Modell wurde noch nie generiert. Das liegt meistens daran, dass die erforderliche Anzahl von Ereignissen in einem Zeitraum von 30 Tagen nie stattgefunden hat.

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 Google Analytics-Property-ID der Conversion.
propertyName

string

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

string

Nur Ausgabe Der Ereignisname einer Firebase-Conversion.
projectId

string

Nur Ausgabe Die Firebase-Projekt-ID der Conversion.

ThirdPartyAppAnalyticsSettings

Einstellungen, die sich auf die Conversion-Aktion eines App-Analysetools eines Drittanbieters beziehen.

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

string

Nur Ausgabe Name des App-Analysetools des Drittanbieters.
eventName

string

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

GoogleAnalytics4Settings

Einstellungen, die sich auf eine Google Analytics 4-Conversion-Aktion beziehen.

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.