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 in der Abfrage verwiesen wird.

adGroupAd

object (AdGroupAd)

Die in der Abfrage angegebene Anzeige.

adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

Das Label der Anzeigengruppe, auf das in der Abfrage verwiesen wird.

adGroupAdLabel

object (AdGroupAdLabel)

Das Anzeigenlabel der Anzeigengruppe, auf das in der Abfrage verwiesen wird.

adGroupAsset

object (AdGroupAsset)

Das in der Abfrage referenzierte Asset der Anzeigengruppe.

adGroupAssetSet

object (AdGroupAssetSet)

Die Asset-Gruppe der Anzeigengruppe, auf die in der Abfrage verwiesen wird

adGroupAudienceView

object (AdGroupAudienceView)

Die Zielgruppenübersicht der Anzeigengruppe, auf die in der Abfrage verwiesen wird.

adGroupBidModifier

object (AdGroupBidModifier)

Die Gebotsanpassung, auf die in der Abfrage verwiesen wird.

adGroupCriterion

object (AdGroupCriterion)

Das in der Abfrage referenzierte Kriterium.

adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

Das in der Abfrage angegebene Label für das Kriterium der Anzeigengruppe.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

Das Label des Kriteriums für die Anzeigengruppe, auf das in der Abfrage verwiesen wird

adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

Das in der Abfrage angegebene Label der Anzeigengruppe.

adGroupLabel

object (AdGroupLabel)

Das in der Abfrage angegebene Anzeigengruppenlabel.

ageRangeView

object (AgeRangeView)

Die Altersgruppenansicht, auf die in der Abfrage verwiesen wird.

asset

object (Asset)

Das Asset, auf das in der Abfrage verwiesen wird

assetGroupAsset

object (AssetGroupAsset)

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

assetGroupSignal

object (AssetGroupSignal)

Das in der Abfrage angegebene Asset-Gruppensignal.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

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

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

Die Ansicht „Top-Kombination der Asset-Gruppe“, auf die in der Abfrage verwiesen wird.

assetGroup

object (AssetGroup)

Die Asset-Gruppe, auf die in der Abfrage verwiesen wird.

assetSetAsset

object (AssetSetAsset)

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

assetSet

object (AssetSet)

Die Asset-Set, auf die in der Abfrage verwiesen wird.

biddingStrategy

object (BiddingStrategy)

Die Gebotsstrategie, auf die in der Abfrage verwiesen wird.

campaignBudget

object (CampaignBudget)

Das Kampagnenbudget, auf das in der Abfrage verwiesen wird.

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 Asset-Gruppe der Kampagne, auf die in der Abfrage verwiesen wird.

campaignAudienceView

object (CampaignAudienceView)

Die Zielgruppenübersicht der Kampagne, auf die in der Abfrage verwiesen wird.

campaignCriterion

object (CampaignCriterion)

Das Kampagnenkriterium, auf das in der Abfrage verwiesen wird

campaignEffectiveLabel

object (CampaignEffectiveLabel)

Das Kampagnen-Effektiv-Label, auf das in der Abfrage verwiesen wird.

campaignLabel

object (CampaignLabel)

Das in der Abfrage angegebene Kampagnenlabel.

cartDataSalesView

object (CartDataSalesView)

Die in der Abfrage referenzierte Verkaufsdatenansicht für Warenkorbdaten.

audience

object (Audience)

Die Zielgruppe, auf die in der Abfrage verwiesen wird.

conversionAction

object (ConversionAction)

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

conversionCustomVariable

object (ConversionCustomVariable)

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

customer

object (Customer)

Der in der Abfrage referenzierte Kunde.

customerAsset

object (CustomerAsset)

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

customerAssetSet

object (CustomerAssetSet)

Die Kunden-Asset-Gruppe, auf die in der Abfrage verwiesen wird.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Die in der Abfrage angegebene Gebotsstrategie.

customerClient

object (CustomerClient)

Der in der Abfrage referenzierte CustomerClient.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

Die Suchbegriffsansicht für dynamische Suchanzeigen, auf die in der Abfrage verwiesen wird.

genderView

object (GenderView)

Die Geschlechterdatenansicht, auf die in der Abfrage verwiesen wird.

geoTargetConstant

object (GeoTargetConstant)

Die in der Abfrage referenzierte geografische Zielkonstante.

keywordView

object (KeywordView)

Die Keyword-Ansicht, auf die in der Abfrage verwiesen wird.

label

object (Label)

Das Label, auf das in der Abfrage verwiesen wird.

languageConstant

object (LanguageConstant)

Die Sprachkonstante, auf die in der Abfrage verwiesen wird.

locationView

object (LocationView)

Die Standortansicht, auf die in der Abfrage verwiesen wird.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Die in der Abfrage angegebene Produktgebotskategorie.

productGroupView

object (ProductGroupView)

Die in der Abfrage referenzierte Produktgruppenansicht.

shoppingPerformanceView

object (ShoppingPerformanceView)

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

userList

object (UserList)

Die Nutzerliste, auf die in der Abfrage verwiesen wird.

userLocationView

object (UserLocationView)

Die Standortansicht des Nutzers, auf die in der Abfrage verwiesen wird.

webpageView

object (WebpageView)

Die in der Abfrage angegebene Webseitenansicht.

visit

object (Visit)

Der Besuch auf Ereignisebene, auf den in der Abfrage verwiesen wird.

conversion

object (Conversion)

Die Conversion auf Ereignisebene, auf die in der Abfrage verwiesen wird.

metrics

object (Metrics)

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,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
Felder
resourceName

string

Der Ressourcenname der Anzeigengruppe. Ressourcennamen von Anzeigengruppen haben das 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 Labels, die dieser Anzeigengruppe zugeordnet sind. Ein effektives Label ist ein Label, das dieser Anzeigengruppe übernommen oder direkt zugewiesen wurde.

engineId

string

ID der Anzeigengruppe im externen Engine-Konto. Dieses Feld gilt nur für Konten, die nicht zu Google Ads gehören, 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. Ist dieses Feld festgelegt, 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.

cpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupEngineStatus)

Der Engine-Status der Anzeigengruppe.

AdGroupStatus

Die möglichen Status einer Anzeigengruppe.

Enums
UNSPECIFIED Der Status wurde nicht angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dieser Wert ist nur für die Antwort zulässig.

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

AdGroupType

Aufzählung der möglichen Typen einer Anzeigengruppe.

Enums
UNSPECIFIED Der Typ wurde nicht angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dieser Wert ist nur für die Antwort zulässig.

SEARCH_STANDARD Der standardmäßige Anzeigengruppentyp für Suchkampagnen.
DISPLAY_STANDARD Der standardmäßige Anzeigengruppentyp für Displaykampagnen.
SHOPPING_PRODUCT_ADS Der Anzeigengruppentyp für Shopping-Kampagnen, bei denen Standardproduktanzeigen ausgeliefert werden.
SHOPPING_SHOWCASE_ADS Der Typ für Anzeigengruppen, bei denen nur Showcase- oder Händleranzeigen in Shopping-Ergebnissen ausgeliefert werden.
HOTEL_ADS Der standardmäßige Anzeigengruppentyp 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 mit dynamischen Suchanzeigen.
SHOPPING_COMPARISON_LISTING_ADS Der Typ für Anzeigengruppen in Kampagnen mit Shopping-Vergleichslisten.
PROMOTED_HOTEL_ADS Der Anzeigengruppentyp für Anzeigengruppen in gesponserten Hotels.
VIDEO_RESPONSIVE Responsive Videoanzeigengruppen
VIDEO_EFFICIENT_REACH Anzeigengruppen vom Typ „Effiziente Reichweite“
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 Anzeigenrotationsmodus wurde nicht angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist nur eine Antwort.

OPTIMIZE Anzeigen von Anzeigengruppen basierend auf Klicks oder Conversions optimieren
ROTATE_FOREVER Gleichmäßige Anzeigenrotation für immer.

AdGroupEngineStatus

Status der Anzeigengruppen-Engine.

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

Verworfen. Nicht verwenden.

AD_GROUP_EXPIRED Für diese Anzeigengruppe werden keine Anzeigen geschaltet, da das Enddatum der Anzeigengruppe verstrichen 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 im Entwurfsstatus ist.
AD_GROUP_PAUSED Die Anzeigengruppe wurde pausiert.
AD_GROUP_SERVING Die Anzeigengruppe ist aktiv und derzeit werden Anzeigen ausgeliefert.
AD_GROUP_SUBMITTED Die Anzeigengruppe wurde eingereicht (alter Microsoft Bing Ads-Status).
CAMPAIGN_PAUSED Für diese Anzeigengruppe werden keine Anzeigen ausgeliefert, weil 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-Funktionen auf Kampagnen- und Anzeigengruppenebene Weitere Informationen zu den Targeting-Einstellungen 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 die Anzeigen auf alle Werte für diese Targeting-Dimension ausgerichtet und basierend auf Ihrem Targeting in anderen Targeting-Dimensionen ausgeliefert werden sollen. Bei einem Wert von true werden für diese Kriterien nur Gebotsanpassungen angewendet. Das Targeting bleibt davon unberührt. Ein Wert von false bedeutet, dass diese Kriterien das Targeting einschränken und Gebotsanpassungen anwenden.

TargetingDimension

Aufzählung möglicher Ausrichtungsdimensionen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
KEYWORD Keyword-Kriterien, z. B. „mars cruise“ KEYWORD kann als benutzerdefinierte Gebotsdimension verwendet werden. Keywords sind immer eine Targeting-Dimension und können daher mit TargetRestriction nicht als Zieldimension „ALL“ festgelegt werden.
AUDIENCE Zielgruppenkriterien, darunter Nutzerlisten, Nutzerinteressen, benutzerdefinierte Zielgruppen mit gemeinsamen Interessen und benutzerdefinierte kaufbereite Zielgruppen
TOPIC Themenkriterien für die Ausrichtung auf Inhaltskategorien, z. B. „category::Tiere>Haustiere“. Wird für das Display- und Video-Targeting verwendet.
GENDER Kriterien für die Ausrichtung auf Geschlechter.
AGE_RANGE Kriterien für das Targeting auf Altersgruppen.
PLACEMENT Placement-Kriterien, darunter Websites wie „www.flowers4sale.com“ sowie mobile Apps, Kategorien für mobile Apps, YouTube-Videos und YouTube-Kanäle.
PARENTAL_STATUS Kriterien für das Targeting nach Elternstatus.
INCOME_RANGE Kriterien für die Ausrichtung auf Einkommensbereich.

AdGroupAd

Eine 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 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 dieser Anzeige übernommen oder direkt zugewiesen ist.

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 Suchmaschinenkonto. 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 Anzeigengruppe.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dieser Wert ist nur für die Antwort zulässig.

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

AdType

Die möglichen Anzeigentypen.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dieser Wert ist nur für die Antwort zulässig.

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 Die Anzeige ist 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 Die Anzeige ist eine Display-Upload-Anzeige mit dem Produkttyp HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Die Anzeige ist eine Displayanzeige mit einem der Produkttypen DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Die Anzeige ist eine App-Interaktionsanzeige.
SHOPPING_COMPARISON_LISTING_AD Die Anzeige ist 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 TrueView In-Stream-Videoanzeige
VIDEO_RESPONSIVE_AD Responsive Videoanzeige
SMART_CAMPAIGN_AD Anzeige in einer smarten Kampagne
APP_PRE_REGISTRATION_AD Anzeige zur Vorregistrierung einer universellen App.
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 Anzeigentitel.

headline3

string

Der dritte Anzeigentitel.

description1

string

Die erste Zeile der Anzeigenbeschreibung.

description2

string

Die zweite Zeile der Anzeigenbeschreibung.

path1

string

Text, der der automatisch generierten sichtbaren URL mit einem Trennzeichen angehängt wird.

path2

string

Text, der path1 mit einem Trennzeichen 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 path1 mit einem Trennzeichen 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 Suchmaschinenstatus von Anzeigengruppenanzeigen auf.

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

Verworfen. Nicht verwenden.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: 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, aber auf Computern gültig.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: Das Creative kann jetzt 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, weil die Anzeigengruppe pausiert wurde.

AdGroupAdEffectiveLabel

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

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

string

Der Ressourcenname des Labels für die Effektivität der Anzeigen in der Anzeigengruppe. Ressourcennamen des effektiven Labels einer Anzeigengruppe haben das Format: customers/{customerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

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

label

string

Das gültige Label, das der Anzeigengruppe zugewiesen ist.

ownerCustomerId

string (int64 format)

Die ID des Kunden, der das effektive Label besitzt.

AdGroupAdLabel

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 für Anzeigenlabels für Anzeigengruppen haben das folgende Format: customers/{customerId}/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 für Anzeigengruppen-Assets haben folgendes 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, die die Status eines Asset-Links beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
ENABLED 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 Asset-Gruppe. Wenn Sie ein Asset-Set für Anzeigengruppen erstellen, wird es mit einer Anzeigengruppe verknüpft.

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

string

Der Ressourcenname des Asset-Sets der Anzeigengruppe. Ressourcennamen der Asset-Gruppen einer Anzeigengruppe haben folgendes Format:

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

adGroup

string

Die Anzeigengruppe, mit der dieses Asset-Set verknüpft ist.

assetSet

string

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

status

enum (AssetSetLinkStatus)

Der Status der Asset-Gruppe der Anzeigengruppe. Schreibgeschützt.

AssetSetLinkStatus

Die möglichen Status der Verknüpfung zwischen der Asset-Gruppe und ihrem Container.

Enums
UNSPECIFIED Der Status wurde nicht angegeben.
UNKNOWN Der empfangene Wert ist in dieser Version nicht bekannt. Dieser Wert ist nur für die Antwort zulässig.
ENABLED Die Verknüpfung zwischen Asset-Set und Container ist aktiviert.
REMOVED Die Verknüpfung zwischen Asset-Set und Container wird entfernt.

AdGroupAudienceView

Eine Zielgruppenansicht für eine Anzeigengruppe Enthält Leistungsdaten aus Interessen und Remarketing-Listen für Displaynetzwerk- und YouTube-Anzeigen sowie Remarketing-Listen für Suchanzeigen (RLSA), die auf Zielgruppenebene zusammengefasst sind.

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

string

Der Ressourcenname der Zielgruppenübersicht der Anzeigengruppe. Ressourcennamen von Zielgruppenansichten für Anzeigengruppen haben das Format:

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

AdGroupBidModifier

Stellt eine Gebotsanpassung für Anzeigengruppen 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 für Gebotsanpassungen für Anzeigengruppen haben folgendes 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.

Erforderlich bei Erstellungsvorgängen ab Version 5. 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 die Ausrichtung 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 Browser
DESKTOP Computer.
CONNECTED_TV Smart-TVs und Spielekonsolen
OTHER Andere Gerätetypen.

AdGroupCriterion

Ein Kriterium für Anzeigengruppen. Im Bericht „Kriterium für Anzeigengruppe“ 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
  ],
  "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 Anzeigengruppen-Kriterien haben folgendes 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 ausgeführt werden kann. 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. Auf der Benutzeroberfläche wird für jede Altersgruppe „aktiviert“ angezeigt, da sie für die Auslieferung der Anzeigen infrage kommen. Für „AdGroupCriterion.status“ wird jedoch „entfernt“ angezeigt, da kein positives 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 Labels, die diesem Anzeigengruppenkriterium zugeordnet sind. Ein effektives Label ist ein Label, das diesem Anzeigengruppenkriterium übernommen oder direkt zugewiesen wurde.

positionEstimates

object (PositionEstimates)

Schätzungen für Kriteriumsgebote an verschiedenen Positionen

finalUrls[]

string

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

engineId

string

ID des Anzeigengruppenkriteriums im externen Engine-Konto. Dieses Feld gilt nur für Konten, die nicht zu Google Ads gehören, 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 für das Targeting (false) oder das Ausschließen (true) verwendet 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 Suchmaschinenstatus für das Anzeigengruppenkriterium.

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 eine 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.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist nur eine Antwort.

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 Informationen zur Qualität von 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 möglicher Kriterientypen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen in dieser Version unbekannten Wert dar.
KEYWORD Keyword, z. B. "Marskreuzfahrt".
PLACEMENT Placement, auch als Website bezeichnet, z. B. „www.blumen4verkauf.de“
MOBILE_APP_CATEGORY Kategorien für mobile Apps, auf die Sie Ihre Anzeigen ausrichten möchten.
MOBILE_APPLICATION Mobile Apps, auf die das Targeting ausgerichtet werden soll.
DEVICE Geräte, auf die Sie das Targeting vornehmen möchten.
LOCATION Zielregionen
LISTING_GROUP Eintragsgruppen 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 Ein Themen-Targeting im Displaynetzwerk (z. B. „Haustiere und Tiere“)
LISTING_SCOPE Zu erfassender Listenumfang.
LANGUAGE Sprache
IP_BLOCK IPBlock.
CONTENT_LABEL Inhaltslabel für den Ausschluss von Kategorien.
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 Kampagne
AUDIENCE Zielgruppe
LOCAL_SERVICE_ID Die Service-ID von Google Lokale Dienstleistungen.
BRAND Marke
BRAND_LIST Markenliste
LIFE_EVENT Lebensereignis

PositionEstimates

Schätzungen für Gebote auf Grundlage von 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 in dieser Version unbekannten Wert dar.
AD_GROUP_CRITERION_ELIGIBLE

Verworfen. Nicht verwenden.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: Gebot oder Qualität 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 von Baidu überprüft. Gemini: 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 : Überprüfung des Kriteriums steht aus.
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.

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 den Wert „Unbekannt“ in dieser Version dar.
EXACT Genau passend
PHRASE Passende Wortgruppe.
BROAD Weitgehend passend:

ListingGroupInfo

Ein Kriterium für Eintragsgruppen.

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

enum (ListingGroupType)

Der Typ der Eintragsgruppe.

ListingGroupType

Der Typ der Unterkunftsgruppe.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
SUBDIVISION Unterteilung von Produkten nach einer bestimmten Eintragsdimension. Diese Knoten werden nicht zum Ausliefern von Einträgen in Listen verwendet, sondern dienen ausschließlich zur Definition der Struktur des Baums.
UNIT Eintragsgruppeneinheit, die ein Gebot definiert.

AgeRangeInfo

Ein Kriterium für die Altersgruppe.

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

enum (AgeRangeType)

Der 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 den Wert „Unbekannt“ in dieser Version dar.
AGE_RANGE_18_24 Zwischen 18 und 24 Jahre alt.
AGE_RANGE_25_34 zwischen 25 und 34 Jahren alt.
AGE_RANGE_35_44 Zwischen 35 und 44 Jahre.
AGE_RANGE_45_54 Zwischen 45 und 54 Jahren.
AGE_RANGE_55_64 Zwischen 55 und 64 Jahren.
AGE_RANGE_65_UP 65 Jahre oder älter.
AGE_RANGE_UNDETERMINED Unbestimmte Altersgruppe.

GenderInfo

Ein Geschlechtskriterium.

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

enum (GenderType)

Typ des Geschlechts.

GenderType

Die Art des demografischen Geschlechts (z. B. weiblich).

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

UserListInfo

Ein Nutzerlistenkriterium. Stellt eine Nutzerliste dar, die vom Werbetreibenden für die Ausrichtung definiert wird.

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

string

Der Name der Nutzerlistenressource.

WebpageInfo

Stellt ein Kriterium für die Ausrichtung auf 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 dieser Art von Parametern 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 einer Werbetreibenden-Website.

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 Webseiten-Targeting.

WebpageConditionOperand

Der Operand der Webseitenbedingung im Webseitenkriterium.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
URL Operand, der eine Ausrichtungsbedingung für die URL einer Webseite angibt.
CATEGORY Operand, der eine Ausrichtungsbedingung für Webseitenkategorien angibt.
PAGE_TITLE Operand, der eine Bedingung für das Targeting auf den Titel einer Webseite angibt.
PAGE_CONTENT Operand, der eine Bedingung für das Targeting auf Webseiteninhalte angibt.
CUSTOM_LABEL Operand, der eine Bedingung für das Targeting auf benutzerdefinierte Labels auf Webseiten angibt.

WebpageConditionOperator

Der Bedingungsoperator für Webseiten im Webseitenkriterium.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
EQUALS Das Argument "Webbedingung" ist mit der verglichenen Webbedingung identisch.
CONTAINS Die Webbedingung für das Argument 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 wirkungsvollen Label. Ein effektives Label ist ein Label, das diesem Anzeigengruppenkriterium übernommen oder direkt zugewiesen ist.

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

string

Der Ressourcenname des Labels für das effektive Anzeigengruppenkriterium. Ressourcennamen des effektiven Labels für Anzeigengruppenkriterien haben folgendes Format: customers/{customerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

Das Anzeigengruppenkriterium, dem das effektive Label zugeordnet ist.

label

string

Das effektive Label, das dem Gruppenkriterium zugewiesen ist.

ownerCustomerId

string (int64 format)

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

AdGroupCriterionLabel

Eine Beziehung zwischen einem Anzeigengruppenkriterium 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/{customerId}/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

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

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

string

Der Ressourcenname des für die Anzeigengruppe geltenden Labels. Anzeigengruppen-effektive Label-Ressourcennamen haben folgendes Format: customers/{customerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

adGroup

string

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

label

string

Das gültige Label, das der Anzeigengruppe zugewiesen ist.

ownerCustomerId

string (int64 format)

Die ID des Kunden, der das effektive Label besitzt.

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 Anzeigengruppen-Labels haben das Format customers/{customerId}/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 nach Altersgruppe.

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

string

Der Ressourcenname der Ansicht für Altersgruppen. Ressourcennamen von Ansichten nach Altersgruppe haben das Format:

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

Asset

Ein Asset ist ein Teil einer Anzeige, der für mehrere Anzeigen verwendet werden kann. Es kann sich beispielsweise um ein Bild (ImageAsset) oder ein Video (YoutubeVideoAsset) handeln. Assets sind unveränderlich und können nicht entfernt werden. Wenn ein Asset nicht mehr ausgeliefert werden soll, entfernen Sie es aus der Entität, die es verwendet.

JSON-Darstellung
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": 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 folgendes 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.

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.

engineStatus

enum (AssetEngineStatus)

Der Engine-Status eines Assets.

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)

Ein einheitliches Asset mit Zusatzinformationen.

pageFeedAsset

object (UnifiedPageFeedAsset)

Ein einheitliches Seitenfeed-Asset.

mobileAppAsset

object (MobileAppAsset)

Ein Asset für eine mobile App.

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 möglicher Asset-Typen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ 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 Reisebranche
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. Dieser Wert ist nur für die Antwort zulässig.
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 wartet auf die Überprüfung durch Nutzer.

AssetEngineStatus

Nächste ID = 11

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ 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. Dies ist der Stringwert mit 11 Zeichen, 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)

Dateigröße des Bild-Assets in Byte.

MimeType

MIME-Typ

Enums
UNSPECIFIED Der MIME-Typ wurde nicht angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dieser Wert ist nur für die Antwort zulässig.

IMAGE_JPEG MIME-Typ „image/jpeg“.
IMAGE_GIF MIME-Typ für image/gif.
IMAGE_PNG MIME-Typ von Bild/PNG.
FLASH MIME-Typ für application/x-shockwave-flash.
TEXT_HTML MIME-Typ „text/html“.
PDF MIME-Typ „application/pdf“.
MSWORD MIME-Typ „application/msword“.
MSEXCEL MIME-Typ „application/vnd.ms-excel“.
RTF MIME-Typ „application/rtf“.
AUDIO_WAV MIME-Typ von audio/wav.
AUDIO_MP3 MIME-Typ „audio/mp3“.
HTML5_AD_ZIP MIME-Typ „application/x-html5-ad-zip“.

ImageDimension

Metadaten für ein Bild in einer bestimmten Größe, entweder in Originalgröße oder in einer anderen 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, unter der das Bild mit dieser Höhe und Breite zurückgegeben wird.

TextAsset

Ein Text-Asset.

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

string

Textinhalt des Text-Assets.

UnifiedCalloutAsset

Ein 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

Startdatum im Format JJJJ-MM-TT, ab dem dieses Asset aktiv ist und mit der Auslieferung beginnen kann.

endDate

string

Das Datum, an dem dieses Asset zuletzt gültig war und noch ausgeliefert wurde, im Format JJJJ-MM-TT.

adScheduleTargets[]

object (AdScheduleInfo)

Liste nicht überschneidender Zeitpläne, in denen alle Zeitintervalle angegeben sind, in denen das Asset ausgeliefert werden kann. Pro Tag sind maximal 6 Zeitpläne möglich, insgesamt 42.

useSearcherTimeZone

boolean

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

AdScheduleInfo

Ein AdSchedule-Kriterium.

„Anzeigenplan“ wird als Wochentag und Zeitintervall angegeben, innerhalb dessen Anzeigen ausgeliefert werden.

Für denselben Tag können nicht mehr als sechs Anzeigenzeitpläne 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 Zeitspanne schließt die Endminute nicht ein.

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

dayOfWeek

enum (DayOfWeek)

Wochentag, für den der Planer gilt.

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

startHour

integer

Startzeit im 24-Stunden-Format. Der Wert für dieses Feld muss zwischen 0 und 23 liegen.

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

endHour

integer

Endzeit im 24-Stunden-Format. 24 steht für das 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

Gibt Viertelstunden an. Beispiel: „FÜNFZEHN“

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version nicht bekannt.
ZERO 0 Minuten nach der vollen Stunde.
FIFTEEN 15 Minuten nach der vollen Stunde.
THIRTY 30 Minuten nach der vollen Stunde
FORTY_FIVE 45 Minuten nach der vollen Stunde.

DayOfWeek

Hier werden Wochentage aufgezählt, z. B. „Montag“.

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

UnifiedSitelinkAsset

Ein einheitliches 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

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

Zweite Zeile der Textzeile 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 gültig ist und Anzeigen ausgeliefert werden können, im Format JJJJ-MM-TT.

endDate

string

Das Datum, an dem dieses Asset zuletzt gültig war und noch ausgeliefert wurde, im Format JJJJ-MM-TT.

adScheduleTargets[]

object (AdScheduleInfo)

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

trackingId

string (int64 format)

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

useSearcherTimeZone

boolean

Gibt an, ob das Sitelink-Asset in der Zeitzone des Suchenden angezeigt werden soll. 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 einheitlichen Seitenfeed.

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

string

Die Webseite, auf die die Anzeigen ausgerichtet werden sollen.

labels[]

string

Labels, mit denen die Seiten-URLs gruppiert werden.

MobileAppAsset

Ein Asset, das eine mobile App darstellt.

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

string

Erforderlich. Ein String, mit dem eine mobile Anwendung eindeutig identifiziert wird. Sie sollte nur die native Plattform-ID enthalten, z. B. „com.android.ebay“ für Android oder „12345689“ für iOS.

appStore

enum (MobileAppVendor)

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

MobileAppVendor

Der Anbieter der mobilen App

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
APPLE_APP_STORE Anbieter der mobilen App für den Apple App Store
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

Zweistelliger Ländercode der Telefonnummer. Beispiele: „US“, „us“.

phoneNumber

string

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

callConversionReportingState

enum (CallConversionReportingState)

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

callConversionAction

string

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

adScheduleTargets[]

object (AdScheduleInfo)

Liste der sich nicht überschneidenden Zeitpläne, die alle Zeitintervalle angeben, in denen das Asset ausgeliefert werden kann. Pro Tag sind maximal 6 Zeitpläne möglich, insgesamt 42.

callOnly

boolean

Gibt an, ob beim 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 Suchenden angezeigt werden soll. Gilt für Microsoft Ads.

startDate

string

Das Startdatum, ab dem dieses Asset gültig ist und Anzeigen ausgeliefert werden können, im Format JJJJ-MM-TT.

endDate

string

Das Datum, an dem dieses Asset zuletzt gültig war und noch ausgeliefert wurde, 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 den Wert „Unbekannt“ in dieser Version dar.
DISABLED Die Conversion-Aktion „Anruf“ ist deaktiviert.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Für die Anruf-Conversion-Aktion wird der auf Kontoebene festgelegte Anruf-Conversion-Typ verwendet.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Für die Conversion-Aktion „Anruf“ 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 möglicher Call-to-Action-Typen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
LEARN_MORE Der Call-to-Action-Typ ist „Weitere Informationen“.
GET_QUOTE Der Call-to-Action-Typ ist „Angebot erhalten“.
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 „Kontakt mit uns aufnehmen“.
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 „Mehr anzeigen“.
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 Kundennummer und einen Asset-Typ eindeutig. Weitere Informationen zu Place IDs findest du unter https://developers.google.com/places/web-service/place-id.

businessProfileLocations[]

object (BusinessProfileLocation)

Die Liste der Standorte des Unternehmens für den Kunden. Dieser wird nur zurückgegeben, wenn das Standort-Asset mit dem Unternehmensprofil-Konto synchronisiert wird. Es ist möglich, dass in einem Konto mehrere Unternehmensprofil-Einträge vorhanden sind, die auf dieselbe Orts-ID verweisen.

locationOwnershipType

enum (LocationOwnershipType)

Die Art 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

Die Standortdaten des Unternehmensprofils wurden mit dem verknüpften Unternehmensprofil-Konto synchronisiert.

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

string

Vom Werbetreibenden im Unternehmensprofil-Konto für den Standort angegebenes Label. Dieser wird aus dem Unternehmensprofil-Konto synchronisiert.

storeCode

string

Der Geschäftscode des Unternehmensprofils für diesen Standort. Diese Daten werden mit dem Unternehmensprofil-Konto synchronisiert.

listingId

string (int64 format)

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

LocationOwnershipType

Mögliche Arten der Inhaberschaft von Standorten

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

AssetGroupAsset

AssetGroupAsset ist die Verknüpfung zwischen einem Asset und einer Asset-Gruppe. Durch das Hinzufügen eines AssetGroup-Assets 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 Name der Asset-Ressource einer Asset-Gruppe hat folgendes Format:

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

assetGroup

string

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

asset

string

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

fieldType

enum (AssetFieldType)

Die Beschreibung des Placements des Assets in der Asset-Gruppe. Beispiel: HEADLINE, YOUTUBE_VIDEO usw.

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 den Wert „Unbekannt“ in dieser Version dar.
HEADLINE Das Asset ist verknüpft, um als Überschrift verwendet zu werden.
DESCRIPTION Das Asset ist verknüpft, um als Beschreibung verwendet zu werden.
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 Media-Bundle 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 für eine Hotelkampagne „Auf Google buchen“ aktiviert ist.
LEAD_FORM Das Asset ist für die Verwendung als Lead-Formularerweiterung verknüpft.
PROMOTION Das Asset ist für die Verwendung als Angebotserweiterung verknüpft.
CALLOUT Das Asset ist für die Verwendung als Zusatzinformation verknüpft.
STRUCTURED_SNIPPET Das Asset ist zur Verwendung als Snippet-Erweiterung verknüpft.
MOBILE_APP Das Asset ist für die Verwendung als App-Erweiterung verknüpft.
HOTEL_CALLOUT Das Asset ist verknüpft und kann als Erweiterung mit Zusatzinformationen für Hotels verwendet werden.
CALL Das Asset ist für die Verwendung als Anruferweiterung verknüpft.
PRICE Das Asset ist verknüpft und kann als Preiserweiterung verwendet werden.
LONG_HEADLINE Das Asset wird zur 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 es für die Auswahl eines Call-to-Actions verwendet werden kann.
AD_IMAGE Das Asset ist verknüpft, damit es für die Auswahl eines Anzeigenbilds verwendet werden kann.
HOTEL_PROPERTY Das Asset ist verknüpft, um es als Hotelunterkunft in einer Performance Max-Kampagne für die Reisebranche zu verwenden.

AssetGroupSignal

„AssetGroupSignal“ steht für ein Signal in einer Asset-Gruppe. Das Vorhandensein eines Signals gibt der Performance Max-Kampagne Aufschluss darüber, 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 Asset-Gruppensignals. Der Ressourcenname des Asset-Gruppensignals hat folgendes 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 für die Performance Max-Kampagne verwendet werden soll.

AudienceInfo

Ein Zielgruppenkriterium.

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

string

Der Name der Zielgruppenressource.

AssetGroupListingGroupFilter

„AssetGroupListingGroupFilter“ steht für einen Filterknoten für Eintragsgruppen in einer Asset-Gruppe.

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 folgendes 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 Eintragsgruppenfilters.

type

enum (ListingGroupFilterType)

Typ eines Knotens für Eintragsgruppenfilter.

vertical

enum (ListingGroupFilterVertical)

Die Vertikale, die der aktuelle Knotenbaum darstellt. Alle Knoten im selben Baum müssen derselben Branche angehören.

caseValue

object (ListingGroupFilterDimension)

Dimensionswert, mit dem diese Gruppen in Listen ihr übergeordnetes Element eingrenzen. Für die Stammgruppe nicht definiert.

parentListingGroupFilter

string

Ressourcenname der übergeordneten Untergruppe der Eintragsgruppe. Null für den Filterknoten der Stammeintragsgruppe.

path

object (ListingGroupFilterDimensionPath)

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

ListingGroupFilterType

Der Typ des Eintragsgruppenfilters.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
SUBDIVISION Unterteilung von Produkten nach einigen Eintragsdimensionen.
UNIT_INCLUDED Ein untergeordneter Knoten des Filters für Eintragsgruppen.
UNIT_EXCLUDED Ein untergeordneter Knoten des Filters für ausgeschlossene Eintragsgruppen.

ListingGroupFilterVertical

Der Typ der Branche des Eintragsgruppenfilters.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
SHOPPING Stellt die Shopping-Branche 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)

Ort 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 des 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 Produktkategorie für Gebote.

Diese ID entspricht der ID der Google-Produktkategorie https://support.google.com/merchants/answer/6324436.

ListingGroupFilterBiddingCategoryLevel

Die Ebene der Gebotskategorie für den Eintragsgruppenfilter.

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

ProductBrand

Marke des Produkts.

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

string

Stringwert der Produktmarke.

ProductChannel

Ort eines Produktangebots.

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

enum (ListingGroupFilterProductChannel)

Wert des Orts.

ListingGroupFilterProductChannel

Aufzählung, die den Ort eines Produktangebots beschreibt.

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

ProductCondition

Zustand eines Produktangebots.

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

enum (ListingGroupFilterProductCondition)

Wert der Bedingung.

ListingGroupFilterProductCondition

Ein Enum, das den Zustand eines Produktangebots beschreibt.

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

ProductCustomAttribute

Benutzerdefiniertes Attribut eines Produktangebots.

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

enum (ListingGroupFilterCustomAttributeIndex)

Der Index des benutzerdefinierten Attributs.

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 den Wert „Unbekannt“ in dieser Version dar.
INDEX0 Benutzerdefiniertes Filterattribut für erste Eintragsgruppe.
INDEX1 Benutzerdefiniertes Attribut für den zweiten Eintragsgruppenfilter.
INDEX2 Benutzerdefiniertes Attribut für den dritten Eintragsgruppenfilter.
INDEX3 Benutzerdefiniertes Attribut für den vierten Eintragsgruppenfilter.
INDEX4 Benutzerdefiniertes Attribut für den fünften Eintragsgruppenfilter.

ProductItemId

Artikel-ID eines Produktangebots.

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

string

Wert der ID.

ProductType

Der Typ eines Produktangebots.

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

enum (ListingGroupFilterProductTypeLevel)

Ebene des Typs.

value

string

Wert des Typs.

ListingGroupFilterProductTypeLevel

Aufzählung, die die Ebene des Typs eines Produktangebots beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ 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 Eintragsgruppenfilter definieren.

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

object (ListingGroupFilterDimension)

Der vollständige Pfad der Dimensionen durch die Eintragsgruppenfilterhierarchie (ohne den Stammknoten) zu diesem Eintragsgruppenfilter.

AssetGroupTopCombinationView

Eine Übersicht zur Verwendung der Kombination aus Anzeigen- und Asset-Gruppen in Anzeigengruppen.

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

string

Der Ressourcenname der obersten kombinierten Ansicht der Asset-Gruppe. Ressourcennamen der Asset-Gruppen-Top-Kombinationsansicht haben das Format: "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}".

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

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

AssetGroupAssetCombinationData

Daten zu Asset-Kombinationen in Asset-Gruppen

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

object (AssetUsage)

Ausgelieferte 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 bereitgestellten 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.

Dieser Wert ist nur für die Antwort zulässig.

HEADLINE_1 Das Asset wird für 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 Textzeile 1 verwendet.
DESCRIPTION_2 Das Asset wird in Beschreibung 2 verwendet.
HEADLINE Das Asset wurde in einem Anzeigentitel verwendet. Verwenden Sie diese Option nur, wenn die Anzeige nur einen Anzeigentitel enthält. Andernfalls verwenden Sie die Enumerationen HEADLINE_1, HEADLINE_2 oder HEADLINE_3.
HEADLINE_IN_PORTRAIT Das Asset wurde als Anzeigentitel in einem Hochformatbild verwendet.
LONG_HEADLINE Das Asset wurde in einem langen Anzeigentitel verwendet (in MultiAssetResponsiveAd).
DESCRIPTION Das Asset wurde in einer Beschreibung verwendet. Verwenden Sie diese Option nur, wenn die Anzeige nur eine Beschreibung enthält. Andernfalls verwenden Sie die Enum-Werte DESCRIPTION_1 oder DESCRIPTION_@
DESCRIPTION_IN_PORTRAIT Das Asset wurde als Textzeile in einem Hochformatbild verwendet.
BUSINESS_NAME_IN_PORTRAIT Das Asset wurde im Hochformat als Name des Unternehmens verwendet.
BUSINESS_NAME Das Asset wurde als Unternehmensname 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 Aufruf verwendet.
MOBILE_APP Dieses Asset wird als mobile App verwendet.
CALLOUT Dieses Asset wird als Zusatzinformation verwendet.
STRUCTURED_SNIPPET Dieses Asset wird als 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.

AssetGroup

Eine Asset-Gruppe. Mit AssetGroupAsset wird ein Asset mit der Asset-Gruppe verknüpft. Mit AssetGroupSignal können Sie einer Asset-Gruppe ein Signal zuordnen.

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 folgendes 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. Es muss eine Mindestlänge von 1 und eine maximale Länge von 128 haben. Er muss innerhalb einer Kampagne eindeutig sein.

finalUrls[]

string

Eine Liste der endgültigen URLs nach allen domainübergreifenden Weiterleitungen. Bei Performance Max-Kampagnen können die URLs standardmäßig erweitert werden, sofern Sie die Funktion nicht deaktivieren.

finalMobileUrls[]

string

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

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)

Die Gesamtleistung der Anzeige für diese 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 den Wert „Unbekannt“ in dieser Version dar.
PENDING Die Anzeigeneffektivität steht derzeit aus.
NO_ADS Es konnten keine Anzeigen generiert werden.
POOR Schlechte Festigkeit.
AVERAGE Durchschnittliche Stärke.
GOOD Gute Stärke.
EXCELLENT Hervorragende Festigkeit.

AssetSetAsset

„AssetSetAsset“ ist die Verknüpfung zwischen einem Asset und einer Asset-Gruppe. Durch das Hinzufügen eines AssetSetAsset wird ein Asset mit einer Asset-Gruppe verknüpft.

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

string

Der Ressourcenname des Asset-Satz-Assets. Asset-Ressourcennamen von Asset-Sets haben folgendes 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 Assets der Asset-Gruppe. Schreibgeschützt.

AssetSetAssetStatus

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

Enums
UNSPECIFIED Der Status wurde nicht angegeben.
UNKNOWN Der empfangene Wert ist in dieser Version nicht bekannt. Dieser Wert ist nur für die Antwort zulässig.
ENABLED Das Asset-Set-Asset ist aktiviert.
REMOVED Das Asset-Set-Asset wird entfernt.

AssetSet

Eine Asset-Gruppe, die eine Sammlung von Assets darstellt. Verwende „AssetSetAsset“, um ein Asset mit der Asset-Gruppe zu 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-Sets haben folgendes 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 folgendes 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 von der Gebotsstrategie verwendete Währung (dreistelliger ISO 4217-Code).

Für Gebotsstrategien in Verwaltungskunden kann diese Währung beim Erstellen festgelegt werden. Standardmäßig wird die Währung des Verwaltungskunden verwendet. Bei ausliefernden Kunden kann dieses Feld nicht festgelegt werden. Für alle Strategien in einem ausliefernden Kunden wird implizit die Währung des ausliefernden Kunden verwendet. In allen Fällen gibt das Feld "effectiveCurrencyCode" die von der Strategie verwendete Währung zurück.

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 von der Gebotsstrategie verwendete Währung (dreistelliger ISO 4217-Code).

Bei Gebotsstrategien für Kunden mit Verwaltungskonten ist dies die Währung, die der Werbetreibende beim Erstellen der Strategie festgelegt hat. Für die Kundenbereitstellung ist dies der currencyCode des Kunden.

Messwerte zur Gebotsstrategie werden in dieser Währung erfasst.

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 eine festgelegt werden. Für scheme ist nur einer der folgenden Werte zulässig:

enhancedCpc

object (EnhancedCpc)

Eine 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.

maximizeConversionValue

object (MaximizeConversionValue)

Eine automatisierte Gebotsstrategie, mit der Sie mit Ihrem Budget einen möglichst hohen Conversion-Wert für Ihre 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, die automatisch auf einen bestimmten Prozentsatz der Impressionen hin optimiert wird.

targetOutrankShare

object (TargetOutrankShare)

Eine Gebotsstrategie, bei der Gebote basierend auf dem angestrebten Anteil der Auktionen festgelegt werden, bei denen der Werbetreibende einen bestimmten Mitbewerber übertreffen soll. Die Verwendung dieses Feldes wurde eingestellt. Es kann keine neue Gebotsstrategie mit diesem Feld erstellt oder Gebotsstrategien mit diesem Feld mit einer Kampagne verknüpft werden. Mutationen zu Strategien, für die 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.

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 Gebotsstrategie.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist nur eine Antwort.

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

BiddingStrategyType

Ein Enum, das mögliche Gebotsstrategietypen beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen in dieser Version unbekannten Wert dar.
COMMISSION Die Provision ist eine automatische Gebotsstrategie, bei der der Werbetreibende einen bestimmten Anteil des Conversion-Werts bezahlt.
ENHANCED_CPC Bei der Gebotsstrategie „Auto-optimierter CPC“ werden Gebote für Klicks erhöht, die mit höherer Wahrscheinlichkeit zu einer Conversion führen, und für Klicks gesenkt, bei denen die Wahrscheinlichkeit geringer ist.
INVALID Wird nur für den Rückgabewert verwendet. Gibt an, dass für eine Kampagne keine Gebotsstrategie festgelegt ist. Dies verhindert, dass Anzeigen in der Kampagne ausgeliefert werden. Beispiel: Eine Kampagne ist mit einer Gebotsstrategie für Verwaltungskonten verknüpft und die Verknüpfung des ausliefernden Kontos mit dem Verwaltungskonto wird später aufgehoben. In diesem Fall wird die Kampagne automatisch von der nicht mehr zugänglichen Gebotsstrategie des Verwaltungskontos getrennt und auf den Gebotsstrategietyp „UNGÜLTIG“ umgestellt.
MANUAL_CPA Gebotsstrategie vom Typ „Manuelle Gebotseinstellung“, 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 impressionbasierte Gebote, bei denen der Nutzer pro 1.000 Impressionen bezahlt.
MANUAL_CPV Eine Gebotsstrategie, bei der ein konfigurierbarer Betrag pro Videoaufruf bezahlt wird.
MAXIMIZE_CONVERSIONS Eine Gebotsstrategie, die die Anzahl der Conversions mit einem festgelegten Tagesbudget automatisch 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 Gebotsschema für Werbung auf Seite 1, bei dem maximale CPC-Gebote auf Impressionen auf Seite 1 oder Seite 1 auf den beworbenen Anzeigenflächen auf google.com festgelegt werden. Dieser Aufzählungswert wird nicht mehr unterstützt.
PERCENT_CPC Bei der Gebotsstrategie „Prozentsatz vom CPC“ sind Gebote ein Bruchteil des angegebenen Preises für eine Ware oder Dienstleistung.
TARGET_CPA Bei der automatischen Gebotsstrategie "Ziel-CPA" werden Gebote so festgelegt, dass Sie mit Ihrem Ziel-CPA (Cost-per-Acquisition) möglichst viele Conversions erzielen.
TARGET_CPM „Ziel-CPM“ ist eine automatische Gebotsstrategie. Hierbei werden Gebote so festgelegt, dass Sie mit Ihrem angestrebten Cost-per-1000-Impressions (CPM) möglichst viele Impressionen erzielen.
TARGET_IMPRESSION_SHARE Eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass ein bestimmter Prozentsatz der Suchanzeigen oben auf der ersten Seite oder an einer anderen ausgewählten Stelle ausgeliefert wird.
TARGET_OUTRANK_SHARE "Kompetitive Auktionsposition" ist eine automatische Gebotsstrategie, bei der Gebote auf Basis des angestrebten Anteils der Auktionen festgelegt werden, bei 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 Ziel-ROAS (Return On Average Spend) erzielen.
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 größerer Wahrscheinlichkeit zu einer Conversion führen, und für Klicks gesenkt werden, die mit geringerer Wahrscheinlichkeit zu einer Conversion führen.

Diese Gebotsstrategie wurde eingestellt und kann nicht mehr erstellt werden. Verwenden Sie für eine gleichwertige Funktionalität „manualCpc“, wobei „advancedCpcEnabled“ auf „true“ festgelegt ist.

MaximizeConversionValue

Eine automatisierte Gebotsstrategie, mit der Sie mit Ihrem Budget einen möglichst hohen Conversion-Wert für Ihre 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 verfügbar.

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 verfügbar.

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.

Conversions maximieren

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 verfügbar.

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 verfügbar.

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. Wenn die Gebotsstrategie festgelegt ist, erzielt sie mit dem Ziel-CPA (oder einem niedrigeren Betrag) so viele Conversions wie möglich. Ist der Ziel-CPA nicht festgelegt, versucht die Gebotsstrategie, den niedrigstmöglichen CPA im Rahmen des Budgets 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 Option 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. Sollte nur für Portfolio-Gebotsstrategien festgelegt werden.

TargetImpressionShare

Eine automatische Gebotsstrategie, bei der Gebote so festgelegt werden, dass ein bestimmter Prozentsatz der Suchanzeigen oben auf der ersten Seite (oder in einer anderen Zielregion) erscheint.

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

enum (TargetImpressionShareLocation)

Die Position der Ausrichtung auf der Suchergebnisseite.

locationFractionMicros

string (int64 format)

Der ausgewählte Anteil der Anzeigen, die an dem ausgewählten Standort ausgeliefert werden sollen, in Mikron. 1 % entspricht beispielsweise 10.000.

cpcBidCeilingMicros

string (int64 format)

Das höchste CPC-Gebot, das das automatische Gebotssystem festlegen 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 möglicher Ziele.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
ANYWHERE_ON_PAGE An einer beliebigen Stelle auf der Webseite.
TOP_OF_PAGE Oberster Anzeigenblock
ABSOLUTE_TOP_OF_PAGE Oberste Anzeigenfläche im oberen Anzeigenfeld.

TargetOutrankShare

Eine automatische Gebotsstrategie, bei der Gebote basierend auf dem Zielanteil der Auktionen festgelegt werden, bei denen der Werbetreibende einen bestimmten Mitbewerber übertreffen soll. 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 Ihren Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erreichen 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 Option 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 Option 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

Kampagnenbudget

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

string

Der Ressourcenname des Kampagnenbudgets. Ressourcennamen des Kampagnenbudgets haben folgendes 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 den Wert „Unbekannt“ in dieser Version dar.
STANDARD Der Budgetserver drosselt die Auslieferung gleichmäßig über den gesamten Zeitraum.
ACCELERATED Die Auslieferung wird vom Budgetserver nicht gedrosselt und Anzeigen werden so schnell wie möglich ausgeliefert.

BudgetPeriod

Möglicher Zeitraum eines Budgets.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
DAILY Tagesbudget:
FIXED_DAILY Festes Tagesbudget
CUSTOM_PERIOD Mit „benutzerdefiniertes Budget“ und „total_amount“ lässt sich das Lifetime-Budgetlimit festlegen.

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,
  "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. Kampagnenressourcennamen haben folgendes 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 Kampagne für die Anzeigenbereitstellung.

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 Optimierung auf 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 trackingUrlTemplate, finalUrls oder mobile_final_urls verwendet werden.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Einstellungen für Echtzeitgebote, eine Funktion, die nur für Kampagnen mit Ausrichtung auf das Ad Exchange-Netzwerk verfügbar ist.

networkSettings

object (NetworkSettings)

Die Netzwerkeinstellungen für die Kampagne.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Die Einstellung für dynamische 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 dieser Kampagne übernommen oder 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

Ressourcenname von „AccessibleBiddingStrategy“, eine schreibgeschützte Ansicht der uneingeschränkten Attribute der angehängten Portfolio-Gebotsstrategie, die durch „biddingStrategy“ identifiziert wurde. Das Feld ist leer, wenn für die Kampagne keine Portfoliostrategie verwendet wird. Strategieattribute ohne Einschränkungen sind für alle Kunden verfügbar, mit denen die Strategie geteilt wird. Sie werden aus der Ressource „AccessibleBiddingStrategy“ gelesen. Im Gegensatz dazu sind eingeschränkte Attribute nur für den Inhaber der Strategie und seine Manager verfügbar. Eingeschränkte Attribute können nur aus der BiddingStrategy-Ressource gelesen werden.

frequencyCaps[]

object (FrequencyCapEntry)

Eine Liste, mit der begrenzt wird, wie oft die Anzeigen dieser Kampagne jedem Nutzer präsentiert werden.

selectiveOptimization

object (SelectiveOptimization)

Einstellung für die selektive Optimierung dieser Kampagne, einschließlich einer Reihe von Conversion-Aktionen, auf 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)

Die Einstellung für das Optimierungsziel für diese Kampagne, einschließlich einer Reihe von Typen von Optimierungszielvorhaben.

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 zu Google Ads gehören, 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 von dieser Kampagne ausgeschlossen werden sollen. Asset-Verknüpfungen mit diesen Feldtypen werden von dieser Kampagne nicht von der übergeordneten Ebene übernommen.

createTime

string

Der Zeitstempel für den Zeitpunkt, zu dem dieser Kampagne erstellt wurde. Der Zeitstempel wird in der Zeitzone des Kunden im Format „yyyy-MM-dd HH:mm:ss“ angegeben. „createTime“ wird in v1 nicht mehr unterstützt. 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".

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 der 30.12.2037 festgelegt. Die Kampagne läuft dann unbegrenzt. Wenn Sie für eine vorhandene Kampagne eine unbegrenzte Laufzeit festlegen möchten, setzen Sie dieses Feld auf 2037-12-30.

finalUrlSuffix

string

Suffix, das an Landingpages angehängt wird, die mit parallelem Tracking ausgeliefert werden.

urlExpansionOptOut

boolean

Gibt an, ob die URL-Erweiterung auf gezieltere URLs deaktiviert ist. Wenn die Option deaktiviert ist (wahr), werden nur die finalen URLs in der Asset-Gruppe oder die URLs aus den Google Merchant Center- oder Geschäftsdatenfeeds des Werbetreibenden als Ziel verwendet. Ist sie aktiviert (false), erfolgt die Ausrichtung auf die gesamte Domain. 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 Portfolio-Gebotsstrategie, die für die Kampagne verwendet wird.

manualCpa

object (ManualCpa)

Manuelle CPA-Standardstrategie. Manuelle Gebotsstrategie, mit der der Werbetreibende das Gebot für jede vom Werbetreibenden angegebene Aktion festlegen kann Nur für Kampagnen für lokale Dienstleistungen unterstützt.

manualCpc

object (ManualCpc)

Manuelle CPC-Standardstrategie Manuelle, auf Klicks basierende Gebote, bei denen der Nutzer pro Klick bezahlt.

manualCpm

object (ManualCpm)

Standardmäßige Gebotsstrategie „Manueller CPM“. Manuelle impressionbasierte Gebote, bei denen der Nutzer pro 1.000 Impressionen bezahlt.

maximizeConversions

object (MaximizeConversions)

Die standardmäßige Gebotsstrategie „Conversions maximieren“, bei der im Rahmen Ihres Budgets automatisch die Anzahl der Conversions maximiert wird.

maximizeConversionValue

object (MaximizeConversionValue)

Die Standard-Gebotsstrategie „Conversion-Wert maximieren“ legt Gebote automatisch so fest, dass Sie mit Ihrem Budget einen möglichst hohen Umsatz erzielen.

targetCpa

object (TargetCpa)

Standard-Gebotsstrategie vom Typ „Ziel-CPA“, bei der 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 von Impressionen erreicht wird.

targetRoas

object (TargetRoas)

Die standardmäßige Gebotsstrategie „Ziel-ROAS“ (Return on Advertising Spend) maximiert automatisch den Umsatz und gleicht gleichzeitig den durchschnittlichen Ziel-ROAS aus.

targetSpend

object (TargetSpend)

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

percentCpc

object (PercentCpc)

Standard-Gebotsstrategie vom Typ „Prozentualer CPC“, bei der Gebote einen Bruchteil des angegebenen Preises für ein bestimmtes Produkt oder eine bestimmte Dienstleistung darstellen.

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 in dieser Version unbekannten Wert 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 nur eine Antwort.

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

BiddingStrategySystemStatus

Die möglichen Systemstatus einer Gebotsstrategie.

Enums
UNSPECIFIED Signalisiert, dass ein unerwarteter Fehler aufgetreten ist. Beispielsweise wurde kein Gebotsstrategietyp oder keine Statusinformationen gefunden.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
ENABLED Die Gebotsstrategie ist aktiv und AdWords kann keine Probleme mit der Strategie feststellen.
LEARNING_NEW Die Gebotsstrategie befindet sich im Lernprozess, da sie vor Kurzem erstellt oder vor Kurzem reaktiviert wurde.
LEARNING_SETTING_CHANGE Die Gebotsstrategie wird aufgrund einer kürzlich vorgenommenen Änderung an den Einstellungen optimiert.
LEARNING_BUDGET_CHANGE Die Gebotsstrategie wird aufgrund einer kürzlich erfolgten Budgetänderung optimiert.
LEARNING_COMPOSITION_CHANGE Die Gebotsstrategie befindet sich im Lernprozess, da sich kürzlich die Anzahl der mit ihr verknüpften Kampagnen, Anzeigengruppen oder Keywords geändert hat.
LEARNING_CONVERSION_TYPE_CHANGE Die Gebotsstrategie hängt von Conversion-Berichten ab. Außerdem hat der Kunde vor Kurzem 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 Gebotslimit eingeschränkt.
LIMITED_BY_CPC_BID_FLOOR Die Gebotsstrategie wird durch den Gebotsuntergrenze eingeschränkt.
LIMITED_BY_DATA Die Gebotsstrategie ist eingeschränkt, da in den letzten Wochen nicht genügend Conversion-Zugriffe erzielt wurden.
LIMITED_BY_BUDGET Ein erheblicher Teil der Keywords in dieser Gebotsstrategie ist durch das Budget begrenzt.
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 Aufgrund des engen Targetings kann das Budget der Gebotsstrategie nicht vollständig aufgebraucht werden.
MISCONFIGURED_ZERO_ELIGIBILITY Für smarte Shopping-Kampagnen ist kein Conversion-Tracking (keine Pings vorhanden) und/oder keine Remarketing-Listen vorhanden.
MISCONFIGURED_CONVERSION_TYPES Die Gebotsstrategie hängt von Conversion-Berichten ab und dem Kunden fehlen Conversion-Typen, die für diese Strategie erfasst 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 in der Strategie teilen.
MISCONFIGURED_STRATEGY_TYPE Die Kampagne hat einen ungültigen Strategietyp und es werden keine Anzeigen ausgeliefert.
PAUSED Die Gebotsstrategie ist nicht aktiv. Der Gebotsstrategie sind entweder keine aktiven Kampagnen, Anzeigengruppen oder Keywords zugeordnet. Möglicherweise sind auch keine aktiven Budgets mit der Gebotsstrategie verknüpft.
UNAVAILABLE Für diese Gebotsstrategie werden derzeit keine Statusberichte unterstützt.
MULTIPLE_LEARNING Für diese Gebotsstrategie gab es in dem betreffenden Zeitraum mehrere LEARNING_*-Systemstatus.
MULTIPLE_LIMITED In dem betreffenden Zeitraum gab es für diese Gebotsstrategie mehrere Systemstatus vom Typ LIMITED_*.
MULTIPLE_MISCONFIGURED In dem betreffenden Zeitraum gab es mehrere Systemstatus vom Typ MISCONFIGURED_* für diese Gebotsstrategie.
MULTIPLE Für diese Gebotsstrategie gab es in dem betreffenden Zeitraum mehrere Systemstatus.

AdServingOptimizationStatus

Enum, das mögliche Auslieferungsstatus beschreibt.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dieser Wert ist nur für die Antwort zulässig.

OPTIMIZE Die Anzeigenbereitstellung wird basierend auf der CTR für die Kampagne optimiert.
CONVERSION_OPTIMIZE Die Anzeigenbereitstellung wird anhand von CTR × Conversion für die Kampagne optimiert. Wenn die Kampagne nicht die Gebotsstrategie „Conversion-Optimierungstool“ verwendet, wird standardmäßig „OPTIMIERT“ angezeigt.
ROTATE Anzeigen werden 90 Tage lang gleichmäßig ausgeliefert und dann für Klicks optimiert.
ROTATE_INDEFINITELY Anzeigen mit geringerer Leistung werden in gleichmäßigerem Verhältnis zu leistungsstärkeren Anzeigen ausgeliefert. Es findet keine Optimierung statt.
UNAVAILABLE Der Status der Anzeigenbereitstellungsoptimierung 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 in dieser Version unbekannten Wert dar.
SEARCH Suchnetzwerk aus. Umfasst Display-Kampagnen im Bündel und Such- und Displaykampagnen.
DISPLAY Nur im Google Displaynetzwerk.
SHOPPING Anzeigen aus Shopping-Kampagnen werden in der Shopping-Property und in den Suchergebnissen von google.com ausgeliefert.
HOTEL Kampagnen mit Hotelanzeigen.
VIDEO Videokampagnen
MULTI_CHANNEL App-Kampagnen und App-Interaktionskampagnen, die auf mehreren Kanälen ausgeliefert werden
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 den Wert „Unbekannt“ in dieser Version dar.
SEARCH_MOBILE_APP App-Kampagnen für die Google Suche
DISPLAY_MOBILE_APP App-Kampagnen für Displayanzeigen
SEARCH_EXPRESS AdWords Express-Kampagnen für Suchkampagnen
DISPLAY_EXPRESS AdWords Express-Kampagnen für das Displaynetzwerk
SHOPPING_SMART_ADS Smarte Shopping-Kampagnen
DISPLAY_GMAIL_AD Gmail-Kampagnen
DISPLAY_SMART_CAMPAIGN Smart-Displaykampagnen: Neue Kampagnen dieses Untertyps können nicht erstellt werden.
VIDEO_OUTSTREAM Out-Stream-Videokampagnen.
VIDEO_ACTION Video-TrueView for Action-Kampagnen.
VIDEO_NON_SKIPPABLE Videokampagnen mit nicht überspringbaren Videoanzeigen
APP_CAMPAIGN Mit einer App-Kampagne können Sie Ihre Android- oder iOS-App ganz einfach in den wichtigsten Google-Produkten bewerben, darunter die Google Suche, Google Play, YouTube und das Google Displaynetzwerk.
APP_CAMPAIGN_FOR_ENGAGEMENT App-Kampagne für Interaktionen, die darauf abzielt, die erneute Interaktion mit der App in mehreren der wichtigsten Google-Produkte wie der Google Suche, YouTube und dem Google Displaynetzwerk zu steigern.
LOCAL_CAMPAIGN Kampagnen, die speziell für lokale Werbung konzipiert sind.
SHOPPING_COMPARISON_LISTING_ADS Shopping-Kampagnen vom Typ „Vergleichsportal“
SMART_CAMPAIGN smarten Standardkampagnen.
VIDEO_SEQUENCE Videokampagnen mit Videosequenzen
APP_CAMPAIGN_FOR_PRE_REGISTRATION App-Kampagne für die Vorregistrierung, die speziell für die Bewerbung der Vorregistrierung für mobile Apps konzipiert ist 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 vom Typ „Reiseaktivitäten“
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook-Tracking nur für Kampagnen in sozialen Netzwerken.

CustomParameter

Eine Zuordnung, die von benutzerdefinierten Parameter-Tags in einer trackingUrlTemplate-, finalUrls- oder mobile_final_urls-URL 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.

RealTimeBiddingSetting

Einstellungen für Echtzeitgebote, eine Funktion, die nur für Kampagnen mit Ausrichtung auf das Ad Exchange-Netzwerk verfügbar ist.

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

boolean

Ob für die Kampagne Echtzeitgebote aktiviert sind.

NetworkSettings

Die Werbenetzwerkeinstellungen 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 (muss für targetGoogleSearch ebenfalls true sein).

targetContentNetwork

boolean

Gibt an, ob Anzeigen auf bestimmten Placements im Google Displaynetzwerk bereitgestellt werden. Placements werden mithilfe des Placement-Kriteriums angegeben.

targetPartnerSearchNetwork

boolean

Gibt an, ob Anzeigen im Google Partner Network ausgeliefert werden. Diese Funktion ist nur für einige ausgewählte Google Partner-Konten verfügbar.

DynamicSearchAdsSetting

Die Einstellung für dynamische Suchanzeigen.

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

string

Erforderlich. Der Internetdomainname, den diese Einstellung darstellt, 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 für die Kampagne ausschließlich vom Werbetreibenden bereitgestellte URLs verwendet werden.

ShoppingSetting

Die Einstellung für Shopping-Kampagnen. Hier wird festgelegt, für welche Produkte in der Kampagne geworben werden kann 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 eines der beiden Felder „feedLabel“ oder „salesCountry“ festgelegt werden. Wenn das Feld „feedLabel“ anstelle von „salesCountry“ verwendet wird, sind Ländercodes im selben Format zulässig, z. B. „XX“. Andernfalls kann es sich um jeden String handeln, der im Google Merchant Center für das Feedlabel verwendet wird.

useVehicleInventory

boolean

Ob das Targeting auf Inventar von Fahrzeugeinträgen erfolgen soll.

merchantId

string (int64 format)

ID des Merchant Center-Kontos. Dieses Feld ist für Erstellungsvorgänge erforderlich. Dieses Feld kann für Shopping-Kampagnen nicht geändert werden.

salesCountry

string

Das Verkaufsland der Produkte, die in die Kampagne aufgenommen werden sollen.

campaignPriority

integer

Priorität der Kampagne. Kampagnen mit einer höheren Priorität haben Vorrang vor Kampagnen mit einer niedrigeren Priorität. Dieses Feld ist für Shopping-Kampagnen erforderlich. Die Werte können zwischen 0 und 2 liegen (jeweils einschließlich). Dieses Feld ist für smarte Shopping-Kampagnen optional. Wenn es festgelegt ist, muss es jedoch den Wert 3 haben.

enableLocal

boolean

Ob lokal erhältliche Produkte berücksichtigt werden sollen

GeoTargetTypeSetting

Eine Sammlung von Einstellungen in Bezug auf die geografische Ausrichtung von Anzeigen

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 auszuschließende geografische Targeting in dieser Kampagne verwendet wird.

PositiveGeoTargetType

Die möglichen positiven Typen für die geografische Ausrichtung.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version nicht bekannt.
PRESENCE_OR_INTEREST Gibt an, dass eine Anzeige ausgelöst wird, wenn sich der Nutzer in den Zielregionen des Werbetreibenden befindet oder sich für diese interessiert.
SEARCH_INTEREST Gibt an, dass eine Anzeige ausgelöst wird, wenn der Nutzer nach den Zielregionen des Werbetreibenden sucht. Diese Funktion kann nur für Such- und Standard-Shopping-Kampagnen verwendet werden.
PRESENCE Gibt an, dass die Auslieferung einer Anzeige ausgelöst wird, wenn sich der Nutzer gerade oder regelmäßig in den Zielregionen des Werbetreibenden befindet.

NegativeGeoTargetType

Die möglichen Typen für auszuschließende geografische Ziele.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version nicht bekannt.
PRESENCE_OR_INTEREST Gibt an, dass eine Anzeige für Nutzer nicht ausgeliefert wird, die sich an den ausgeschlossenen Orten des Werbetreibenden befinden oder sich dafür interessieren.
PRESENCE Gibt an, dass eine Anzeige für Nutzer nicht ausgeliefert wird, die sich an den vom Werbetreibenden ausgeschlossenen Standorten befinden.

FrequencyCapEntry

Dieser Typ hat keine Felder.

Eine Regel, die angibt, wie oft eine Anzeige (oder eine Gruppe von Anzeigen) einem Nutzer innerhalb eines bestimmten Zeitraums maximal präsentiert werden kann.

SelectiveOptimization

Die selektive Optimierungseinstellung für diese Kampagne. Sie enthält eine Reihe von Conversion-Aktionen, für die die 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ählten Ressourcennamen für Conversion-Aktionen, mit denen diese Kampagne optimiert werden kann.

OptimizationGoalSetting

Einstellung für das Optimierungsziel dieser Kampagne, einschließlich einer Reihe von Optimierungszieltypen.

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

enum (OptimizationGoalType)

Die Liste der Optimierungszieltypen.

OptimizationGoalType

Art des Optimierungsziels

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur als Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
CALL_CLICKS Für Anrufklicks optimieren Bei Conversions vom Typ „Anrufklick“ haben Nutzer nach dem Ansehen einer Anzeige „Anrufen“ ausgewählt, um ein Geschäft zu kontaktieren.
DRIVING_DIRECTIONS Für Wegbeschreibungen optimieren Bei diesen Conversions haben Nutzer nach dem Ansehen einer Anzeige „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 dynamisches Tracking verwendet wird.

ManualCpa

Dieser Typ hat keine Felder.

Manuelle Gebotsstrategie, mit der der Werbetreibende das Gebot für jede vom Werbetreibenden angegebene Aktion festlegen kann

ManualCpc

Manuelle, auf Klicks basierende 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 impressionbasierte Gebote, bei denen der Nutzer pro 1.000 Impressionen bezahlt.

PercentCpc

Eine Gebotsstrategie, bei der Gebote einen Bruchteil des angegebenen Preises für eine Ware oder Dienstleistung ausmachen.

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

string (int64 format)

Höchstgrenze, die von der Gebotsstrategie festgelegt werden kann. Dieses optionale Feld wird vom Werbetreibenden eingegeben und in lokalen millionstel Einheiten angegeben. Hinweis: Ein Nullwert wird genauso interpretiert wie eine nicht definierte Höchstgebotsgrenze.

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 übersteigen, der durchschnittliche Gebotsbetrag für eine Kampagne jedoch nicht.

TargetCpm

Dieser Typ hat keine Felder.

„Ziel-CPM“ (Cost-per-1000-Impressions) ist eine automatische Gebotsstrategie, mit der Gebote so festgelegt werden, dass die Leistung unter Berücksichtigung des 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. CampaignAsset-Ressourcennamen haben folgendes 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 Asset-Gruppe. Durch das Hinzufügen eines CampaignAssetSet 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. Asset-Ressourcennamen von Asset-Gruppen haben folgendes Format:

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

campaign

string

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

assetSet

string

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

status

enum (AssetSetLinkStatus)

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

CampaignAudienceView

Eine Zielgruppenübersicht für Kampagnen. Enthält Leistungsdaten aus Interessen und Remarketing-Listen für Anzeigen im Displaynetzwerk und im YouTube-Werbenetzwerk sowie Remarketing-Listen für Suchanzeigen (RLSA), die nach Kampagnen- und Zielgruppenkriterien zusammengefasst sind. Diese Ansicht enthält nur Zielgruppen, die auf Kampagnenebene verknüpft sind.

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

string

Der Ressourcenname der Zielgruppenansicht auf Kampagnenebene. Ressourcennamen von Kampagnen-Zielgruppenansichten haben das 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 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 für das Targeting (false) oder das Ausschließen (true) verwendet werden soll.

Union-Feld criterion. Das Kampagnenkriterium.

Es muss genau eine 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 Kampagnenkriteriums.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dieser Wert ist nur für die Antwort zulässig.

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

Geozielkonstanten, die den Umfang des geografischen Gebiets im Feed einschränken. Derzeit ist nur eine Geotargeting-Konstante zulässig.

radiusUnits

enum (LocationGroupRadiusUnits)

Einheit für den Radius. Meilen und Meter werden für Geozielkonstanten unterstützt. Für Feedelementsätze werden Meilen und Meter unterstützt. Dieser Wert ist erforderlich und muss bei CREATE-Vorgängen festgelegt werden.

feedItemSets[]

string

FeedItemSets, deren FeedItems ausgerichtet sind. Wenn mehrere IDs angegeben werden, werden alle Elemente ausgewählt, die in mindestens einem Set enthalten sind. Dieses Feld kann nicht mit geoTargetConstants verwendet werden. Diese Option ist optional und kann nur bei CREATE-Vorgängen festgelegt werden.

radius

string (int64 format)

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

LocationGroupRadiusUnits

Die Maßeinheit für den Umkreis in der Standortgruppe (z. B. KILOMETER)

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ 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 dieser Kampagne übernommen oder direkt zugewiesen ist.

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

string

Der Name der Ressource, Ressourcennamen von „CampaignEffectiveLabel“ haben das Format: customers/{customerId}/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/{customerId}/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

Verkaufsansicht für Warenkorbdaten

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

string

Der Ressourcenname der Ansicht „Verkäufe mit Warenkorbdaten“. Ressourcennamen von Verkaufsansichten mit Warenkorbdaten 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 folgendes Format:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

ID der Zielgruppe.

name

string

Erforderlich. Name der Zielgruppe. Er sollte für alle Zielgruppen eindeutig sein. Die Mindestlänge muss 1 und die maximale Länge 255 Zeichen betragen.

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

Ressourcenname der Conversion-Aktion. Ressourcennamen von Conversion-Aktionen haben folgendes 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 wurden.

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 „primaryForGoal“-Bit einer Conversion-Aktion „false“ ist, ist die Conversion-Aktion für alle Kampagnen nicht gebotsfähig, unabhängig vom Conversion-Zielvorhaben der Kunden oder Kampagne. Bei benutzerdefinierten Conversion-Zielvorhaben wird „primaryForGoal“ jedoch nicht berücksichtigt. Wenn für eine Kampagne ein benutzerdefiniertes Conversion-Zielvorhaben mit der Conversion-Aktion „primaryForGoal = false“ konfiguriert ist, kann für diese Conversion-Aktion weiterhin geboten werden. Wenn „primaryForGoal“ nicht festgelegt ist, wird standardmäßig „true“ verwendet. In Version 9 kann „primaryForGoal“ erst nach dem Erstellen über einen „update“-Vorgang auf „false“ gesetzt werden, da es nicht als optional deklariert ist.

ownerCustomer

string

Der Ressourcenname des Kunden, der die Conversion-Aktion verwaltet, oder null, wenn es sich um eine systemdefinierte Conversion-Aktion handelt.

includeInClientAccountConversionsMetric

boolean

Gibt an, ob diese Conversion-Aktion in den Messwert „Conversions für das Kundenkonto“ 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 darf.

appId

string

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

ConversionActionStatus

Mögliche Status einer Conversion-Aktion.

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

ConversionActionType

Mögliche Typen einer Conversion-Aktion.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
AD_CALL Conversions, die erfasst werden, wenn ein Nutzer auf die Anruferweiterung einer Anzeige klickt.
CLICK_TO_CALL Conversions, die erfasst werden, 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 stattfinden, wenn ein Nutzer über die Android-Abrechnung einen Kauf in einer App tätigt.
UPLOAD_CALLS Anruf-Conversions, die vom Werbetreibenden erfasst und hochgeladen werden.
UPLOAD_CLICKS Conversions, die vom Werbetreibenden erfasst und mit zugeordneten Klicks hochgeladen werden.
WEBPAGE Conversions, die auf einer Webseite stattfinden.
WEBSITE_CALL Conversions, die erfasst werden, wenn ein Nutzer eine dynamisch generierte Telefonnummer von der Website eines Werbetreibenden aus anruft.
STORE_SALES_DIRECT_UPLOAD Conversions vom Typ „Ladenverkäufe“, die auf selbst erhobenen oder von Händlern hochgeladenen Daten basieren. Nur Kunden auf der Zulassungsliste können die Uploadtypen „Ladenverkäufe (direkter Upload)“ verwenden.
STORE_SALES Conversion vom Typ „Ladenverkäufe“, die auf selbst erhobenen oder von Händlern hochgeladenen Händlerdaten und/oder auf Käufen im Geschäft mit Karten von Zahlungsnetzwerken basiert. Nur Kunden auf der Zulassungsliste können Arten von Ladenverkäufen verwenden. Schreibgeschützt.
FIREBASE_ANDROID_FIRST_OPEN Conversions vom Typ „Erstes Öffnen“ von Android-Apps, die über Firebase erfasst werden.
FIREBASE_ANDROID_IN_APP_PURCHASE In-App-Käufe in Android-Apps, die über Firebase erfasst werden
FIREBASE_ANDROID_CUSTOM Benutzerdefinierte Conversions für Android-Apps, die über Firebase erfasst werden
FIREBASE_IOS_FIRST_OPEN Conversions vom Typ „Erstes Öffnen“ von iOS-Apps, die über Firebase erfasst werden
FIREBASE_IOS_IN_APP_PURCHASE In-App-Kauf-Conversions von iOS-Apps, die über Firebase erfasst werden
FIREBASE_IOS_CUSTOM Über Firebase erfasste benutzerdefinierte Conversions für iOS-Apps
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversions vom Typ „Erstes Öffnen“ von Android-Apps, die über App-Analysetools von Drittanbietern erfasst werden.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversions für In-App-Käufe in Android-Apps, die über App-Analysetools von Drittanbietern erfasst werden
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Benutzerdefinierte Conversions in Android-Apps, die mit App-Analysen von Drittanbietern erfasst werden
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversions vom Typ „Erstes Öffnen“ in iOS-Apps, die mit App-Analysen von Drittanbietern erfasst werden
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversions für In-App-Käufe in iOS-Apps, die mit App-Analysen von Drittanbietern erfasst werden
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Benutzerdefinierte Conversions in iOS-Apps, die mit 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 ohne App-spezifische Art erfasst werden. Schreibgeschützt.
FLOODLIGHT_ACTION Floodlight-Aktivität, die zählt, wie oft Nutzer eine bestimmte Webseite besucht haben, nachdem sie eine der Anzeigen eines Werbetreibenden gesehen oder angeklickt haben. Schreibgeschützt.
FLOODLIGHT_TRANSACTION Floodlight-Aktivität, mit der die Anzahl der Verkäufe oder der gekauften Artikel erfasst wird. Außerdem kann der Gesamtwert jedes Verkaufs erfasst werden. Schreibgeschützt.
GOOGLE_HOSTED Conversions, mit denen lokale Aktionen in den Produkten und Diensten von Google nach der Interaktion mit einer Anzeige erfasst werden. Schreibgeschützt.
LEAD_FORM_SUBMIT Conversions, die erfasst werden, wenn ein Nutzer ein Lead-Formular einreicht. Schreibgeschützt.
SALESFORCE Conversions aus Salesforce Schreibgeschützt.
SEARCH_ADS_360 Conversions, die aus Search Ads 360-Floodlight-Daten importiert wurden. Schreibgeschützt.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Anruf-Conversions, die bei Anzeigen in smarten Kampagnen ohne eingerichtetes Anruf-Tracking mit benutzerdefinierten Kriterien für smarte Kampagnen erfolgen Schreibgeschützt.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Der Nutzer klickt in Google Maps auf ein Anrufelement. Nur 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 über Anzeigen mit Anruf-Tracking bei smarten Kampagnen erfolgen. Dazu werden benutzerdefinierte Kriterien der smarten Kampagne verwendet. Schreibgeschützt.
STORE_VISITS Conversions, die auftreten, wenn ein Nutzer das Ladengeschäft eines Werbetreibenden besucht. Schreibgeschützt.
WEBPAGE_CODELESS Conversions, die aus Websiteereignissen wie Formulareinreichungen oder Seitenladevorgängen erstellt wurden und für die keine individuell codierten Ereignis-Snippets verwendet werden. Schreibgeschützt.
UNIVERSAL_ANALYTICS_GOAL Conversions, die auf verknüpfte Universal Analytics-Zielvorhaben zurückzuführen sind.
UNIVERSAL_ANALYTICS_TRANSACTION Conversions, die aus verknüpften Universal Analytics-Transaktionen stammen.
GOOGLE_ANALYTICS_4_CUSTOM Conversions, die aus verknüpften Google Analytics 4-Conversion-Ereignissen stammen
GOOGLE_ANALYTICS_4_PURCHASE Conversions, die aus verknüpften Google Analytics 4-Kauf-Conversions stammen.

ConversionActionCategory

Die Kategorie der Conversions, die einer Conversion-Aktion zugeordnet sind.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
DEFAULT Standardkategorie.
PAGE_VIEW Ein Nutzer besucht eine Seite.
PURCHASE Ereignis „Kauf“, „Umsatz“ oder „Bestellung aufgegeben“
SIGNUP Nutzeraktion „Anmeldung“.
LEAD Aktion zur Lead-Generierung
DOWNLOAD Softwaredownload (wie bei einer App)
ADD_TO_CART Hinzufügen von Artikeln zum Einkaufswagen oder zur Tasche auf der Website eines Werbetreibenden
BEGIN_CHECKOUT Wenn ein Nutzer 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 Aufruf, um auf Interesse am Angebot eines Werbetreibenden hinzuweisen.
IMPORTED_LEAD Eine Lead-Conversion, die aus einer externen Quelle in Google Ads importiert wurde.
SUBMIT_LEAD_FORM Einreichen eines Formulars auf der Website eines Werbetreibenden, in dem das Interesse des Unternehmens angegeben wird.
BOOK_APPOINTMENT Eine Terminbuchung mit dem Unternehmen eines Werbetreibenden.
REQUEST_QUOTE Eine Anfrage für ein Angebot oder eine Preisschätzung.
GET_DIRECTIONS Eine Suche nach dem Standort eines Werbetreibenden mit der Absicht, ihn zu besuchen.
OUTBOUND_CLICK Ein Klick auf die Website eines Partners eines Werbetreibenden.
CONTACT Ein Anruf, eine SMS, eine E-Mail, ein Chat oder eine andere Art der Kontaktaufnahme mit einem Werbetreibenden.
ENGAGEMENT Ein Ereignis für die Nutzerinteraktion auf der Website, z. B. eine lange Verweildauer oder ein intelligentes Google Analytics-Zielvorhaben. Für den Import von Zielvorhaben aus Google Analytics, Firebase und Google Analytics Gold gedacht.
STORE_VISIT Ein Besuch in einem Geschäft.
STORE_SALE Ein Verkauf in einem Ladengeschäft.
QUALIFIED_LEAD Eine Lead-Conversion, die aus einer externen Quelle in Google Ads importiert wurde und vom Werbetreibenden (Marketing-/Vertriebsteam) weiter qualifiziert wurde. Im Lead-to-Sale-Trichter erhalten Werbetreibende Leads und setzen sie um, indem sie sich an die Nutzer wenden. Wenn der Nutzer interessiert ist und das Produkt möglicherweise kauft, werden diese Leads vom Werbetreibenden als „qualifizierte Leads“ gekennzeichnet.
CONVERTED_LEAD Eine Lead-Conversion, die aus einer externen Quelle in Google Ads importiert wurde und eine vom Werbetreibenden für die Lead-Generierung ausgewählte 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

Dieser Wert wird verwendet, wenn Conversion-Ereignisse für diese Conversion-Aktion mit einem ungültigen, unzulässigen oder fehlenden Wert gesendet werden oder wenn diese Conversion-Aktion so konfiguriert ist, dass immer der Standardwert verwendet wird.

defaultCurrencyCode

string

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

alwaysUseDefaultValue

boolean

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

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 potenziell viele vorherige Interaktionen verteilt wird.

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

DataDrivenModelStatus

Listet die Status datengetriebener Modelle auf.

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

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 Variable für Conversions. Weitere Informationen finden Sie unter https://support.google.com/sa360/answer/13567857 im Hilfeartikel „Benutzerdefinierte Floodlight-Messwerte und -Dimensionen in der neuen Search Ads 360-Version“.

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 folgendes 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 sollten keine zusätzlichen Leerzeichen eingefügt werden.

tag

string

Erforderlich. Das Tag der benutzerdefinierten Variablen für Conversions. Das Tag muss eindeutig sein und aus einem direkt gefolgt von einer Zahl kleiner als ormequal bis 100 bestehen. Beispiel: „u4“.

status

enum (ConversionCustomVariableStatus)

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

ownerCustomer

string

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

family

enum (ConversionCustomVariableFamily)

Familie der benutzerdefinierten Conversion-Variablen.

cardinality

enum (ConversionCustomVariableCardinality)

Kardinalität der benutzerdefinierten Conversion-Variablen.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Felder für benutzerdefinierte Floodlight-Conversion-Variablen 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-Variablen.

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

Die benutzerdefinierte Conversion-Variable wird erst aktiviert, wenn der Status auf „AKTIVIERT“ gesetzt wird. Bis dahin werden keine Statistiken erfasst.

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

ENABLED Die benutzerdefinierte Variable für Conversions ist aktiviert und es werden Statistiken erfasst.
PAUSED Die benutzerdefinierte Conversion-Variable wird pausiert. Es werden erst wieder Statistiken erfasst, wenn sie wieder auf AKTIVIERT gesetzt wird.

ConversionCustomVariableFamily

Familie einer benutzerdefinierten Conversion-Variablen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
STANDARD Die standardmäßige benutzerdefinierte Conversion-Variable. Kunden müssen die Funktion vor der Verwendung aktivieren.
FLOODLIGHT Die benutzerdefinierte Conversion-Variable, die aus einer benutzerdefinierten Floodlight-Variablen importiert wurde.

ConversionCustomVariableCardinality

Kardinalität einer benutzerdefinierten Conversion-Variablen.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
BELOW_ALL_LIMITS Die Kardinalität der benutzerdefinierten Conversion-Variablen liegt unter allen Grenzwerten. Die Variable kann für die Segmentierung verwendet werden und es können Statistiken für neue Werte erfasst werden, wenn die Variable aktiviert ist.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT Die Kardinalität der benutzerdefinierten Conversion-Variablen überschreitet das Segmentierungslimit, aber nicht das Statistiklimit. Die Segmentierung wird deaktiviert, aber es können Statistiken für neue Werte erfasst werden, wenn die Variable aktiviert ist.
APPROACHES_STATS_LIMIT Die benutzerdefinierte Variable für Conversions hat die Segmentierungslimits überschritten und nähert sich den Statistiklimits (> 90%). Die Segmentierung wird deaktiviert, aber es können Statistiken 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 Statistikgrenzwerte überschritten. Die Segmentierung wird deaktiviert und Statistiken für aktivierte Variablen können nur angesammelt werden, wenn die vorhandenen Werte die Kardinalität der Variablen nicht weiter erhöhen.

FloodlightConversionCustomVariableInfo

Informationen zu benutzerdefinierten Floodlight-Conversion-Variablen 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)

In Search Ads 360 definierter Datentyp für Floodlight-Variablen.

FloodlightVariableType

Der in Search Ads 360 definierte Typ der Floodlight-Variable. 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 den Wert „Unbekannt“ in dieser Version dar.
DIMENSION Typ der Floodlight-Dimension.
METRIC Typ der Floodlight-Messwertvariablen.
UNSET Der Floodlight-Variablentyp ist nicht festgelegt.

FloodlightVariableDataType

Der Datentyp der Floodlight-Variable gemäß Definition in Search Ads 360. 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 den Wert „Unbekannt“ in dieser Version dar.
NUMBER Stellt eine Floodlight-Variable vom Typ „Zahl“ dar. Diese Variable kann Floodlight-Variablen vom Typ „DIMENSION“ oder „MESSWERT“ 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,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Felder
resourceName

string

Der Ressourcenname des Kunden. Ressourcennamen von Kunden haben das 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)

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

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".

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 endgültige 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

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)

Conversion-Tracking-Status Sie gibt an, ob der Kunde Conversion-Tracking verwendet und wer der Inhaber des Conversion-Trackings für diesen Kunden ist. Wenn dieser Kunde kontoübergreifendes Conversion-Tracking verwendet, unterscheidet sich der zurückgegebene Wert je nach login-customer-id der Anfrage.

enhancedConversionsForLeadsEnabled

boolean

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, bei dem Conversions erstellt und verwaltet werden. Dieses Feld ist schreibgeschützt.

conversionTrackingId

string (int64 format)

Die Conversion-Tracking-ID, die für dieses Konto verwendet wird. Diese ID sagt im Gegensatz zu conversionTrackingStatus nicht aus, ob der Kunde Conversion-Tracking verwendet. Dieses Feld ist schreibgeschützt.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

Die Conversion-Tracking-ID des Verwaltungskontos des Kunden. Er wird festgelegt, wenn der Kunde Conversion-Tracking aktiviert, und ü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. Dieser Wert wird festgelegt, wenn das kontoübergreifende Conversion-Tracking aktiviert ist. Er überschreibt die conversionTrackingId.

ConversionTrackingStatus

Conversion-Tracking-Status des Kunden.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen in dieser Version unbekannten Wert 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 in login-customer-id der Anfrage angegeben ist.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Die Conversion-Aktionen werden von einem Kontoverwalter erstellt und verwaltet, der nicht dem Kunden oder Manager entspricht, der in der login-customer-id der Anfrage angegeben ist.

AccountType

Mögliche Engine-Kontotypen

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

DoubleClickCampaignManagerSetting

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

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)

ID des Campaign Manager-Netzwerks, das diesem Kunden zugeordnet ist.

timeZone

string

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

AccountStatus

Mögliche Status eines Kontos.

Enums
UNSPECIFIED Standardwert.
UNKNOWN Unbekannter Wert.
ENABLED Im Konto können Anzeigen ausgeliefert werden.
PAUSED Das Konto wurde vom Nutzer deaktiviert.
SUSPENDED Das Konto wurde durch einen internen Vorgang deaktiviert.
REMOVED Das Konto wird unwiderruflich 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 in dieser Version unbekannten Wert dar.
ENABLED Gibt an, dass es sich um ein aktives Konto handelt, über das Anzeigen ausgeliefert werden können.
CANCELED Das Konto wurde gekündigt und es können keine Anzeigen ausgeliefert werden. Kann von einem Administrator wieder aktiviert werden.
SUSPENDED Über ein gesperrtes Konto können keine Anzeigen ausgeliefert werden. Kann nur vom Google-Support aktiviert werden.
CLOSED Gibt an, dass für ein geschlossenes Konto keine Anzeigen ausgeliefert werden können. Das Testkonto hat ebenfalls den Status „GESCHLOSSEN“. Der Status ist dauerhaft und kann nicht wiederhergestellt werden.

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 Kunden-Assets. Ressourcennamen „CustomerAsset“ haben folgendes 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 Asset-Gruppe. Durch das Hinzufügen eines CustomerAssetSet wird eine Asset-Gruppe 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. Asset-Ressourcennamen von Asset-Sets haben folgendes 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 diese Asset-Gruppe verknüpft ist.

status

enum (AssetSetLinkStatus)

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

AccessibleBiddingStrategy

Stellt eine Ansicht der BiddingStrategies dar, die dem Kunden gehören und mit ihm geteilt werden.

Im Gegensatz zu „Gebotsstrategie“ enthält diese Ressource neben Strategien, die dem Kunden gehören, auch Strategien, die von Administratoren des Kunden verwaltet und mit diesem geteilt werden. Diese Ressource enthält keine Messwerte und nur einen Teil 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 barrierefreien Gebotsstrategie. Ressourcennamen für AccessibleBiddingStrategy haben folgendes 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

Der beschreibende Name des Kunden, zu dem die Gebotsstrategie gehört.

Union-Feld scheme. Das Gebotsschema.

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

maximizeConversionValue

object (MaximizeConversionValue)

Eine automatische Gebotsstrategie, mit der Sie im Rahmen Ihres Budgets einen möglichst hohen Conversion-Wert für Ihre 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, die automatisch auf einen bestimmten Prozentsatz der Impressionen hin optimiert wird.

targetRoas

object (TargetRoas)

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

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 für Ihre 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.

Conversions maximieren

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)

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 der Suchanzeigen oben auf der ersten Seite (oder in einer anderen Zielregion) erscheint.

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

enum (TargetImpressionShareLocation)

Die Position der Ausrichtung auf der Suchergebnisseite.

locationFractionMicros

string (int64 format)

Der ausgewählte Anteil der Anzeigen, die an dem ausgewählten Standort ausgeliefert werden sollen, in Mikron. 1 % entspricht beispielsweise 10.000.

cpcBidCeilingMicros

string (int64 format)

Das höchste CPC-Gebot, das das automatische Gebotssystem festlegen 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 Ihren Umsatz maximieren und gleichzeitig einen bestimmten Ziel-ROAS (Return on Advertising Spend) erreichen 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 den Wert „Unbekannt“ in dieser Version dar.
ACTIVE Gibt die aktuelle in-effektive Beziehung an
INACTIVE Gibt an, dass die Beziehung beendet wurde.
PENDING Gibt an, dass die Beziehung vom Kontoverwalter angefordert, aber vom Kunden noch nicht akzeptiert wurde.
REFUSED Die Beziehung wurde vom Manager angefordert, aber der Kunde hat abgelehnt.
CANCELED Gibt an, dass eine Beziehung vom Kontoverwalter angefordert, aber vom Administrator abgebrochen wurde.

CustomerClient

Eine Verknüpfung zwischen dem jeweiligen Kunden und einem Kundenkonto. „CustomerClients“ gibt es nur für Verwaltungskonten. Alle direkten und indirekten Kunden des Kunden sowie das Verwaltungskonto selbst sind inbegriffen.

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 von Kundenkunden haben das Format: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

Die Ressourcennamen der Labels des anfragenden Kunden, die auf den Kundenkunden angewendet werden. Labelressourcennamen haben das Format:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

Der Status des Kunden. Schreibgeschützt.

clientCustomer

string

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

hidden

boolean

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

Schreibgeschützt.

level

string (int64 format)

Entfernung zwischen dem Kunden und dem Kunden. Für den Self-Link ist der Wert 0. Schreibgeschützt.

timeZone

string

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

testAccount

boolean

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

manager

boolean

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

descriptiveName

string

Beschreibender Name für den Kunden. Schreibgeschützt.

currencyCode

string

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

id

string (int64 format)

Die ID des Kunden. Schreibgeschützt.

DynamicSearchAdsSearchTermView

Eine Suchbegriffsansicht für dynamische Suchanzeigen.

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

string

Der Ressourcenname der Suchbegriffsdatenansicht für dynamische Suchanzeigen. Die Ressourcennamen der Suchbegriffansicht für dynamische Suchanzeigen haben folgendes 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

Ansicht nach Geschlecht Die Ressource „genderView“ gibt den effektiven Bereitstellungsstatus an, nicht die hinzugefügten Kriterien. Anzeigen in einer Anzeigengruppe ohne Geschlechterkriterien werden standardmäßig allen Geschlechtern präsentiert. Daher werden in der Geschlechterübersicht alle Geschlechter mit Statistiken aufgeführt.

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

string

Der Ressourcenname der Geschlechterübersicht. Ressourcennamen von Geschlechteransichten 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 folgendes Format:

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

Status der Konstanten für das geografische Ziel.

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ändige 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 folgendes Format:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

Die möglichen Status einer geografischen Zielkonstante.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dieser Wert ist nur für die Antwort zulässig.

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 der Keyword-Ansicht haben folgendes 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/{customerId}/labels/{label_id}

status

enum (LabelStatus)

Status des Labels. Schreibgeschützt.

textLabel

object (TextLabel)

Ein Labeltyp, bei dem Text auf einem farbigen Hintergrund angezeigt wird.

id

string (int64 format)

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 in dieser Version unbekannten Wert dar.
ENABLED Das Label ist aktiviert.
REMOVED Das Label wird entfernt.

TextLabel

Eine Art von Label, das Text auf einem farbigen Hintergrund anzeigt.

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 folgendes 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. „Englisch (USA)“ oder „Spanisch“.

targetable

boolean

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 Produkt-Gebotskategorie.

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 Kategorie für Produktgebote. Ressourcennamen für Produktgebotene haben das Format:

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

level

enum (ProductBiddingCategoryLevel)

Ebene der Produktkategorie für Gebote.

status

enum (ProductBiddingCategoryStatus)

Status der Gebotskategorie des Produkts.

id

string (int64 format)

ID der Gebotskategorie des Produkts.

Diese ID entspricht der ID der Google-Produktkategorie https://support.google.com/merchants/answer/6324436.

countryCode

string

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

productBiddingCategoryConstantParent

string

Ressourcenname der übergeordneten Produktkategorie für Gebote.

languageCode

string

Sprachcode der Kategorie für Produktkategorie-Gebote.

localizedName

string

Der Wert der Gebotskategorie des Produkts, der gemäß languageCode lokalisiert ist.

ProductBiddingCategoryLevel

Enum, das die Ebene der Gebotskategorie des Produkts beschreibt.

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

ProductBiddingCategoryStatus

Enum, das den Status der Produktgebotskategorie beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ 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 Produktgruppenansicht

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

string

Der Ressourcenname der Produktgruppenansicht. Ressourcennamen von Produktgruppen-Ansichten haben das Format:

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

ShoppingPerformanceView

Shopping-Leistungsansicht Statistiken zu Shopping-Kampagnen, die auf mehreren Produktdimensionsebenen zusammengefasst sind Die Werte der Produktdimensionen aus dem Merchant Center, z. B. Marke, Kategorie, benutzerdefinierte Attribute, Produktzustand und Produkttyp, spiegeln den Status der einzelnen Dimensionen zum Datum und zur Uhrzeit wider, zu dem das entsprechende Ereignis erfasst wurde.

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

string

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

UserList

Eine Nutzerliste. Dies ist eine Liste der Nutzer, auf die ein Kunde seine Anzeigen ausrichten kann.

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

string

Der Ressourcenname der Nutzerliste. Ressourcennamen für Nutzerlisten haben folgendes Format:

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

Der Typ dieser Liste.

Dieses Feld ist schreibgeschützt.

id

string (int64 format)

ID der Nutzerliste.

name

string

Der 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 den Wert „Unbekannt“ in dieser Version dar.
REMARKETING UserList als Sammlung von Conversion-Typen.
LOGICAL „UserList“ als Kombination anderer Nutzerlisten/-interessen.
EXTERNAL_REMARKETING UserList, die auf der Google Ad Manager-Plattform erstellt wurde.
RULE_BASED Mit einer Regel verknüpfte UserList.
SIMILAR UserList mit Nutzern, die denen einer anderen UserList ähneln.
CRM_BASED Nutzerliste mit selbst erhobenen CRM-Daten des Werbetreibenden in Form von E-Mails oder anderen Formaten.

UserLocationView

Eine Ansicht des Nutzerstandorts.

Die Ansicht „Nutzerstandort“ enthält alle Messwerte, die auf Länderebene zusammengefasst werden. Hierbei wird eine Zeile pro Land angezeigt. Hier werden Messwerte am tatsächlichen physischen Standort des Nutzers nach Standort mit oder ohne Ausrichtung erfasst. Wenn andere Segmentfelder verwendet werden, kann es mehr als eine Zeile pro Land geben.

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

string

Der Ressourcenname der Nutzerstandortansicht. Ressourcennamen der Ansicht "UserLocation" haben folgendes Format:

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

countryCriterionId

string (int64 format)

Kriteriums-ID für das Land.

targetingLocation

boolean

Gibt an, ob die Ausrichtung auf Standorte erfolgt ist.

WebpageView

Eine Webseitenansicht.

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

string

Der Ressourcenname der Webseitenansicht. Ressourcennamen von Webseitenansichten 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. Namen von Besucherressourcen haben das 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)

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

assetFieldType

enum (AssetFieldType)

Asset-Feldtyp des Besuchsereignisses.

ProductChannel

Aufzählung, die den Ort eines Produktangebots beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen in dieser Version unbekannten Wert 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 folgendes 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 ID-Spalte oder der FloodlightOrderId-Spalte, je nach den 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 ENTFERNT.

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 den Wert „Unbekannt“ in dieser Version dar.
VISIT Die Conversion wird einem Besuch zugeordnet.
CRITERION_AD Die Conversion wird einem Kriterium und Anzeigenpaar zugeordnet.

ConversionStatus

Mögliche Status einer Conversion.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen in dieser Version unbekannten Wert dar.
ENABLED Die Conversion 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
}
Felder
allConversionsValueByConversionDate

number

Wert aller Conversions Wenn diese Spalte mit dem Datum ausgewählt ist, bedeuten die Werte in der Datumsspalte das Conversion-Datum. Details zu den Spalten „nach_Conversion-Datum“ finden Sie unter https://support.google.com/sa360/answer/9250611.

allConversionsByConversionDate

number

Die Gesamtzahl der Conversions. Dazu gehören alle Conversions unabhängig vom Wert von „includeInConversionsMetric“. Wenn diese Spalte mit „Datum“ ausgewählt ist, beziehen sich die Werte in der Datumsspalte auf das Conversion-Datum. Weitere Informationen zu den Spalten „Nach Conversion-Datum“ finden Sie unter https://support.google.com/sa360/answer/9250611.

conversionCustomMetrics[]

object (Value)

Die benutzerdefinierten Conversion-Messwerte.

conversionsValueByConversionDate

number

Die Summe der Werte für gebotsfähige Conversions nach Conversion-Datum. Wenn diese Spalte mit „Datum“ ausgewählt ist, beziehen sich die Werte in der Datumsspalte auf das Conversion-Datum.

conversionsByConversionDate

number

Die Summe der Conversions nach Conversion-Datum für gebotsfähige Conversion-Typen. Aufgrund der Attributionsmodellierung kann der Wert auch nur anteilig sein. Wenn diese Spalte mit dem Datum ausgewählt ist, bedeuten die Werte in der Datumsspalte das Conversion-Datum.

historicalCreativeQualityScore

enum (QualityScoreBucket)

Der Verlauf des Qualitätsfaktors des Creatives.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

Die Qualität der bisherigen Nutzererfahrung mit der Landingpage.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

Die bisherige prognostizierte Klickrate (Click-through-Rate, CTR) für die Suche.

interactionEventTypes[]

enum (InteractionEventType)

Die Typen der kostenpflichtigen und kostenlosen Interaktionen.

rawEventConversionMetrics[]

object (Value)

Rohdaten zu Ereignis-Conversions

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. Dazu gehören alle Conversions 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. Dabei wird nicht berücksichtigt, ob die Anrufe entgegengenommen wurden. Die Anrufdauer wird ebenfalls nicht erfasst.

Dieser Messwert gilt nur für Feedelemente.

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 Feedelemente.

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 Feedelemente.

allConversionsFromOrder

number

Die Häufigkeit, mit der Nutzer nach dem Klick auf eine Anzeige eine Bestellung in einem Geschäft aufgegeben haben.

Dieser Messwert gilt nur für Feedelemente.

allConversionsFromOtherEngagement

number

Die Anzahl anderer Conversions, die Nutzer nach dem Klicken auf eine Anzeige ausgeführt haben (z. B. eine Rezension posten oder den Standort eines Geschäfts speichern).

Dieser Messwert gilt nur für Feedelemente.

allConversionsFromStoreVisit

number

Die geschätzte Häufigkeit, mit der Nutzer nach dem Klicken auf eine Anzeige ein Geschäft besucht haben.

Dieser Messwert gilt nur für Feedelemente.

visits

number

Klicks, die in Search Ads 360 erfasst und erfolgreich 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 Feedelemente.

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 gebotsfähige Conversions (aus Interaktion) pro infrage kommender Conversion-Interaktion. Gibt an, wie oft eine Interaktion mit einer Anzeige 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 Interaktionen, die eine Conversion auslösen können.

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. Es werden nur Conversion-Aktionen berücksichtigt, 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

Durchschnittliche Kosten pro gebotsfähigen Conversion, die für Conversions infrage kommen.

costPerCurrentModelAttributedConversion

number

Die Kosten für Anzeigeninteraktionen geteilt durch die aktuellen Conversions des Modells. Es werden nur Conversion-Aktionen berücksichtigt, 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 „alle_conversions“ enthalten.

crossDeviceConversionsByConversionDate

number

Die Anzahl der geräteübergreifenden Conversions nach Conversion-Datum. Details zu den Spalten „nach_Conversion-Datum“ finden Sie unter https://support.google.com/sa360/answer/9250611.

crossDeviceConversionsValue

number

Die Summe der geräteübergreifenden Conversions.

crossDeviceConversionsValueByConversionDate

number

Die Summe der geräteübergreifenden Conversion-Werte nach Conversion-Datum. Details zu den Spalten „nach_Conversion-Datum“ 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 aller Conversions im Feld "conversions". 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. Dabei handelt es sich um Klicks, die von Google als nicht legitim eingestuft werden und durch routinemäßige Filterverfahren erkannt werden, z. B. bekannte ungültige Zugriffe in Rechenzentren, Bots, Spiders oder andere Crawler, unregelmäßige Muster usw. 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. Dies sind ungültige 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 ausgeliefert wurde. 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 Schätzung, 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 der Anzeigen 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 Impressionen, die Sie mit Ihren 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 mit „Datum“ ausgewählt ist, beziehen sich die Werte in der Datumsspalte auf das Conversion-Datum. Weitere Informationen zu den Spalten „Nach Conversion-Datum“ 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 der gebotsfähigen Conversions durchschnittlich wert ist.

valuePerConversionsByConversionDate

number

Der Wert der gebotsfähigen Conversions nach Conversion-Datum geteilt durch die Anzahl der gebotsfähigen Conversions nach Conversion-Datum. Gibt an, wie viel eine der gebotsfähigen Conversions durchschnittlich wert ist (nach Conversion-Datum). Wenn diese Spalte mit „Datum“ ausgewählt ist, beziehen sich die Werte in der Datumsspalte auf das Conversion-Datum.

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 dies 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. Den Parameter „metric_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. Den Parameter „metric_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountCrossSellGrossProfitMicros

string (int64 format)

„Bruttogewinn aus Cross-Selling für 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. Den Parameter „metric_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountCrossSellRevenueMicros

string (int64 format)

„Cross-Selling-Umsatz für das Kundenkonto“ 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 dies 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. Den Parameter „metric_currency“ finden Sie unter https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountCrossSellUnitsSold

number

„Verkaufte Stückzahl (Cross-Selling-Einheit) des Kundenkontos“ 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 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 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)

„Bruttogewinn für 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)

„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.

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 dieser 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)“ 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.

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)

Ein int64.

floatValue

number

Eine Fließkommazahl.

doubleValue

number

Ein Double-Wert.

stringValue

string

Ein String.

QualityScoreBucket

Aufzählung der möglichen Qualitätsfaktor-Buckets.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ 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

Enum, das mögliche Arten von kostenpflichtigen und kostenlosen Interaktionen beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ 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 standardmäßige InteractionEventType für Click-Events.
ENGAGEMENT Die Absicht des Nutzers, mit der Anzeige zu interagieren.
VIDEO_VIEW Der Nutzer hat sich eine Videoanzeige angesehen.
NONE Der Standard-InteractionEventType für Conversion-Ereignisse vom Typ „Anzeigen“. Dieser wird verwendet, wenn in einer Zeile für Anzeigen-Conversions NICHT angegeben ist, dass die kostenlosen Interaktionen (z. B. Anzeigen-Conversions) beworben und als Teil der Kernmesswerte erfasst werden sollen. Dabei handelt es sich einfach um andere (Werbe-)Conversions.

Segmente

Nur-Segment-Felder

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

Die 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 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 „Anzeigengruppe“ verwendet. Gibt an, ob die Interaktionsmesswerte für das Asset selbst oder ein anderes Asset oder Anzeigenblock erfasst wurden. Interaktionen (z. B. Klicks) werden für alle Teile der ausgelieferten Anzeige gezählt (z. B. die Anzeige selbst und andere Komponenten wie Sitelinks), wenn sie zusammen ausgeliefert werden. Wenn „interactionOnThisAsset“ auf „true“ gesetzt ist, beziehen sich die Interaktionen auf dieses bestimmte Asset. Ist „interactionOnThisAsset“ auf „false“ gesetzt, beziehen sich die Interaktionen nicht auf dieses bestimmte Asset, sondern auf andere Teile der ausgelieferten Anzeige, mit der dieses Asset ausgeliefert wird.

AdNetworkType

Listet die Google Ads-Werbenetzwerktypen auf.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version nicht bekannt.
SEARCH Google-Suche.
SEARCH_PARTNERS Suchnetzwerk-Partner
CONTENT Displaynetzwerk
YOUTUBE_WATCH YouTube-Videos
MIXED Netzwerkübergreifend.

Keyword

Ein Keyword-Kriterienssegment.

JSON-Darstellung
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Felder
info

object (KeywordInfo)

Keyword-Informationen

adGroupCriterion

string

Der AdGroupCriterion-Ressourcenname.

ProductChannelExclusivity

Aufzählung, die die Verfügbarkeit eines Produktangebots beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
SINGLE_CHANNEL Der Artikel wird nur über einen Kanal verkauft, entweder in Geschäften oder online, wie im ProductChannel angegeben.
MULTI_CHANNEL Der Artikel wird mit seinem Pendant im Onlineshop oder im Geschäft abgeglichen, um anzugeben, dass er in beiden ShoppingProductChannels zum Kauf verfügbar ist.

ProductCondition

Ein Enum, das den Zustand eines Produktangebots beschreibt.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den Wert „Unbekannt“ in dieser Version dar.
OLD Der Produktzustand ist alt.
NEW Der Zustand des Produkts ist „Neu“.
REFURBISHED Der Zustand des Produkts ist aufgearbeitet.
USED Der Zustand des Produkts ist „Gebraucht“.

AssetInteractionTarget

Ein AssetInteractionTarget-Segment.

JSON-Darstellung
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Felder
asset

string

Der Name der Asset-Ressource.

interactionOnThisAsset

boolean

Wird nur mit Messwerten für CustomerAsset, CampaignAsset und AdGroupAsset verwendet. Gibt an, ob die Interaktionsmesswerte für das Asset selbst oder ein anderes Asset oder Anzeigenblock erfasst wurden.