SearchAds360Row

Eine von der Abfrage zurückgegebene Zeile.

JSON-Darstellung
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Felder
adGroup

object (AdGroup)

Die Anzeigengruppe, auf die sich die Anfrage bezieht.

adGroupAd

object (AdGroupAd)

Die in der Anfrage erwähnte Anzeige.

adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

Das in der Abfrage referenzierte effektive Label der Anzeigengruppenanzeige.

adGroupAdLabel

object (AdGroupAdLabel)

Das in der Abfrage referenzierte Anzeigenlabel der Anzeigengruppe.

adGroupAsset

object (AdGroupAsset)

Das in der Abfrage referenzierte Asset der Anzeigengruppe.

adGroupAssetSet

object (AdGroupAssetSet)

Die in der Abfrage referenzierte Asset-Gruppe der Anzeigengruppe.

adGroupAudienceView

object (AdGroupAudienceView)

Die in der Abfrage referenzierte Zielgruppenansicht der Anzeigengruppe.

adGroupBidModifier

object (AdGroupBidModifier)

Die in der Abfrage referenzierte Gebotsanpassung.

adGroupCriterion

object (AdGroupCriterion)

Das in der Anfrage referenzierte Kriterium.

adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

Das in der Abfrage referenzierte effektive Label des Kriteriums für Anzeigengruppen.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

Das Label für das Kriterium der Anzeigengruppe, auf das in der Abfrage verwiesen wird.

adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

Das in der Abfrage referenzierte effektive Label der Anzeigengruppe.

adGroupLabel

object (AdGroupLabel)

Das in der Abfrage referenzierte Label der Anzeigengruppe.

ageRangeView

object (AgeRangeView)

Die in der Abfrage referenzierte Ansicht für Altersgruppen.

asset

object (Asset)

Das in der Anfrage referenzierte Asset.

assetGroupAsset

object (AssetGroupAsset)

Das in der Abfrage referenzierte Asset der Asset-Gruppe.

assetGroupSignal

object (AssetGroupSignal)

Das in der Abfrage referenzierte Signal der Asset-Gruppe.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Der in der Abfrage referenzierte Filter für Asset-Eintragsgruppen.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

Die in der Abfrage referenzierte Ansicht der leistungsstärksten Kombinationen für die Asset-Gruppe.

assetGroup

object (AssetGroup)

Die in der Abfrage referenzierte Asset-Gruppe.

assetSetAsset

object (AssetSetAsset)

Das Asset-Gruppen-Asset, auf das in der Abfrage verwiesen wird.

assetSet

object (AssetSet)

Die in der Abfrage referenzierte Asset-Gruppe.

biddingStrategy

object (BiddingStrategy)

Die in der Anfrage angegebene Gebotsstrategie.

campaignBudget

object (CampaignBudget)

Das in der Anfrage angegebene Kampagnenbudget.

campaign

object (Campaign)

Die Kampagne, auf die in der Abfrage verwiesen wird.

campaignAsset

object (CampaignAsset)

Das in der Abfrage referenzierte Kampagnen-Asset.

campaignAssetSet

object (CampaignAssetSet)

Die in der Abfrage referenzierte Asset-Gruppe der Kampagne.

campaignAudienceView

object (CampaignAudienceView)

Die in der Abfrage referenzierte Zielgruppenansicht der Kampagne.

campaignCriterion

object (CampaignCriterion)

Das in der Abfrage referenzierte Kampagnenkriterium.

campaignEffectiveLabel

object (CampaignEffectiveLabel)

Das in der Abfrage referenzierte Label für die effektive Kampagne.

campaignLabel

object (CampaignLabel)

Das in der Abfrage referenzierte Kampagnenlabel.

cartDataSalesView

object (CartDataSalesView)

Die in der Abfrage referenzierte Ansicht für Verkäufe mit Warenkorbdaten.

audience

object (Audience)

Die in der Abfrage referenzierte Zielgruppe.

conversionAction

object (ConversionAction)

Die in der Abfrage referenzierte Conversion-Aktion.

conversionCustomVariable

object (ConversionCustomVariable)

Die benutzerdefinierte Conversion-Variable, auf die in der Abfrage verwiesen wird.

customer

object (Customer)

Der Kunde, auf den sich die Anfrage bezieht.

customerAsset

object (CustomerAsset)

Das in der Anfrage referenzierte Kunden-Asset.

customerAssetSet

object (CustomerAssetSet)

Die in der Abfrage referenzierte Asset-Gruppe des Kunden.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Die in der Abfrage referenzierte zugängliche Gebotsstrategie.

customerClient

object (CustomerClient)

Der in der Abfrage referenzierte CustomerClient.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

Die in der Abfrage referenzierte Ansicht „Suchbegriff“ für dynamische Suchanzeigen.

genderView

object (GenderView)

Die in der Abfrage referenzierte Ansicht für das Geschlecht.

geoTargetConstant

object (GeoTargetConstant)

Die in der Abfrage referenzierte geografische Zielkonstante.

keywordView

object (KeywordView)

Die in der Abfrage referenzierte Keyword-Ansicht.

label

object (Label)

Das in der Anfrage referenzierte Label.

languageConstant

object (LanguageConstant)

Die in der Anfrage referenzierte Sprachkonstante.

locationView

object (LocationView)

Die in der Abfrage referenzierte Standortansicht.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Die in der Anfrage angegebene Gebotskategorie des Produkts.

productGroupView

object (ProductGroupView)

Die in der Anfrage referenzierte Produktgruppenansicht.

shoppingPerformanceView

object (ShoppingPerformanceView)

Die in der Abfrage referenzierte Ansicht für die Shopping-Leistung.

userList

object (UserList)

Die in der Abfrage referenzierte Nutzerliste.

userLocationView

object (UserLocationView)

Die in der Abfrage referenzierte Ansicht für Nutzerstandorte.

webpageView

object (WebpageView)

Die in der Abfrage referenzierte Seitenansicht.

visit

object (Visit)

Der in der Abfrage referenzierte Besuch auf Ereignisebene.

conversion

object (Conversion)

Die in der Abfrage referenzierte Conversion auf Ereignisebene.

metrics

object (Metrics)

Die Messwerte.

segments

object (Segments)

Die Segmente.

customColumns[]

object (Value)

Die benutzerdefinierten Spalten.

Anzeigengruppe

Eine Anzeigengruppe.

JSON-Darstellung
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
Felder
resourceName

string

Der Ressourcenname der Anzeigengruppe. Ressourcennamen von Anzeigengruppen haben das folgende Format:

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

Der Status der Anzeigengruppe.

type

enum (AdGroupType)

Der Typ der Anzeigengruppe.

adRotationMode

enum (AdGroupAdRotationMode)

Der Modus der Anzeigenrotation der Anzeigengruppe.

creationTime

string

Der Zeitstempel, zu dem diese Anzeigengruppe erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

targetingSetting

object (TargetingSetting)

Einstellung für Targeting-bezogene Funktionen.

labels[]

string

Die Ressourcennamen der Labels, die dieser Anzeigengruppe zugeordnet sind.

effectiveLabels[]

string

Die Ressourcennamen der effektiven Labels, die dieser Anzeigengruppe zugeordnet sind. Ein effektives Label ist ein Label, das von dieser Anzeigengruppe übernommen oder ihr direkt zugewiesen wurde.

engineId

string

ID der Anzeigengruppe im externen Engine-Konto. Dieses Feld gilt nur für ein Konto, das nicht von Google Ads stammt, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für eine Google Ads-Entität stattdessen „adGroup.id“.

startDate

string

Datum, an dem die Anzeigengruppe beginnt, Anzeigen bereitzustellen. Standardmäßig beginnt die Anzeigengruppe jetzt oder am Startdatum der Anzeigengruppe, je nachdem, was später ist. Wenn dieses Feld festgelegt ist, beginnt die Anzeigengruppe am Anfang des angegebenen Datums in der Zeitzone des Kunden. Dieses Feld ist nur für Microsoft Advertising- und Facebook-Gateway-Konten verfügbar.

Format: JJJJ-MM-TT Beispiel: 2019-03-14

endDate

string

Datum, an dem die Anzeigengruppe nicht mehr Anzeigen bereitstellt. Standardmäßig endet die Anzeigengruppe am Enddatum der Anzeigengruppe. Wenn dieses Feld festgelegt ist, endet die Anzeigengruppe am Ende des angegebenen Datums in der Zeitzone des Kunden. Dieses Feld ist nur für Microsoft Advertising- und Facebook-Gateway-Konten verfügbar.

Format: JJJJ-MM-TT Beispiel: 2019-03-14

languageCode

string

Die Sprache der Anzeigen und Keywords in einer Anzeigengruppe. Dieses Feld ist nur für Microsoft Advertising-Konten verfügbar. Weitere Informationen: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

Der Zeitpunkt der letzten Änderung der Anzeigengruppe. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

id

string (int64 format)

Die ID der Anzeigengruppe.

name

string

Der Name der Anzeigengruppe.

Dieses Feld ist erforderlich und darf beim Erstellen neuer Anzeigengruppen nicht leer sein.

Er muss weniger als 255 UTF-8-Zeichen in voller Breite enthalten.

Er darf keine Null (Codepunkt 0x0), NL-Zeilenvorschub (Codepunkt 0xA) oder Zeilenumbruchzeichen (Codepunkt 0xD) enthalten.

trackingUrlTemplate

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

cpcBidMicros

string (int64 format)

Das maximale CPC-Gebot (Cost-per-Click).

engineStatus

enum (AdGroupEngineStatus)

Der Engine-Status für die Anzeigengruppe.

finalUrlSuffix

string

URL-Vorlage zum Anhängen von Parametern an die finale URL.

AdGroupStatus

Die möglichen Status einer Anzeigengruppe.

Enums
UNSPECIFIED Der Status wurde nicht angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

ENABLED Die Anzeigengruppe ist aktiviert.
PAUSED Die Anzeigengruppe ist pausiert.
REMOVED Die Anzeigengruppe wird entfernt.

AdGroupType

Enumeration mit den möglichen Typen einer Anzeigengruppe.

Enums
UNSPECIFIED Der Typ wurde nicht angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

SEARCH_STANDARD Der Standardanzeigengruppentyp für Suchkampagnen.
DISPLAY_STANDARD Der Standardtyp für Anzeigengruppen für Displaykampagnen.
SHOPPING_PRODUCT_ADS Der Anzeigengruppentyp für Shopping-Kampagnen, in denen Standard-Produktanzeigen ausgeliefert werden.
SHOPPING_SHOWCASE_ADS Der Typ für Anzeigengruppen, in denen nur Showcase- oder Händleranzeigen in Shopping-Ergebnissen ausgeliefert werden.
HOTEL_ADS Der Standardtyp für Anzeigengruppen für Hotelkampagnen.
SHOPPING_SMART_ADS Der Typ für Anzeigengruppen in smarten Shopping-Kampagnen.
VIDEO_BUMPER Kurze, nicht überspringbare In-Stream-Videoanzeigen
VIDEO_TRUE_VIEW_IN_STREAM TrueView In-Stream-Videoanzeigen (überspringbar).
VIDEO_TRUE_VIEW_IN_DISPLAY TrueView In-Display-Videoanzeigen.
VIDEO_NON_SKIPPABLE_IN_STREAM Nicht überspringbare In-Stream-Videoanzeigen
VIDEO_OUTSTREAM Out-Stream-Videoanzeigen
SEARCH_DYNAMIC_ADS Anzeigengruppentyp für Anzeigengruppen für dynamische Suchanzeigen.
SHOPPING_COMPARISON_LISTING_ADS Der Typ für Anzeigengruppen in Shopping-Vergleichsanzeigenkampagnen.
PROMOTED_HOTEL_ADS Der Anzeigengruppentyp für Anzeigengruppen für beworbene Hotels.
VIDEO_RESPONSIVE Gruppen mit responsiven Videoanzeigen
VIDEO_EFFICIENT_REACH Anzeigengruppen für effiziente Reichweite für Videoanzeigen.
SMART_CAMPAIGN_ADS Anzeigengruppentyp für smarte Kampagnen.
TRAVEL_ADS Anzeigengruppentyp für Reisekampagnen.

AdGroupAdRotationMode

Die möglichen Modi der Anzeigenrotation einer Anzeigengruppe.

Enums
UNSPECIFIED Der Modus der Anzeigenrotation wurde nicht angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

OPTIMIZE Anzeigen in Anzeigengruppen anhand von Klicks oder Conversions optimieren
ROTATE_FOREVER Gleichmäßige Anzeigenrotation auf unbestimmte Zeit.

AdGroupEngineStatus

Status der Anzeigengruppen-Engine.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
AD_GROUP_ELIGIBLE

Verworfen Nicht verwenden.

AD_GROUP_EXPIRED Für diese Anzeigengruppe werden keine Anzeigen ausgeliefert, weil das Enddatum der Anzeigengruppe überschritten ist.
AD_GROUP_REMOVED Die Anzeigengruppe wurde gelöscht.
AD_GROUP_DRAFT Für diese Anzeigengruppe werden keine Anzeigen ausgeliefert, da die zugehörige Anzeigengruppe noch als Entwurf vorliegt.
AD_GROUP_PAUSED Die Anzeigengruppe wurde pausiert.
AD_GROUP_SERVING Die Anzeigengruppe ist aktiv und es werden derzeit Anzeigen ausgeliefert.
AD_GROUP_SUBMITTED Die Anzeigengruppe wurde eingereicht (Microsoft Bing Ads-Legacy-Status).
CAMPAIGN_PAUSED Für diese Anzeigengruppe werden keine Anzeigen ausgeliefert, da die Kampagne pausiert wurde.
ACCOUNT_PAUSED Für diese Anzeigengruppe werden keine Anzeigen ausgeliefert, da das Konto pausiert wurde.

TargetingSetting

Einstellungen für die Targeting-bezogenen Funktionen auf Kampagnen- und Anzeigengruppenebene. Weitere Informationen zur Ausrichtungseinstellung finden Sie unter https://support.google.com/google-ads/answer/7365594.

JSON-Darstellung
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
Felder
targetRestrictions[]

object (TargetRestriction)

Die Einstellung für die Pro-Ausrichtungs-Dimension, um die Reichweite Ihrer Kampagne oder Anzeigengruppe einzuschränken.

TargetRestriction

Die Liste der Targeting-Einstellungen für die einzelnen Targeting-Dimensionen.

JSON-Darstellung
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
Felder
targetingDimension

enum (TargetingDimension)

Die Targeting-Dimension, auf die sich diese Einstellungen beziehen.

bidOnly

boolean

Gibt an, ob Ihre Anzeigen nur für die Kriterien ausgeliefert werden sollen, die Sie für diese Targeting-Dimension ausgewählt haben, oder ob alle Werte für diese Targeting-Dimension berücksichtigt und Anzeigen basierend auf Ihrem Targeting in anderen Targeting-Dimensionen ausgeliefert werden sollen. Ein Wert von true bedeutet, dass für diese Kriterien nur Gebotsanpassungen angewendet werden und sich das Targeting nicht ändert. Ein Wert von false bedeutet, dass diese Kriterien sowohl das Targeting als auch die Anwendung von Gebotsmodifikatoren einschränken.

TargetingDimension

Aufzählung zur Beschreibung möglicher Targeting-Dimensionen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
KEYWORD Keyword-Kriterien, z. B. „Mars-Kreuzfahrt“. KEYWORD kann als benutzerdefinierte Gebotsdimension verwendet werden. Keywords sind immer eine Targeting-Dimension und können daher nicht mit TargetRestriction als Zieldimension „ALL“ festgelegt werden.
AUDIENCE Zielgruppenkriterien, einschließlich Nutzerliste, Nutzerinteresse, benutzerdefinierte Zielgruppensegmente mit gemeinsamen Interessen und benutzerdefinierte Zielgruppensegmente mit gemeinsamer Absicht.
TOPIC Themenkriterien für das Targeting von Inhaltskategorien, z. B. „category::Animals>Pets“. Wird für Display- und Video-Targeting verwendet.
GENDER Kriterien für die Ausrichtung auf Geschlecht.
AGE_RANGE Kriterien für das Targeting von Altersgruppen.
PLACEMENT Placement-Kriterien, zu denen Websites wie „www.flowers4sale.com“ sowie mobile Apps, mobile App-Kategorien, YouTube-Videos und YouTube-Kanäle gehören.
PARENTAL_STATUS Kriterien für das Targeting nach Elternstatus.
INCOME_RANGE Kriterien für die Ausrichtung auf Einkommensbereiche.

AdGroupAd

Eine Anzeige in einer Anzeigengruppe.

JSON-Darstellung
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
Felder
resourceName

string

Der Ressourcenname der Anzeige. Ressourcennamen von Anzeigen in Anzeigengruppen haben das folgende Format:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

status

enum (AdGroupAdStatus)

Der Status der Anzeige.

ad

object (Ad)

Die Anzeige.

creationTime

string

Der Zeitstempel, zu dem diese Anzeigengruppenanzeige erstellt wurde. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

labels[]

string

Die Ressourcennamen der Labels, die dieser Anzeigengruppenanzeige zugeordnet sind.

effectiveLabels[]

string

Die Ressourcennamen der effektiven Labels, die dieser Anzeige zugeordnet sind. Ein effektives Label ist ein Label, das von dieser Anzeige übernommen oder ihr direkt zugewiesen wurde.

engineId

string

ID der Anzeige im externen Engine-Konto. Dieses Feld gilt nur für ein Search Ads 360-Konto, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für eine andere Entität als Search Ads 360 stattdessen „adGroupAd.ad.id“.

engineStatus

enum (AdGroupAdEngineStatus)

Zusätzlicher Status der Anzeige im externen Engine-Konto. Mögliche Status (je nach Art des externen Kontos) sind "Aktiv", "berechtigt", "Überprüfung steht aus" usw.

lastModifiedTime

string

Der Zeitpunkt der letzten Änderung der Anzeigengruppenanzeige. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

AdGroupAdStatus

Die möglichen Status einer AdGroupAd.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

ENABLED Die Anzeige in der Anzeigengruppe ist aktiviert.
PAUSED Die Anzeige in der Anzeigengruppe ist pausiert.
REMOVED Die Anzeige in der Anzeigengruppe wird entfernt.

FinalAppUrl

Eine URL für den Deeplink zu einer App für das angegebene Betriebssystem.

JSON-Darstellung
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Felder
osType

enum (AppUrlOperatingSystemType)

Das Betriebssystem, auf das diese URL ausgerichtet ist. Erforderlich.

url

string

Die Deeplink-URL der App. Deeplinks geben einen Ort in einer App an, der dem Inhalt entspricht, den Sie präsentieren möchten. Sie sollten das Format {Schema}://{Hostpfad} haben. Das Schema gibt an, welche App geöffnet werden soll. Für Ihre App können Sie ein benutzerdefiniertes Schema verwenden, das mit dem Namen der App beginnt. Mit dem Host und dem Pfad wird der eindeutige Speicherort Ihrer Inhalte in der App angegeben. Beispiel: „exampleapp://productid_1234“. Erforderlich.

AppUrlOperatingSystemType

Betriebssystem

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
IOS Das Betriebssystem Apple iOS.
ANDROID Das Android-Betriebssystem.

AdType

Die möglichen Typen einer Anzeige.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

TEXT_AD Die Anzeige ist eine Textanzeige.
EXPANDED_TEXT_AD Die Anzeige ist eine erweiterte Textanzeige.
CALL_ONLY_AD Die Anzeige ist eine Nur-Anrufanzeige.
EXPANDED_DYNAMIC_SEARCH_AD Es handelt sich um eine erweiterte dynamische Suchanzeige.
HOTEL_AD Die Anzeige ist eine Hotelanzeige.
SHOPPING_SMART_AD Die Anzeige ist eine smarte Shopping-Anzeige.
SHOPPING_PRODUCT_AD Die Anzeige ist eine Standard-Shopping-Anzeige.
VIDEO_AD Die Anzeige ist eine Videoanzeige.
GMAIL_AD Diese Anzeige ist eine Gmail-Anzeige.
IMAGE_AD Diese Anzeige ist eine Bildanzeige.
RESPONSIVE_SEARCH_AD Die Anzeige ist eine responsive Suchanzeige.
LEGACY_RESPONSIVE_DISPLAY_AD Die Anzeige ist eine bisherige responsive Displayanzeige.
APP_AD Die Anzeige ist eine App-Anzeige.
LEGACY_APP_INSTALL_AD Die Anzeige ist eine alte App-Installationsanzeige.
RESPONSIVE_DISPLAY_AD Die Anzeige ist eine responsive Displayanzeige.
LOCAL_AD Die Anzeige ist eine lokale Anzeige.
HTML5_UPLOAD_AD Es handelt sich um eine Upload-Anzeige für das Displaynetzwerk mit dem Produkttyp HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Es handelt sich um eine Display-Upload-Anzeige mit einem der Produkttypen DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Die Anzeige ist eine App-Interaktionsanzeige.
SHOPPING_COMPARISON_LISTING_AD Es handelt sich um eine Shopping-Vergleichsanzeige.
VIDEO_BUMPER_AD Bumper-Videoanzeige
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Nicht überspringbare In-Stream-Videoanzeige
VIDEO_OUTSTREAM_AD Out-Stream-Videoanzeige.
VIDEO_TRUEVIEW_DISCOVERY_AD TrueView In-Display-Videoanzeige
VIDEO_TRUEVIEW_IN_STREAM_AD Video-TrueView In-Stream-Anzeige.
VIDEO_RESPONSIVE_AD Responsive Videoanzeige
SMART_CAMPAIGN_AD Anzeige für smarte Kampagnen
APP_PRE_REGISTRATION_AD Anzeige zur Vorregistrierung für universelle Apps.
DISCOVERY_MULTI_ASSET_AD Discovery-Anzeige mit mehreren Assets
TRAVEL_AD Reiseanzeige
DISCOVERY_VIDEO_RESPONSIVE_AD Responsive Discovery-Videoanzeige
MULTIMEDIA_AD Multimedia-Anzeige

SearchAds360TextAdInfo

Eine Search Ads 360-Textanzeige.

JSON-Darstellung
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
Felder
headline

string

Der Titel der Anzeige.

description1

string

Die erste Zeile der Anzeigenbeschreibung.

description2

string

Die zweite Zeile der Anzeigenbeschreibung.

displayUrl

string

Die angezeigte URL der Anzeige.

displayMobileUrl

string

Die angezeigte mobile URL der Anzeige.

adTrackingId

string (int64 format)

Die Tracking-ID der Anzeige.

SearchAds360ExpandedTextAdInfo

Eine erweiterte Textanzeige in Search Ads 360.

JSON-Darstellung
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Felder
headline

string

Der Titel der Anzeige.

headline2

string

Der zweite Titel der Anzeige.

headline3

string

Der dritte Titel der Anzeige.

description1

string

Die erste Zeile der Anzeigenbeschreibung.

description2

string

Die zweite Zeile der Anzeigenbeschreibung.

path1

string

Text, der mit einem Trennzeichen an die automatisch generierte sichtbare URL angehängt wird.

path2

string

Text, der mit einem Trennzeichen an „path1“ angehängt wird.

adTrackingId

string (int64 format)

Die Tracking-ID der Anzeige.

SearchAds360ResponsiveSearchAdInfo

Eine responsive Suchanzeige in Search Ads 360.

JSON-Darstellung
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Felder
headlines[]

object (AdTextAsset)

Liste der Textassets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Titel aus dieser Liste ausgewählt.

descriptions[]

object (AdTextAsset)

Liste der Text-Assets für Beschreibungen. Wenn die Anzeige bereitgestellt wird, werden die Beschreibungen aus dieser Liste ausgewählt.

path1

string

Text, der mit einem Trennzeichen an die automatisch generierte sichtbare URL angehängt wird.

path2

string

Text, der mit einem Trennzeichen an „path1“ angehängt wird.

adTrackingId

string (int64 format)

Die Tracking-ID der Anzeige.

AdTextAsset

Ein Text-Asset, das in einer Anzeige verwendet wird.

JSON-Darstellung
{
  "text": string
}
Felder
text

string

Asset-Text:

SearchAds360ProductAdInfo

Dieser Typ hat keine Felder.

Eine Search Ads 360-Produktanzeige.

SearchAds360ExpandedDynamicSearchAdInfo

Eine erweiterte dynamische Suchanzeige.

JSON-Darstellung
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
Felder
description1

string

Die erste Zeile der Anzeigenbeschreibung.

description2

string

Die zweite Zeile der Anzeigenbeschreibung.

adTrackingId

string (int64 format)

Die Tracking-ID der Anzeige.

AdGroupAdEngineStatus

Listet die Engine-Status für Anzeigengruppenanzeigen auf.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
AD_GROUP_AD_ELIGIBLE

Verworfen Nicht verwenden.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: Das Creative wurde nicht genehmigt.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: Die mobile URL wird derzeit überprüft.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: Das Creative ist auf Mobilgeräten ungültig, jedoch auf Computern gültig.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: Das Creative kann aktiviert werden.
AD_GROUP_AD_NOT_REVIEWED Baidu: Creative wurde nicht überprüft.
AD_GROUP_AD_ON_HOLD

Verworfen Nicht verwenden. Zuvor von Gemini verwendet

AD_GROUP_AD_PAUSED Das Creative wurde pausiert.
AD_GROUP_AD_REMOVED Das Creative wurde entfernt.
AD_GROUP_AD_PENDING_REVIEW Die Überprüfung des Creatives steht noch aus.
AD_GROUP_AD_UNDER_REVIEW Das Creative wird überprüft.
AD_GROUP_AD_APPROVED Das Creative wurde genehmigt.
AD_GROUP_AD_DISAPPROVED Das Creative wurde abgelehnt.
AD_GROUP_AD_SERVING Das Creative wird ausgeliefert.
AD_GROUP_AD_ACCOUNT_PAUSED Das Creative wurde pausiert, weil das Konto pausiert ist.
AD_GROUP_AD_CAMPAIGN_PAUSED Das Creative wurde pausiert, da die Kampagne pausiert wurde.
AD_GROUP_AD_AD_GROUP_PAUSED Das Creative wurde pausiert, da die Anzeigengruppe pausiert ist.

AdGroupAdEffectiveLabel

Eine Beziehung zwischen einer Anzeigengruppenanzeige und einem effektiven Label. Ein effektives Label ist ein Label, das von dieser Anzeigengruppenanzeige übernommen oder ihr direkt zugewiesen wurde.

JSON-Darstellung
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Felder
resourceName

string

Der Ressourcenname des effektiven Labels der Anzeigengruppenanzeige. Ressourcennamen für effektive Labels von Anzeigengruppenanzeigen haben das Format: customers/{ownerCustomerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

Die Anzeige in der Anzeigengruppe, mit der das effektive Label verknüpft ist.

label

string

Das effektive Label, das der Anzeigengruppe zugewiesen ist.

ownerCustomerId

string (int64 format)

Die ID des Kunden, dem das effektive Label gehört.

AdGroupAdLabel

Eine Beziehung zwischen einer Anzeige in einer Anzeigengruppe und einem Label.

JSON-Darstellung
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Felder
resourceName

string

Der Ressourcenname des Anzeigenlabels der Gruppe. Ressourcennamen von Anzeigengruppenanzeigenlabels haben das Format: customers/{ownerCustomerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

Die Anzeigengruppe, an die das Label angehängt ist.

label

string

Das Label, das der Anzeigengruppe zugewiesen ist.

ownerCustomerId

string (int64 format)

Die ID des Kunden, dem das Label gehört.

AdGroupAsset

Eine Verknüpfung zwischen einer Anzeigengruppe und einem Asset.

JSON-Darstellung
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Felder
resourceName

string

Der Ressourcenname des Anzeigengruppen-Assets. Ressourcennamen von AdGroupAsset haben das folgende Format:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

adGroup

string

Erforderlich. Die Anzeigengruppe, mit der das Asset verknüpft ist.

asset

string

Erforderlich. Das Asset, das mit der Anzeigengruppe verknüpft ist.

status

enum (AssetLinkStatus)

Status des Anzeigengruppen-Assets.

AssetLinkStatus

Aufzählung zum Beschreiben von Status eines Asset-Links.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ENABLED Die Asset-Verknüpfung ist aktiviert.
REMOVED Der Asset-Link wurde entfernt.
PAUSED Die Asset-Verknüpfung ist pausiert.

AdGroupAssetSet

„AdGroupAssetSet“ ist die Verknüpfung zwischen einer Anzeigengruppe und einer Assetgruppe. Wenn Sie ein AdGroupAssetSet erstellen, wird ein Asset-Set mit einer Anzeigengruppe verknüpft.

JSON-Darstellung
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Felder
resourceName

string

Der Ressourcenname der Asset-Gruppe der Anzeigengruppe. Ressourcennamen von Asset-Sets für Anzeigengruppen haben das folgende Format:

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

adGroup

string

Die Anzeigengruppe, mit der dieser Asset-Satz verknüpft ist.

assetSet

string

Der Asset-Satz, der mit der Anzeigengruppe verknüpft ist.

status

enum (AssetSetLinkStatus)

Der Status des Anzeigengruppen-Asset-Sets. Schreibgeschützt.

AssetSetLinkStatus

Die möglichen Status der Verknüpfung zwischen einem Asset-Set und seinem Container.

Enums
UNSPECIFIED Der Status wurde nicht angegeben.
UNKNOWN Der empfangene Wert ist in dieser Version nicht bekannt. Dies ist ein reiner Antwortwert.
ENABLED Die Verknüpfung zwischen der Asset-Gruppe und dem zugehörigen Container ist aktiviert.
REMOVED Die Verknüpfung zwischen dem Asset-Set und dem zugehörigen Container wird entfernt.

AdGroupAudienceView

Eine Ansicht der Zielgruppen der Anzeigengruppe. Enthält Leistungsdaten aus Interessen- und Remarketing-Listen für Anzeigen im Displaynetzwerk und im YouTube-Netzwerk sowie Remarketing-Listen für Suchanzeigen (RLSA), die auf Zielgruppenebene zusammengefasst werden.

JSON-Darstellung
{
  "resourceName": string
}
Felder
resourceName

string

Der Ressourcenname der Ansicht „Zielgruppe der Anzeigengruppe“. Ressourcennamen von Zielgruppenansichten für Anzeigengruppen haben das Format:

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

Stellt eine Gebotsanpassung für eine Anzeigengruppe dar.

JSON-Darstellung
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
Felder
resourceName

string

Der Ressourcenname der Anzeigengruppe für die Gebotsanpassung. Ressourcennamen der Anzeigengruppe für die Gebotsanpassung haben das Format:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

bidModifier

number

Die Anpassung für das Gebot, wenn das Kriterium übereinstimmt. Die Anpassung muss im Bereich zwischen 0,1 und 10,0 liegen. Der Bereich ist 1,0 bis 6,0 für PreferredContent. Verwenden Sie 0, um einen Gerätetyp zu deaktivieren.

Union-Feld criterion. Das Kriterium dieser Gebotsanpassung für die Anzeigengruppe.

Ab V5 für Erstellungsvorgänge erforderlich. Für criterion ist nur einer der folgenden Werte zulässig:

device

object (DeviceInfo)

Ein Gerätekriterium.

DeviceInfo

Ein Gerätekriterium.

JSON-Darstellung
{
  "type": enum (Device)
}
Felder
type

enum (Device)

Typ des Geräts.

Gerät

Listet Google Ads-Geräte auf, die für das Targeting verfügbar sind.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
MOBILE Mobilgeräte mit vollwertigem Internetbrowser
TABLET Tablets mit vollwertigem Internetbrowser
DESKTOP Computer.
CONNECTED_TV Smart-TVs und Spielekonsolen
OTHER Andere Gerätetypen

AdGroupCriterion

Ein Kriterium für Anzeigengruppen. Im Bericht „Anzeigengruppenkriterien“ werden nur Kriterien zurückgegeben, die der Anzeigengruppe explizit hinzugefügt wurden.

JSON-Darstellung
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
Felder
resourceName

string

Der Ressourcenname des Anzeigengruppenkriteriums. Ressourcennamen von Anzeigengruppenkriterien haben das folgende Format:

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

creationTime

string

Der Zeitstempel, zu dem diese Anzeigengruppe-Kriterium erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

status

enum (AdGroupCriterionStatus)

Der Status des Kriteriums.

Dies ist der Status der vom Kunden festgelegten Anzeigengruppen-Kriteriumsentität festgelegt. Hinweis: In UI-Berichten können zusätzliche Informationen enthalten sein, die sich darauf auswirken, ob ein Kriterium für die Ausführung infrage kommt. In einigen Fällen kann ein Kriterium, das in der API entfernt wird, weiterhin in der Benutzeroberfläche als aktiviert angezeigt werden. So werden beispielsweise Kampagnen standardmäßig für Nutzer aller Altersstufen ausgeliefert, sofern nicht welche ausgeschlossen wurden. In der Benutzeroberfläche wird jede Altersgruppe als „Aktiviert“ angezeigt, da Nutzer in diesen Altersgruppen die Anzeigen sehen können. AdGroupCriterion.status wird jedoch als „Entfernt“ angezeigt, da kein einzuschließendes Kriterium hinzugefügt wurde.

qualityInfo

object (QualityInfo)

Informationen zur Qualität des Kriteriums.

type

enum (CriterionType)

Der Typ des Kriteriums.

labels[]

string

Die Ressourcennamen der Labels, die dieser Anzeigengruppe-Kriterium zugeordnet sind.

effectiveLabels[]

string

Die Ressourcennamen der effektiven Labels, die diesem Anzeigengruppenkriterium zugeordnet sind. Ein effektives Label ist ein Label, das von diesem Anzeigengruppenkriterium übernommen oder ihm direkt zugewiesen wurde.

positionEstimates

object (PositionEstimates)

Schätzungen für Gebote für Kriterien an verschiedenen Positionen.

finalUrls[]

string

Die Liste möglicher endgültige URLs nach allen domainübergreifenden Weiterleitungen für die Anzeige.

finalMobileUrls[]

string

Die Liste der möglichen endgültigen mobilen URLs nach allen domainübergreifenden Weiterleitungen.

urlCustomParameters[]

object (CustomParameter)

Die Liste der Zuordnungen, die zum Ersetzen von benutzerdefinierten Parameter-Tags in einem trackingUrlTemplate, finalUrls oder mobile_final_urls verwendet werden.

engineId

string

ID des Anzeigengruppenkriteriums im externen Engine-Konto. Dieses Feld gilt nur für Konten, die nicht von Google Ads stammen, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für eine Google Ads-Entität stattdessen „adGroupCriterion.criterion_id“.

lastModifiedTime

string

Der Zeitpunkt der letzten Änderung der Anzeigengruppe-Kriterium. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

criterionId

string (int64 format)

Die ID des Kriteriums.

adGroup

string

Die Anzeigengruppe, zu der das Kriterium gehört.

negative

boolean

Gibt an, ob das Kriterium ausgerichtet (false) oder ausgeschlossen (true) werden soll.

Dieses Feld ist unveränderlich. Wenn Sie ein Kriterium von positiv zu negativ ändern möchten, entfernen Sie es und fügen Sie es noch einmal hinzu.

bidModifier

number

Die Anpassung für das Gebot, wenn das Kriterium übereinstimmt. Die Anpassung muss im Bereich zwischen 0,1 und 10,0 liegen. Die meisten Zielkriterien unterstützen Anpassungen.

cpcBidMicros

string (int64 format)

Das Gebot für den CPC (Cost-per-Click).

effectiveCpcBidMicros

string (int64 format)

Das effektive Gebot für den CPC (Cost-per-Click).

engineStatus

enum (AdGroupCriterionEngineStatus)

Der Engine-Status für das Kriterium für die Anzeigengruppe.

finalUrlSuffix

string

URL-Vorlage zum Anfügen von Parametern an die endgültige URL.

trackingUrlTemplate

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

Union-Feld criterion. Das Kriterium für die Anzeigengruppe.

Es muss genau einer festgelegt werden. Für criterion ist nur einer der folgenden Werte zulässig:

keyword

object (KeywordInfo)

Keyword.

listingGroup

object (ListingGroupInfo)

Eintragsgruppe

ageRange

object (AgeRangeInfo)

Altersgruppe.

gender

object (GenderInfo)

Gender.

userList

object (UserListInfo)

Nutzerliste.

webpage

object (WebpageInfo)

Webseite

location

object (LocationInfo)

Standort.

AdGroupCriterionStatus

Die möglichen Status eines AdGroupCriterion-Objekts.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

ENABLED Das Kriterium für die Anzeigengruppe ist aktiviert.
PAUSED Das Kriterium für die Anzeigengruppe ist pausiert.
REMOVED Das Kriterium für die Anzeigengruppe wird entfernt.

QualityInfo

Ein Container für Qualitätsinformationen zu Anzeigengruppenkriterien.

JSON-Darstellung
{
  "qualityScore": integer
}
Felder
qualityScore

integer

Der Qualitätsfaktor.

Dieses Feld wird möglicherweise nicht ausgefüllt, wenn Google nicht genügend Informationen zur Bestimmung eines Werts hat.

CriterionType

Aufzählung zur Beschreibung möglicher Kriterientypen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
KEYWORD Keyword, z. B. „Marskreuzfahrt“.
PLACEMENT Placement, auch als Website bezeichnet, z. B. „www.flowers4sale.com“
MOBILE_APP_CATEGORY Kategorien für mobile Apps, auf die Sie die Ausrichtung vornehmen möchten.
MOBILE_APPLICATION Mobile Apps, auf die Sie das Targeting ausrichten möchten.
DEVICE Geräte, auf die Sie Anzeigen ausrichten möchten.
LOCATION Standorte für die Ausrichtung.
LISTING_GROUP Aufzulistende Gruppen für die Ausrichtung.
AD_SCHEDULE Werbezeitplaner
AGE_RANGE Altersgruppe.
GENDER Gender.
INCOME_RANGE Einkommensbereich
PARENTAL_STATUS Elternstatus.
YOUTUBE_VIDEO YouTube-Video
YOUTUBE_CHANNEL YouTube-Kanal
USER_LIST Nutzerliste.
PROXIMITY Nähe.
TOPIC Eine Ausrichtung auf Themen im Displaynetzwerk, z. B. „Haustiere und Tiere“.
LISTING_SCOPE Listenumfang für das Targeting.
LANGUAGE Sprache
IP_BLOCK IpBlock.
CONTENT_LABEL Inhaltslabel für den Kategorieausschluss.
CARRIER Mobilfunkanbieter.
USER_INTEREST Eine Kategorie, für die sich der Nutzer interessiert.
WEBPAGE Webseitenkriterium für dynamische Suchanzeigen.
OPERATING_SYSTEM_VERSION Jetzt gehts zum Betriebssystem.
APP_PAYMENT_MODEL App-Zahlungsmodell
MOBILE_DEVICE Mobilgerät.
CUSTOM_AFFINITY Benutzerdefiniertes gemeinsames Interesse
CUSTOM_INTENT Benutzerdefinierte Zielgruppe mit gemeinsamer Absicht
LOCATION_GROUP Standortgruppe:
CUSTOM_AUDIENCE Benutzerdefinierte Zielgruppe
COMBINED_AUDIENCE Kombinierte Zielgruppe
KEYWORD_THEME Keyword-Thema für smarte Kampagnen
AUDIENCE Zielgruppe
LOCAL_SERVICE_ID Dienst-ID für Google Lokale Dienstleistungen
BRAND Marke
BRAND_LIST Markenliste
LIFE_EVENT Lebensereignis

PositionEstimates

Schätzungen für Gebote für Kriterien an verschiedenen Positionen.

JSON-Darstellung
{
  "topOfPageCpcMicros": string
}
Felder
topOfPageCpcMicros

string (int64 format)

Die Schätzung des CPC-Gebots, das erforderlich ist, damit die Anzeige oben auf der ersten Seite der Suchergebnisse angezeigt wird.

AdGroupCriterionEngineStatus

Listet die Engine-Status von AdGroupCriterion auf.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
AD_GROUP_CRITERION_ELIGIBLE

Verworfen Nicht verwenden.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: Das Gebot oder die Qualität ist zu niedrig für die Auslieferung.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: Von Baidu aufgrund eines niedrigen Suchvolumens pausiert.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: Die mobile URL wird derzeit überprüft.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: Die Landingpage für ein Gerät ist ungültig, während die Landingpage für das andere Gerät gültig ist.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: Das Keyword wurde erstellt und von der Baidu-Kontoverwaltung pausiert. Sie können es jetzt aktivieren.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: Die Anzeige wird derzeit von Baidu überprüft. Gemini: Das Kriterium wird überprüft.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: Zu überprüfendes Kriterium.
AD_GROUP_CRITERION_ON_HOLD

Verworfen Nicht verwenden. Zuvor von Gemini verwendet

AD_GROUP_CRITERION_PENDING_REVIEW Y!J : Kriterium steht zur Überprüfung an
AD_GROUP_CRITERION_PAUSED Das Kriterium wurde pausiert.
AD_GROUP_CRITERION_REMOVED Das Kriterium wurde entfernt.
AD_GROUP_CRITERION_APPROVED Das Kriterium wurde genehmigt.
AD_GROUP_CRITERION_DISAPPROVED Das Kriterium wurde abgelehnt.
AD_GROUP_CRITERION_SERVING Das Kriterium ist aktiv und wird ausgeliefert.
AD_GROUP_CRITERION_ACCOUNT_PAUSED Das Kriterium wurde pausiert, da das Konto pausiert ist.

CustomParameter

Eine Zuordnung, die von benutzerdefinierten Parameter-Tags in einem trackingUrlTemplate, finalUrls oder mobile_final_urls verwendet werden kann.

JSON-Darstellung
{
  "key": string,
  "value": string
}
Felder
key

string

Der Schlüssel, der mit dem Namen des Parameter-Tags übereinstimmt.

value

string

Der zu ersetzende Wert.

KeywordInfo

Ein Keyword-Kriterium.

JSON-Darstellung
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
Felder
matchType

enum (KeywordMatchType)

Der Übereinstimmungstyp des Keywords.

text

string

Der Text des Keywords (maximal 80 Zeichen und 10 Wörter).

KeywordMatchType

Mögliche Keyword-Optionen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
EXACT Genaue Übereinstimmung
PHRASE Passende Wortgruppe
BROAD „Weitgehend passend“

ListingGroupInfo

Ein Kriterium für eine Eintragsgruppe.

JSON-Darstellung
{
  "type": enum (ListingGroupType)
}
Felder
type

enum (ListingGroupType)

Typ der Listengruppe.

ListingGroupType

Der Typ der Listengruppe.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
SUBDIVISION Unterteilung von Produkten anhand einer Dimension für Einträge. Diese Knoten werden nicht für die Ausrichtung von Einträgen verwendet, sondern dienen lediglich dazu, die Struktur des Baums zu definieren.
UNIT Anzeigengruppeneinheit, die ein Gebot definiert.

AgeRangeInfo

Ein Kriterium für die Altersgruppe.

JSON-Darstellung
{
  "type": enum (AgeRangeType)
}
Felder
type

enum (AgeRangeType)

Typ der Altersgruppe.

AgeRangeType

Die Art der demografischen Altersgruppen, z. B. zwischen 18 und 24 Jahren.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
AGE_RANGE_18_24 Zwischen 18 und 24 Jahre alt.
AGE_RANGE_25_34 Zwischen 25 und 34 Jahre alt.
AGE_RANGE_35_44 Zwischen 35 und 44 Jahre alt.
AGE_RANGE_45_54 Zwischen 45 und 54 Jahre alt.
AGE_RANGE_55_64 Zwischen 55 und 64 Jahre alt.
AGE_RANGE_65_UP 65 Jahre und älter
AGE_RANGE_UNDETERMINED Altersgruppe nicht bestimmt.

GenderInfo

Ein Geschlechtskriterium.

JSON-Darstellung
{
  "type": enum (GenderType)
}
Felder
type

enum (GenderType)

Typ des Geschlechts.

GenderType

Die Art der demografischen Geschlechter, z. B. „weiblich“.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
MALE Männlich
FEMALE Weiblich.
UNDETERMINED Geschlecht: unbestimmt

UserListInfo

Ein Kriterium für Nutzerlisten. Stellt eine Nutzerliste dar, die vom Werbetreibenden für das Targeting definiert wurde.

JSON-Darstellung
{
  "userList": string
}
Felder
userList

string

Der Ressourcenname der Nutzerliste.

WebpageInfo

Stellt ein Kriterium für das Targeting von Webseiten der Website eines Werbetreibenden dar.

JSON-Darstellung
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Felder
conditions[]

object (WebpageConditionInfo)

Bedingungen oder logische Ausdrücke für das Targeting auf Webseiten. Die Liste der Bedingungen für das Targeting auf Webseiten wird zusammen gebunden wenn sie für das Targeting ausgewertet wird. Eine leere Liste mit Bedingungen gibt an, dass sich auf alle Seiten der Website der Kampagne per Targeting konzentriert wird.

Dieses Feld ist für CREATE-Vorgänge erforderlich und für UPDATE-Vorgänge nicht zulässig.

coveragePercentage

number

Prozentsatz der Websitekriterienabdeckung Dies ist der berechnete Prozentsatz der Websiteabdeckung auf Grundlage des Websiteziels, des auszuschließenden Websiteziels und der auszuschließenden Keywords in der Anzeigengruppe und Kampagne. Wenn die Abdeckung beispielsweise mit 1 zurückgegegeben wird, bedeutet dies, dass sie eine Abdeckung von 100% hat. Dieses Feld ist schreibgeschützt.

criterionName

string

Der Name des Kriteriums, das durch diesen Parameter definiert wird. Der Name wird verwendet, um Kriterien mit diesem Parametertyp zu identifizieren, zu sortieren und zu filtern.

Dieses Feld ist für CREATE-Vorgänge erforderlich und für UPDATE-Vorgänge nicht zulässig.

WebpageConditionInfo

Logischer Ausdruck für das Targeting von Webseiten der Website eines Werbetreibenden.

JSON-Darstellung
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
Felder
operand

enum (WebpageConditionOperand)

Operand der Bedingung für das Targeting auf Webseiten.

operator

enum (WebpageConditionOperator)

Operator der Bedingung für das Targeting auf Webseiten.

argument

string

Argument der Bedingung für das Targeting auf Webseiten.

WebpageConditionOperand

Der Operand für die Webseitenbedingung im Webseitenkriterium.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
URL Operand, der eine Bedingung für die Ausrichtung auf eine Webseiten-URL angibt.
CATEGORY Operand, der eine Ausrichtungsbedingung für eine Webseitenkategorie angibt.
PAGE_TITLE Operand, der eine Targeting-Bedingung für den Titel einer Webseite angibt.
PAGE_CONTENT Operand, der eine Bedingung für die Ausrichtung auf Webseiteninhalte angibt.
CUSTOM_LABEL Operand für eine benutzerdefinierte Label-Ausrichtungsbedingung für Webseiten.

WebpageConditionOperator

Der Operator für die Webseitenbedingung im Webseitenkriterium.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
EQUALS Das Argument „Webbedingung“ entspricht der verglichenen Webbedingung.
CONTAINS Die Webbedingung des Arguments ist Teil der verglichenen Webbedingung.

LocationInfo

Ein Standortkriterium.

JSON-Darstellung
{
  "geoTargetConstant": string
}
Felder
geoTargetConstant

string

Ressourcenname der geografischen Zielkonstante

AdGroupCriterionEffectiveLabel

Eine Beziehung zwischen einem Anzeigengruppenkriterium und einem effektiven Label. Ein effektives Label ist ein Label, das von diesem Anzeigengruppenkriterium übernommen oder ihm direkt zugewiesen wurde.

JSON-Darstellung
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Felder
resourceName

string

Der Ressourcenname des effektiven Labels des Anzeigengruppenkriteriums. Ressourcennamen von effektiven Labels für Anzeigengruppenkriterien haben das Format: customers/{ownerCustomerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

Das Kriterium der Anzeigengruppe, mit dem das effektive Label verknüpft ist.

label

string

Das effektive Label, das dem Kriterium der Anzeigengruppe zugewiesen ist.

ownerCustomerId

string (int64 format)

Die ID des Kunden, dem das effektive Label gehört.

AdGroupCriterionLabel

Eine Beziehung zwischen einem Kriterium der Anzeigengruppe und einem Label.

JSON-Darstellung
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Felder
resourceName

string

Der Ressourcenname des Labels der Anzeigengruppe, das die Kriterien erfüllt. Ressourcennamen von Anzeigengruppen-Kriterienlabels haben folgendes Format: customers/{ownerCustomerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

Das Kriterium der Anzeigengruppe, mit dem das Label verknüpft ist.

label

string

Das Label, das dem Gruppenkriterium zugewiesen ist.

ownerCustomerId

string (int64 format)

Die ID des Kunden, dem das Label gehört.

AdGroupEffectiveLabel

Eine Beziehung zwischen einer Anzeigengruppe und einem effektiven Label. Ein effektives Label ist ein Label, das von dieser Anzeigengruppe übernommen oder ihr direkt zugewiesen wurde.

JSON-Darstellung
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Felder
resourceName

string

Der Ressourcenname des effektiven Labels der Anzeigengruppe. Ressourcennamen von effektiven Labels für Anzeigengruppen haben das Format customers/{ownerCustomerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}.

adGroup

string

Die Anzeigengruppe, mit der das effektive Label verknüpft ist.

label

string

Das effektive Label, das der Anzeigengruppe zugewiesen ist.

ownerCustomerId

string (int64 format)

Die ID des Kunden, dem das effektive Label gehört.

AdGroupLabel

Eine Beziehung zwischen einer Anzeigengruppe und einem Label.

JSON-Darstellung
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Felder
resourceName

string

Der Ressourcenname des Labels der Anzeigengruppe. Ressourcennamen von Anzeigengruppenlabels haben das Format customers/{ownerCustomerId}/adGroupLabels/{ad_group_id}~{label_id}.

adGroup

string

Die Anzeigengruppe, mit der das Label verknüpft ist.

label

string

Das Label, das der Anzeigengruppe zugewiesen ist.

ownerCustomerId

string (int64 format)

Die ID des Kunden, dem das Label gehört.

AgeRangeView

Eine Ansicht mit Altersgruppen.

JSON-Darstellung
{
  "resourceName": string
}
Felder
resourceName

string

Der Ressourcenname der Ansicht für Altersgruppen. Ressourcennamen von Altersgruppenansichten haben das folgende Format:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

Asset

Ein Asset ist Teil einer Anzeige, das für mehrere Anzeigen verwendet werden kann. Das kann ein Bild (ImageAsset) oder ein Video (YoutubeVideoAsset) sein. Assets sind unveränderlich und können nicht entfernt werden. Wenn Sie verhindern möchten, dass ein Asset ausgeliefert wird, entfernen Sie es aus der Entität, in der es verwendet wird.

JSON-Darstellung
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
Felder
resourceName

string

Der Ressourcenname des Assets. Asset-Ressourcennamen haben das folgende Format:

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Typ des Assets.

finalUrls[]

string

Eine Liste der möglichen endgültigen URLs nach allen domainübergreifenden Weiterleitungen.

finalMobileUrls[]

string

Eine Liste der möglichen endgültigen mobilen URLs nach allen domainübergreifenden Weiterleitungen.

urlCustomParameters[]

object (CustomParameter)

Eine Liste der Zuordnungen, die zum Ersetzen von benutzerdefinierten Parameter-Tags für URLs in „trackingUrlTemplate“, „finalUrls“ und/oder „finalMobileUrls“ verwendet werden sollen.

status

enum (AssetStatus)

Der Status des Assets.

creationTime

string

Der Zeitstempel für den Zeitpunkt, zu dem dieser Asset erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

lastModifiedTime

string

Der Zeitpunkt der letzten Änderung an diesem Asset. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

id

string (int64 format)

Die ID des Inhalts.

name

string

Optionaler Name des Assets.

trackingUrlTemplate

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

finalUrlSuffix

string

URL-Vorlage zum Anhängen von Parametern an Landingpage-URLs, die mit parallelem Tracking ausgeliefert werden.

engineStatus

enum (AssetEngineStatus)

Der Engine-Status für ein Asset.

Union-Feld asset_data. Der spezifische Typ des Assets. Für asset_data ist nur einer der folgenden Werte zulässig:
youtubeVideoAsset

object (YoutubeVideoAsset)

Ein YouTube-Video-Asset

imageAsset

object (ImageAsset)

Ein Bild-Asset.

textAsset

object (TextAsset)

Ein Text-Asset.

calloutAsset

object (UnifiedCalloutAsset)

Einheitliches Asset mit Zusatzinformationen

pageFeedAsset

object (UnifiedPageFeedAsset)

Ein einheitliches Seitenfeed-Asset.

mobileAppAsset

object (MobileAppAsset)

Ein Asset für mobile Apps.

callAsset

object (UnifiedCallAsset)

Ein einheitliches Anruf-Asset.

callToActionAsset

object (CallToActionAsset)

Ein Call-to-Action-Asset.

locationAsset

object (UnifiedLocationAsset)

Ein einheitliches Standort-Asset.

AssetType

Aufzählung zur Beschreibung möglicher Asset-Typen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
YOUTUBE_VIDEO YouTube-Video-Asset
MEDIA_BUNDLE Mediaset-Asset.
IMAGE Bild-Asset
TEXT Text-Asset
LEAD_FORM Asset mit Lead-Formular
BOOK_ON_GOOGLE Book on Google-Asset
PROMOTION Angebots-Asset
CALLOUT Asset mit Zusatzinformationen
STRUCTURED_SNIPPET Snippet-Asset
PAGE_FEED Seitenfeed-Asset.
DYNAMIC_EDUCATION Dynamisches Asset für Bildung
MOBILE_APP Asset für mobile App.
HOTEL_CALLOUT Asset mit Zusatzinformationen für Hotels
CALL Anruf-Asset
PRICE Preis-Asset.
CALL_TO_ACTION Call-to-Action-Asset.
DYNAMIC_REAL_ESTATE Dynamisches Immobilien-Asset.
DYNAMIC_CUSTOM Dynamisches benutzerdefiniertes Asset.
DYNAMIC_HOTELS_AND_RENTALS Dynamisches Asset für Hotels und Mietobjekte.
DYNAMIC_FLIGHTS Asset für dynamische Anzeigen für Flüge.
DYNAMIC_TRAVEL Asset für dynamische Anzeigen für Reisen.
DYNAMIC_LOCAL Dynamisches lokales Asset.
DYNAMIC_JOBS Asset für dynamische Anzeigen für Karriere und Beruf.
LOCATION Standort-Asset
HOTEL_PROPERTY Hotel-Property-Asset

AssetStatus

Die möglichen Status eines Assets.

Enums
UNSPECIFIED Der Status wurde nicht angegeben.
UNKNOWN Der empfangene Wert ist in dieser Version nicht bekannt. Dies ist ein reiner Antwortwert.
ENABLED Das Asset ist aktiviert.
REMOVED Das Asset wird entfernt.
ARCHIVED Das Asset ist archiviert.
PENDING_SYSTEM_GENERATED Das Asset wurde vom System generiert und muss noch vom Nutzer überprüft werden.

AssetEngineStatus

Aufzählung zur Beschreibung möglicher Asset-Engine-Status.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
SERVING Das Asset ist aktiv.
SERVING_LIMITED Das Asset ist eingeschränkt aktiv.
DISAPPROVED Das Asset wurde abgelehnt (nicht zulässig).
DISABLED Das Asset ist inaktiv (ausstehend).
REMOVED Das Asset wurde entfernt.

YoutubeVideoAsset

Ein YouTube-Asset.

JSON-Darstellung
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Felder
youtubeVideoTitle

string

YouTube-Videotitel.

youtubeVideoId

string

YouTube-Video-ID. Das ist der 11 Zeichen lange Stringwert, der in der YouTube-Video-URL verwendet wird.

ImageAsset

Ein Bild-Asset.

JSON-Darstellung
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
Felder
mimeType

enum (MimeType)

MIME-Typ des Bild-Assets.

fullSize

object (ImageDimension)

Metadaten für dieses Bild in Originalgröße.

fileSize

string (int64 format)

Die Dateigröße des Bild-Assets in Byte.

MimeType

Der MIME-Typ

Enums
UNSPECIFIED Der MIME-Typ wurde nicht angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

IMAGE_JPEG MIME-Typ des Bildes/JPEG.
IMAGE_GIF MIME-Typ des Bildes/GIFs.
IMAGE_PNG MIME-Typ des Bildes/PNG.
FLASH MIME-Typ von application/x-shockwave-flash.
TEXT_HTML MIME-Typ von „text/html“.
PDF MIME-Typ von application/pdf.
MSWORD MIME-Typ von application/msword.
MSEXCEL MIME-Typ von application/vnd.ms-excel.
RTF MIME-Typ von application/rtf.
AUDIO_WAV MIME-Typ von „audio/wav“.
AUDIO_MP3 MIME-Typ von audio/mp3.
HTML5_AD_ZIP MIME-Typ von application/x-html5-ad-zip.

ImageDimension

Metadaten für ein Bild in einer bestimmten Größe, entweder in Originalgröße oder in einer angepassten Größe.

JSON-Darstellung
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Felder
heightPixels

string (int64 format)

Höhe des Bilds

widthPixels

string (int64 format)

Breite des Bilds

url

string

Eine URL, die das Bild mit dieser Höhe und Breite zurückgibt.

TextAsset

Ein Text-Asset.

JSON-Darstellung
{
  "text": string
}
Felder
text

string

Textinhalt des Text-Assets.

UnifiedCalloutAsset

Einheitliches Asset mit Zusatzinformationen

JSON-Darstellung
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
Felder
calloutText

string

Der Text der Erweiterung mit Zusatzinformationen. Die Länge der Zeichenfolge muss zwischen 1 und 25 Zeichen (einschließlich) liegen.

startDate

string

Das Startdatum, ab dem dieses Asset aktiv ist und ausgeliefert werden kann, im Format JJJJ-MM-TT.

endDate

string

Das letzte Datum, an dem dieses Asset aktiv ist und ausgeliefert wird, im Format JJJJ-MM-TT.

adScheduleTargets[]

object (AdScheduleInfo)

Liste der nicht überlappenden Zeitpläne, in denen alle Zeitintervalle angegeben sind, in denen das Asset ausgeliefert werden darf. Es können maximal 6 Zeitpläne pro Tag und insgesamt 42 Zeitpläne erstellt werden.

useSearcherTimeZone

boolean

Gibt an, ob das Asset in der Zeitzone des Suchnutzers angezeigt werden soll. Gilt für Microsoft Ads.

AdScheduleInfo

Stellt ein AdSchedule-Kriterium dar.

AdSchedule wird als Wochentag und Zeitintervall angegeben, in dem Anzeigen ausgeliefert werden.

Für denselben Tag können maximal sechs AdSchedules hinzugefügt werden.

JSON-Darstellung
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
Felder
startMinute

enum (MinuteOfHour)

Minuten nach der Startstunde, zu der dieser Zeitplan beginnt.

Dieses Feld ist für CREATE-Vorgänge erforderlich und für UPDATE-Vorgänge nicht zulässig.

endMinute

enum (MinuteOfHour)

Minuten nach der Endzeit, zu der dieser Zeitplan endet. Die letzte Minute ist nicht im Zeitplan enthalten.

Dieses Feld ist für CREATE-Vorgänge erforderlich und für UPDATE-Vorgänge nicht zulässig.

dayOfWeek

enum (DayOfWeek)

Der Wochentag, für den der Zeitplan gilt.

Dieses Feld ist für CREATE-Vorgänge erforderlich und für UPDATE-Vorgänge nicht zulässig.

startHour

integer

Die Startstunde im 24‑Stunden-Format. Der Wert in diesem Feld muss zwischen 0 und 23 liegen (jeweils einschließlich).

Dieses Feld ist für CREATE-Vorgänge erforderlich und für UPDATE-Vorgänge nicht zulässig.

endHour

integer

Ende der Stunde im 24‑Stunden-Format; 24 bedeutet Ende des Tages. Der Wert in diesem Feld muss zwischen 0 und 24 (einschließlich) liegen.

Dieses Feld ist für CREATE-Vorgänge erforderlich und für UPDATE-Vorgänge nicht zulässig.

MinuteOfHour

Aufzählung von Viertelstunden. Beispiel: „FIFTEEN“

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
ZERO Null Minuten nach der vollen Stunde.
FIFTEEN Viertel nach.
THIRTY Halb.
FORTY_FIVE Viertel vor.

DayOfWeek

Listet Wochentage auf, z. B. „Montag“.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
MONDAY Montag
TUESDAY Dienstag
WEDNESDAY Mittwoch
THURSDAY Donnerstag
FRIDAY Freitag
SATURDAY Samstag.
SUNDAY Sonntag

UnifiedSitelinkAsset

Ein vereinheitlichtes Sitelink-Asset.

JSON-Darstellung
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
Felder
description1

string

Die erste Zeile der Beschreibung für den Sitelink. Wenn dieser Wert festgelegt wird, sollte die Länge zwischen 1 und 35 (einschließlich) betragen und description2 muss auch festgelegt werden.

description2

string

Die zweite Zeile der Beschreibung für den Sitelink. Wenn dieser Wert festgelegt wird, sollte die Länge zwischen 1 und 35 (einschließlich) betragen und description1 muss auch festgelegt werden.

startDate

string

Das Startdatum, ab dem dieses Asset aktiv ist und ausgeliefert werden kann, im Format JJJJ-MM-TT.

endDate

string

Das letzte Datum, an dem dieses Asset aktiv ist und ausgeliefert wird, im Format JJJJ-MM-TT.

adScheduleTargets[]

object (AdScheduleInfo)

Liste der nicht überlappenden Zeitpläne, in denen alle Zeitintervalle angegeben sind, in denen das Asset ausgeliefert werden darf. Es können maximal 6 Zeitpläne pro Tag und insgesamt 42 Zeitpläne erstellt werden.

trackingId

string (int64 format)

ID, die zum Erfassen von Klicks für das Sitelink-Asset verwendet wird. Das ist ein Yahoo!- Nur für Japan.

useSearcherTimeZone

boolean

Gibt an, ob das Sitelink-Asset in der Zeitzone des Nutzers angezeigt werden soll, der die Suche ausführt. Gilt für Microsoft Ads.

mobilePreferred

boolean

Gibt an, ob das Sitelink-Asset auf Mobilgeräten ausgeliefert werden soll. Gilt für Microsoft Ads.

UnifiedPageFeedAsset

Ein Asset für einen vereinheitlichten Seitenfeed.

JSON-Darstellung
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
Felder
pageUrl

string

Die Webseite, auf die Werbetreibende ihre Anzeigen ausrichten möchten.

labels[]

string

Labels zum Gruppieren der Seiten-URLs.

MobileAppAsset

Ein Asset, das eine mobile App repräsentiert.

JSON-Darstellung
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
Felder
appId

string

Erforderlich. Ein String, der eine mobile Anwendung eindeutig identifiziert. Sie sollte nur die plattformspezifische ID enthalten, z. B. „com.android.ebay“ für Android oder „12345689“ für iOS.

appStore

enum (MobileAppVendor)

Erforderlich. Der App-Store, über den diese App vertrieben wird.

MobileAppVendor

Der Typ des Anbieters der mobilen App

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
APPLE_APP_STORE Anbieter der mobilen App für den App Store von Apple.
GOOGLE_APP_STORE Anbieter der mobilen App für den Google App Store.

UnifiedCallAsset

Ein einheitliches Anruf-Asset.

JSON-Darstellung
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
Felder
countryCode

string

Ländercode der Telefonnummer mit zwei Buchstaben. Beispiele: „US“, „us“.

phoneNumber

string

Die Rohdaten der Telefonnummer des Werbetreibenden. Beispiele: „1234567890“, „(123)456-7890“

callConversionReportingState

enum (CallConversionReportingState)

Gibt an, ob für dieses CallAsset eine eigene Einstellung für Anruf-Conversions verwendet werden soll, die Einstellung auf Kontoebene übernommen werden soll oder Anruf-Conversions deaktiviert werden sollen.

callConversionAction

string

Die Conversion-Aktion, der eine Anruf-Conversion zugeordnet werden soll. Wenn nicht festgelegt, wird die Standard-Conversion-Aktion verwendet. Dieses Feld hat nur Auswirkungen, wenn „callConversionReportingState“ auf „USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION“ festgelegt ist.

adScheduleTargets[]

object (AdScheduleInfo)

Liste der nicht überlappenden Zeitpläne, in denen alle Zeitintervalle angegeben sind, in denen das Asset ausgeliefert werden darf. Es können maximal 6 Zeitpläne pro Tag und insgesamt 42 Zeitpläne erstellt werden.

callOnly

boolean

Gibt an, ob bei dem Anruf nur die Telefonnummer ohne Link zur Website angezeigt wird. Gilt für Microsoft Ads.

callTrackingEnabled

boolean

Gibt an, ob der Anruf für das Anruf-Tracking aktiviert werden soll. Gilt für Microsoft Ads.

useSearcherTimeZone

boolean

Gibt an, ob die Anruferweiterung in der Zeitzone des Nutzers angezeigt werden soll. Gilt für Microsoft Ads.

startDate

string

Das Startdatum, ab dem dieses Asset aktiv ist und ausgeliefert werden kann, im Format JJJJ-MM-TT.

endDate

string

Das letzte Datum, an dem dieses Asset aktiv ist und ausgeliefert wird, im Format JJJJ-MM-TT.

CallConversionReportingState

Mögliche Datentypen für den Status einer Anruf-Conversion-Aktion.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
DISABLED Die Anruf-Conversion-Aktion ist deaktiviert.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Für die Anruf-Conversion-Aktion wird der Anruf-Conversion-Typ verwendet, der auf Kontoebene festgelegt ist.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Für die Anruf-Conversion-Aktion wird der Anruf-Conversion-Typ verwendet, der auf Ressourcenebene (Nur-Anrufanzeigen/Anruferweiterungen) festgelegt ist.

CallToActionAsset

Ein Call-to-Action-Asset.

JSON-Darstellung
{
  "callToAction": enum (CallToActionType)
}
Felder
callToAction

enum (CallToActionType)

Call-to-Action.

CallToActionType

Aufzählung, die mögliche Call-to-Action-Typen beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
LEARN_MORE Der Call-to-Action-Typ ist „Weitere Informationen“.
GET_QUOTE Der Call-to-Action-Typ ist „Angebot einholen“.
APPLY_NOW Der Call-to-Action-Typ ist „Jetzt bewerben“.
SIGN_UP Der Call-to-Action-Typ ist „Registrieren“.
CONTACT_US Der Call-to-Action-Typ ist „Kontaktieren Sie uns“.
SUBSCRIBE Der Call-to-Action-Typ ist „Abonnieren“.
DOWNLOAD Der Call-to-Action-Typ ist „Herunterladen“.
BOOK_NOW Der Call-to-Action-Typ ist „Jetzt buchen“.
SHOP_NOW Der Call-to-Action-Typ ist „Jetzt kaufen“.
BUY_NOW Der Call-to-Action-Typ ist „Jetzt kaufen“.
DONATE_NOW Der Call-to-Action-Typ ist „Jetzt spenden“.
ORDER_NOW Der Call-to-Action-Typ ist „Jetzt bestellen“.
PLAY_NOW Der Call-to-Action-Typ ist „Jetzt spielen“.
SEE_MORE Der Call-to-Action-Typ ist „Weitere Informationen“.
START_NOW Der Call-to-Action-Typ ist „Jetzt starten“.
VISIT_SITE Der Call-to-Action-Typ ist „Website besuchen“.
WATCH_NOW Der Call-to-Action-Typ ist „Jetzt ansehen“.

UnifiedLocationAsset

Ein einheitliches Standort-Asset.

JSON-Darstellung
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Felder
placeId

string

Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. Dieses Feld ist für eine bestimmte Kunden-ID und einen bestimmten Asset-Typ eindeutig. Weitere Informationen zu Place IDs finden Sie unter https://developers.google.com/places/web-service/place-id.

businessProfileLocations[]

object (BusinessProfileLocation)

Die Liste der Unternehmensstandorte für den Kunden. Dieser Wert wird nur zurückgegeben, wenn das Standort-Asset mit dem Unternehmensprofil-Konto synchronisiert wird. Es ist möglich, dass unter demselben Konto mehrere Unternehmensprofileinträge mit derselben Orts-ID vorhanden sind.

locationOwnershipType

enum (LocationOwnershipType)

Der Typ der Inhaberschaft des Standorts. Wenn der Typ BUSINESS_OWNER ist, wird er als Standorterweiterung ausgeliefert. Wenn der Typ AFFILIATE ist, wird er als Affiliate-Standort ausgeliefert.

BusinessProfileLocation

Standortdaten aus dem Unternehmensprofil, die aus dem verknüpften Unternehmensprofil-Konto synchronisiert wurden.

JSON-Darstellung
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Felder
labels[]

string

Vom Werbetreibenden angegebenes Label für den Standort im Unternehmensprofil-Konto. Diese Informationen werden aus dem Unternehmensprofil-Konto synchronisiert.

storeCode

string

Geschäftscode des Unternehmensprofils für diesen Standort. Diese Informationen werden aus dem Unternehmensprofil-Konto synchronisiert.

listingId

string (int64 format)

Die Unternehmensprofil-ID dieses Standorts. Diese Informationen werden aus dem verknüpften Unternehmensprofil-Konto synchronisiert.

LocationOwnershipType

Mögliche Arten der Inhaberschaft eines Standorts.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
BUSINESS_OWNER Inhaber des Unternehmensstandorts(alte Standorterweiterung).
AFFILIATE Affiliate-Standort(Standorterweiterung eines Drittanbieters – ALE)

AssetGroupAsset

AssetGroupAsset ist die Verknüpfung zwischen einem Asset und einer Asset-Gruppe. Wenn Sie ein AssetGroupAsset hinzufügen, wird ein Asset mit einer Asset-Gruppe verknüpft.

JSON-Darstellung
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
Felder
resourceName

string

Der Ressourcenname des Asset-Gruppen-Assets. Der Ressourcenname eines Assets in einer Asset-Gruppe hat das folgende Format:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

Die Asset-Gruppe, mit der dieses Asset-Gruppen-Asset verknüpft ist.

asset

string

Das Asset, mit dem dieses Asset-Gruppen-Asset verknüpft ist.

fieldType

enum (AssetFieldType)

Die Beschreibung der Platzierung des Assets in der Asset-Gruppe. Beispiele: HEADLINE, YOUTUBE_VIDEO

status

enum (AssetLinkStatus)

Der Status der Verknüpfung zwischen einem Asset und einer Asset-Gruppe.

Asset-Feldtyp

Aufzählung, die die möglichen Placements eines Assets beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
HEADLINE Das Asset ist für die Verwendung als Überschrift verknüpft.
DESCRIPTION Das Asset ist für die Verwendung als Beschreibung verknüpft.
MANDATORY_AD_TEXT Das Asset ist für die Verwendung als obligatorischer Anzeigentext verknüpft.
MARKETING_IMAGE Das Asset ist für die Verwendung als Marketingbild verknüpft.
MEDIA_BUNDLE Das Asset ist für die Verwendung als Mediaset verknüpft.
YOUTUBE_VIDEO Das Asset ist für die Verwendung als YouTube-Video verknüpft.
BOOK_ON_GOOGLE Das Asset ist verknüpft, um anzugeben, dass eine Hotelkampagne für „Auf Google buchen“ aktiviert ist.
LEAD_FORM Das Asset ist verknüpft und kann als Lead-Formularerweiterung verwendet werden.
PROMOTION Das Asset ist für die Verwendung als Angebotserweiterung verknüpft.
CALLOUT Das Asset ist für die Verwendung als Erweiterung mit Zusatzinformationen verknüpft.
STRUCTURED_SNIPPET Das Asset ist für die Verwendung als Snippet-Erweiterung verknüpft.
MOBILE_APP Das Asset ist für die Verwendung als Erweiterung für mobile Apps verknüpft.
HOTEL_CALLOUT Das Asset ist für die Verwendung als Erweiterung mit Zusatzinformationen für Hotels verknüpft.
CALL Das Asset ist für die Verwendung als Anruferweiterung verknüpft.
PRICE Das Asset ist für die Verwendung als Preiserweiterung verknüpft.
LONG_HEADLINE Das Asset ist für die Verwendung als langer Anzeigentitel verknüpft.
BUSINESS_NAME Das Asset ist für die Verwendung als Unternehmensname verknüpft.
SQUARE_MARKETING_IMAGE Das Asset ist für die Verwendung als quadratisches Marketingbild verknüpft.
PORTRAIT_MARKETING_IMAGE Das Asset ist für die Verwendung als Marketingbild im Hochformat verknüpft.
VIDEO Das Asset ist für die Verwendung als Nicht-YouTube-Logo verknüpft.
CALL_TO_ACTION_SELECTION Das Asset ist verknüpft, damit ein Call-to-Action ausgewählt werden kann.
AD_IMAGE Das Asset ist verknüpft, damit ein Anzeigenbild ausgewählt werden kann.
HOTEL_PROPERTY Das Asset ist verknüpft und kann als Hotelunterkunft in einer Performance Max-Kampagne für die Reisebranche verwendet werden.
LONG_DESCRIPTION Das Asset ist für die Verwendung als Langbeschreibung verknüpft.
CALL_TO_ACTION Das Asset ist für die Verwendung als Call-to-Action verknüpft.

AssetGroupSignal

AssetGroupSignal stellt ein Signal in einer Asset-Gruppe dar. Mithilfe eines Signals wird in Performance Max-Kampagnen angegeben, bei wem die Conversion-Wahrscheinlichkeit am höchsten ist. Bei Performance Max-Kampagnen wird das Signal verwendet, um nach neuen Nutzern zu suchen, die eine ähnliche oder stärkere Kaufabsicht haben, und so Conversions in Such-, Display- und Videokampagnen sowie anderen Kampagnentypen zu erzielen.

JSON-Darstellung
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
Felder
resourceName

string

Der Ressourcenname des Signals der Asset-Gruppe. Der Ressourcenname für das Signal einer Asset-Gruppe hat das folgende Format:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

Die Asset-Gruppe, zu der dieses Asset-Gruppensignal gehört.

Union-Feld signal. Das Signal der Asset-Gruppe. Für signal ist nur einer der folgenden Werte zulässig:
audience

object (AudienceInfo)

Das Zielgruppensignal, das von der Performance Max-Kampagne verwendet werden soll.

AudienceInfo

Ein Zielgruppenkriterium.

JSON-Darstellung
{
  "audience": string
}
Felder
audience

string

Der Name der Zielgruppenressource.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter stellt einen Filterbaumknoten für Einträge in einer Asset-Gruppe dar.

JSON-Darstellung
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Felder
resourceName

string

Der Ressourcenname des Filters für Asset-Eintragsgruppen. Der Ressourcenname für Filter für Asset-Eintragsgruppen hat das folgende Format:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

Die Asset-Gruppe, zu der dieser Filter für Asset-Eintragsgruppen gehört.

id

string (int64 format)

Die ID des ListingGroupFilter.

type

enum (ListingGroupFilterType)

Typ eines Filterknotens für eine Eintragsgruppe.

vertical

enum (ListingGroupFilterVertical)

Die vertikale Achse, die der aktuelle Knotenbaum darstellt. Alle Knoten im selben Baum müssen zur selben Branche gehören.

caseValue

object (ListingGroupFilterDimension)

Dimensionswert, mit dem die übergeordnete Gruppe dieser Gruppe in Listen verfeinert wird. Für die Stammgruppe nicht definiert.

parentListingGroupFilter

string

Ressourcenname der Unterteilung der übergeordneten Eintragssammlung. Null für den Filterknoten der Stamm-Eintragsgruppe.

path

object (ListingGroupFilterDimensionPath)

Der Pfad der Dimensionen, die diesen Filter für die Eintragsgruppe definieren.

ListingGroupFilterType

Der Typ des Filters für die Eintragsgruppe.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
SUBDIVISION Unterteilung von Produkten anhand bestimmter Dimensionen für Einträge.
UNIT_INCLUDED Ein eingeschlossener Blattknoten für den Filter einer Eintragsgruppe.
UNIT_EXCLUDED Ein ausgeschlossener Blattknoten des Filters für Eintragsgruppen.

ListingGroupFilterVertical

Der Typ der vertikalen Filter für Einträge.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
SHOPPING Stellt den Shopping-Bereich dar. Die Branche ist nur in Performance Max-Kampagnen für den Einzelhandel zulässig.

ListingGroupFilterDimension

Eintragsdimensionen für den Filter für Asset-Eintragsgruppen.

JSON-Darstellung
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
Felder
Union-Feld dimension. Eine Dimension eines der folgenden Typen ist immer vorhanden. Für dimension ist nur einer der folgenden Werte zulässig:
productBiddingCategory

object (ProductBiddingCategory)

Gebotskategorie eines Produktangebots.

productBrand

object (ProductBrand)

Marke eines Produktangebots.

productChannel

object (ProductChannel)

Lokalität eines Produktangebots.

productCondition

object (ProductCondition)

Zustand eines Produktangebots.

productCustomAttribute

object (ProductCustomAttribute)

Benutzerdefiniertes Attribut eines Produktangebots.

productItemId

object (ProductItemId)

Artikel-ID eines Produktangebots.

productType

object (ProductType)

Art eines Produktangebots.

ProductBiddingCategory

Ein Element einer Gebotskategorie auf einer bestimmten Ebene. Kategorien der obersten Ebene befinden sich auf Ebene 1, ihre untergeordneten Kategorien auf Ebene 2 usw. Derzeit werden bis zu fünf Ebenen unterstützt. Der Nutzer muss einen Dimensionstyp angeben, der die Ebene der Kategorie angibt. Alle Fälle derselben Unterteilung müssen denselben Dimensionstyp (Kategorieebene) haben.

JSON-Darstellung
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
Felder
level

enum (ListingGroupFilterBiddingCategoryLevel)

Gibt die Ebene der Kategorie in der Taxonomie an.

id

string (int64 format)

ID der Gebotskategorie des Produkts.

Diese ID entspricht der ID für „google_product_category“ [Google_Produktkategorie], die in diesem Artikel beschrieben wird: https://support.google.com/merchants/answer/6324436.

ListingGroupFilterBiddingCategoryLevel

Die Ebene der Gebotskategorie des Eintragsgruppenfilters.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
LEVEL1 Stufe 1
LEVEL2 Stufe 2
LEVEL3 Stufe 3
LEVEL4 Stufe 4:
LEVEL5 Stufe 5

ProductBrand

Marke des Produkts.

JSON-Darstellung
{
  "value": string
}
Felder
value

string

Stringwert der Produktmarke.

ProductChannel

Lokalität eines Produktangebots.

JSON-Darstellung
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Felder
channel

enum (ListingGroupFilterProductChannel)

Wert des Orts.

ListingGroupFilterProductChannel

Aufzählung zur Beschreibung der Lokalität eines Produktangebots.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ONLINE Der Artikel wird online verkauft.
LOCAL Der Artikel wird in Geschäften vor Ort verkauft.

ProductCondition

Zustand eines Produktangebots.

JSON-Darstellung
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Felder
condition

enum (ListingGroupFilterProductCondition)

Wert der Bedingung.

ListingGroupFilterProductCondition

Enum, das den Zustand eines Produktangebots beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
NEW Der Zustand des Produkts ist „Neu“.
REFURBISHED Der Zustand des Produkts ist „generalüberholt“.
USED Der Zustand des Produkts ist „gebraucht“.

ProductCustomAttribute

Benutzerdefiniertes Attribut eines Produktangebots.

JSON-Darstellung
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Felder
index

enum (ListingGroupFilterCustomAttributeIndex)

Gibt den Index des benutzerdefinierten Attributs an.

value

string

Stringwert des benutzerdefinierten Produktattributs.

ListingGroupFilterCustomAttributeIndex

Der Index der Kundenattribute.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
INDEX0 Benutzerdefiniertes Attribut für den ersten Filter für Eintragsgruppen.
INDEX1 Benutzerdefiniertes Attribut für den zweiten Filter für Eintragsgruppen.
INDEX2 Benutzerdefiniertes Attribut für den dritten Filter für Eintragsgruppen.
INDEX3 Viertes benutzerdefiniertes Attribut für den Filter für Eintragsgruppen.
INDEX4 Fünftes benutzerdefiniertes Attribut für den Filter für Eintragsgruppen.

ProductItemId

Artikel-ID eines Produktangebots.

JSON-Darstellung
{
  "value": string
}
Felder
value

string

Wert der ID.

ProductType

Art eines Produktangebots.

JSON-Darstellung
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Felder
level

enum (ListingGroupFilterProductTypeLevel)

Ebene des Typs.

value

string

Wert des Typs.

ListingGroupFilterProductTypeLevel

Enum, das das Niveau des Typs eines Produktangebots beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
LEVEL1 Stufe 1
LEVEL2 Stufe 2
LEVEL3 Stufe 3
LEVEL4 Stufe 4:
LEVEL5 Stufe 5

ListingGroupFilterDimensionPath

Der Pfad, der die Dimensionen definiert, die einen Filter für eine Eintragsgruppe definieren.

JSON-Darstellung
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
Felder
dimensions[]

object (ListingGroupFilterDimension)

Der vollständige Pfad der Dimensionen durch die Hierarchie der Filter für die Eintragsgruppe (ohne den Root-Knoten) zu diesem Filter für die Eintragsgruppe.

AssetGroupTopCombinationView

Hier sehen Sie die Nutzung der leistungsstärksten Asset-Kombinationen für Asset-Gruppen.

JSON-Darstellung
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Felder
resourceName

string

Der Ressourcenname der Ansicht mit den Top-Kombinationen der Asset-Gruppe. Ressourcennamen von AssetGroup Top Combination-Ansichten haben das Format „customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}“.

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Die leistungsstärksten Kombinationen von Assets, die zusammen ausgeliefert wurden.

AssetGroupAssetCombinationData

Daten zu Asset-Kombinationen für Asset-Gruppen

JSON-Darstellung
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Felder
assetCombinationServedAssets[]

object (AssetUsage)

Bereitgestellte Assets.

AssetUsage

Enthält die Nutzungsinformationen des Assets.

JSON-Darstellung
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Felder
asset

string

Ressourcenname des Assets.

servedAssetFieldType

enum (ServedAssetFieldType)

Der Typ des ausgelieferten Felds des Assets.

ServedAssetFieldType

Die möglichen Asset-Feldtypen.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

HEADLINE_1 Das Asset wird in Anzeigentitel 1 verwendet.
HEADLINE_2 Das Asset wird in Anzeigentitel 2 verwendet.
HEADLINE_3 Das Asset wird in Anzeigentitel 3 verwendet.
DESCRIPTION_1 Das Asset wird in der Beschreibung 1 verwendet.
DESCRIPTION_2 Das Asset wird in „Beschreibung 2“ verwendet.
HEADLINE Das Asset wurde in einem Anzeigentitel verwendet. Verwenden Sie diesen Parameter nur, wenn die Anzeige nur einen Anzeigentitel enthält. Verwenden Sie andernfalls die Enumerationen HEADLINE_1, HEADLINE_2 oder HEADLINE_3.
HEADLINE_IN_PORTRAIT Das Asset wurde als Anzeigentitel in einem Bild im Hochformat verwendet.
LONG_HEADLINE Das Asset wurde in einem langen Anzeigentitel verwendet (in MultiAssetResponsiveAd).
DESCRIPTION Das Asset wurde in einer Beschreibung verwendet. Verwenden Sie diesen Parameter nur, wenn die Anzeige nur eine Beschreibung enthält. Verwenden Sie andernfalls die Enums DESCRIPTION_1 oder DESCRIPTION_@.
DESCRIPTION_IN_PORTRAIT Das Asset wurde als Beschreibung im Hochformatbild verwendet.
BUSINESS_NAME_IN_PORTRAIT Das Asset wurde als Name des Unternehmens im Hochformat verwendet.
BUSINESS_NAME Das Asset wurde als Name des Unternehmens verwendet.
MARKETING_IMAGE Das Asset wurde als Marketingbild verwendet.
MARKETING_IMAGE_IN_PORTRAIT Das Asset wurde als Marketingbild im Hochformat verwendet.
SQUARE_MARKETING_IMAGE Das Asset wurde als quadratisches Marketingbild verwendet.
PORTRAIT_MARKETING_IMAGE Das Asset wurde als Marketingbild im Hochformat verwendet.
CALL_TO_ACTION Das Asset wurde als Call-to-Action verwendet.
YOU_TUBE_VIDEO Das Asset wurde als YouTube-Video verwendet.
CALL Dieses Asset wird als Anruf verwendet.
MOBILE_APP Dieses Asset wird als mobile App verwendet.
CALLOUT Dieses Asset wird als Zusatzinformationen verwendet.
STRUCTURED_SNIPPET Dieses Asset wird als strukturiertes Snippet verwendet.
PRICE Dieses Asset wird als Preis verwendet.
PROMOTION Dieses Asset wird als Angebot verwendet.
AD_IMAGE Dieses Asset wird als Bild verwendet.
LEAD_FORM Das Asset wird als Lead-Formular verwendet.
DESCRIPTION_PREFIX Das Asset wird als Textzeilenpräfix verwendet.

AssetGroup

Eine Asset-Gruppe. Mit „AssetGroupAsset“ wird ein Asset mit der Asset-Gruppe verknüpft. Mit AssetGroupSignal wird ein Signal einer Asset-Gruppe zugeordnet.

JSON-Darstellung
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Felder
resourceName

string

Der Ressourcenname der Asset-Gruppe. Ressourcennamen von Asset-Gruppen haben das folgende Format:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

Die ID der Asset-Gruppe.

campaign

string

Die Kampagne, mit der diese Asset-Gruppe verknüpft ist. Das Asset, das mit der Asset-Gruppe verknüpft ist.

name

string

Erforderlich. Name der Asset-Gruppe. Erforderlich. Sie muss mindestens 1 und darf maximal 128 Zeichen lang sein. Sie muss innerhalb einer Kampagne eindeutig sein.

finalUrls[]

string

Eine Liste der endgültigen URLs nach allen domainübergreifenden Weiterleitungen. Bei Performance Max-Kampagnen sind die URLs standardmäßig für die Erweiterung vorgesehen, sofern die Funktion nicht deaktiviert wird.

finalMobileUrls[]

string

Eine Liste der finalen mobilen URLs nach allen domainübergreifenden Weiterleitungen. Bei Performance Max-Kampagnen sind die URLs standardmäßig für die Erweiterung vorgesehen, sofern die Funktion nicht deaktiviert wird.

status

enum (AssetGroupStatus)

Der Status der Asset-Gruppe.

path1

string

Erster Teil des Textes, der an die URL in der Anzeige angehängt werden kann.

path2

string

Zweiter Teil des Textes, der an die URL angehängt sein kann, die in der Anzeige angezeigt wird. Dieses Feld kann nur festgelegt werden, wenn path1 festgelegt ist.

adStrength

enum (AdStrength)

Gesamte Anzeigeneffektivität dieser Asset-Gruppe.

AssetGroupStatus

Die möglichen Status einer Asset-Gruppe.

Enums
UNSPECIFIED Der Status wurde nicht angegeben.
UNKNOWN Der empfangene Wert ist in dieser Version nicht bekannt.
ENABLED Die Asset-Gruppe ist aktiviert.
PAUSED Die Asset-Gruppe ist pausiert.
REMOVED Die Asset-Gruppe wird entfernt.

AdStrength

Enum mit den möglichen Anzeigeneffektivitäten.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
PENDING Die Anzeigeneffektivität wird derzeit ermittelt.
NO_ADS Es konnten keine Anzeigen generiert werden.
POOR Unzureichende Effektivität.
AVERAGE Durchschnittliche Stärke.
GOOD Gute Stärke.
EXCELLENT Hervorragende Festigkeit.

AssetSetAsset

„AssetSetAsset“ ist die Verknüpfung zwischen einem Asset und einer Assetgruppe. Wenn Sie ein AssetSetAsset hinzufügen, wird ein Asset mit einem Asset-Set verknüpft.

JSON-Darstellung
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
Felder
resourceName

string

Der Ressourcenname des Asset-Sets-Assets. Ressourcennamen für Assets in Asset-Gruppen haben das folgende Format:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

string

Der Asset-Satz, mit dem dieses Asset-Set-Asset verknüpft ist.

asset

string

Das Asset, mit dem dieses Asset-Set-Asset verknüpft ist.

status

enum (AssetSetAssetStatus)

Der Status des Asset-Set-Assets. Schreibgeschützt.

AssetSetAssetStatus

Die möglichen Status eines Asset-Gruppen-Assets.

Enums
UNSPECIFIED Der Status wurde nicht angegeben.
UNKNOWN Der empfangene Wert ist in dieser Version nicht bekannt. Dies ist ein reiner Antwortwert.
ENABLED Das Asset-Set-Asset ist aktiviert.
REMOVED Das Asset-Set-Asset wird entfernt.

AssetSet

Eine Asset-Gruppe, die eine Sammlung von Assets darstellt. Mit AssetSetAsset können Sie ein Asset mit der Assetgruppe verknüpfen.

JSON-Darstellung
{
  "id": string,
  "resourceName": string
}
Felder
id

string (int64 format)

Die ID der Asset-Gruppe.

resourceName

string

Der Ressourcenname des Asset-Sets. Ressourcennamen von Asset-Gruppen haben das folgende Format:

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Eine Gebotsstrategie.

JSON-Darstellung
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Felder
resourceName

string

Der Ressourcenname der Gebotsstrategie. Ressourcennamen für Gebotsstrategien haben das folgende Format:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

Der Status der Gebotsstrategie.

Dieses Feld ist schreibgeschützt.

type

enum (BiddingStrategyType)

Der Typ der Gebotsstrategie. Erstellen Sie eine Gebotsstrategie, indem Sie das Gebotsschema festlegen.

Dieses Feld ist schreibgeschützt.

currencyCode

string

Die Währung, die von der Gebotsstrategie verwendet wird (dreistelliger ISO 4217-Code).

Bei Gebotsstrategien in Verwaltungskonten kann diese Währung bei der Erstellung festgelegt werden. Standardmäßig wird die Währung des Verwaltungskontos verwendet. Für Kunden mit Auslieferung kann dieses Feld nicht festgelegt werden. Bei allen Strategien eines Kunden mit Auslieferung wird implizit die Währung des Kunden mit Auslieferung verwendet. In allen Fällen wird im Feld „effectiveCurrencyCode“ die von der Strategie verwendete Währung zurückgegeben.

id

string (int64 format)

Die ID der Gebotsstrategie.

name

string

Der Name der Gebotsstrategie. Alle Gebotsstrategien innerhalb eines Kontos müssen eindeutig benannt werden.

Die Länge des Strings sollte zwischen 1 und 255 (einschließlich) in UTF-8-Byte (gekürzt) liegen.

effectiveCurrencyCode

string

Die Währung, die von der Gebotsstrategie verwendet wird (dreistelliger ISO 4217-Code).

Bei Gebotsstrategien in Verwaltungskonten ist das die Währung, die vom Werbetreibenden beim Erstellen der Strategie festgelegt wurde. Für die Bereitstellung für Kunden ist dies der currencyCode des Kunden.

Messwerte zur Gebotsstrategie werden in dieser Währung angegeben.

Dieses Feld ist schreibgeschützt.

campaignCount

string (int64 format)

Die Anzahl der Kampagnen, die dieser Gebotsstrategie zugeordnet sind.

Dieses Feld ist schreibgeschützt.

nonRemovedCampaignCount

string (int64 format)

Die Anzahl der nicht entfernten Kampagnen, die mit dieser Gebotsstrategie verknüpft sind.

Dieses Feld ist schreibgeschützt.

Union-Feld scheme. Das Gebotsschema.

Es kann nur einer festgelegt werden. Für scheme ist nur einer der folgenden Werte zulässig:

enhancedCpc

object (EnhancedCpc)

Bei dieser Gebotsstrategie werden Gebote für Klicks erhöht, die mit höherer Wahrscheinlichkeit zu einer Conversion führen, und für Klicks gesenkt, bei denen dies weniger wahrscheinlich ist.

maximizeConversionValue

object (MaximizeConversionValue)

Eine automatisierte Gebotsstrategie, mit der Sie mit Ihrem Budget einen möglichst hohen Conversion-Wert in Ihren Kampagnen erzielen.

maximizeConversions

object (MaximizeConversions)

Eine automatische Gebotsstrategie, mit der Sie mit Ihrem Budget möglichst viele Conversions für Ihre Kampagnen erzielen.

targetCpa

object (TargetCpa)

Bei dieser Gebotsstrategie werden die Gebote so festgelegt, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen.

targetImpressionShare

object (TargetImpressionShare)

Eine Gebotsstrategie, bei der Gebote automatisch für einen ausgewählten Prozentsatz von Impressionen optimiert werden.

targetOutrankShare

object (TargetOutrankShare)

Eine Gebotsstrategie, bei der Gebote auf Grundlage des Zielanteils von Auktionen festgelegt werden, in denen der Werbetreibende einen bestimmten Mitbewerber übertreffen sollte. Die Verwendung dieses Feldes wurde eingestellt. Das Erstellen einer neuen Gebotsstrategie mit diesem Feld oder das Zuordnen von Gebotsstrategien mit diesem Feld zu einer Kampagne schlägt fehl. Änderungen an Strategien, in denen dieses Schema bereits vorhanden ist, sind zulässig.

targetRoas

object (TargetRoas)

Eine Gebotsstrategie, mit der Sie den Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erzielen können.

targetSpend

object (TargetSpend)

Eine Gebotsstrategie, bei der Ihre Gebote so festgelegt werden, dass Sie mit Ihrem Budget möglichst viele Klicks erzielen.

BiddingStrategyStatus

Mögliche Status einer BiddingStrategy.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

ENABLED Die Gebotsstrategie ist aktiviert.
REMOVED Die Gebotsstrategie wird entfernt.

BiddingStrategyType

Enumeration, die mögliche Gebotsstrategietypen beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
COMMISSION „Provision“ ist eine automatische Gebotsstrategie, bei der der Werbetreibende einen bestimmten Prozentsatz des Conversion-Werts zahlt.
ENHANCED_CPC Beim auto-optimierten CPC werden Gebote für Klicks, die mit größerer Wahrscheinlichkeit zu einer Conversion führen, erhöht und Gebote für Klicks mit geringerer Wahrscheinlichkeit gesenkt.
INVALID Wird nur für den Rückgabewert verwendet. Gibt an, dass für eine Kampagne keine Gebotsstrategie festgelegt ist. Dadurch wird verhindert, dass die Kampagne ausgeliefert wird. Eine Kampagne kann beispielsweise mit einer Gebotsstrategie eines Verwaltungskontos verknüpft sein und das Auslieferungskonto wird später vom Verwaltungskonto getrennt. In diesem Fall wird die Kampagne automatisch von der nun nicht mehr zugänglichen Gebotsstrategie der Verwaltungsmarke getrennt und auf den Gebotsstrategietyp „INVALID“ umgestellt.
MANUAL_CPA Manuelle Gebotsstrategie, mit der Werbetreibende das Gebot pro vom Werbetreibenden angegebener Aktion festlegen können.
MANUAL_CPC Manuelle klickbasierte Gebote, bei denen Nutzer pro Klick bezahlen
MANUAL_CPM Manuelle gebotsbasierte Abrechnung nach Impressionen, bei der der Nutzer pro tausend Impressionen bezahlt.
MANUAL_CPV Eine Gebotsstrategie, bei der ein konfigurierbarer Betrag pro Videoaufruf bezahlt wird.
MAXIMIZE_CONVERSIONS Bei dieser Gebotsstrategie wird die Anzahl der Conversions automatisch im Rahmen eines Tagesbudgets maximiert.
MAXIMIZE_CONVERSION_VALUE Eine automatische Gebotsstrategie, bei der Gebote automatisch so festgelegt werden, dass Sie mit Ihrem Budget möglichst viel Umsatz erzielen.
PAGE_ONE_PROMOTED Das Gebotsschema „Beworbene Anzeigen auf der ersten Seite“ legt maximale CPC-Gebote für Impressionen auf der ersten Seite oder für beworbene Anzeigen auf der ersten Seite auf google.com fest. Dieser Enumerationswert ist veraltet.
PERCENT_CPC Bei der Gebotsstrategie „Prozentualer CPC“ sind Gebote ein Bruchteil des beworbenen Preises für ein bestimmtes Produkt oder eine bestimmte Dienstleistung.
TARGET_CPA „Ziel-CPA“ ist eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen.
TARGET_CPM Bei der automatischen Gebotsstrategie „Ziel-CPM“ werden die Gebote so festgelegt, dass Sie mit Ihrem Ziel-CPM (Cost-per-1000-Impressions) möglichst viele Impressionen erzielen.
TARGET_IMPRESSION_SHARE Eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass ein bestimmter Prozentsatz von Suchanzeigen oben auf der ersten Seite (oder an einem anderen Zielort) ausgeliefert wird.
TARGET_OUTRANK_SHARE „Kompetitive Auktionsposition“ ist eine automatische Gebotsstrategie, bei der Gebote auf Grundlage des angestrebten Anteils an Auktionen festgelegt werden, in denen der Werbetreibende einen bestimmten Mitbewerber übertreffen soll. Dieser Enum-Wert ist veraltet.
TARGET_ROAS „Ziel-ROAS“ ist eine automatische Gebotsstrategie, mit der Sie den Umsatz maximieren und gleichzeitig einen bestimmten durchschnittlichen ROAS (Return on Advertising Spend) erzielen können.
TARGET_SPEND Bei der automatischen Gebotsstrategie „Ausgabenziel“ werden Ihre Gebote so festgelegt, dass Sie mit Ihrem Budget möglichst viele Klicks erzielen.

EnhancedCpc

Dieser Typ hat keine Felder.

Eine automatische Gebotsstrategie, bei der Gebote für Klicks erhöht werden, die mit höherer Wahrscheinlichkeit zu einer Conversion führen, und für Klicks gesenkt werden, bei denen dies weniger wahrscheinlich ist.

Diese Gebotsstrategie wird nicht mehr unterstützt und kann nicht mehr erstellt werden. Verwenden Sie „ManualCpc“ mit „enhancedCpcEnabled“ auf „true“ gesetzt, um die gleiche Funktionalität zu erhalten.

MaximizeConversionValue

Eine automatisierte Gebotsstrategie, mit der Sie mit Ihrem Budget einen möglichst hohen Conversion-Wert in Ihren Kampagnen erzielen.

JSON-Darstellung
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
Felder
cpcBidCeilingMicros

string (int64 format)

Höchstgrenze, die von der Gebotsstrategie festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords. Nur für Portfolio-Gebotsstrategien änderbar.

cpcBidFloorMicros

string (int64 format)

Mindestgebot, das von der Gebotsfunktion festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords. Nur für Portfolio-Gebotsstrategien änderbar.

targetRoas

number

Die Option "Ziel-ROAS" (Return on Advertising Spend). Wenn diese Option festgelegt ist, maximiert die Gebotsstrategie den Umsatz, während der Ziel-ROAS gemittelt wird. Ist der Ziel-ROAS hoch, kann die Gebotsstrategie unter Umständen nicht das gesamte Budget ausgeben. Ist der Ziel-ROAS nicht festgelegt, versucht die Gebotsstrategie, den höchstmöglichen ROAS für das Budget zu erreichen.

MaximizeConversions

Eine automatische Gebotsstrategie, mit der Sie mit Ihrem Budget möglichst viele Conversions für Ihre Kampagnen erzielen.

JSON-Darstellung
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
Felder
cpcBidCeilingMicros

string (int64 format)

Höchstgrenze, die von der Gebotsstrategie festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords. Nur für Portfolio-Gebotsstrategien änderbar.

cpcBidFloorMicros

string (int64 format)

Mindestgebot, das von der Gebotsfunktion festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords. Nur für Portfolio-Gebotsstrategien änderbar.

targetCpaMicros

string (int64 format)

Die Option „Ziel-CPA (Cost-per-Action)“. Das ist der durchschnittliche Betrag, den Sie pro Conversion-Aktion ausgeben möchten. Er wird in Mikroeinheiten der Währung der Gebotsstrategie angegeben. Falls festgelegt, werden mit der Gebotsstrategie möglichst viele Conversions zum Ziel-CPA oder darunter erzielt. Ist der Ziel-CPA nicht festgelegt, versucht die Gebotsstrategie, den niedrigstmöglichen CPA für das Budget zu erreichen.

TargetCpa

Bei dieser automatischen Gebotsstrategie werden die Gebote so festgelegt, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen.

JSON-Darstellung
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Felder
targetCpaMicros

string (int64 format)

Durchschnittliches CPC-Ziel. Dieses Ziel muss größer oder gleich der abrechenbaren Mindesteinheit basierend auf der Währung für das Konto sein.

cpcBidCeilingMicros

string (int64 format)

Höchstgrenze, die von der Gebotsstrategie festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords. Diese Einstellung sollte nur für Portfolio-Gebotsstrategien festgelegt werden.

cpcBidFloorMicros

string (int64 format)

Mindestgebot, das von der Gebotsfunktion festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords. Diese Einstellung sollte nur für Portfolio-Gebotsstrategien festgelegt werden.

TargetImpressionShare

Eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass ein bestimmter Prozentsatz von Suchanzeigen oben auf der ersten Seite (oder an einem anderen Zielort) ausgeliefert wird.

JSON-Darstellung
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Felder
location

enum (TargetImpressionShareLocation)

Die Zielposition auf der Suchergebnisseite.

locationFractionMicros

string (int64 format)

Der ausgewählte Anteil der Anzeigen, die am Zielstandort ausgeliefert werden sollen, in Mikros. Beispiel: 1% entspricht 10.000.

cpcBidCeilingMicros

string (int64 format)

Das höchste CPC-Gebot, das vom automatischen Gebotssystem festgelegt werden darf. Dies ist ein Pflichtfeld, das vom Werbetreibenden ausgefüllt wird, der die Obergrenze festlegt, und das in lokalen Micros-Werten angegeben wird.

TargetImpressionShareLocation

Aufzählung zur Beschreibung möglicher Ziele.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ANYWHERE_ON_PAGE An einer beliebigen Stelle auf der Webseite.
TOP_OF_PAGE Oberster Anzeigenblock
ABSOLUTE_TOP_OF_PAGE Beste Position im obersten Anzeigenblock.

TargetOutrankShare

Eine automatische Gebotsstrategie, bei der Gebote auf Grundlage des Zielanteils von Auktionen festgelegt werden, in denen der Werbetreibende einen bestimmten Mitbewerber übertreffen sollte. Diese Strategie ist veraltet.

JSON-Darstellung
{
  "cpcBidCeilingMicros": string
}
Felder
cpcBidCeilingMicros

string (Int64Value format)

Höchstgrenze, die von der Gebotsstrategie festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords.

TargetRoas

Eine automatische Gebotsstrategie, mit der Sie den Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erzielen können.

JSON-Darstellung
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Felder
targetRoas

number

Erforderlich. Der gewählte Umsatz (basierend auf den Conversion-Daten) pro Ausgabeneinheit. Wert muss zwischen 0,01 und 1000,0 (einschließlich) liegen.

cpcBidCeilingMicros

string (int64 format)

Höchstgrenze, die von der Gebotsstrategie festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords. Diese Einstellung sollte nur für Portfolio-Gebotsstrategien festgelegt werden.

cpcBidFloorMicros

string (int64 format)

Mindestgebot, das von der Gebotsfunktion festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords. Diese Einstellung sollte nur für Portfolio-Gebotsstrategien festgelegt werden.

TargetSpend

Eine automatische Gebotsstrategie, bei der Ihre Gebote so festgelegt werden, dass Sie mit Ihrem Budget möglichst viele Klicks erzielen.

JSON-Darstellung
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Felder
targetSpendMicros
(deprecated)

string (int64 format)

Veraltet: Das Ausgabenziel, unter dem die Klicks maximiert werden sollen. Eine TargetSpend-Gebotsfunktion versucht, den kleineren Wert oder den natürlichen Drosselungsbetrag auszugeben. Wenn nicht angegeben, wird das Budget als Ausgabenziel verwendet. Dieses Feld ist veraltet und sollte nicht mehr verwendet werden. Weitere Informationen finden Sie unter https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

cpcBidCeilingMicros

string (int64 format)

Höchstgrenze, die von der Gebotsstrategie festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords.

CampaignBudget

Ein Kampagnenbudget.

JSON-Darstellung
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
Felder
resourceName

string

Der Ressourcenname des Kampagnenbudgets. Ressourcennamen von Kampagnenbudgets haben das folgende Format:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

Die Bereitstellungsmethode, mit der festgelegt wird, mit welcher Rate das Kampagnenbudget ausgegeben wird.

Der Standardwert ist STANDARD, wenn bei einem Erstellungsvorgang nichts angegeben ist.

period

enum (BudgetPeriod)

Zeitraum, in dem das Budget ausgegeben werden kann. Der Standardwert ist DAILY, wenn nicht angegeben.

amountMicros

string (int64 format)

Der Betrag des Budgets in der lokalen Währung des Kontos. Die Menge wird in Mikros angegeben, wobei eine Million einer Währungseinheit entspricht. Die monatlichen Ausgaben sind auf das 30,4-Fache dieses Betrags beschränkt.

BudgetDeliveryMethod

Mögliche Auslieferungsmethoden für ein Budget.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
STANDARD Der Budgetserver drosselt die Auslieferung gleichmäßig über den gesamten Zeitraum hinweg.
ACCELERATED Der Budgetserver drosselt die Auslieferung nicht und Anzeigen werden so schnell wie möglich ausgeliefert.

BudgetPeriod

Möglicher Zeitraum für ein Budget.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
DAILY Tagesbudget:
FIXED_DAILY Festes Tagesbudget.
CUSTOM_PERIOD Mit „custom_budget“ kann zusammen mit „total_amount“ ein Lifetime-Budgetlimit angegeben werden.

Kampagne

Eine Kampagne.

JSON-Darstellung
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Felder
resourceName

string

Der Ressourcenname der Kampagne. Ressourcennamen von Kampagnen haben das Format:

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

Der Status der Kampagne.

Wenn eine neue Kampagne hinzugefügt wird, ist der Status standardmäßig ENABLED.

servingStatus

enum (CampaignServingStatus)

Der Status der Anzeigenbereitstellung der Kampagne.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Der Systemstatus der Gebotsstrategie der Kampagne.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Der Optimierungsstatus der Anzeigenbereitstellung der Kampagne.

advertisingChannelType

enum (AdvertisingChannelType)

Das primäre Bereitstellungsziel für Anzeigen innerhalb der Kampagne. Die Targeting-Optionen können in networkSettings optimiert werden.

Dieses Feld ist erforderlich und darf beim Erstellen neuer Kampagnen nicht leer sein.

Kann nur beim Erstellen von Kampagnen festgelegt werden. Nachdem die Kampagne erstellt wurde, kann das Feld nicht mehr geändert werden.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

Optionale Verfeinerung für advertisingChannelType: Muss ein gültiger Untertyp des übergeordneten Kanal-Typs sein.

Kann nur beim Erstellen von Kampagnen festgelegt werden. Nachdem die Kampagne erstellt wurde, kann das Feld nicht mehr geändert werden.

urlCustomParameters[]

object (CustomParameter)

Die Liste der Zuordnungen, die zum Ersetzen von benutzerdefinierten Parameter-Tags in einem trackingUrlTemplate, finalUrls oder mobile_final_urls verwendet werden.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Einstellungen für die automatische Gebotseinstellung, eine Funktion, die nur für Kampagnen verfügbar ist, die auf das Ad Exchange-Netzwerk ausgerichtet sind.

networkSettings

object (NetworkSettings)

Die Netzwerkeinstellungen für die Kampagne.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Die Einstellung zum Steuern dynamischer Suchanzeigen.

shoppingSetting

object (ShoppingSetting)

Die Einstellung zum Steuern von Shopping-Kampagnen.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

Die Einstellung für das geografische Targeting von Anzeigen.

effectiveLabels[]

string

Die Ressourcennamen der effektiven Labels, die dieser Kampagne zugeordnet sind. Ein effektives Label ist ein Label, das von dieser Kampagne übernommen oder ihr direkt zugewiesen wurde.

labels[]

string

Die Ressourcennamen der Labels, die dieser Kampagne zugeordnet sind.

biddingStrategyType

enum (BiddingStrategyType)

Der Typ der Gebotsstrategie.

Eine Gebotsstrategie kann entweder durch Festlegen des Gebotsschemas erstellt werden, um eine Standard-Gebotsstrategie zu erstellen, oder durch das Feld biddingStrategy, um eine Portfolio-Gebotsstrategie zu erstellen.

Dieses Feld ist schreibgeschützt.

accessibleBiddingStrategy

string

Der Ressourcenname von AccessibleBiddingStrategy, einer schreibgeschützten Ansicht der uneingeschränkten Attribute der angehängten Portfolio-Gebotsstrategie, die durch „biddingStrategy“ identifiziert wird. Leer, wenn in der Kampagne keine Portfoliostrategie verwendet wird. Attribute für uneingeschränkte Strategien sind für alle Kunden verfügbar, für die die Strategie freigegeben ist. Sie werden aus der AccessibleBiddingStrategy-Ressource gelesen. Im Gegensatz dazu sind eingeschränkte Attribute nur für den Kunden verfügbar, dem die Strategie gehört, und seine Administratoren. Eingeschränkte Attribute können nur aus der BiddingStrategy-Ressource gelesen werden.

frequencyCaps[]

object (FrequencyCapEntry)

Eine Liste, mit der Sie festlegen können, wie oft jeder Nutzer die Anzeigen dieser Kampagne sehen soll.

selectiveOptimization

object (SelectiveOptimization)

Einstellung für die selektive Optimierung für diese Kampagne, die eine Reihe von Conversion-Aktionen enthält, für die diese Kampagne optimiert werden soll. Diese Funktion gilt nur für App-Kampagnen, bei denen MULTI_CHANNEL als AdvertisingChannelType und APP_CAMPAIGN oder APP_CAMPAIGN_FOR_ENGAGEMENT als AdvertisingChannelSubType verwendet wird.

optimizationGoalSetting

object (OptimizationGoalSetting)

Optimierungsziel für diese Kampagne, das eine Reihe von Optimierungszieltypen umfasst.

trackingSetting

object (TrackingSetting)

Einstellungen auf Kampagnenebene für Tracking-Informationen

engineId

string

ID der Kampagne im externen Engine-Konto. Dieses Feld gilt nur für Konten, die nicht Google Ads-Konten sind, z. B. Yahoo! Japan, Microsoft oder Baidu. Verwenden Sie für eine Google Ads-Entität stattdessen „campaign.id“.

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Die Asset-Feldtypen, die aus dieser Kampagne ausgeschlossen werden sollen. Asset-Verknüpfungen mit diesen Feldtypen werden nicht von der übergeordneten Ebene in diese Kampagne übernommen.

createTime

string

Der Zeitstempel für den Zeitpunkt, zu dem dieser Kampagne erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format „JJJJ-MM-TT HH:mm:ss“. „createTime“ wird in Version 1 eingestellt. Verwenden Sie stattdessen „creationTime“.

creationTime

string

Der Zeitstempel für den Zeitpunkt, zu dem dieser Kampagne erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

lastModifiedTime

string

Der Zeitpunkt der letzten Änderung an diesem Kampagne. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

feedTypes[]

enum (AssetSetType)

Die Arten von Feeds, die direkt mit dieser Kampagne verknüpft sind.

id

string (int64 format)

Die ID der Kampagne.

name

string

Dies ist der Name der Kampagne.

Dieses Feld ist erforderlich und darf beim Erstellen neuer Kampagnen nicht leer sein.

Er darf keine Null (Codepunkt 0x0), NL-Zeilenvorschub (Codepunkt 0xA) oder Zeilenumbruchzeichen (Codepunkt 0xD) enthalten.

trackingUrlTemplate

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.

campaignBudget

string

Der Ressourcenname des Kampagnenbudgets der Kampagne.

startDate

string

Das Datum, an dem die Kampagne in der Zeitzone des Kunden gestartet wurde im Format JJJJ-MM-TT.

endDate

string

Die letzte Tag der Kampagne in der Zeitzone des Kunden im Format JJJJ-MM-TT. Beim Erstellen wird standardmäßig 2037-12-30 festgelegt, was bedeutet, dass die Kampagne unbegrenzt läuft. Wenn Sie für eine vorhandene Kampagne eine unbegrenzte Laufzeit festlegen möchten, setzen Sie dieses Feld auf 2037-12-30.

finalUrlSuffix

string

Suffix zum Anhängen von Abfrageparametern an Landingpages, die mit parallelem Tracking ausgeliefert werden.

urlExpansionOptOut

boolean

Gibt an, ob die URL-Erweiterung auf gezieltere URLs deaktiviert ist. Wenn sie deaktiviert ist (true), werden nur die finalen URLs in der Asset-Gruppe oder die URLs, die in den Google Merchant Center- oder Geschäftsdaten-Feeds des Werbetreibenden angegeben sind, als Ziel verwendet. Wenn die Option aktiviert ist („false“), wird die gesamte Domain als Ziel verwendet. Dieses Feld kann nur für Performance Max-Kampagnen festgelegt werden. Der Standardwert ist „false“.

Union-Feld campaign_bidding_strategy. Die Gebotsstrategie für die Kampagne.

Muss entweder eine Portfolio-Gebotsstrategie (über den BiddingStrategy-Dienst erstellt) oder eine Standard-Gebotsstrategie sein, die in die Kampagne eingebettet ist. Für campaign_bidding_strategy ist nur einer der folgenden Werte zulässig:

biddingStrategy

string

Der Ressourcenname der von der Kampagne verwendeten Portfolio-Gebotsstrategie.

manualCpa

object (ManualCpa)

Standardmäßige manuelle CPA-Gebotsstrategie. Manuelle Gebotsstrategie, mit der Werbetreibende das Gebot pro vom Werbetreibenden angegebener Aktion festlegen können. Wird nur für Kampagnen für lokale Dienstleistungen unterstützt.

manualCpc

object (ManualCpc)

Standardmäßige Gebotsstrategie „Manueller CPC“ Manuelle klickbasierte Gebote, bei denen der Nutzer pro Klick bezahlt.

manualCpm

object (ManualCpm)

Standardmäßige manuelle CPM-Gebotsstrategie. Manuelle gebotsbasierte Gebote, bei denen der Nutzer pro 1.000 Impressionen bezahlt.

maximizeConversions

object (MaximizeConversions)

Standard-Gebotsstrategie „Conversions maximieren“, mit der die Anzahl der Conversions automatisch maximiert wird, ohne das Budget zu überschreiten.

maximizeConversionValue

object (MaximizeConversionValue)

Standard-Gebotsstrategie „Conversion-Wert maximieren“, bei der Gebote automatisch so festgelegt werden, dass Sie mit Ihrem Budget einen möglichst hohen Umsatz erzielen.

targetCpa

object (TargetCpa)

Standard-Gebotsstrategie „Ziel-CPA“, bei der die Gebote automatisch so festgelegt werden, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen.

targetImpressionShare

object (TargetImpressionShare)

Gebotsstrategie „Angestrebter Anteil an möglichen Impressionen“ Eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass ein bestimmter Prozentsatz an Impressionen erzielt wird.

targetRoas

object (TargetRoas)

Standard-Gebotsstrategie „Ziel-ROAS“, mit der der Umsatz automatisch maximiert und gleichzeitig ein bestimmter Ziel-ROAS (Return on Advertising Spend) erzielt wird.

targetSpend

object (TargetSpend)

Standard-Gebotsstrategie „Ausgabenziel“, bei der Ihre Gebote automatisch so festgelegt werden, dass Sie mit Ihrem Budget möglichst viele Klicks erzielen.

percentCpc

object (PercentCpc)

Standard-Gebotsstrategie „Prozentualer CPC“, bei der Gebote ein Bruchteil des beworbenen Preises für ein bestimmtes Produkt oder eine bestimmte Dienstleistung sind.

targetCpm

object (TargetCpm)

Eine Gebotsstrategie, mit der der Cost-per-1000-Impressions automatisch optimiert wird.

CampaignStatus

Mögliche Status einer Kampagne.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ENABLED Die Kampagne ist aktiv und Anzeigen können ausgeliefert werden.
PAUSED Die Kampagne wurde vom Nutzer pausiert.
REMOVED Die Kampagne wurde entfernt.

CampaignServingStatus

Mögliche Auslieferungsstatus einer Kampagne.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

SERVING Bereitstellung.
NONE Keine.
ENDED Beendet.
PENDING Ausstehend.
SUSPENDED Gesperrt

BiddingStrategySystemStatus

Mögliche Systemstatus einer BiddingStrategy.

Enums
UNSPECIFIED Gibt an, dass ein unerwarteter Fehler aufgetreten ist, z. B. wenn kein Gebotsstrategietyp oder keine Statusinformationen gefunden wurden.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ENABLED Die Gebotsstrategie ist aktiv und AdWords kann keine Probleme mit der Strategie feststellen.
LEARNING_NEW Die Gebotsstrategie befindet sich in der Lernphase, weil sie vor Kurzem erstellt oder reaktiviert wurde.
LEARNING_SETTING_CHANGE Die Gebotsstrategie befindet sich aufgrund einer kürzlichen Einstellungsänderung in der Lernphase.
LEARNING_BUDGET_CHANGE Die Gebotsstrategie befindet sich aufgrund einer kürzlichen Budgetänderung in der Lernphase.
LEARNING_COMPOSITION_CHANGE Die Gebotsstrategie befindet sich in der Lernphase, weil sich die Anzahl der zugehörigen Kampagnen, Anzeigengruppen oder Keywords kürzlich geändert hat.
LEARNING_CONVERSION_TYPE_CHANGE Die Gebotsstrategie hängt von Conversion-Berichten ab und der Kunde hat kürzlich Conversion-Typen geändert, die für die Gebotsstrategie relevant waren.
LEARNING_CONVERSION_SETTING_CHANGE Die Gebotsstrategie hängt von Conversion-Berichten ab und der Kunde hat vor Kurzem seine Conversion-Einstellungen geändert.
LIMITED_BY_CPC_BID_CEILING Die Gebotsstrategie ist durch das Gebotsobergrenze eingeschränkt.
LIMITED_BY_CPC_BID_FLOOR Die Gebotsstrategie ist durch das Mindestgebot eingeschränkt.
LIMITED_BY_DATA Die Gebotsstrategie ist eingeschränkt, weil in den letzten Wochen nicht genügend Conversion-Traffic vorhanden war.
LIMITED_BY_BUDGET Ein erheblicher Teil der Keywords in dieser Gebotsstrategie ist durch das Budget eingeschränkt.
LIMITED_BY_LOW_PRIORITY_SPEND Das Ausgabenziel der Gebotsstrategie kann nicht erreicht werden, da die Ausgaben nicht priorisiert wurden.
LIMITED_BY_LOW_QUALITY Ein erheblicher Teil der Keywords in dieser Gebotsstrategie hat einen niedrigen Qualitätsfaktor.
LIMITED_BY_INVENTORY Das Budget der Gebotsstrategie kann aufgrund der eingeschränkten Ausrichtung nicht vollständig ausgegeben werden.
MISCONFIGURED_ZERO_ELIGIBILITY Conversion-Tracking (keine Pings vorhanden) und/oder Remarketing-Listen für smarte Shopping-Kampagnen fehlen.
MISCONFIGURED_CONVERSION_TYPES Die Gebotsstrategie hängt von Conversion-Berichten ab. Dem Kunden fehlen Conversion-Typen, für die Berichte zu dieser Strategie erstellt werden könnten.
MISCONFIGURED_CONVERSION_SETTINGS Die Gebotsstrategie hängt von Conversion-Berichten ab und die Conversion-Einstellungen des Kunden sind falsch konfiguriert.
MISCONFIGURED_SHARED_BUDGET Es gibt Kampagnen außerhalb der Gebotsstrategie, die Budgets mit Kampagnen teilen, die in der Strategie enthalten sind.
MISCONFIGURED_STRATEGY_TYPE Die Kampagne hat einen ungültigen Strategietyp und wird nicht ausgeliefert.
PAUSED Die Gebotsstrategie ist nicht aktiv. Entweder sind der Gebotsstrategie keine aktiven Kampagnen, Anzeigengruppen oder Keywords zugeordnet. Oder es sind keine aktiven Budgets mit der Gebotsstrategie verknüpft.
UNAVAILABLE Für diese Gebotsstrategie ist derzeit keine Statusberichterstellung möglich.
MULTIPLE_LEARNING Für diese Gebotsstrategie gab es im fraglichen Zeitraum mehrere Systemstatus vom Typ LEARNING_*.
MULTIPLE_LIMITED Für diese Gebotsstrategie gab es im fraglichen Zeitraum mehrere Systemstatus vom Typ „LIMITED_*“.
MULTIPLE_MISCONFIGURED Für diese Gebotsstrategie gab es im fraglichen Zeitraum mehrere Systemstatus MISCONFIGURED_*.
MULTIPLE Für diese Gebotsstrategie gab es im fraglichen Zeitraum mehrere Systemstatus.

AdServingOptimizationStatus

Aufzählung zur Beschreibung möglicher Auslieferungsstatus.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

OPTIMIZE Die Anzeigenbereitstellung wird anhand der CTR der Kampagne optimiert.
CONVERSION_OPTIMIZE Die Anzeigenbereitstellung wird basierend auf der Klickrate × Conversion für die Kampagne optimiert. Wenn die Kampagne nicht die Gebotsstrategie „Conversion-Optimierungstool“ verwendet, wird standardmäßig „OPTIMIZED“ festgelegt.
ROTATE Anzeigen werden 90 Tage lang gleichmäßig rotiert und dann für Klicks optimiert.
ROTATE_INDEFINITELY Anzeigen mit geringerer Leistung werden gleichmäßiger mit leistungsstärkeren Anzeigen ausgeliefert. Es findet keine Optimierung statt.
UNAVAILABLE Der Optimierungsstatus der Anzeigenbereitstellung ist nicht verfügbar.

AdvertisingChannelType

Enum, das die verschiedenen Werbekanaltypen beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
SEARCH Suchnetzwerk aus. Einschließlich Display-Kampagnen mit Bündelung und Search+-Kampagnen.
DISPLAY Nur Google Displaynetzwerk
SHOPPING Shopping-Kampagnen werden in der Shopping-Property und in den Suchergebnissen auf google.com ausgeliefert.
HOTEL Kampagnen mit Hotelanzeigen
VIDEO Videokampagnen
MULTI_CHANNEL App-Kampagnen und App-Interaktionskampagnen, die auf mehreren Kanälen laufen.
LOCAL Kampagnen mit lokalen Anzeigen.
SMART Smarte Kampagnen
PERFORMANCE_MAX Performance Max-Kampagnen
LOCAL_SERVICES Kampagnen für lokale Dienstleistungen
DISCOVERY Discovery-Kampagnen
TRAVEL Reisekampagnen.
SOCIAL Soziale Kampagnen

AdvertisingChannelSubType

Aufzählung, die die verschiedenen Kanaluntertypen beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur als Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
SEARCH_MOBILE_APP App-Kampagnen für die Suche
DISPLAY_MOBILE_APP App-Kampagnen für das Displaynetzwerk
SEARCH_EXPRESS AdWords Express-Kampagnen für die Suche
DISPLAY_EXPRESS AdWords Express-Kampagnen für das Displaynetzwerk
SHOPPING_SMART_ADS Smarte Shopping-Kampagnen
DISPLAY_GMAIL_AD Kampagnen mit Gmail-Anzeigen
DISPLAY_SMART_CAMPAIGN Smart-Displaykampagnen: Es können keine neuen Kampagnen dieses Untertyps erstellt werden.
VIDEO_OUTSTREAM Out-Stream-Videokampagnen
VIDEO_ACTION TrueView for Action-Videokampagnen.
VIDEO_NON_SKIPPABLE Videokampagnen mit nicht überspringbaren Videoanzeigen
APP_CAMPAIGN Mit App-Kampagnen lassen sich Ihre Android- oder iOS-Apps ganz einfach in den beliebtesten Google-Produkten bewerben, darunter die Google Suche, Google Play, YouTube und das Google Displaynetzwerk.
APP_CAMPAIGN_FOR_ENGAGEMENT App-Kampagne für Interaktionen, mit der Nutzer in mehreren wichtigen Google-Produkten wie der Google Suche, YouTube und dem Google Displaynetzwerk dazu angeregt werden sollen, die App wieder zu verwenden
LOCAL_CAMPAIGN Spezielle Kampagnen für lokale Werbung
SHOPPING_COMPARISON_LISTING_ADS Vergleichskampagnen für Shopping.
SMART_CAMPAIGN Standard-Smart-Kampagnen
VIDEO_SEQUENCE Videokampagnen mit Sequenz-Videoanzeigen
APP_CAMPAIGN_FOR_PRE_REGISTRATION App-Kampagne für die Vorregistrierung, die speziell für die Werbung für die Vorregistrierung für mobile Apps entwickelt wurde und auf mehrere Werbekanäle bei Google Play, YouTube und im Displaynetzwerk ausgerichtet ist.
VIDEO_REACH_TARGET_FREQUENCY Videokampagne vom Typ „Reichweite“ mit der Gebotsstrategie „Angestrebte Häufigkeit“
TRAVEL_ACTIVITIES Kampagnen für Reiseaktivitäten.
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook-Tracking nur für Kampagnen in sozialen Netzwerken

RealTimeBiddingSetting

Einstellungen für die automatische Gebotseinstellung, eine Funktion, die nur für Kampagnen verfügbar ist, die auf das Ad Exchange-Netzwerk ausgerichtet sind.

JSON-Darstellung
{
  "optIn": boolean
}
Felder
optIn

boolean

Gibt an, ob für die Kampagne Echtzeitgebote aktiviert sind.

NetworkSettings

Die Netzwerkeinstellungen für die Kampagne.

JSON-Darstellung
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
Felder
targetSearchNetwork

boolean

Gibt an, ob Anzeigen auf Partnerwebsites im Google Suchnetzwerk ausgeliefert werden (targetGoogleSearch muss ebenfalls true sein).

targetContentNetwork

boolean

Gibt an, ob Anzeigen auf bestimmten Placements im Google Displaynetzwerk bereitgestellt werden. Placements werden mit dem Placement-Kriterium angegeben.

targetPartnerSearchNetwork

boolean

Gibt an, ob Anzeigen im Google-Partnernetzwerk ausgeliefert werden. Diese Funktion ist nur für ausgewählte Google-Partnerkonten verfügbar.

DynamicSearchAdsSetting

Die Einstellung zum Steuern dynamischer Suchanzeigen.

JSON-Darstellung
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
Felder
domainName

string

Erforderlich. Der Internetdomainname, den diese Einstellung repräsentiert, z. B. „google.com“ oder „www.google.com“.

languageCode

string

Erforderlich. Der Sprachcode, der die Sprache der Domain angibt, z. B. „en“.

useSuppliedUrlsOnly

boolean

Gibt an, ob in der Kampagne ausschließlich vom Werbetreibenden bereitgestellte URLs verwendet werden.

ShoppingSetting

Die Einstellung für Shopping-Kampagnen. Hier wird festgelegt, welche Produkte in der Kampagne beworben werden können und wie diese Kampagne mit anderen Shopping-Kampagnen interagiert.

JSON-Darstellung
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
Felder
feedLabel

string

Feedlabel der Produkte, die in die Kampagne aufgenommen werden sollen. Es kann nur „feedLabel“ oder „salesCountry“ festgelegt werden. Wenn „feedLabel“ anstelle von „salesCountry“ verwendet wird, akzeptiert das Feld Ländercodes im selben Format, z. B. „XX“. „Andere“ kann ein beliebiger String sein, der für das Feedlabel im Google Merchant Center verwendet wird.

useVehicleInventory

boolean

Gibt an, ob das Targeting auf Inventar für Fahrzeugangebote erfolgen soll.

merchantId

string (int64 format)

ID des Merchant Center-Kontos. Dieses Feld ist für Erstellungsvorgänge erforderlich. Dieses Feld ist für Shopping-Kampagnen unveränderlich.

salesCountry

string

Absatzland der Produkte, die in die Kampagne aufgenommen werden sollen.

campaignPriority

integer

Priorität der Kampagne. Kampagnen mit numerisch höheren Prioritäten haben Vorrang vor Kampagnen mit niedrigeren Prioritäten. Dieses Feld ist für Shopping-Kampagnen erforderlich. Die Werte müssen zwischen 0 und 2 liegen (jeweils einschließlich). Dieses Feld ist für smarte Shopping-Kampagnen optional, muss aber bei Festlegung den Wert 3 haben.

enableLocal

boolean

Gibt an, ob lokale Produkte einbezogen werden sollen.

GeoTargetTypeSetting

Stellt eine Sammlung von Einstellungen für das geografische Targeting von Anzeigen dar.

JSON-Darstellung
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Felder
positiveGeoTargetType

enum (PositiveGeoTargetType)

Die Einstellung, die für das positive geografische Targeting in dieser Kampagne verwendet wird.

negativeGeoTargetType

enum (NegativeGeoTargetType)

Die Einstellung, die für das geografische Targeting mit Ausschluss in dieser Kampagne verwendet wird.

PositiveGeoTargetType

Die möglichen geografischen Zieltypen für die positive Ausrichtung.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
PRESENCE_OR_INTEREST Gibt an, dass eine Anzeige ausgelöst wird, wenn sich der Nutzer an den Zielorten des Werbetreibenden befindet oder Interesse an diesen Orten zeigt.
SEARCH_INTEREST Gibt an, dass eine Anzeige ausgelöst wird, wenn der Nutzer nach den Zielstandorten des Werbetreibenden sucht. Diese Funktion kann nur für Such- und Standard-Shopping-Kampagnen verwendet werden.
PRESENCE Gibt an, dass eine Anzeige ausgelöst wird, wenn sich der Nutzer in den Zielregionen des Werbetreibenden befindet oder sich dort regelmäßig aufhält.

NegativeGeoTargetType

Mögliche geografische Typen für den Ausschluss.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
PRESENCE_OR_INTEREST Gibt an, dass ein Nutzer die Anzeige nicht sieht, wenn er sich an den ausgeschlossenen Orten des Werbetreibenden befindet oder sich dafür interessiert.
PRESENCE Gibt an, dass ein Nutzer die Anzeige nicht sieht, wenn er sich an den ausgeschlossenen Standorten des Werbetreibenden befindet.

FrequencyCapEntry

Dieser Typ hat keine Felder.

Eine Regel, die die maximale Häufigkeit angibt, mit der eine Anzeige (oder eine Gruppe von Anzeigen) einem Nutzer in einem bestimmten Zeitraum präsentiert werden kann.

SelectiveOptimization

Einstellung für die selektive Optimierung für diese Kampagne, die eine Reihe von Conversion-Aktionen enthält, für die diese Kampagne optimiert werden soll. Diese Funktion gilt nur für App-Kampagnen, bei denen MULTI_CHANNEL als AdvertisingChannelType und APP_CAMPAIGN oder APP_CAMPAIGN_FOR_ENGAGEMENT als AdvertisingChannelSubType verwendet wird.

JSON-Darstellung
{
  "conversionActions": [
    string
  ]
}
Felder
conversionActions[]

string

Die ausgewählte Gruppe von Ressourcennamen für Conversion-Aktionen zur Optimierung dieser Kampagne.

OptimizationGoalSetting

Optimierungsziel für diese Kampagne, das eine Reihe von Optimierungszieltypen umfasst.

JSON-Darstellung
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Felder
optimizationGoalTypes[]

enum (OptimizationGoalType)

Die Liste der Optimierungszieltypen.

OptimizationGoalType

Der Typ des Optimierungsziels

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur als Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
CALL_CLICKS Für Anrufklicks optimieren Anruf-Click-Conversions sind die Häufigkeit, mit der Nutzer nach dem Ansehen einer Anzeige auf „Anrufen“ geklickt haben, um ein Geschäft zu kontaktieren.
DRIVING_DIRECTIONS Für Wegbeschreibungen optimieren Bei Conversions durch Wegbeschreibungen haben Nutzer nach dem Ansehen einer Anzeige die Option „Routenplaner“ ausgewählt, um eine Wegbeschreibung zu einem Geschäft aufzurufen.
APP_PRE_REGISTRATION Für die Vorregistrierung optimieren Vorregistrierungs-Conversions sind die Anzahl der Vorregistrierungen, die eine Benachrichtigung erhalten, wenn die App veröffentlicht wird.

TrackingSetting

Einstellungen auf Kampagnenebene für Tracking-Informationen

JSON-Darstellung
{
  "trackingUrl": string
}
Felder
trackingUrl

string

Die URL, die für das dynamische Tracking verwendet wird.

AssetSetType

Mögliche Typen einer Asset-Gruppe.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
PAGE_FEED Asset-Gruppe für Seiten
DYNAMIC_EDUCATION Asset-Gruppe für dynamische Anzeigen für Bildung
MERCHANT_CENTER_FEED Google Merchant Center-Asset-Gruppe.
DYNAMIC_REAL_ESTATE Asset-Gruppe für dynamische Immobilienanzeigen.
DYNAMIC_CUSTOM Dynamisches benutzerdefiniertes Asset-Set
DYNAMIC_HOTELS_AND_RENTALS Asset-Gruppe für dynamische Anzeigen für Hotels und Mietobjekte
DYNAMIC_FLIGHTS Asset-Gruppe für dynamische Anzeigen für Flüge.
DYNAMIC_TRAVEL Asset-Gruppe für dynamische Anzeigen für Reisen.
DYNAMIC_LOCAL Dynamische lokale Asset-Gruppe.
DYNAMIC_JOBS Asset-Gruppe für dynamische Anzeigen für Karriere und Beruf
LOCATION_SYNC Asset-Gruppe auf Ebene der Standortsynchronisierung.
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP Asset-Gruppe für Unternehmensprofil-Standortgruppen.
CHAIN_DYNAMIC_LOCATION_GROUP Asset-Gruppe für Standorte von Handelsketten, die sowohl für eigene Standorte als auch für Affiliate-Standorte verwendet werden kann.
STATIC_LOCATION_GROUP Statische Asset-Gruppe für Standortgruppen, die sowohl für eigene Standorte als auch für Affiliate-Standorte verwendet werden kann.
HOTEL_PROPERTY Asset-Gruppe für Hotelunterkünfte, mit der ein Feed für Hotelunterkünfte mit Performance Max-Kampagnen für die Reisebranche verknüpft wird.
TRAVEL_FEED Typ der Asset-Gruppe für Reise-Feeds. Kann entweder einen Hotelfeed oder einen Feed für Aktivitäten darstellen.

ManualCpa

Dieser Typ hat keine Felder.

Manuelle Gebotsstrategie, mit der Werbetreibende das Gebot pro vom Werbetreibenden angegebener Aktion festlegen können.

ManualCpc

Manuelle klickbasierte Gebote, bei denen der Nutzer pro Klick bezahlt.

JSON-Darstellung
{
  "enhancedCpcEnabled": boolean
}
Felder
enhancedCpcEnabled

boolean

Gibt an, ob Gebote basierend auf Daten des Conversion-Optimierungstools optimiert werden sollen.

ManualCpm

Dieser Typ hat keine Felder.

Manuelle gebotsbasierte Gebote, bei denen der Nutzer pro 1.000 Impressionen bezahlt.

PercentCpc

Eine Gebotsstrategie, bei der Gebote einen Bruchteil des beworbenen Preises für ein Produkt oder eine Dienstleistung ausmachen.

JSON-Darstellung
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Felder
cpcBidCeilingMicros

string (int64 format)

Höchstgrenze, die von der Gebotsstrategie festgelegt werden kann. Dies ist ein optionales Feld, das vom Werbetreibenden ausgefüllt wird und in lokalen Micros-Werten angegeben wird. Hinweis: Ein Nullwert wird so interpretiert, als wäre „bid_ceiling“ nicht definiert.

enhancedCpcEnabled

boolean

Passt das Gebot für jede Auktion abhängig von der Wahrscheinlichkeit einer Conversion nach oben oder unten an. Einzelne Gebote können „cpcBidCeilingMicros“ überschreiten, aber die durchschnittlichen Gebotsbeträge für eine Kampagne sollten dies nicht.

TargetCpm

Dieser Typ hat keine Felder.

„Ziel-CPM“ (Cost-per-1000-Impressions) ist eine automatisierte Gebotsstrategie, bei der Gebote so festgelegt werden, dass die Leistung bei dem von Ihnen festgelegten Ziel-CPM optimiert wird.

CampaignAsset

Eine Verknüpfung zwischen einer Kampagne und einem Asset.

JSON-Darstellung
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
Felder
resourceName

string

Der Ressourcenname des Kampagnen-Assets. Ressourcennamen von CampaignAsset haben das folgende Format:

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum (AssetLinkStatus)

Status des Kampagnen-Assets.

campaign

string

Die Kampagne, mit der das Asset verknüpft ist.

asset

string

Das Asset, das mit der Kampagne verknüpft ist.

CampaignAssetSet

CampaignAssetSet ist die Verknüpfung zwischen einer Kampagne und einer Assetgruppe. Wenn Sie eine CampaignAssetSet hinzufügen, wird eine Asset-Gruppe mit einer Kampagne verknüpft.

JSON-Darstellung
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Felder
resourceName

string

Der Ressourcenname der Asset-Gruppe der Kampagne. Ressourcennamen für Assets in Asset-Gruppen haben das folgende Format:

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

Die Kampagne, mit der dieser Asset-Satz verknüpft ist.

assetSet

string

Der Asset-Satz, der mit der Kampagne verknüpft ist.

status

enum (AssetSetLinkStatus)

Der Status des Assets der Asset-Gruppe der Kampagne. Schreibgeschützt.

CampaignAudienceView

Eine Zielgruppenansicht für Kampagnen. Enthält Leistungsdaten aus Interessen- und Remarketing-Listen für Anzeigen im Displaynetzwerk und im YouTube-Netzwerk sowie Remarketing-Listen für Suchanzeigen, die nach Kampagne und Zielgruppenkriterium zusammengefasst sind. Diese Ansicht enthält nur Zielgruppen, die auf Kampagnenebene verknüpft sind.

JSON-Darstellung
{
  "resourceName": string
}
Felder
resourceName

string

Der Ressourcenname der Kampagnenzielgruppenansicht. Ressourcennamen von Kampagnenzielgruppen-Ansichten haben das folgende Format:

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

Ein Kampagnenkriterium.

JSON-Darstellung
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
Felder
resourceName

string

Der Ressourcenname des Kampagnenkriteriums. Ressourcennamen von Kampagnenkriterien haben das folgende Format:

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

displayName

string

Der Anzeigename des Kriteriums.

Dieses Feld wird für Mutationen ignoriert.

type

enum (CriterionType)

Der Typ des Kriteriums.

status

enum (CampaignCriterionStatus)

Der Status des Kriteriums.

lastModifiedTime

string

Der Zeitpunkt der letzten Änderung an diesem Kampagnenkriterium. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

criterionId

string (int64 format)

Die ID des Kriteriums.

Dieses Feld wird während der Mutation ignoriert.

bidModifier

number

Die Anpassung der Gebote, wenn das Kriterium übereinstimmt. Die Anpassung muss im Bereich zwischen 0,1 und 10,0 liegen. Die meisten Zielkriterien unterstützen Anpassungen. Verwenden Sie 0, um einen Gerätetyp zu deaktivieren.

negative

boolean

Gibt an, ob das Kriterium ausgerichtet (false) oder ausgeschlossen (true) werden soll.

Union-Feld criterion. Das Kampagnenkriterium.

Es muss genau einer festgelegt werden. Für criterion ist nur einer der folgenden Werte zulässig:

keyword

object (KeywordInfo)

Keyword.

location

object (LocationInfo)

Standort.

device

object (DeviceInfo)

Gerät.

ageRange

object (AgeRangeInfo)

Altersgruppe.

gender

object (GenderInfo)

Gender.

userList

object (UserListInfo)

Nutzerliste.

language

object (LanguageInfo)

Sprache

webpage

object (WebpageInfo)

Webseite

locationGroup

object (LocationGroupInfo)

Standortgruppe

CampaignCriterionStatus

Die möglichen Status eines CampaignCriterion.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

ENABLED Das Kampagnenkriterium ist aktiviert.
PAUSED Das Kampagnenkriterium ist pausiert.
REMOVED Das Kampagnenkriterium wird entfernt.

LanguageInfo

Ein Sprachkriterium.

JSON-Darstellung
{
  "languageConstant": string
}
Felder
languageConstant

string

Der Ressourcenname der Sprachkonstante.

LocationGroupInfo

Ein Umkreis um eine Liste von Standorten, die über einen Feed angegeben werden.

JSON-Darstellung
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
Felder
geoTargetConstants[]

string

Konstanten für geografische Ziele, die den Umfang des geografischen Gebiets im Feed einschränken. Derzeit ist nur eine geografische Zielgruppenkonstante zulässig.

radiusUnits

enum (LocationGroupRadiusUnits)

Einheit des Radius. Für Geozielkonstanten werden Kilometer und Meter unterstützt. Für Feedartikelgruppen werden Millimeilen und Meter unterstützt. Dies ist erforderlich und muss bei CREATE-Vorgängen festgelegt werden.

feedItemSets[]

string

FeedItemSets, auf deren FeedItems die Ausrichtung erfolgt. Wenn mehrere IDs angegeben sind, werden alle Elemente, die in mindestens einem Set enthalten sind, als Zielgruppe verwendet. Dieses Feld kann nicht mit „geoTargetConstants“ verwendet werden. Dies ist optional und kann nur bei CREATE-Vorgängen festgelegt werden.

radius

string (int64 format)

Entfernung in Einheiten, die den Radius um Zielregionen angeben. Dies ist erforderlich und muss bei CREATE-Vorgängen festgelegt werden.

LocationGroupRadiusUnits

Die Einheit für die Radiusentfernung in der Standortgruppe (z. B. MILES)

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
METERS Meter
MILES Meilen
MILLI_MILES Milli Miles

CampaignEffectiveLabel

Stellt eine Beziehung zwischen einer Kampagne und einem effektiven Label dar. Ein effektives Label ist ein Label, das von dieser Kampagne übernommen oder ihr direkt zugewiesen wurde.

JSON-Darstellung
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Felder
resourceName

string

Der Name der Ressource. Ressourcennamen von CampaignEffectivelabel haben das Format: customers/{ownerCustomerId}/campaignEffectiveLabels/{campaign_id}~{label_id}

campaign

string

Die Kampagne, mit der das effektive Label verknüpft ist.

label

string

Das der Kampagne zugewiesene effektive Label.

ownerCustomerId

string (int64 format)

Die ID des Kunden, dem das effektive Label gehört.

CampaignLabel

Stellt eine Beziehung zwischen einer Kampagne und einem Label dar.

JSON-Darstellung
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Felder
resourceName

string

Der Name der Ressource. Ressourcennamen von Kampagnenlabels haben das Format customers/{ownerCustomerId}/campaignLabels/{campaign_id}~{label_id}.

campaign

string

Die Kampagne, mit der das Label verknüpft ist.

label

string

Das der Kampagne zugewiesene Label.

ownerCustomerId

string (int64 format)

Die ID des Kunden, dem das Label gehört.

CartDataSalesView

Umsatzansicht für Warenkorbdaten

JSON-Darstellung
{
  "resourceName": string
}
Felder
resourceName

string

Der Ressourcenname der Ansicht „Umsatz mit Warenkorbdaten“. Ressourcennamen von Ansichten für Verkaufsdaten aus dem Warenkorb haben das Format: customers/{customerId}/cartDataSalesView

Zielgruppe

Zielgruppen sind eine effektive Ausrichtungsoption. Dabei erstellen Sie anhand mehrerer Segmentattribute wie detaillierten demografischen Merkmalen und gemeinsamen Interessen Zielgruppen, die Teilen Ihrer Zielgruppensegmente entsprechen.

JSON-Darstellung
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
Felder
resourceName

string

Der Ressourcenname der Zielgruppe. Zielgruppennamen haben das folgende Format:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

ID der Zielgruppe.

name

string

Erforderlich. Name der Zielgruppe. Sie sollte für alle Zielgruppen eindeutig sein. Sie muss mindestens 1 und darf maximal 255 Zeichen lang sein.

description

string

Beschreibung dieser Zielgruppe.

ConversionAction

Eine Conversion-Aktion.

JSON-Darstellung
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
Felder
resourceName

string

Der Ressourcenname der Conversion-Aktion. Ressourcennamen von Conversion-Aktionen haben das folgende Format:

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

Zeitstempel der Erstellung der Floodlight-Aktivität im ISO 8601-Format.

status

enum (ConversionActionStatus)

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

type

enum (ConversionActionType)

Der Typ dieser Conversion-Aktion.

category

enum (ConversionActionCategory)

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

valueSettings

object (ValueSettings)

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

attributionModelSettings

object (AttributionModelSettings)

Einstellungen für das Attributionsmodell dieser Conversion-Aktion.

floodlightSettings

object (FloodlightSettings)

Floodlight-Einstellungen für Floodlight-Conversion-Typen.

id

string (int64 format)

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 „false“ ist, kann die Conversion-Aktion für alle Kampagnen nicht für Gebote verwendet werden, unabhängig vom Conversion-Zielvorhaben des Kunden oder der Kampagne. Bei benutzerdefinierten Conversion-Zielvorhaben wird „primaryForGoal“ jedoch nicht berücksichtigt. Wenn für eine Kampagne also ein benutzerdefiniertes Conversion-Zielvorhaben mit einer Conversion-Aktion mit „primaryForGoal“ = „false“ konfiguriert ist, ist diese Conversion-Aktion trotzdem gebotsfähig. Standardmäßig ist „primaryForGoal“ auf „true“ gesetzt, wenn kein Wert festgelegt ist. In V9 kann „primaryForGoal“ nach der Erstellung nur über einen „update“-Vorgang auf „false“ gesetzt werden, da es nicht als optional deklariert ist.

ownerCustomer

string

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

includeInClientAccountConversionsMetric

boolean

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

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.

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 einen unbekannten Wert 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 einen unbekannten Wert in dieser Version dar.
AD_CALL Conversions, die erfolgen, 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 einen Kauf in einer App über die Android-Abrechnung 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 auftreten, wenn ein Nutzer eine dynamisch generierte Telefonnummer auf der Website eines Werbetreibenden anruft.
STORE_SALES_DIRECT_UPLOAD Conversion vom Typ „Ladenverkäufe“ basierend auf selbst erhobenen oder von Drittanbietern hochgeladenen Händlerdaten. Nur Kunden auf der Zulassungsliste können die Uploadtypen für Ladenverkäufe (direkter Upload) verwenden.
STORE_SALES Conversion-Tracking für Ladenverkäufe auf Grundlage von selbst erhobenen oder von Drittanbietern hochgeladenen Händlerdaten und/oder von Käufen im Geschäft mit Karten von Zahlungsnetzwerken. Nur Kunden auf der Zulassungsliste können Arten von Ladenverkäufen verwenden. Schreibgeschützt.
FIREBASE_ANDROID_FIRST_OPEN „Erstes Öffnen“-Conversions für Android-Apps, die über Firebase erfasst werden.
FIREBASE_ANDROID_IN_APP_PURCHASE Conversion-Tracking für In-App-Käufe in Android-Apps über Firebase
FIREBASE_ANDROID_CUSTOM Benutzerdefinierte Conversions für Android-Apps, die über Firebase erfasst werden.
FIREBASE_IOS_FIRST_OPEN „first_open“-Conversions für iOS-Apps, die über Firebase erfasst werden.
FIREBASE_IOS_IN_APP_PURCHASE In-App-Käufe in 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 beim ersten Öffnen von Android-Apps, die über Drittanbieter-App-Analysetools 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 für das erste Öffnen von iOS-Apps, die über Drittanbieter-App-Analysetools erfasst werden.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversion-Tracking für In-App-Käufe in iOS-Apps über App-Analysetools von Drittanbietern
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 ein Nutzer eine mobile App im Google Play Store vorregistriert. Schreibgeschützt.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversions, bei 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 erfasst 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 aus Google-Produkten und ‑Diensten nach einer 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

Eingestellt: Die Salesforce-Integration wird eingestellt und durch eine verbesserte Methode zum Importieren von Conversions aus Salesforce ersetzt. – https://support.google.com/google-ads/answer/14728349

SEARCH_ADS_360 Conversions, die aus Search Ads 360-Floodlight-Daten importiert wurden. Schreibgeschützt.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Anruf-Conversions, die in Anzeigen von smarten Kampagnen ohne eingerichtetes Anruf-Tracking auftreten, werden anhand benutzerdefinierter Kriterien für smarte Kampagnen erfasst. Schreibgeschützt.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Der Nutzer klickt in Google Maps auf ein Anrufelement. Nur smarte Kampagnen Schreibgeschützt.
SMART_CAMPAIGN_MAP_DIRECTIONS Der Nutzer ruft in Google Maps eine Wegbeschreibung zu einem Unternehmensstandort ab. Nur smarte Kampagnen Schreibgeschützt.
SMART_CAMPAIGN_TRACKED_CALLS Anruf-Conversions, die in Anzeigen von Smart-Kampagnen mit eingerichtetem Anruf-Tracking mithilfe benutzerdefinierter Kriterien für Smart-Kampagnen erfolgen. Schreibgeschützt.
STORE_VISITS Conversions, die erfolgen, wenn ein Nutzer das Ladengeschäft eines Werbetreibenden besucht. Schreibgeschützt.
WEBPAGE_CODELESS Conversions, die aus Websiteereignissen wie Formulareinsendungen oder Seitenaufrufen erstellt werden und für die keine individuell codierten Ereignis-Snippets verwendet werden. Schreibgeschützt.
UNIVERSAL_ANALYTICS_GOAL Conversions, die aus verknüpften Universal Analytics-Zielvorhaben stammen.
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-Conversion-Ereignissen stammen.
GOOGLE_ANALYTICS_4_PURCHASE Conversions, die aus verknüpften Google Analytics 4-Kauf-Conversions stammen.

ConversionActionCategory

Die Kategorie der Conversions, die einer ConversionAction zugeordnet sind.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
DEFAULT Standardkategorie.
PAGE_VIEW Nutzer besucht eine Seite.
PURCHASE Kauf-, Verkaufs- oder „Bestellung aufgegeben“-Ereignis.
SIGNUP Nutzeraktion zur Registrierung.
LEAD Aktion zur Lead-Generierung.
DOWNLOAD Aktion zum Herunterladen von Software (z. B. einer App).
ADD_TO_CART Das Hinzufügen von Artikeln in einen Einkaufswagen auf der Website eines Werbetreibenden.
BEGIN_CHECKOUT Wenn jemand den Bezahlvorgang auf der Website eines Werbetreibenden startet.
SUBSCRIBE_PAID Der Beginn eines kostenpflichtigen Abos für ein Produkt oder eine Dienstleistung.
PHONE_CALL_LEAD Ein Anruf, um Interesse am Angebot eines Werbetreibenden zu bekunden.
IMPORTED_LEAD Eine Lead-Conversion, die aus einer externen Quelle in Google Ads importiert wurde.
SUBMIT_LEAD_FORM Ein Formular auf der Website eines Werbetreibenden wird gesendet, um Interesse an einem Unternehmen zu bekunden.
BOOK_APPOINTMENT Eine Terminbuchung bei einem Unternehmen des Werbetreibenden.
REQUEST_QUOTE Eine Anfrage für ein Angebot oder eine Preisschätzung.
GET_DIRECTIONS Eine Suche nach dem Unternehmensstandort eines Werbetreibenden mit der Absicht, ihn zu besuchen.
OUTBOUND_CLICK Ein Klick auf die Website eines Partners des Werbetreibenden.
CONTACT Ein Anruf, eine SMS, eine E‑Mail, ein Chat oder eine andere Art der Kontaktaufnahme mit einem Werbetreibenden.
ENGAGEMENT Ein Ereignis zur Website-Interaktion, z. B. eine lange Website-Zeit oder ein Smart Goal in Google Analytics (GA). Soll für GA-, Firebase- und GA Gold-Zielvorhabenimporte verwendet werden.
STORE_VISIT Ein Besuch im Ladengeschäft.
STORE_SALE Ein Verkauf in einem Ladengeschäft.
QUALIFIED_LEAD Eine Lead-Conversion, die aus einer externen Quelle in Google Ads importiert und vom Werbetreibenden (Marketing-/Vertriebsteam) weiter qualifiziert wurde. Im Prozess von der Lead-Generierung bis zum Kauf erhalten Werbetreibende Leads und reagieren darauf, indem sie sich an den Nutzer wenden. Wenn der Nutzer interessiert ist und das Produkt möglicherweise kauft, kennzeichnet der Werbetreibende solche Leads als „qualifizierte Leads“.
CONVERTED_LEAD Ein Lead mit Conversion, der aus einer externen Quelle in Google Ads importiert wurde und der eine vom Werbetreibenden für Lead-Generierung definierte Phase durchlaufen hat.

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

Der 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 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 immer der Standardwert verwendet werden soll.

alwaysUseDefaultValue

boolean

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

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)

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

AttributionModel

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

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
EXTERNAL Verwendet die externe Attribution.
GOOGLE_ADS_LAST_CLICK Der gesamte Wert einer Conversion wird dem letzten Klick zugeordnet.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Ordnet den gesamten Wert einer Conversion dem ersten Klick zu, der über die Google Suche erfolgt ist.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Ordnet den Wert einer Conversion mithilfe der Google Suche-Attribution gleichmäßig allen zugehörigen Klicks zu.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Ordnet Conversions mit exponentiell mehr Gewichtung den letzten Klicks zu (Halbwertszeit: 1 Woche).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Ordnet 40% des Werts einer Conversion dem ersten und dem 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 Flexibles Modell, bei dem mithilfe von maschinellem Lernen die angemessene Verteilung der Beiträge auf Klicks mit Google Search-Attribution ermittelt wird.

DataDrivenModelStatus

Listet die Status von datengetriebenen Modellen auf.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
AVAILABLE Das datengetriebene Modell ist verfügbar.
STALE Das datengetriebene Modell ist veraltet. Die Informationen wurden seit mindestens 7 Tagen nicht aktualisiert. Sie wird noch verwendet, läuft aber ab, wenn sie 30 Tage lang nicht aktualisiert wird.
EXPIRED Das datengetriebene Modell ist abgelaufen. Es wurde seit mindestens 30 Tagen 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 von Ereignissen stattgefunden hat.
NEVER_GENERATED Das datengetriebene Modell wurde noch nie generiert. Das liegt meistens daran, dass in keinem 30‑Tages-Zeitraum die erforderliche Anzahl von Ereignissen erreicht wurde.

FloodlightSettings

Einstellungen für eine Floodlight-Conversion-Aktion.

JSON-Darstellung
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
Felder
activityGroupTag

string

String zur Identifizierung einer Floodlight-Aktivitätsgruppe bei der Erfassung von Conversions.

activityTag

string

String zur Identifizierung einer Floodlight-Aktivität bei der Erfassung von Conversions.

activityId

string (int64 format)

ID der Floodlight-Aktivität in DoubleClick Campaign Manager (DCM).

ConversionCustomVariable

Eine benutzerdefinierte Conversion-Variable. Weitere Informationen finden Sie unter „Benutzerdefinierte Floodlight-Messwerte und -Dimensionen in der neuen Search Ads 360-Version“ unter https://support.google.com/sa360/answer/13567857.

JSON-Darstellung
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
Felder
resourceName

string

Der Ressourcenname der benutzerdefinierten Conversion-Variablen. Ressourcennamen für benutzerdefinierte Conversion-Variablen haben das folgende Format:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

Die ID der benutzerdefinierten Conversion-Variablen.

name

string

Erforderlich. Der Name der benutzerdefinierten Conversion-Variablen. Der Name muss eindeutig sein. Der Name darf maximal 100 Zeichen lang sein. Vor und nach dem Text dürfen keine zusätzlichen Leerzeichen stehen.

tag

string

Erforderlich. Das Tag der benutzerdefinierten Conversion-Variablen. Das Tag muss eindeutig sein und aus dem Buchstaben „u“ bestehen, gefolgt von einer Zahl, die kleiner oder gleich 100 ist. Beispiel: „u4“.

status

enum (ConversionCustomVariableStatus)

Der Status der benutzerdefinierten Conversion-Variablen für die Erfassung von Conversion-Ereignissen.

ownerCustomer

string

Der Ressourcenname des Kunden, dem die benutzerdefinierte Conversion-Variable gehört.

family

enum (ConversionCustomVariableFamily)

Familie der benutzerdefinierten Conversion-Variable.

cardinality

enum (ConversionCustomVariableCardinality)

Kardinalität der benutzerdefinierten Conversion-Variable.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Felder für benutzerdefinierte Variablen für Floodlight-Conversions in Search Ads 360.

customColumnIds[]

string (int64 format)

Die IDs der benutzerdefinierten Spalten, in denen diese benutzerdefinierte Conversion-Variable verwendet wird.

ConversionCustomVariableStatus

Mögliche Status einer benutzerdefinierten Conversion-Variable.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ACTIVATION_NEEDED

Die benutzerdefinierte Conversion-Variable muss noch aktiviert werden. Bis dahin werden keine Statistiken erfasst.

Dieser Status kann nicht in CREATE- und UPDATE-Anfragen verwendet werden.

ENABLED Die benutzerdefinierte Conversion-Variable ist aktiviert und es werden Statistiken erfasst.
PAUSED Die benutzerdefinierte Conversion-Variable ist pausiert. Es werden keine Statistiken erfasst, bis sie wieder auf ENABLED gesetzt wird.

ConversionCustomVariableFamily

Familie einer benutzerdefinierten Conversion-Variablen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
STANDARD Die benutzerdefinierte Standard-Conversion-Variable. Kunden müssen die Karte vor der Verwendung aktivieren.
FLOODLIGHT Die benutzerdefinierte Conversion-Variable, die aus einer benutzerdefinierten Floodlight-Variable importiert wurde.

ConversionCustomVariableCardinality

Kardinalität einer benutzerdefinierten Conversion-Variable.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
BELOW_ALL_LIMITS Die benutzerdefinierte Conversion-Variable hat eine Kardinalität, die unter allen Grenzwerten liegt. Die Variable kann für die Segmentierung verwendet werden. Wenn sie aktiviert ist, können Statistiken für neue Werte erfasst werden.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT Die benutzerdefinierte Conversion-Variable hat eine Kardinalität, die den Segmentierungsgrenzwert, aber nicht den Statistikgrenzwert überschreitet. Die Segmentierung wird deaktiviert, aber Statistiken können für neue Werte erfasst werden, wenn die Variable aktiviert ist.
APPROACHES_STATS_LIMIT Die benutzerdefinierte Conversion-Variable hat die Segmentierungslimits überschritten und nähert sich den Statistiklimits (> 90%). Die Segmentierung wird deaktiviert, aber Statistiken können für neue Werte erfasst werden, wenn die Variable aktiviert ist.
EXCEEDS_STATS_LIMIT Die benutzerdefinierte Conversion-Variable hat sowohl die Segmentierungs- als auch die Statistiklimits überschritten. Die Segmentierung wird deaktiviert und Statistiken für aktivierte Variablen können nur erfasst werden, wenn die vorhandenen Werte die Kardinalität der Variablen nicht weiter erhöhen.

FloodlightConversionCustomVariableInfo

Informationen zu benutzerdefinierten Variablen für Floodlight-Conversions in Search Ads 360.

JSON-Darstellung
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
Felder
floodlightVariableType

enum (FloodlightVariableType)

In Search Ads 360 definierter Floodlight-Variablentyp.

floodlightVariableDataType

enum (FloodlightVariableDataType)

Datentyp der Floodlight-Variable, der in Search Ads 360 definiert ist.

FloodlightVariableType

Typ der Floodlight-Variable, wie in Search Ads 360 definiert. Weitere Informationen finden Sie unter https://support.google.com/searchads/answer/4397154?hl=en.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
DIMENSION Typ der Floodlight-Variablen für Dimensionen.
METRIC Typ der Floodlight-Variablen für Messwerte.
UNSET Der Floodlight-Variablentyp ist nicht festgelegt.

FloodlightVariableDataType

Der Datentyp der Floodlight-Variable, wie in Search Ads 360 definiert. Weitere Informationen finden Sie unter https://support.google.com/searchads/answer/4397154?hl=en.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
NUMBER Stellt eine Floodlight-Variable vom Typ „Number“ dar. Diese Variable kann Floodlight-Variablen vom Typ DIMENSION oder METRIC zugewiesen werden.
STRING Stellt eine Floodlight-Variable vom Typ „String“ dar. Diese Variable kann Floodlight-Variablen vom Typ DIMENSION zugewiesen werden.

Kunde

Ein Kunde

JSON-Darstellung
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Felder
resourceName

string

Der Ressourcenname des Kunden. Kundenressourcennamen haben das folgende Format:

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

Conversion-Tracking-Einstellung für einen Kunden.

accountType

enum (AccountType)

Engine-Kontotyp, z. B. Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine-Track usw.

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

DoubleClick Campaign Manager-Einstellung (DCM) für einen Manager-Kunden.

accountStatus

enum (AccountStatus)

Kontostatus, z. B. „Aktiviert“, „Pausiert“ oder „Entfernt“

lastModifiedTime

string

Der Zeitpunkt der letzten Änderung an diesem Kunden. Das Datum und die Uhrzeit hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

engineId

string

ID des Kontos im externen Engine-Konto.

status

enum (CustomerStatus)

Der Status des Kunden.

creationTime

string

Der Zeitstempel für den Zeitpunkt, zu dem dieser Kunde erstellt wurde. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

managerId

string (int64 format)

Die Kundennummer des Verwaltungskontos. Der Wert 0 gibt an, dass der Kunde kein SA360-Verwaltungskonto hat.

managerDescriptiveName

string

Der aussagekräftige Name des Managers.

subManagerId

string (int64 format)

Die Kundennummer des untergeordneten Verwaltungskontos. Der Wert 0 gibt an, dass der Kunde kein untergeordnetes SA360-Verwaltungskonto hat.

subManagerDescriptiveName

string

Der aussagekräftige Name des untergeordneten Verwaltungskontos.

associateManagerId

string (int64 format)

Die Kundennummer des Partner-Verwaltungskontos. Der Wert 0 gibt an, dass der Kunde kein Partner-Verwaltungskonto für SA360 hat.

associateManagerDescriptiveName

string

Der aussagekräftige Name des zugehörigen Managers.

accountLevel

enum (AccountLevelType)

Die Kontoebene des Kunden: Verwaltungskonto, untergeordnetes Verwaltungskonto, Partner-Verwaltungskonto, Dienstkonto.

id

string (int64 format)

Die ID des Kunden.

descriptiveName

string

Optionaler, nicht eindeutiger beschreibender Name des Kunden.

currencyCode

string

Die Währung, in der das Konto geführt wird. Ein Teil der Währungscodes aus dem ISO 4217-Standard wird unterstützt.

timeZone

string

Die lokale Zeitzonen-ID des Kunden.

trackingUrlTemplate

string

Die URL-Vorlage zum Erstellen einer Tracking-URL aus Parametern.

finalUrlSuffix

string

Die URL-Vorlage zum Anhängen von Parametern an die finale URL.

autoTaggingEnabled

boolean

Gibt an, ob das automatische Tagging für den Kunden aktiviert ist.

manager

boolean

Gibt an, ob der Kunde ein Manager ist.

ConversionTrackingSetting

Eine Sammlung von kundenweiten Einstellungen für das Conversion-Tracking in Search Ads 360.

JSON-Darstellung
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Felder
acceptedCustomerDataTerms

boolean

Gibt an, ob der Kunde die Nutzungsbedingungen für Kundendaten akzeptiert hat. Wenn Sie kontoübergreifendes Conversion-Tracking verwenden, wird dieser Wert vom Verwaltungskonto übernommen. Dieses Feld ist schreibgeschützt. Weitere Informationen finden Sie unter https://support.google.com/adspolicy/answer/7475709.

conversionTrackingStatus

enum (ConversionTrackingStatus)

Status des Conversion-Trackings. Hier sehen Sie, ob der Kunde Conversion-Tracking verwendet und wer der Inhaber des Conversion-Trackings ist. Wenn dieser Kunde kontoübergreifendes Conversion-Tracking verwendet, hängt der zurückgegebene Wert vom login-customer-id der Anfrage ab.

enhancedConversionsForLeadsEnabled

boolean

Gibt an, ob der Kunde erweiterte Conversions für Leads aktiviert hat. Wenn Sie kontoübergreifendes Conversion-Tracking verwenden, wird dieser Wert vom Verwaltungskonto übernommen. Dieses Feld ist schreibgeschützt.

googleAdsConversionCustomer

string

Der Ressourcenname des Kunden, für den Conversions erstellt und verwaltet werden. Dieses Feld ist schreibgeschützt.

conversionTrackingId

string (int64 format)

Die für dieses Konto verwendete Conversion-Tracking-ID. Diese ID gibt nicht an, ob der Kunde Conversion-Tracking verwendet (das wird durch conversionTrackingStatus angegeben). Dieses Feld ist schreibgeschützt.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

Die Conversion-Tracking-ID des Verwaltungskontos des Kunden. Diese ID wird festgelegt, wenn der Kunde das Conversion-Tracking aktiviert hat. Sie überschreibt „conversionTrackingId“. Dieses Feld kann nur über die Google Ads-Benutzeroberfläche verwaltet werden. Dieses Feld ist schreibgeschützt.

crossAccountConversionTrackingId

string (int64 format)

Die Conversion-Tracking-ID des Verwaltungskontos des Kunden. Diese ID wird festgelegt, wenn der Kunde kontoübergreifendes Conversion-Tracking aktiviert hat. Sie überschreibt „conversionTrackingId“.

ConversionTrackingStatus

Status des Conversion-Trackings des Kunden.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
NOT_CONVERSION_TRACKED Der Kunde verwendet kein Conversion-Tracking.
CONVERSION_TRACKING_MANAGED_BY_SELF Die Conversion-Aktionen werden von diesem Kunden erstellt und verwaltet.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Die Conversion-Aktionen werden vom Verwaltungskonto erstellt und verwaltet, das im login-customer-id der Anfrage angegeben ist.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Die Conversion-Aktionen werden von einem anderen Administrator als dem im login-customer-id der Anfrage angegebenen Kunden oder Administrator erstellt und verwaltet.

AccountType

Mögliche Engine-Kontotypen

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
BAIDU Baidu-Konto
ENGINE_TRACK Konto für Suchmaschinen-Tracking
FACEBOOK Facebook-Konto
FACEBOOK_GATEWAY Facebook-Konto, das über ein Gateway verwaltet wird.
GOOGLE_ADS Google Ads-Konto.
MICROSOFT Microsoft Advertising-Konto
SEARCH_ADS_360 Search Ads 360-Verwaltungskonto
YAHOO_JAPAN Yahoo Japan-Konto.

DoubleClickCampaignManagerSetting

DoubleClick Campaign Manager-Einstellung (DCM) für einen Manager-Kunden.

JSON-Darstellung
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
Felder
advertiserId

string (int64 format)

ID des Campaign Manager-Werbetreibenden, der mit diesem Kunden verknüpft ist.

networkId

string (int64 format)

Die ID des Campaign Manager-Netzwerks, das mit diesem Kunden verknüpft ist.

timeZone

string

Die Zeitzone des Campaign Manager-Netzwerks, das diesem Kunden zugeordnet ist, im Format der IANA-Zeitzonendatenbank, z. B. „America/New_York“.

AccountStatus

Mögliche Status eines Kontos.

Enums
UNSPECIFIED Standardwert.
UNKNOWN Der Wert ist unbekannt.
ENABLED Über das Konto können Anzeigen ausgeliefert werden.
PAUSED Das Konto wurde vom Nutzer deaktiviert.
SUSPENDED Das Konto wird durch einen internen Prozess deaktiviert.
REMOVED Das Konto wurde endgültig deaktiviert.
DRAFT Das Konto wird noch eingerichtet und ist noch nicht AKTIVIERT.

CustomerStatus

Mögliche Status eines Kunden.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ENABLED Gibt an, dass das Konto aktiv ist und Anzeigen ausgeliefert werden können.
CANCELED Gibt an, dass in einem gekündigten Konto keine Anzeigen ausgeliefert werden können. Kann von einem Administrator wieder aktiviert werden.
SUSPENDED Weist auf ein gesperrtes Konto hin, in dem keine Anzeigen ausgeliefert werden können. Kann nur vom Google-Support aktiviert werden.
CLOSED Gibt ein geschlossenes Konto an, in dem keine Anzeigen ausgeliefert werden können. Das Testkonto hat dann ebenfalls den Status „GESCHLOSSEN“. Der Status ist endgültig und kann nicht wieder geöffnet werden.

AccountLevelType

Aufzählung zur Beschreibung möglicher Kontoebenen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
CLIENT_ACCOUNT_FACEBOOK Kundenkonto (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS Kundenkonto (Google Ads)
CLIENT_ACCOUNT_MICROSOFT Kundenkonto (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN Kundenkonto (Yahoo Japan)
CLIENT_ACCOUNT_ENGINE_TRACK Kundenkonto (Suchmaschinen-Tracking)
MANAGER Verwaltungskonto der obersten Ebene
SUB_MANAGER Untergeordnetes Verwaltungskonto
ASSOCIATE_MANAGER Partner-Verwaltungskonto

CustomerAsset

Eine Verknüpfung zwischen einem Kunden und einem Asset.

JSON-Darstellung
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Felder
resourceName

string

Der Ressourcenname des Kundenassets. CustomerAsset-Ressourcennamen haben das folgende Format:

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

Erforderlich. Das Asset, das mit dem Kunden verknüpft ist.

status

enum (AssetLinkStatus)

Status des Kunden-Assets.

CustomerAssetSet

CustomerAssetSet ist die Verknüpfung zwischen einem Kunden und einer Assetgruppe. Wenn Sie ein CustomerAssetSet hinzufügen, wird ein Asset-Set mit einem Kunden verknüpft.

JSON-Darstellung
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
Felder
resourceName

string

Der Ressourcenname des Kunden-Asset-Sets. Ressourcennamen für Assets in Asset-Gruppen haben das folgende Format:

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

Der Asset-Satz, der mit dem Kunden verknüpft ist.

customer

string

Der Kunde, mit dem dieser Asset-Satz verknüpft ist.

status

enum (AssetSetLinkStatus)

Der Status des Asset-Gruppen-Assets. Schreibgeschützt.

AccessibleBiddingStrategy

Stellt eine Ansicht von BiddingStrategies dar, die dem Kunden gehören und für ihn freigegeben sind.

Im Gegensatz zu BiddingStrategy enthält diese Ressource Strategien, die dem Kunden gehören, und Strategien, die von den Administratoren des Kunden erstellt und für diesen Kunden freigegeben wurden. Diese Ressource enthält keine Messwerte und nur eine begrenzte Teilmenge der BiddingStrategy-Attribute.

JSON-Darstellung
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Felder
resourceName

string

Der Ressourcenname der zugänglichen Gebotsstrategie. Ressourcennamen für AccessibleBiddingStrategy haben das folgende Format:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

Die ID der Gebotsstrategie.

name

string

Der Name der Gebotsstrategie.

type

enum (BiddingStrategyType)

Der Typ der Gebotsstrategie.

ownerCustomerId

string (int64 format)

Die ID des Kunden, dem die Gebotsstrategie gehört.

ownerDescriptiveName

string

descriptiveName des Kunden, dem die Gebotsstrategie gehört.

Union-Feld scheme. Das Gebotsschema.

Es kann nur einer festgelegt werden. Für scheme ist nur einer der folgenden Werte zulässig:

maximizeConversionValue

object (MaximizeConversionValue)

Eine automatisierte Gebotsstrategie, mit der Sie mit Ihrem Budget einen möglichst hohen Conversion-Wert in Ihren Kampagnen erzielen.

maximizeConversions

object (MaximizeConversions)

Eine automatische Gebotsstrategie, mit der Sie mit Ihrem Budget möglichst viele Conversions für Ihre Kampagnen erzielen.

targetCpa

object (TargetCpa)

Bei dieser Gebotsstrategie werden die Gebote so festgelegt, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen.

targetImpressionShare

object (TargetImpressionShare)

Eine Gebotsstrategie, bei der Gebote automatisch für einen ausgewählten Prozentsatz von Impressionen optimiert werden.

targetRoas

object (TargetRoas)

Eine Gebotsstrategie, mit der Sie den Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erzielen können.

targetSpend

object (TargetSpend)

Eine Gebotsstrategie, bei der Ihre Gebote so festgelegt werden, dass Sie mit Ihrem Budget möglichst viele Klicks erzielen.

MaximizeConversionValue

Eine automatisierte Gebotsstrategie, mit der Sie mit Ihrem Budget einen möglichst hohen Conversion-Wert in Ihren Kampagnen erzielen.

JSON-Darstellung
{
  "targetRoas": number
}
Felder
targetRoas

number

Die Option "Ziel-ROAS" (Return on Advertising Spend). Wenn diese Option festgelegt ist, maximiert die Gebotsstrategie den Umsatz, während der Ziel-ROAS gemittelt wird. Ist der Ziel-ROAS hoch, kann die Gebotsstrategie unter Umständen nicht das gesamte Budget ausgeben. Ist der Ziel-ROAS nicht festgelegt, versucht die Gebotsstrategie, den höchstmöglichen ROAS für das Budget zu erreichen.

MaximizeConversions

Eine automatische Gebotsstrategie, mit der Sie mit Ihrem Budget möglichst viele Conversions für Ihre Kampagnen erzielen.

JSON-Darstellung
{
  "targetCpa": string,
  "targetCpaMicros": string
}
Felder
targetCpa

string (int64 format)

Die Option „Ziel-CPA (Cost-per-Acquisition)“. Das ist der durchschnittliche Betrag, den Sie pro Akquisition ausgeben möchten.

targetCpaMicros

string (int64 format)

Die Option „Ziel-CPA (Cost-per-Acquisition)“. Das ist der durchschnittliche Betrag, den Sie pro Akquisition ausgeben möchten.

TargetCpa

Bei dieser automatischen Gebotsstrategie werden die Gebote so festgelegt, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen.

JSON-Darstellung
{
  "targetCpaMicros": string
}
Felder
targetCpaMicros

string (int64 format)

Durchschnittliches CPC-Ziel. Dieses Ziel muss größer oder gleich der abrechenbaren Mindesteinheit basierend auf der Währung für das Konto sein.

TargetImpressionShare

Eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass ein bestimmter Prozentsatz von Suchanzeigen oben auf der ersten Seite (oder an einem anderen Zielort) ausgeliefert wird.

JSON-Darstellung
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Felder
location

enum (TargetImpressionShareLocation)

Die Zielposition auf der Suchergebnisseite.

locationFractionMicros

string (int64 format)

Der ausgewählte Anteil der Anzeigen, die am Zielstandort ausgeliefert werden sollen, in Mikros. Beispiel: 1% entspricht 10.000.

cpcBidCeilingMicros

string (int64 format)

Das höchste CPC-Gebot, das vom automatischen Gebotssystem festgelegt werden darf. Dies ist ein Pflichtfeld, das vom Werbetreibenden ausgefüllt wird, der die Obergrenze festlegt, und das in lokalen Micros-Werten angegeben wird.

TargetRoas

Eine automatische Gebotsstrategie, mit der Sie den Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erzielen können.

JSON-Darstellung
{
  "targetRoas": number
}
Felder
targetRoas

number

Der gewählte Umsatz (basierend auf den Conversion-Daten) pro Ausgabeneinheit.

TargetSpend

Eine automatische Gebotsstrategie, bei der Ihre Gebote so festgelegt werden, dass Sie mit Ihrem Budget möglichst viele Klicks erzielen.

JSON-Darstellung
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Felder
targetSpendMicros
(deprecated)

string (int64 format)

Das Ausgabenziel, unter dem die Klicks maximiert werden sollen. Eine TargetSpend-Gebotsfunktion versucht, den kleineren Wert oder den natürlichen Drosselungsbetrag auszugeben. Wenn nicht angegeben, wird das Budget als Ausgabenziel verwendet. Dieses Feld ist veraltet und sollte nicht mehr verwendet werden. Weitere Informationen finden Sie unter https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

cpcBidCeilingMicros

string (int64 format)

Höchstgrenze, die von der Gebotsstrategie festgelegt werden kann. Der Grenzwert gilt für alle von der Strategie verwalteten Keywords.

ManagerLinkStatus

Mögliche Status einer Verknüpfung.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ACTIVE Gibt die aktuelle gültige Beziehung an
INACTIVE Gibt eine beendete Beziehung an
PENDING Gibt an, dass die Beziehung vom Administrator angefordert wurde, der Kunde sie aber noch nicht akzeptiert hat.
REFUSED Die Beziehung wurde vom Verwaltungskonto angefordert, aber der Kunde hat sie abgelehnt.
CANCELED Gibt an, dass die Beziehung vom Verwaltungskonto angefordert, aber vom Verwaltungskonto abgebrochen wurde.

CustomerClient

Eine Verknüpfung zwischen dem angegebenen Kunden und einem Kunden des Kunden. CustomerClients sind nur für Managerkonten verfügbar. Alle direkten und indirekten Kundenkonten sowie das Verwaltungskonto selbst sind enthalten.

JSON-Darstellung
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Felder
resourceName

string

Der Ressourcenname des Kundenclients. Ressourcennamen für „CustomerClient“ haben das Format customers/{customerId}/customerClients/{client_customer_id}.

appliedLabels[]

string

Die Ressourcennamen der Labels, die dem anfragenden Kunden gehören und auf den Clientkunden angewendet werden. Labelressourcennamen haben das Format:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

Der Status des Kunden des Mandanten. Schreibgeschützt.

clientCustomer

string

Der Ressourcenname des Clientkunden, der mit dem angegebenen Kunden verknüpft ist. Schreibgeschützt.

hidden

boolean

Gibt an, ob es sich um ein verborgenes Konto handelt.

Schreibgeschützt.

level

string (int64 format)

Entfernung zwischen dem angegebenen Kunden und dem Client. Bei einem Self-Link ist der Ebenenwert 0. Schreibgeschützt.

timeZone

string

Die Stringdarstellung der Zeitzone des Clients im Common Locale Data Repository (CLDR), z. B. „America/Los_Angeles“. Schreibgeschützt.

testAccount

boolean

Gibt an, ob der Kunde ein Testkonto hat. Schreibgeschützt.

manager

boolean

Gibt an, ob der Client ein Manager ist. Schreibgeschützt.

descriptiveName

string

Ein beschreibender Name für den Client. Schreibgeschützt.

currencyCode

string

Währungscode (z. B. „USD“, „EUR“) für den Kunden. Schreibgeschützt.

id

string (int64 format)

Die ID des Kunden des Kunden. Schreibgeschützt.

DynamicSearchAdsSearchTermView

Ansicht mit Suchbegriffen für dynamische Suchanzeigen

JSON-Darstellung
{
  "resourceName": string,
  "landingPage": string
}
Felder
resourceName

string

Der Ressourcenname der Ansicht „Suchbegriffe für dynamische Suchanzeigen“. Ressourcennamen von Ansichten für Suchbegriffe für dynamische Suchanzeigen haben das folgende Format:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

Die dynamisch ausgewählte Landingpage-URL der Impression.

Dieses Feld ist schreibgeschützt.

GenderView

Eine Geschlechtsansicht. Die Ressource „genderView“ spiegelt den tatsächlichen Auslieferungsstatus wider und nicht die hinzugefügten Kriterien. In einer Anzeigengruppe ohne Geschlechterkriterien werden Anzeigen standardmäßig für alle Geschlechter ausgeliefert. Daher werden alle Geschlechter in „genderView“ mit Statistiken angezeigt.

JSON-Darstellung
{
  "resourceName": string
}
Felder
resourceName

string

Der Ressourcenname der Geschlechtsansicht. Ressourcennamen von Ansichten für Geschlecht haben das Format:

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

Eine geografische Zielkonstante.

JSON-Darstellung
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
Felder
resourceName

string

Der Ressourcenname der geografischen Zielkonstante. Ressourcennamen für geografische Zielkonstanten haben das folgende Format:

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

Status der geografischen Zielkonstante.

id

string (int64 format)

Die ID der geografischen Zielkonstante.

name

string

Englischer Name der geografischen Zielkonstante.

countryCode

string

Der ISO 3166-1 Alpha-2-Ländercode, der dem Ziel zugeordnet ist.

targetType

string

Zieltyp der geografischen Zielkonstante.

canonicalName

string

Der vollständig qualifizierte englische Name, bestehend aus dem Namen des Ziels und dem Namen des übergeordneten Elements und des Landes.

parentGeoTarget

string

Der Ressourcenname der übergeordneten geografischen Zielkonstante. Ressourcennamen für geografische Zielkonstanten haben das folgende Format:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

Mögliche Status einer geografischen Zielkonstante.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.

ENABLED Die geografische Zielkonstante ist gültig.
REMOVAL_PLANNED Die geografische Zielkonstante ist veraltet und wird entfernt.

KeywordView

Eine Keyword-Ansicht.

JSON-Darstellung
{
  "resourceName": string
}
Felder
resourceName

string

Der Ressourcenname der Keyword-Ansicht. Ressourcennamen von Keyword-Ansichten haben das Format:

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

Label

Ein Label.

JSON-Darstellung
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Felder
resourceName

string

Der Name der Ressource. Labelressourcennamen haben das Format customers/{ownerCustomerId}/labels/{label_id}.

status

enum (LabelStatus)

Status des Labels. Schreibgeschützt.

textLabel

object (TextLabel)

Eine Art von Label, auf dem Text auf einem farbigen Hintergrund angezeigt wird.

id

string (int64 format)

Die ID des Labels. Schreibgeschützt.

name

string

Der Name des Labels.

Dieses Feld ist erforderlich und sollte beim Erstellen eines neuen Labels nicht leer sein.

Die Länge der Zeichenfolge muss zwischen 1 und 80 Zeichen (einschließlich) liegen.

LabelStatus

Mögliche Status eines Labels.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ENABLED Das Label ist aktiviert.
REMOVED Das Label wird entfernt.

TextLabel

Eine Art von Label, auf dem Text auf einem farbigen Hintergrund angezeigt wird.

JSON-Darstellung
{
  "backgroundColor": string,
  "description": string
}
Felder
backgroundColor

string

Hintergrundfarbe des Labels im HEX-Format. Dieser String muss dem regulären Ausdruck „^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$“ entsprechen. Hinweis: Die Hintergrundfarbe ist für Verwaltungskonten möglicherweise nicht sichtbar.

description

string

Eine kurze Beschreibung des Labels. Die Länge darf maximal 200 Zeichen betragen.

LanguageConstant

Eine Sprache.

JSON-Darstellung
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Felder
resourceName

string

Der Ressourcenname der Sprachkonstante. Ressourcennamen für Sprachkonstanten haben das folgende Format:

languageConstants/{criterionId}

id

string (int64 format)

Die ID der Sprachkonstante.

code

string

Der Sprachcode, z. B. „en_US“, „en_AU“, „es“, „fr“ usw.

name

string

Der vollständige Name der Sprache auf Englisch, z. B. „English (US)“, „Spanish“ usw.

targetable

boolean

Gibt an, ob die Sprache für das Targeting verwendet werden kann.

LocationView

In einer Standortansicht wird die Leistung von Kampagnen nach einem Standortkriterium zusammengefasst.

JSON-Darstellung
{
  "resourceName": string
}
Felder
resourceName

string

Der Ressourcenname der Standortansicht. Ressourcennamen von Standortansichten haben das Format:

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

Eine Produktgebotskategorie.

JSON-Darstellung
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Felder
resourceName

string

Der Ressourcenname der Gebotskategorie für das Produkt. Ressourcennamen für Gebotskategorien für Produkte haben das Format:

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

Ebene der Gebotskategorie des Produkts.

status

enum (ProductBiddingCategoryStatus)

Status der Gebotskategorie des Produkts.

id

string (int64 format)

ID der Gebotskategorie des Produkts.

Diese ID entspricht der ID für „google_product_category“ [Google_Produktkategorie], die in diesem Artikel beschrieben wird: https://support.google.com/merchants/answer/6324436.

countryCode

string

Ländercode der Gebotskategorie des Produkts mit zwei Großbuchstaben.

productBiddingCategoryConstantParent

string

Ressourcenname der übergeordneten Gebotskategorie für Produkte.

languageCode

string

Sprachcode der Gebotskategorie des Produkts.

localizedName

string

Anzeigewert der Gebotskategorie des Produkts, lokalisiert gemäß „languageCode“.

ProductBiddingCategoryLevel

Enum, das die Ebene der Produktgebotskategorie beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
LEVEL1 Stufe 1
LEVEL2 Stufe 2
LEVEL3 Stufe 3
LEVEL4 Stufe 4:
LEVEL5 Stufe 5

ProductBiddingCategoryStatus

Enum, das den Status der Gebotskategorie des Produkts beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ACTIVE Die Kategorie ist aktiv und kann für Gebote verwendet werden.
OBSOLETE Die Kategorie ist veraltet. Wird nur zu Berichtszwecken verwendet.

ProductGroupView

Eine Ansicht für Produktgruppen.

JSON-Darstellung
{
  "resourceName": string
}
Felder
resourceName

string

Der Ressourcenname der Ansicht für Produktgruppen. Ressourcennamen von Produktgruppen-Ansichten haben das Format:

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

Ansicht „Shoppingleistung“ Stellt Statistiken für Shopping-Kampagnen bereit, die auf verschiedenen Ebenen von Produktdimensionen zusammengefasst werden. Die Werte für Produktdimensionen aus dem Merchant Center, z. B. Marke, Kategorie, benutzerdefinierte Attribute, Produktzustand und Produkttyp, spiegeln den Status der jeweiligen Dimension zum Datum und zur Uhrzeit wider, zu der das entsprechende Ereignis aufgezeichnet wurde.

JSON-Darstellung
{
  "resourceName": string
}
Felder
resourceName

string

Der Ressourcenname der Shopping-Leistungsübersicht. Ressourcennamen von Shopping-Leistungsansichten haben das Format customers/{customerId}/shoppingPerformanceView.

UserList

Eine Nutzerliste. Das ist eine Liste von Nutzern, auf die ein Kunde ausgerichtet werden kann.

JSON-Darstellung
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
Felder
resourceName

string

Der Ressourcenname der Nutzerliste. Ressourcennamen von Nutzerlisten haben das folgende Format:

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

Typ dieser Liste.

Dieses Feld ist schreibgeschützt.

id

string (int64 format)

ID der Nutzerliste.

name

string

Name dieser Nutzerliste. Je nach access_reason ist der Name der Nutzerliste möglicherweise nicht eindeutig (z. B. wenn access_reason=SHARED).

UserListType

Enum mit möglichen Nutzerlistentypen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
REMARKETING UserList als Sammlung von Conversion-Typen.
LOGICAL UserList, die als Kombination aus anderen Nutzerlisten/Interessen dargestellt wird.
EXTERNAL_REMARKETING In der Google Ad Manager-Plattform erstellte Nutzerliste.
RULE_BASED Mit einer Regel verknüpfte UserList.
SIMILAR UserList mit Nutzern, die Nutzern einer anderen UserList ähneln.
CRM_BASED UserList: Liste mit selbst erhobenen CRM-Daten, die vom Werbetreibenden in Form von E-Mail-Adressen oder anderen Formaten bereitgestellt werden.

UserLocationView

Eine Ansicht des Nutzerstandorts.

Die Ansicht „Nutzerstandort“ enthält alle Messwerte, die auf Länderebene zusammengefasst sind. Für jedes Land gibt es eine Zeile. Er enthält Messwerte am tatsächlichen Standort des Nutzers. Die Werte beziehen sich auf Standorte, die im Targeting enthalten oder nicht enthalten sind. Wenn andere Segmentfelder verwendet werden, erhalten Sie möglicherweise mehr als eine Zeile pro Land.

JSON-Darstellung
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Felder
resourceName

string

Der Ressourcenname der Ansicht „Nutzerstandort“. Ressourcennamen von UserLocation-Ansichten haben das Format:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string (int64 format)

Kriteriums-ID für das Land.

targetingLocation

boolean

Gibt an, ob der Standort als Zielvorhaben festgelegt wurde.

WebpageView

Eine Seitenansicht.

JSON-Darstellung
{
  "resourceName": string
}
Felder
resourceName

string

Der Ressourcenname der Seitenaufruf-Ansicht. Ressourcennamen von Webseitenaufrufen haben das Format:

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

Aufrufen

Ein Besuch.

JSON-Darstellung
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Felder
resourceName

string

Der Ressourcenname des Besuchs. Besuchsressourcennamen haben das folgende Format:

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string (int64 format)

Die ID des Besuchs.

criterionId

string (int64 format)

Search Ads 360-Keyword-ID Der Wert 0 gibt an, dass das Keyword nicht zugeordnet ist.

merchantId

string (int64 format)

Die Search Ads 360-Inventarkonto-ID mit dem Produkt, auf das geklickt wurde. Diese ID wird in Search Ads 360 generiert, wenn Sie ein Inventarkonto in Search Ads 360 verknüpfen.

adId

string (int64 format)

Ad ID. Der Wert 0 gibt an, dass die Anzeige nicht zugeordnet ist.

clickId

string

Ein eindeutiger String für jeden Besuch, der als Landingpage-URL-Parameter an die Landingpage übergeben wird.

visitDateTime

string

Der Zeitstempel des Besuchsereignisses. Der Zeitstempel hat die Zeitzone des Kunden und ist im Format "JJJJ-MM-TT HH:mm:ss.ssssss".

productId

string

ID des Produkts, auf das geklickt wurde.

productChannel

enum (ProductChannel)

Der Vertriebskanal des Produkts, auf das geklickt wurde: online oder lokal.

productLanguageCode

string

Die Sprache (ISO-639-1), die für den Merchant Center-Feed festgelegt wurde, der Daten zum Produkt enthält.

productStoreId

string

Das Geschäft in der Anzeige für lokales Inventar, auf das geklickt wurde. Dieser sollte den Geschäfts-IDs entsprechen, die in Ihrem Feed mit lokal erhältlichen Produkten verwendet werden.

productCountryCode

string

Das Land (ISO-3166-Format), das für den Inventarfeed registriert ist, auf dem das Produkt angeklickt wurde.

assetId

string (int64 format)

ID des Assets, mit dem während des Besuchs interagiert wurde.

assetFieldType

enum (AssetFieldType)

Asset-Feldtyp des Besuchsereignisses.

ProductChannel

Aufzählung zur Beschreibung der Lokalität eines Produktangebots.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ONLINE Der Artikel wird online verkauft.
LOCAL Der Artikel wird in Geschäften vor Ort verkauft.

Conversion

Eine Conversion.

JSON-Darstellung
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Felder
resourceName

string

Der Ressourcenname der Conversion. Namen von Conversion-Ressourcen haben das folgende Format:

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

ID der Conversion.

criterionId

string (int64 format)

Search Ads 360-Kriteriums-ID Der Wert 0 zeigt an, dass das Kriterium nicht zugeordnet ist.

merchantId

string (int64 format)

Die Search Ads 360-Inventarkonto-ID mit dem Produkt, auf das geklickt wurde. Diese ID wird in Search Ads 360 generiert, wenn Sie ein Inventarkonto in Search Ads 360 verknüpfen.

adId

string (int64 format)

Ad ID. Der Wert 0 gibt an, dass die Anzeige nicht zugeordnet ist.

clickId

string

Ein eindeutiger String für den Besuch, dem die Conversion zugeordnet wird, und der als Landingpage-URL-Parameter an die Landingpage übergeben wird.

visitId

string (int64 format)

Die Search Ads 360-Besuchs-ID, der die Conversion zugeordnet ist.

advertiserConversionId

string

Bei Offline-Conversions ist dies eine ID, die von Werbetreibenden bereitgestellt wird. Wenn ein Werbetreibender eine solche ID nicht angibt, generiert Search Ads 360 eine. Bei Online-Conversions entspricht dies der Spalte „id“ oder der Spalte „floodlightOrderId“, je nach Floodlight-Anweisungen des Werbetreibenden.

productId

string

ID des Produkts, auf das geklickt wurde.

productChannel

enum (ProductChannel)

Der Vertriebskanal des Produkts, auf das geklickt wurde: online oder lokal.

productLanguageCode

string

Die Sprache (ISO-639-1), die für den Merchant Center-Feed festgelegt wurde, der Daten zum Produkt enthält.

productStoreId

string

Das Geschäft in der Anzeige für lokales Inventar, auf das geklickt wurde. Dieser sollte den Geschäfts-IDs entsprechen, die in Ihrem Feed mit lokal erhältlichen Produkten verwendet werden.

productCountryCode

string

Das Land (ISO-3166-Format), das für den Inventarfeed registriert ist, auf dem das Produkt angeklickt wurde.

attributionType

enum (AttributionType)

Wozu wird die Conversion zugeordnet: Besuch oder Keyword + Anzeige.

conversionDateTime

string

Der Zeitstempel des Conversion-Ereignisses.

conversionLastModifiedDateTime

string

Der Zeitstempel der letzten Änderung der Konvertierung.

conversionVisitDateTime

string

Der Zeitstempel des Besuchs, dem die Conversion zugeordnet ist.

conversionQuantity

string (int64 format)

Die Anzahl der von der Conversion aufgezeichneten Elemente, wie durch den Parameter "qty url" festgelegt. Der Werbetreibende ist dafür verantwortlich, Parameter dynamisch auszufüllen, z. B. die Anzahl der in der Conversion verkauften Artikel. Andernfalls wird standardmäßig 1 verwendet.

conversionRevenueMicros

string (int64 format)

Der angepasste Umsatz in Mikros für das Conversion-Ereignis. Der Wert wird immer in der Währung des Dienstkontos angegeben.

floodlightOriginalRevenue

string (int64 format)

Der ursprüngliche, unveränderte Umsatz, der mit dem Floodlight-Ereignis (in der Währung des aktuellen Berichts) verknüpft ist, vor der Änderung der Floodlight-Währungsanweisung.

floodlightOrderId

string

Die ID des Floodlight-Auftrags, der vom Werbetreibenden für die Conversion bereitgestellt wurde.

status

enum (ConversionStatus)

Der Status der Conversion, entweder ENABLED oder REMOVED.

assetId

string (int64 format)

ID des Assets, mit dem während des Conversion-Ereignisses interagiert wurde.

assetFieldType

enum (AssetFieldType)

Asset-Feldtyp des Conversion-Ereignisses.

AttributionType

Conversion-Attributionstyp in Search Ads 360

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
VISIT Die Conversion wird einem Besuch zugeordnet.
CRITERION_AD Die Conversion wird einem Kriterium und einem Anzeigenpaar zugeordnet.

ConversionStatus

Mögliche Status einer Conversion.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ENABLED Die Umstellung ist aktiviert.
REMOVED Die Conversion wurde entfernt.

Messwerte

Messwertdaten

JSON-Darstellung
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
Felder
allConversionsValueByConversionDate

number

Der Wert aller Conversions. Wenn diese Spalte zusammen mit „Datum“ ausgewählt wird, geben die Werte in der Spalte „Datum“ das Conversion-Datum an. Details zu den Spalten „by_conversion_date“ finden Sie unter https://support.google.com/sa360/answer/9250611.

allConversionsByConversionDate

number

Die Gesamtzahl der Conversions. Das schließt alle Conversions ein, unabhängig vom Wert von „includeInConversionsMetric“. Wenn diese Spalte zusammen mit „Datum“ ausgewählt wird, geben die Werte in der Spalte „Datum“ das Conversion-Datum an. Details zu den Spalten „by_conversion_date“ finden Sie unter https://support.google.com/sa360/answer/9250611.

conversionCustomMetrics[]

object (Value)

Die benutzerdefinierten Conversion-Messwerte.

conversionsValueByConversionDate

number

Die Summe der Werte der gebotsfähigen Conversions nach Conversion-Datum. Wenn diese Spalte zusammen mit „Datum“ ausgewählt wird, geben die Werte in der Spalte „Datum“ das Conversion-Datum an.

conversionsByConversionDate

number

Die Summe der Conversions nach Conversion-Datum für Conversion-Typen, die in Gebotsstrategien berücksichtigt werden. Kann aufgrund der Attributionsmodellierung auch ein Bruchteil sein. Wenn diese Spalte zusammen mit „Datum“ ausgewählt wird, geben die Werte in der Spalte „Datum“ das Conversion-Datum an.

historicalCreativeQualityScore

enum (QualityScoreBucket)

Der Verlauf des Qualitätsfaktors für das Creative.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

Die Qualität der bisherigen Nutzererfahrung mit der Landingpage.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

Die prognostizierte Klickrate (CTR) für die Suche aus dem Verlauf.

interactionEventTypes[]

enum (InteractionEventType)

Die Typen der kostenpflichtigen und kostenlosen Interaktionen.

rawEventConversionMetrics[]

object (Value)

Die Rohdaten-Messwerte für Conversion-Ereignisse.

absoluteTopImpressionPercentage

number

Der „Anteil an Impressionen an oberster Position im Suchnetzwerk“ ist der Prozentsatz der Impressionen für Suchanzeigen, die an der auffälligsten Position oben auf der Suchergebnisseite ausgeliefert wurden.

allConversionsFromInteractionsRate

number

Alle Conversions aus Interaktionen (im Gegensatz zu "View-through-Conversions") geteilt durch die Anzahl der Anzeigeninteraktionen.

allConversionsValue

number

Der Wert aller Conversions.

allConversions

number

Die Gesamtzahl der Conversions. Das schließt alle Conversions ein, unabhängig vom Wert von „includeInConversionsMetric“.

allConversionsValuePerCost

number

Der Wert aller Conversions geteilt durch die Gesamtkosten der Anzeigeninteraktionen, z. B. Klicks auf Textanzeigen oder Aufrufe von Videoanzeigen.

allConversionsFromClickToCall

number

Die Häufigkeit, mit der Nutzer nach dem Klicken auf eine Anzeige auf die Anrufschaltfläche geklickt haben, um ein Geschäft anzurufen. Dabei wird nicht berücksichtigt, ob die Anrufe entgegengenommen wurden. Die Anrufdauer wird ebenfalls nicht erfasst.

Dieser Messwert gilt nur für Feed-Elemente.

allConversionsFromDirections

number

Die Häufigkeit, mit der Nutzer nach dem Klicken auf eine Anzeige auf die Schaltfläche „Routenplaner“ geklickt haben, um eine Wegbeschreibung zu einem Geschäft aufzurufen.

Dieser Messwert gilt nur für Feed-Elemente.

allConversionsFromInteractionsValuePerInteraction

number

Der Wert aller Conversions aus Interaktionen geteilt durch die Gesamtzahl der Interaktionen.

allConversionsFromMenu

number

Die Häufigkeit, mit der Nutzer nach dem Klicken auf eine Anzeige auf einen Link geklickt haben, um die Speisekarte aufzurufen.

Dieser Messwert gilt nur für Feed-Elemente.

allConversionsFromOrder

number

Die Häufigkeit, mit der Nutzer bei einem Geschäft eine Bestellung aufgegeben haben, nachdem sie auf eine Anzeige geklickt haben.

Dieser Messwert gilt nur für Feed-Elemente.

allConversionsFromOtherEngagement

number

Die Anzahl anderer Conversions, nachdem Nutzer auf eine Anzeige geklickt haben (z. B. eine Rezension posten oder den Standort des Geschäfts speichern)

Dieser Messwert gilt nur für Feed-Elemente.

allConversionsFromStoreVisit

number

Die geschätzte Häufigkeit, mit der Nutzer ein Geschäft besucht haben, nachdem sie auf eine Anzeige geklickt haben.

Dieser Messwert gilt nur für Feed-Elemente.

visits

number

Klicks, die von Search Ads 360 erfolgreich erfasst und an die Landingpage eines Werbetreibenden weitergeleitet wurden.

allConversionsFromStoreWebsite

number

Die Häufigkeit, mit der Nutzer nach dem Klicken auf eine Anzeige zur URL eines Geschäfts weitergeleitet wurden.

Dieser Messwert gilt nur für Feed-Elemente.

averageCost

number

Der durchschnittliche Betrag, den Sie pro Interaktion bezahlen. Dafür werden die Gesamtkosten Ihrer Anzeigen durch die Anzahl aller Interaktionen geteilt.

averageCpc

number

Die Gesamtkosten aller Klicks geteilt durch die Gesamtzahl der erhaltenen Klicks. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

averageCpm

number

Durchschnittlicher Cost-per-1000-Impressions (CPM). Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clicks

string (int64 format)

Die Anzahl der Klicks.

contentBudgetLostImpressionShare

number

Der geschätzte Prozentsatz der Häufigkeit, in der Ihre Anzeige im Display-Netzwerk hätte angezeigt werden können. Dies geschah aber nicht, da Ihr Budget zu niedrig war. Hinweis: Der Anteil an entgangenen Impressionen im Content-Budget wird im Bereich von 0 bis 0,9 angegeben. Jeder Wert über 0,9 wird als 0,9001 angegeben.

contentImpressionShare

number

Die Anzahl von Impressionen im Displaynetzwerk, die Sie tatsächlich erzielt haben, geteilt durch die geschätzte Anzahl von Impressionen, die Sie insgesamt hätten erzielen können. Hinweis: Der Anteil an möglichen Impressionen wird im Bereich von 0,1 bis 1 angegeben. Jeder Wert unter 0,1 wird als 0,0999 angegeben.

contentRankLostImpressionShare

number

Der geschätzte Prozentsatz der Impressionen im Display-Netzwerk, die Ihre Anzeigen aufgrund eines schlechten Rankings nicht erhalten haben. Hinweis: Der Anteil an entgangenen Impressionen wird im Bereich von 0 bis 0,9 angegeben. Jeder Wert über 0,9 wird als 0,9001 angegeben.

conversionsFromInteractionsRate

number

Durchschnittliche Anzahl der gebotsfähigen Conversions (aus Interaktion) pro interaktionsbezogener Conversion. Gibt an, wie oft eine Anzeigeninteraktion im Durchschnitt zu einer gebotsfähigen Conversion führt.

clientAccountConversionsValue

number

Der Wert von Conversions für das Kundenkonto. Dies gilt nur für Conversion-Aktionen, bei denen das Attribut „includeInClientAccountConversionsMetric“ auf „true“ festgelegt ist. Wenn Sie Conversion-basierte Bidding verwenden, werden Ihre Gebotsstrategien für diese Conversions optimiert.

conversionsValuePerCost

number

Der Wert der gebotsfähigen Conversion geteilt durch die Gesamtkosten der für Conversions infrage kommenden Interaktionen.

conversionsFromInteractionsValuePerInteraction

number

Der Wert der Conversions aus Interaktionen geteilt durch die Anzahl der Anzeigeninteraktionen. Dies gilt nur für Conversion-Aktionen, bei denen das Attribut „includeInConversionsMetric“ auf „true“ festgelegt ist. Wenn Sie Conversion-basierte Bidding verwenden, werden Ihre Gebotsstrategien für diese Conversions optimiert.

clientAccountConversions

number

Die Anzahl der Conversions für das Kundenkonto. Dies gilt nur für Conversion-Aktionen, bei denen das Attribut „includeInClientAccountConversionsMetric“ auf „true“ festgelegt ist. Wenn Sie Conversion-basierte Bidding verwenden, werden Ihre Gebotsstrategien für diese Conversions optimiert.

costMicros

string (int64 format)

Die Summe aus Cost-per-Click (CPC) und Cost-per-1000-Impressions (CPM) innerhalb des ausgewählten Zeitraums. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

costPerAllConversions

number

Die Kosten für Interaktionen mit Anzeigen geteilt durch alle Conversions.

costPerConversion

number

Die durchschnittlichen Kosten pro gebotsfähiger Conversion, die für Conversions infrage kommen.

costPerCurrentModelAttributedConversion

number

Die Kosten für Anzeigeninteraktionen geteilt durch die aktuellen Conversions des Modells. Dies gilt nur für Conversion-Aktionen, bei denen das Attribut „includeInConversionsMetric“ auf „true“ festgelegt ist. Wenn Sie Conversion-basierte Bidding verwenden, werden Ihre Gebotsstrategien für diese Conversions optimiert.

crossDeviceConversions

number

Conversions, die generiert werden, wenn ein Kunde auf einem Gerät auf eine Anzeige klickt und dann auf einem anderen Gerät oder in einem anderen Browser eine Conversion durchführt. Geräteübergreifende Conversions sind bereits in „allConversions“ enthalten.

crossDeviceConversionsByConversionDate

number

Die Anzahl der geräteübergreifenden Conversions nach Conversion-Datum. Details zu den Spalten „by_conversion_date“ finden Sie unter https://support.google.com/sa360/answer/9250611.

crossDeviceConversionsValue

number

Die Summe der Werte der geräteübergreifenden Conversions.

crossDeviceConversionsValueByConversionDate

number

Die Summe der Werte der geräteübergreifenden Conversions nach Conversion-Datum. Details zu den Spalten „by_conversion_date“ finden Sie unter https://support.google.com/sa360/answer/9250611.

ctr

number

Die Anzahl der Klicks (Ihre Anzeige), die durch die Anzeige dividiert wird, geteilt durch die Anzahl der Anzeigenbereitstellungen (Impressionen).

conversions

number

Die Anzahl der Conversions. Dies gilt nur für Conversion-Aktionen, bei denen das Attribut „includeInConversionsMetric“ auf „true“ festgelegt ist. Wenn Sie Conversion-basierte Bidding verwenden, werden Ihre Gebotsstrategien für diese Conversions optimiert.

conversionsValue

number

Die Summe der Conversion-Werte für die Conversions, die im Feld „Conversions“ enthalten sind. Dieser Messwert ist nur dann aussagekräftig, wenn Sie einen Wert für Ihre Conversion-Aktionen eingegeben haben.

averageQualityScore

number

Der durchschnittliche Qualitätsfaktor.

historicalQualityScore

string (int64 format)

Der Verlauf des Qualitätsfaktors

impressions

string (int64 format)

Anzahl der Häufigkeit, mit der Ihre Anzeige auf einer Suchergebnisseite oder Website im Google-Netzwerk angezeigt wurde.

interactionRate

number

Die Häufigkeit, mit der Nutzer mit Ihrer Anzeige interagieren, nachdem sie angezeigt wurde. Dies ist die Anzahl der Interaktionen geteilt durch die Anzahl der Einblendungen Ihrer Anzeige.

interactions

string (int64 format)

Die Anzahl der Interaktionen. Eine Interaktion ist die Hauptnutzeraktion des jeweiligen Anzeigenformats, also beispielsweise Klicks auf Text- und Shopping-Anzeigen oder Aufrufe von Videoanzeigen.

invalidClickRate

number

Der Prozentsatz der Klicks, die im Berichtszeitraum aus Ihrer Gesamtzahl von Klicks (gefilterte + nicht gefilterte Klicks) herausgefiltert wurden.

invalidClicks

string (int64 format)

Anzahl der Klicks, die Google als unzulässig betrachtet und Ihnen nicht in Rechnung gestellt wird.

generalInvalidClickRate

number

Der Prozentsatz der Klicks, die aus der Gesamtzahl der Klicks (gefilterte + nicht gefilterte Klicks) herausgefiltert wurden, weil sie von Google als allgemein ungültig eingestuft wurden. Diese Klicks werden durch routinemäßige Filterverfahren erkannt (z. B. bekannte ungültige Zugriffe aus Rechenzentren, Bots, Spider oder andere Crawler, unregelmäßige Muster). Sie werden Ihnen nicht in Rechnung gestellt und wirken sich auch nicht auf Ihre Kontostatistiken aus. Weitere Informationen finden Sie auf der Hilfeseite unter https://support.google.com/campaignmanager/answer/6076504.

generalInvalidClicks

string (int64 format)

Anzahl der allgemein ungültigen Klicks. Diese Klicks sind eine Teilmenge Ihrer ungültigen Klicks, die durch routinemäßige Filterverfahren erkannt werden (z. B. bekannte ungültige Zugriffe aus Rechenzentren, Bots, Spider oder andere Crawler, unregelmäßige Muster). Sie werden Ihnen nicht in Rechnung gestellt und wirken sich auch nicht auf Ihre Kontostatistiken aus. Weitere Informationen finden Sie auf der Hilfeseite unter https://support.google.com/campaignmanager/answer/6076504.

mobileFriendlyClicksPercentage

number

Der Prozentsatz der Klicks auf Mobilgeräten, die zu einer für Mobilgeräte optimierten Seite führen.

searchAbsoluteTopImpressionShare

number

Der Prozentsatz der Shopping- oder Such-Anzeigenimpressionen des Kunden, die an der beliebtesten Shopping-Position angezeigt werden. Weitere Informationen finden Sie unter https://support.google.com/sa360/answer/9566729. Jeder Wert unter 0,1 wird als 0,0999 angegeben.

searchBudgetLostAbsoluteTopImpressionShare

number

Die Schätzung, wie oft Ihre Anzeige aufgrund eines niedrigen Budgets nicht an erster Stelle der Anzeigen oben auf der Suchergebnisseite lag. Hinweis: Der Anteil an entgangenen Impressionen an oberster Position aufgrund des Suchbudgets wird im Bereich von 0 bis 0,9 angegeben. Jeder Wert über 0,9 wird als 0,9001 angegeben.

searchBudgetLostImpressionShare

number

Der geschätzte Prozentsatz der Häufigkeit, in der Ihre Anzeige im Suchnetzwerk hätte angezeigt werden können. Dies geschah aber nicht, da Ihr Budget zu niedrig war. Hinweis: Das Suchbudget für den Anteil an entgangenen Impressionen wird im Bereich von 0 bis 0,9 angegeben. Jeder Wert über 0,9 wird als 0,9001 angegeben.

searchBudgetLostTopImpressionShare

number

Die Zahl, die angibt, wie oft Ihre Anzeige aufgrund eines niedrigen Budgets nicht direkt vor oder nach den relevantesten Ergebnissen der organischen Suche ausgeliefert wurde. Hinweis: Das Suchbudget für den Anteil an entgangenen Impressionen an oberer Position wird im Bereich von 0 bis 0,9 angegeben. Jeder Wert über 0,9 wird als 0,9001 angegeben.

searchClickShare

number

Die Anzahl der Klicks, die Sie im Suchnetzwerk erhalten haben, geteilt durch die geschätzte Anzahl der Klicks, die Sie erhalten könnten. Hinweis: Der Anteil an möglichen Klicks für die Suche wird im Bereich von 0,1 bis 1 angegeben. Jeder Wert unter 0,1 wird als 0,0999 angegeben.

searchExactMatchImpressionShare

number

Die Impressionen, die Sie erhalten haben, geteilt durch die geschätzte Anzahl von Impressionen, die Sie im Suchnetzwerk für Suchbegriffe zurückgegeben haben könnten, die genau Ihren Keywords entsprechen (oder nahe Varianten Ihres Keywords waren), unabhängig von Ihren Keyword-Optionen. Hinweis: Der Rang vom Anteil an entgangenen Impressionen an oberer Position wird im Bereich von 0,1 bis 1 angegeben. Jeder Wert unter 0,1 wird als 0,0999 angegeben.

searchImpressionShare

number

Die Anzahl von Impressionen im Suchnetzwerk, die Sie tatsächlich erzielt haben, geteilt durch die geschätzte Anzahl von Impressionen, die Sie insgesamt hätten erzielen können. Hinweis: Der Anteil an möglichen Impressionen im Suchnetzwerk wird im Bereich von 0,1 bis 1 angegeben. Jeder Wert unter 0,1 wird als 0,0999 angegeben.

searchRankLostAbsoluteTopImpressionShare

number

Die Schätzung, wie oft Ihre Anzeige aufgrund eines schlechten Anzeigenrangs nicht an erster Stelle oben auf der Suchergebnisseite ausgeliefert wurde. Hinweis: Das Suchranking des Anteils an entgangenen Impressionen an oberer Position wird im Bereich von 0 bis 0,9 angegeben. Jeder Wert über 0,9 wird als 0,9001 angegeben.

searchRankLostImpressionShare

number

Der geschätzte Prozentsatz der Impressionen im Suchnetzwerk, die Ihre Anzeigen aufgrund eines schlechten Rankings nicht erhalten haben. Hinweis: Der Rang vom Anteil an entgangenen Impressionen an oberer Position wird im Bereich von 0 bis 0,9 angegeben. Jeder Wert über 0,9 wird als 0,9001 angegeben.

searchRankLostTopImpressionShare

number

Die Schätzung, wie oft Ihre Anzeige aufgrund eines schlechten Anzeigenrangs nicht direkt vor oder nach den relevantesten Ergebnissen der organischen Suche ausgeliefert wurde. Hinweis: Der Rang vom Anteil an entgangenen Impressionen an oberer Position wird im Bereich von 0 bis 0,9 angegeben. Jeder Wert über 0,9 wird als 0,9001 angegeben.

searchTopImpressionShare

number

Die Anzahl der Impressionen, die Sie mit Anzeigen oben auf der Suchergebnisseite erzielt haben, im Vergleich zur geschätzten Anzahl der Impressionen, die Sie mit diesen Anzeigen hätten erzielen können. Hinweis: Der Anteil an möglichen Impressionen wird im Bereich von 0,1 bis 1 angegeben. Jeder Wert unter 0,1 wird als 0,0999 angegeben.

Anzeigen oben auf der Seite werden normalerweise oberhalb der relevantesten organischen Ergebnisse ausgeliefert. Bei bestimmten Suchanfragen können sie auch darunter eingeblendet werden.

topImpressionPercentage

number

Der Prozentsatz der Anzeigenimpressionen, die direkt vor oder nach den relevantesten Ergebnissen der organischen Suche ausgeliefert werden.

valuePerAllConversions

number

Der Wert aller Conversions geteilt durch die Anzahl aller Conversions.

valuePerAllConversionsByConversionDate

number

Der Wert aller Conversions geteilt durch die Anzahl aller Conversions. Wenn diese Spalte zusammen mit „Datum“ ausgewählt wird, geben die Werte in der Spalte „Datum“ das Conversion-Datum an. Details zu den Spalten „by_conversion_date“ finden Sie unter https://support.google.com/sa360/answer/9250611.

valuePerConversion

number

Der Wert der gebotsfähigen Conversions geteilt durch die Anzahl der gebotsfähigen Conversions. Gibt an, wie viel eine gebotsfähige Conversion durchschnittlich wert ist.

valuePerConversionsByConversionDate

number

Der Wert der gebotsfähigen Conversions nach Conversion-Datum geteilt durch die gebotsfähigen Conversions nach Conversion-Datum. Gibt an, wie viel jede der gebotsfähigen Conversions durchschnittlich wert ist (nach Conversion-Datum). Wenn diese Spalte zusammen mit „Datum“ ausgewählt wird, geben die Werte in der Spalte „Datum“ das Conversion-Datum an.

clientAccountViewThroughConversions

string (int64 format)

Die Gesamtzahl der View-Through-Conversions. Dies ist der Fall, wenn ein Kunde eine Bild- oder Rich Media-Anzeige sieht und später eine Conversion auf Ihrer Website durchführt, ohne mit einer anderen Anzeige zu interagieren (z. B. darauf zu klicken).

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

Die Selbstkosten für Cross-Selling-Produkte im Kundenkonto sind die Gesamtkosten der Produkte, die infolge der Werbung für ein anderes Produkt verkauft werden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn diese Produkte nicht übereinstimmen, wird das als Cross-Selling betrachtet. Selbstkosten für Cross-Selling-Produkte sind die Gesamtkosten der verkauften Produkte, die nicht beworben wurden. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Der Hut hat einen Selbstkostenpreis von 3 €, das Hemd hat einen Selbstkostenwert von 5 €. Die Selbstkosten für Cross-Selling-Produkte dieser Bestellung betragen 5 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

crossSellCostOfGoodsSoldMicros

string (int64 format)

Selbstkosten für Cross-Selling-Produkte sind die Gesamtkosten der Produkte, die infolge der Werbung für ein anderes Produkts verkauft werden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn diese Produkte nicht übereinstimmen, wird das als Cross-Selling betrachtet. Selbstkosten für Cross-Selling-Produkte sind die Gesamtkosten der verkauften Produkte, die nicht beworben wurden. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Der Hut hat einen Selbstkostenpreis von 3 €, das Hemd hat einen Selbstkostenwert von 5 €. Die Selbstkosten für Cross-Selling-Produkte dieser Bestellung betragen 5 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountCrossSellGrossProfitMicros

string (int64 format)

Der Bruttogewinn aus Cross-Selling im Kundenkonto ist der Gewinn, den Sie mit Produkten erzielen, die infolge der Werbung für ein anderes Produkt verkauft wurden, abzüglich der Selbstkosten. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Jedes in der Kaufmenge enthaltene Produkt ist ein „verkauftes Produkt“. Wenn diese Produkte nicht übereinstimmen, wird das als Cross-Selling betrachtet. Der Bruttogewinn aus Cross-Selling ist der Umsatz, den Sie durch Cross-Selling erzielt haben, und der auf Ihre Anzeigen zurückzuführen ist, abzüglich der Kosten der verkauften Produkte. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Das Hemd kostet 20 € und hat einen Selbstkostenwert von 5 €. Der Bruttogewinn aus Cross-Selling für diese Bestellung beträgt 15 € = 20 € – 5 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

crossSellGrossProfitMicros

string (int64 format)

„Bruttogewinn aus Cross-Selling“ ist der Gewinn, den Sie mit Produkten erzielen, die infolge der Werbung für ein anderes Produkt verkauft wurden, abzüglich der Selbstkosten. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Jedes in der Kaufmenge enthaltene Produkt ist ein „verkauftes Produkt“. Wenn diese Produkte nicht übereinstimmen, wird das als Cross-Selling betrachtet. Der Bruttogewinn aus Cross-Selling ist der Umsatz, den Sie durch Cross-Selling erzielt haben, und der auf Ihre Anzeigen zurückzuführen ist, abzüglich der Kosten der verkauften Produkte. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Das Hemd kostet 20 € und hat einen Selbstkostenwert von 5 €. Der Bruttogewinn aus Cross-Selling für diese Bestellung beträgt 15 € = 20 € – 5 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountCrossSellRevenueMicros

string (int64 format)

Der Cross-Selling-Umsatz des Kundenkontos ist der Gesamtbetrag, den Sie mit Produkten erzielt haben, die infolge der Werbung für ein anderes Produkt verkauft wurden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn diese Produkte nicht übereinstimmen, wird das als Cross-Selling betrachtet. Der Cross-Selling-Umsatz ist der Gesamtwert, den Sie durch Cross-Selling erzielt haben und der auf Ihre Anzeigen zurückzuführen ist. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Der Hut kostet 10 € und das Hemd 20 €. Der Cross-Selling-Umsatz dieser Bestellung beträgt 20 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

crossSellRevenueMicros

string (int64 format)

„Cross-Selling-Umsatz“ ist der Gesamtbetrag, den Sie mit Produkten erzielt haben, die infolge der Werbung für ein anderes Produkt verkauft wurden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn diese Produkte nicht übereinstimmen, wird das als Cross-Selling betrachtet. Der Cross-Selling-Umsatz ist der Gesamtwert, den Sie durch Cross-Selling erzielt haben und der auf Ihre Anzeigen zurückzuführen ist. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Der Hut kostet 10 € und das Hemd 20 €. Der Cross-Selling-Umsatz dieser Bestellung beträgt 20 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountCrossSellUnitsSold

number

„Verkaufte Stückzahl (Cross-Selling-Produkte)“ im Kundenkonto ist die Gesamtzahl der Produkte, die infolge der Werbung für ein anderes Produkt verkauft wurden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn diese Produkte nicht übereinstimmen, wird das als Cross-Selling betrachtet. „Verkaufte Stückzahl (Cross-Selling-Produkte)“ ist die Gesamtzahl der Cross-Selling-Produkte aus allen Bestellungen, die Ihren Anzeigen zugeordnet wurden. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut, ein Hemd und eine Jacke gekauft. Die verkaufte Stückzahl aus Cross-Selling in dieser Bestellung beträgt 2. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen.

crossSellUnitsSold

number

„Verkaufte Stückzahl (Cross-Selling-Produkte)“ ist die Gesamtzahl der Produkte, die infolge der Werbung für ein anderes Produkt verkauft wurden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn diese Produkte nicht übereinstimmen, wird das als Cross-Selling betrachtet. „Verkaufte Stückzahl (Cross-Selling-Produkte)“ ist die Gesamtzahl der Cross-Selling-Produkte aus allen Bestellungen, die Ihren Anzeigen zugeordnet wurden. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut, ein Hemd und eine Jacke gekauft. Die verkaufte Stückzahl aus Cross-Selling in dieser Bestellung beträgt 2. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

Die Selbstkosten für das Hauptprodukt im Kundenkonto sind die Gesamtkosten der Produkte, die infolge der Werbung für dasselbe Produkt verkauft werden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn die beworbenen und verkauften Produkte übereinstimmen, werden die Kosten dieser Waren unter den Selbstkosten für das Hauptprodukt aufgeführt. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Der Hut hat einen Selbstkostenpreis von 3 €, das Hemd hat einen Selbstkostenwert von 5 €. Die Selbstkosten für das Hauptprodukt dieser Bestellung betragen 3 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

leadCostOfGoodsSoldMicros

string (int64 format)

Die Selbstkosten für das Hauptprodukt sind die Gesamtkosten der Produkte, die infolge der Werbung für dasselbe Produkt verkauft werden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn die beworbenen und verkauften Produkte übereinstimmen, werden die Kosten dieser Waren unter den Selbstkosten für das Hauptprodukt aufgeführt. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Der Hut hat einen Selbstkostenpreis von 3 €, das Hemd hat einen Selbstkostenwert von 5 €. Die Selbstkosten für das Hauptprodukt dieser Bestellung betragen 3 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountLeadGrossProfitMicros

string (int64 format)

Der Bruttogewinn für das Hauptprodukt im Kundenkonto ist der Gewinn, den Sie mit Produkten erzielen, die infolge der Werbung für dasselbe Produkt verkauft wurden, abzüglich der Selbstkosten. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn die beworbenen und verkauften Produkte übereinstimmen, entspricht der Umsatz aus diesen Verkäufen abzüglich der Selbstkosten dem Bruttogewinn für das Hauptprodukt. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Der Hut kostet 10 € und hat einen Selbstkostenwert von 3 €. Bei dieser Bestellung entspricht der Bruttogewinn für das Hauptprodukt 7 €: 10 € - 3 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

leadGrossProfitMicros

string (int64 format)

„Bruttogewinn für Hauptprodukt“ ist der Gewinn, den Sie mit Produkten erzielen, die infolge der Werbung für dasselbe Produkt verkauft wurden, abzüglich der Selbstkosten. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn die beworbenen und verkauften Produkte übereinstimmen, entspricht der Umsatz aus diesen Verkäufen abzüglich der Selbstkosten dem Bruttogewinn für das Hauptprodukt. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Der Hut kostet 10 € und hat einen Selbstkostenwert von 3 €. Bei dieser Bestellung entspricht der Bruttogewinn für das Hauptprodukt 7 €: 10 € - 3 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountLeadRevenueMicros

string (int64 format)

Der Umsatz für Hauptprodukte im Kundenkonto ist der Gesamtbetrag, den Sie mit Produkten erzielt haben, die infolge der Werbung für dasselbe Produkt verkauft wurden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn die beworbenen und verkauften Produkte übereinstimmen, sind Gesamteinnahmen aus dem Verkauf dieser Produkte unter „Umsatz für Hauptprodukt“ aufgeführt. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Der Hut kostet 10 € und das Hemd 20 €. Der „Umsatz für Hauptprodukt“ für diese Bestellung beträgt 10 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

leadRevenueMicros

string (int64 format)

„Umsatz für Hauptprodukt“ ist der Gesamtbetrag, den Sie mit Produkten erzielt haben, die infolge der Werbung für dasselbe Produkt verkauft wurden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn die beworbenen und verkauften Produkte übereinstimmen, sind Gesamteinnahmen aus dem Verkauf dieser Produkte unter „Umsatz für Hauptprodukt“ aufgeführt. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut und ein Hemd gekauft. Der Hut kostet 10 € und das Hemd 20 €. Der „Umsatz für Hauptprodukt“ für diese Bestellung beträgt 10 €. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen. Dieser Messwert ist ein Geldwert und wird standardmäßig in der Währung des Kunden zurückgegeben. Weitere Informationen zum Parameter „metrics_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountLeadUnitsSold

number

„Verkaufte Stückzahl (Hauptprodukt)“ im Kundenkonto ist die Gesamtzahl der Produkte, die infolge der Werbung für dasselbe Produkt verkauft wurden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn die beworbenen und verkauften Produkte übereinstimmen, wird die Gesamtzahl dieser verkauften Produkte unter „Verkaufte Stückzahl (Hauptprodukt)“ aufgeführt. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut, ein Hemd und eine Jacke gekauft. Die „Verkaufte Stückzahl (Hauptprodukt)“ in dieser Bestellung beträgt dann 1. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen.

leadUnitsSold

number

„Verkaufte Stückzahl (Hauptprodukt)“ ist die Gesamtzahl der Produkte, die infolge der Werbung für dasselbe Produkt verkauft wurden. Funktionsweise: Sie erfassen Conversions mit Warenkorbdaten für abgeschlossene Käufe auf Ihrer Website. Wenn der Anzeige, mit der vor dem Kauf interagiert wurde, ein bestimmtes Produkt zugeordnet ist (siehe Shopping-Anzeigen), wird es als „beworbenes Produkt“ betrachtet. Ein Produkt, das in der Bestellung des Kunden enthalten ist, ist ein „verkauftes Produkt“. Wenn die beworbenen und verkauften Produkte übereinstimmen, wird die Gesamtzahl dieser verkauften Produkte unter „Verkaufte Stückzahl (Hauptprodukt)“ aufgeführt. Beispiel: Ein Nutzer hat auf eine Shopping-Anzeige für einen Hut geklickt und dann denselben Hut, ein Hemd und eine Jacke gekauft. Die „Verkaufte Stückzahl (Hauptprodukt)“ in dieser Bestellung beträgt dann 1. Dieser Messwert ist nur verfügbar, wenn Sie Conversions mit Warenkorbdaten erfassen.

uniqueUsers

string (int64 format)

Die Anzahl der einzelnen Nutzer, die Ihre Anzeige im angeforderten Zeitraum gesehen haben. Dieser Messwert kann nicht aggregiert werden und kann nur für Zeiträume von maximal 92 Tagen angefordert werden. Dieser Messwert ist für die folgenden Kampagnentypen verfügbar: Display-, Video-, Discovery- und App-Kampagnen.

averageImpressionFrequencyPerUser

number

Die durchschnittliche Häufigkeit, mit der ein einzelner Nutzer Ihre Anzeige im angeforderten Zeitraum gesehen hat. Dieser Messwert kann nicht aggregiert werden und kann nur für Zeiträume von maximal 92 Tagen angefordert werden. Dieser Messwert ist für die folgenden Kampagnentypen verfügbar: Display-, Video-, Discovery- und App-Kampagnen.

Wert

Ein generischer Datencontainer.

JSON-Darstellung
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Felder
Union-Feld value. Einen Wert Für value ist nur einer der folgenden Werte zulässig:
booleanValue

boolean

Boolescher Wert.

int64Value

string (int64 format)

Eine int64-Ganzzahl.

floatValue

number

Eine Gleitkommazahl.

doubleValue

number

Ein Double-Wert.

stringValue

string

Ein String.

QualityScoreBucket

Enum mit den möglichen Qualitätsfaktor-Bereichen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
BELOW_AVERAGE Die Qualität des Creatives ist unterdurchschnittlich.
AVERAGE Die Qualität des Creatives ist durchschnittlich.
ABOVE_AVERAGE Die Qualität des Creatives ist überdurchschnittlich.

InteractionEventType

Enumeration, die mögliche Arten von kostenpflichtigen und kostenlosen Interaktionen beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
CLICK Klicken Sie auf die Website. In den meisten Fällen führt diese Interaktion zu einer externen Website, in der Regel zur Landingpage des Werbetreibenden. Dies ist auch der Standardwert für „InteractionEventType“ für Klickereignisse.
ENGAGEMENT Die vom Nutzer geäußerte Absicht, mit der Anzeige zu interagieren.
VIDEO_VIEW Der Nutzer hat sich eine Videoanzeige angesehen.
NONE Der Standardwert für „InteractionEventType“ für Anzeigen-Conversion-Ereignisse. Dies wird verwendet, wenn in einer Zeile für Anzeigen-Conversions NICHT angegeben ist, dass die kostenlosen Interaktionen (z. B. die Anzeigen-Conversions) „beworben“ und als Teil der wichtigsten Messwerte erfasst werden sollen. Es handelt sich einfach um andere (Werbe-)Conversions.

Segmente

Nur Segmentfelder.

JSON-Darstellung
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Felder
adNetworkType

enum (AdNetworkType)

Der Werbenetzwerktyp.

conversionActionCategory

enum (ConversionActionCategory)

Kategorie der Conversion-Aktion.

conversionCustomDimensions[]

object (Value)

Die benutzerdefinierten Conversion-Dimensionen.

dayOfWeek

enum (DayOfWeek)

Wochentag, z. B. MONDAY.

device

enum (Device)

Das Gerät, für das Messwerte gelten.

keyword

object (Keyword)

Keyword-Kriterium.

productChannel

enum (ProductChannel)

Kanal des Produkts.

productChannelExclusivity

enum (ProductChannelExclusivity)

Kanal-Exklusivität des Produkts.

productCondition

enum (ProductCondition)

Zustand des Produkts.

productSoldCondition

enum (ProductCondition)

Zustand des verkauften Produkts.

rawEventConversionDimensions[]

object (Value)

Die Rohdaten-Conversion-Dimensionen für Ereignisse.

conversionAction

string

Ressourcenname der Conversion-Aktion.

conversionActionName

string

Name der Conversion-Aktion.

date

string

Datum, für das Messwerte gelten. JJJJ-MM-TT-Format, z. B. 2018-04-17.

geoTargetCity

string

Ressourcenname der geografischen Zielkonstante, die eine Stadt darstellt.

geoTargetCountry

string

Ressourcenname der geografischen Zielkonstante, die ein Land darstellt.

geoTargetMetro

string

Ressourcenname der Geozielkonstante, die eine Metropolregion darstellt.

geoTargetRegion

string

Ressourcenname der geografischen Zielkonstante, die eine Region darstellt.

hour

integer

Tageszeit als Zahl zwischen 0 und 23 (einschließlich).

month

string

Monat, dargestellt durch das Datum des ersten Tages eines Monats. Formatiert als JJJJ-MM-TT.

productBiddingCategoryLevel1

string

Gebotskategorie (Ebene 1) des Produkts.

productBiddingCategoryLevel2

string

Gebotskategorie (Ebene 2) des Produkts.

productBiddingCategoryLevel3

string

Gebotskategorie (Ebene 3) des Produkts.

productBiddingCategoryLevel4

string

Gebotskategorie (Ebene 4) des Produkts.

productBiddingCategoryLevel5

string

Gebotskategorie (Ebene 5) des Produkts.

productBrand

string

Marke des Produkts.

productCountry

string

Ressourcenname der geografischen Zielkonstante für das Absatzland des Produkts.

productCustomAttribute0

string

Benutzerdefiniertes Attribut 0 des Produkts.

productCustomAttribute1

string

Benutzerdefiniertes Attribut 1 des Produkts.

productCustomAttribute2

string

Benutzerdefiniertes Attribut 2 des Produkts.

productCustomAttribute3

string

Benutzerdefiniertes Attribut 3 des Produkts.

productCustomAttribute4

string

Benutzerdefiniertes Attribut 4 des Produkts.

productItemId

string

Artikel-ID des Produkts.

productLanguage

string

Ressourcenname der Sprachkonstante für die Sprache des Produkts.

productSoldBiddingCategoryLevel1

string

Gebotskategorie (Ebene 1) des verkauften Produkts.

productSoldBiddingCategoryLevel2

string

Gebotskategorie (Ebene 2) des verkauften Produkts.

productSoldBiddingCategoryLevel3

string

Gebotskategorie (Ebene 3) des verkauften Produkts.

productSoldBiddingCategoryLevel4

string

Gebotskategorie (Ebene 4) des verkauften Produkts.

productSoldBiddingCategoryLevel5

string

Gebotskategorie (Ebene 5) des verkauften Produkts.

productSoldBrand

string

Marke des verkauften Produkts.

productSoldCustomAttribute0

string

Benutzerdefiniertes Attribut 0 des verkauften Produkts.

productSoldCustomAttribute1

string

Benutzerdefiniertes Attribut 1 des verkauften Produkts.

productSoldCustomAttribute2

string

Benutzerdefiniertes Attribut 2 des verkauften Produkts.

productSoldCustomAttribute3

string

Benutzerdefiniertes Attribut 3 des verkauften Produkts.

productSoldCustomAttribute4

string

Benutzerdefiniertes Attribut 4 des verkauften Produkts.

productSoldItemId

string

Artikel-ID des verkauften Produkts.

productSoldTitle

string

Titel des verkauften Produkts.

productSoldTypeL1

string

Typ (Ebene 1) des verkauften Produkts.

productSoldTypeL2

string

Typ (Ebene 2) des verkauften Produkts.

productSoldTypeL3

string

Typ (Ebene 3) des verkauften Produkts.

productSoldTypeL4

string

Typ (Ebene 4) des verkauften Produkts.

productSoldTypeL5

string

Typ (Ebene 5) des verkauften Produkts.

productStoreId

string

Store-ID des Produkts.

productTitle

string

Titel des Produkts.

productTypeL1

string

Typ (Ebene 1) des Produkts.

productTypeL2

string

Typ (Ebene 2) des Produkts.

productTypeL3

string

Typ (Ebene 3) des Produkts.

productTypeL4

string

Typ (Ebene 4) des Produkts.

productTypeL5

string

Typ (Ebene 5) des Produkts.

quarter

string

Quartal, dargestellt durch das Datum des ersten Tages eines Quartals. Verwendet das Kalenderjahr für die Quartale, z. B. beginnt das zweite Quartal 2018 am 01.04.2018. Formatiert als JJJJ-MM-TT.

week

string

Woche, definiert als Montag bis Sonntag und dargestellt durch das Datum am Montag. Formatiert als JJJJ-MM-TT.

year

integer

Jahr im Format JJJJ.

assetInteractionTarget

object (AssetInteractionTarget)

Wird nur mit den Messwerten „CustomerAsset“, „CampaignAsset“ und „AdGroupAsset“ verwendet. Gibt an, ob die Interaktionsmesswerte für das Asset selbst oder für ein anderes Asset oder eine andere Anzeigeneinheit erfasst wurden. Interaktionen (z. B. Klicks) werden für alle Teile der ausgelieferten Anzeige (z. B. die Anzeige selbst und andere Komponenten wie Sitelinks) gezählt, wenn sie zusammen ausgeliefert werden. Wenn „interactionOnThisAsset“ auf „true“ gesetzt ist, beziehen sich die Interaktionen auf dieses bestimmte Asset. Wenn „interactionOnThisAsset“ auf „false“ gesetzt ist, beziehen sich die Interaktionen nicht auf dieses bestimmte Asset, sondern auf andere Teile der ausgelieferten Anzeige, mit der dieses Asset ausgeliefert wird.

AdNetworkType

Listet Google Ads-Netzwerktypen auf.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
SEARCH Google-Suche.
SEARCH_PARTNERS Suchnetzwerk-Partner
CONTENT Displaynetzwerk
YOUTUBE_WATCH YouTube-Videos
MIXED Netzwerkübergreifend.

Keyword

Ein Keyword-Kriterium-Segment.

JSON-Darstellung
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Felder
info

object (KeywordInfo)

Keyword-Informationen.

adGroupCriterion

string

Der AdGroupCriterion-Ressourcenname.

ProductChannelExclusivity

Aufzählung zur Beschreibung der Verfügbarkeit eines Produktangebots.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
SINGLE_CHANNEL Der Artikel wird nur über einen Kanal verkauft, entweder in Ladengeschäften oder online, wie durch den Parameter „ProductChannel“ angegeben.
MULTI_CHANNEL Der Artikel wird mit seinem Online- oder Ladengeschäft-Pendant abgeglichen. Das bedeutet, dass er in beiden ShoppingProductChannels gekauft werden kann.

ProductCondition

Enum, das den Zustand eines Produktangebots beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
OLD Der Produktzustand ist „gebraucht“.
NEW Der Zustand des Produkts ist „Neu“.
REFURBISHED Der Zustand des Produkts ist „generalüberholt“.
USED Der Zustand des Produkts ist „gebraucht“.

AssetInteractionTarget

Ein AssetInteractionTarget-Segment.

JSON-Darstellung
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Felder
asset

string

Der Ressourcenname des Assets.

interactionOnThisAsset

boolean

Wird nur mit den Messwerten „CustomerAsset“, „CampaignAsset“ und „AdGroupAsset“ verwendet. Gibt an, ob die Interaktionsmesswerte für das Asset selbst oder für ein anderes Asset oder eine andere Anzeigeneinheit erfasst wurden.