AdGroupCriterion

Ein Kriterium für die Anzeigengruppe. Der Bericht "adGroupCriterion" gibt nur Kriterien zurück, die der Anzeigengruppe explizit hinzugefügt wurden.

JSON-Darstellung 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname des Anzeigengruppenkriteriums. Ressourcennamen für Anzeigengruppenkriterien haben das folgende Format:

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

Nur Ausgabe. Der Anzeigename des Kriteriums.

Dieses Feld wird für Mutationen ignoriert.
status

enum (AdGroupCriterionStatus)

Der Status des Kriteriums.

Dies ist der Status der vom Kunden festgelegten Anzeigengruppen-Kriteriumsentität festgelegt. Hinweis: UI-Berichte können zusätzliche Informationen enthalten, die beeinflussen, 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 die Anzeigen für sie ausgeliefert werden können. In "adwords.status" wird jedoch "entfernt" angezeigt, da kein positives Kriterium hinzugefügt wurde.
qualityInfo

object (QualityInfo)

Nur Ausgabe. Informationen zur Qualität des Kriteriums.
type

enum (CriterionType)

Nur Ausgabe. Der Typ des Kriteriums.
systemServingStatus

enum (CriterionSystemServingStatus)

Nur Ausgabe. Bereitstellungsstatus des Kriteriums.
approvalStatus

enum (AdGroupCriterionApprovalStatus)

Nur Ausgabe. Freigabestatus des Kriteriums.
disapprovalReasons[]

string

Nur Ausgabe. Liste der Ablehnungsgründe des Kriteriums.

Weitere Informationen zu den verschiedenen Gründen für die Ablehnung eines Kriteriums finden Sie unter https://support.google.com/adspolicy/answer/6008942.

Dieses Feld ist schreibgeschützt.
labels[]

string

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

enum (BiddingSource)

Nur Ausgabe. Quelle des effektiven CPC-Gebots.
effectiveCpmBidSource

enum (BiddingSource)

Nur Ausgabe. Quelle des effektiven CPM-Gebots.
effectiveCpvBidSource

enum (BiddingSource)

Nur Ausgabe. Quelle des effektiven CPV-Gebots.
effectivePercentCpcBidSource

enum (BiddingSource)

Nur Ausgabe. Quelle des effektiven prozentualen CPC-Gebots.
positionEstimates

object (PositionEstimates)

Nur Ausgabe. 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.
finalMobileUrls[]

string

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

object (CustomParameter)

Die Liste der Zuordnungen, die zum Ersetzen von Tags für benutzerdefinierte Parameter in einem trackingUrlTemplate-, finalUrls- oder mobile_final_urls-Element verwendet werden.
criterionId

string (int64 format)

Nur Ausgabe. Die ID des Kriteriums.

Dieses Feld wird für Mutationen ignoriert.
adGroup

string

Nicht veränderbar. Die Anzeigengruppe, zu der das Kriterium gehört.
negative

boolean

Nicht veränderbar. Gibt an, ob das Kriterium für das Targeting verwendet (false) oder ausgeschlossen werden soll (true).

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).
cpmBidMicros

string (int64 format)

Das CPM-Gebot (Cost-per-1000-Impressions, d. h. sichtbare Impressionen).
cpvBidMicros

string (int64 format)

Das CPC-Gebot (Cost-per-View).
percentCpcBidMicros

string (int64 format)

Der Betrag des CPC-Gebots, ausgedrückt als Bruchteil des beworbenen Preises für eine Ware oder Dienstleistung. Der gültige Bereich für den Bruch ist [0,1) und der hier gespeicherte Wert ist 1.000.000 * [fraction].
effectiveCpcBidMicros

string (int64 format)

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

string (int64 format)

Nur Ausgabe. Das effektive Gebot für CPM (Kosten pro Tausend sichtbare Impressionen).
effectiveCpvBidMicros

string (int64 format)

Nur Ausgabe. Das effektive CPV-Gebot (Cost-per-View)
effectivePercentCpcBidMicros

string (int64 format)

Nur Ausgabe. Der effektive prozentuale CPC-Gebotsbetrag.
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 eins festgelegt werden. Für criterion ist nur einer der folgenden Werte zulässig:
keyword

object (KeywordInfo)

Nicht veränderbar. Keyword
placement

object (PlacementInfo)

Nicht veränderbar. Platzierung.
mobileAppCategory

object (MobileAppCategoryInfo)

Nicht veränderbar. Kategorie "Mobile App".
mobileApplication

object (MobileApplicationInfo)

Nicht veränderbar. Mobile App
listingGroup

object (ListingGroupInfo)

Nicht veränderbar. Eintragsgruppe.
ageRange

object (AgeRangeInfo)

Nicht veränderbar. Altersgruppe.
gender

object (GenderInfo)

Nicht veränderbar. Gender.
incomeRange

object (IncomeRangeInfo)

Nicht veränderbar. Einkommensbereich.
parentalStatus

object (ParentalStatusInfo)

Nicht veränderbar. Elternstatus.
userList

object (UserListInfo)

Nicht veränderbar. Nutzerliste.
youtubeVideo

object (YouTubeVideoInfo)

Nicht veränderbar. YouTube-Video
youtubeChannel

object (YouTubeChannelInfo)

Nicht veränderbar. YouTube-Kanal
topic

object (TopicInfo)

Nicht veränderbar. Thema
userInterest

object (UserInterestInfo)

Nicht veränderbar. Nutzerinteresse
webpage

object (WebpageInfo)

Nicht veränderbar. Webseite
appPaymentModel

object (AppPaymentModelInfo)

Nicht veränderbar. App-Zahlungsmodell.
customAffinity

object (CustomAffinityInfo)

Nicht veränderbar. Benutzerdefiniertes gemeinsames Interesse.
customIntent

object (CustomIntentInfo)

Nicht veränderbar. Benutzerdefinierte Zielgruppe mit gemeinsamer Absicht.
customAudience

object (CustomAudienceInfo)

Nicht veränderbar. Benutzerdefinierte Zielgruppe.
combinedAudience

object (CombinedAudienceInfo)

Nicht veränderbar. Kombinierte Zielgruppe.
audience

object (AudienceInfo)

Nicht veränderbar. Zielgruppe.
location

object (LocationInfo)

Nicht veränderbar. Standort.
language

object (LanguageInfo)

Nicht veränderbar. Sprache

AdGroupCriterionStatus

Die möglichen Status eines Anzeigengruppenkriteriums.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

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

QualityInfo

Ein Container für Informationen zur Qualität des Anzeigengruppenkriteriums.

JSON-Darstellung 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
Felder
creativeQualityScore

enum (QualityScoreBucket)

Nur Ausgabe. Die Leistung der Anzeige im Vergleich zu anderen Werbetreibenden.
postClickQualityScore

enum (QualityScoreBucket)

Nur Ausgabe. Der Qualitätsfaktor der Landingpage.
searchPredictedCtr

enum (QualityScoreBucket)

Nur Ausgabe. Die Klickrate (Click-through-Rate, CTR) im Vergleich zu der von anderen Werbetreibenden.
qualityScore

integer

Nur Ausgabe. Der Qualitätsfaktor.

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

CriterionSystemServingStatus

Zählt den Auslieferungsstatus des Kriteriumssystems auf.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
ELIGIBLE Zulässig.
RARELY_SERVED Geringes Suchvolumen.

AdGroupCriterionApprovalStatus

Zählt den Freigabestatus für das Anzeigengruppenfeld auf.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
APPROVED Freigegeben.
DISAPPROVED Abgelehnt.
PENDING_REVIEW Überprüfung steht aus.
UNDER_REVIEW Wird überprüft.

PositionEstimates

Schätzungen für Kriteriumsgebote an verschiedenen Positionen.

JSON-Darstellung 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
Felder
firstPageCpcMicros

string (int64 format)

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

string (int64 format)

Nur Ausgabe. Dies ist die Schätzung des CPC-Gebots, das erforderlich ist, damit die Anzeige an erster Stelle auf der ersten Seite der Suchergebnisse angezeigt wird.
topOfPageCpcMicros

string (int64 format)

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

string (int64 format)

Nur Ausgabe. Schätzung, wie viele Klicks Sie pro Woche erzielen könnten, wenn Sie Ihr Keyword-Gebot in den Wert in firstPositionCpcMicros ändern
estimatedAddCostAtFirstPositionCpc

string (int64 format)

Nur Ausgabe. Schätzung, wie sich die Kosten pro Woche möglicherweise ändern, wenn Sie Ihr Keyword-Gebot auf den Wert in firstPositionCpcMicros ändern.

ListingGroupInfo

Ein Kriterium für die Eintragsgruppe.

JSON-Darstellung 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
Felder
type

enum (ListingGroupType)

Typ der Eintragsgruppe.
caseValue

object (ListingDimensionInfo)

Dimensionswert, mit dem diese Eintragsgruppe ihr übergeordnetes Element optimiert. Für die Stammgruppe nicht definiert.
parentAdGroupCriterion

string

Ressourcenname des Anzeigengruppenkriteriums, das der Untergruppe der übergeordneten Eintragsgruppe entspricht. Nullwert für die Stammgruppe.
path

object (ListingDimensionPath)

Der Pfad der Dimensionen, mit denen diese Eintragsgruppe definiert wird.

ListingGroupType

Der Typ der Eintragsgruppe.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
SUBDIVISION Unterteilung der Produkte entlang einer Eintragsdimension. Diese Knoten werden nicht für das Targeting von Listeneinträgen verwendet, sondern dienen lediglich der Definition der Struktur der Struktur.
UNIT Eintragsgruppeneinheit, die ein Gebot definiert

ListingDimensionPath

Der Pfad zu den Dimensionen, mit denen eine Eintragsgruppe definiert wird.

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

object (ListingDimensionInfo)

Der vollständige Pfad der Dimensionen über die Hierarchie der Eintragsgruppen vom Stamm (ohne den Stamm selbst) bis zur Eintragsgruppe.

AppPaymentModelInfo

Ein Kriterium für das App-Zahlungsmodell.

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

enum (AppPaymentModelType)

Typ des App-Zahlungsmodells.

AppPaymentModelType

Aufzählung zur Beschreibung möglicher App-Zahlungsmodelle.

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

CustomIntentInfo

Ein benutzerdefiniertes Kriterium mit gemeinsamer Absicht. Ein Kriterium dieses Typs ist nur für das Targeting verfügbar.

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

string

Der Name der CustomInterest-Ressource.