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)
    }
  ],
  "primaryStatusReasons": [
    enum (AdGroupCriterionPrimaryStatusReason)
  ],
  "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,
  "primaryStatus": enum (AdGroupCriterionPrimaryStatus),

  // 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 folgendes 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: Berichte der Benutzeroberfläche können zusätzliche Informationen enthalten, die sich darauf auswirken, ob ein Kriterium erstellt 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. In der Benutzeroberfläche wird für jede Altersgruppe der Status „Aktiviert“ angezeigt, da die Anzeigen für diese Nutzer ausgeliefert werden können. Für AdGroupCriterion.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.

Die verschiedenen Gründe für die Ablehnung eines Kriteriums finden Sie hier: 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 verwendet werden, um Tags mit benutzerdefinierten Parametern in trackingUrlTemplate, finalUrls oder mobile_final_urls zu ersetzen.
primaryStatusReasons[]

enum (AdGroupCriterionPrimaryStatusReason)

Nur Ausgabe. Die primären Statusgründe für das Anzeigengruppenkriterium.
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 (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).
cpmBidMicros

string (int64 format)

Das CPM-Gebot (sichtbare Cost-per-1000-Impressions).
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 Betrag für das prozentuale CPC-Gebot.
finalUrlSuffix

string

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

string

Die URL-Vorlage zum Erstellen einer Tracking-URL.
primaryStatus

enum (AdGroupCriterionPrimaryStatus)

Nur Ausgabe. Der primäre Status für das Anzeigengruppenkriterium.

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

Es muss genau ein Wert 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. Placement
mobileAppCategory

object (MobileAppCategoryInfo)

Nicht veränderbar. Kategorie mobiler Apps.
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 nur eine Antwort.
ENABLED Das Kriterium für die Anzeigengruppe ist aktiviert.
PAUSED Das Kriterium für die Anzeigengruppe ist pausiert.
REMOVED Das Anzeigengruppenkriterium 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

Listet den Auslieferungsstatus des Kriteriumssystems auf.

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

AdGroupCriterionApprovalStatus

Listet die Anzeigengruppen-Freigabestatus 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 der Anzahl an Klicks, die Sie pro Woche erzielen könnten, wenn Sie das Keyword-Gebot auf den Wert in „firstPositionCpcMicros“ ändern.
estimatedAddCostAtFirstPositionCpc

string (int64 format)

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

AdGroupCriterionPrimaryStatus

Aufzählung mit Beschreibung des möglichen primären Status des Anzeigengruppenkriteriums Enthält Informationen dazu, warum die Auslieferung eines Kriteriums einer Anzeigengruppe nicht oder nicht optimal funktioniert.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen in dieser Version unbekannten Wert dar.
ELIGIBLE Das Kriterium für die Anzeigengruppe kann ausgeliefert werden.
PAUSED Das Kriterium für die Anzeigengruppe ist pausiert.
REMOVED Das Anzeigengruppenkriterium wird entfernt.
PENDING Das Kriterium für die Anzeigengruppe ist ausstehend.
NOT_ELIGIBLE Das Kriterium für die Anzeigengruppe kann nicht ausgeliefert werden.

AdGroupCriterionPrimaryStatusReason

Aufzählung mit möglichen Gründen für den primären Status des Anzeigengruppenkriteriums Enthält Informationen dazu, warum ein Anzeigengruppenkriterium nicht oder nicht optimal ausgeliefert wird. Diese Gründe werden zusammengefasst, um den primären Status eines Anzeigengruppenkriteriums zu ermitteln.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
CAMPAIGN_PENDING Die vom Nutzer angegebene Startzeit für diese Kampagne liegt in der Zukunft. Leistet einen Beitrag zu "AdGroupCriterionPrimaryStatus.PENDING".
CAMPAIGN_CRITERION_NEGATIVE Das Anzeigengruppenkriterium wird durch ein auszuschließendes Kampagnenkriterium überschrieben. Trägt zu "AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE" bei.
CAMPAIGN_PAUSED Der vom Nutzer angegebene Kampagnenstatus ist „Pausiert“. Trägt zu "AdGroupCriterionPrimaryStatus.PAUS" bei.
CAMPAIGN_REMOVED Der vom Nutzer angegebene Kampagnenstatus wird entfernt. Trägt zum Element "AdGroupCriterionPrimaryStatus.REMOVED" bei.
CAMPAIGN_ENDED Die vom Nutzer angegebene Zeit für das Ende dieser Kampagne ist verstrichen. Leistet einen Beitrag zu "AdGroupCriterionPrimaryStatus.ENDED".
AD_GROUP_PAUSED Der vom Nutzer angegebene Anzeigengruppenstatus ist „Pausiert“. Trägt zu "AdGroupCriterionPrimaryStatus.PAUS" bei.
AD_GROUP_REMOVED Der vom Nutzer angegebene Anzeigengruppenstatus wird entfernt. Trägt zum Element "AdGroupCriterionPrimaryStatus.REMOVED" bei.
AD_GROUP_CRITERION_DISAPPROVED Das Kriterium für die Anzeigengruppe wurde vom Freigabesystem für Anzeigen abgelehnt. Trägt zu "AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE" bei.
AD_GROUP_CRITERION_RARELY_SERVED Das Kriterium für die Anzeigengruppe wird selten ausgeliefert. Trägt zu "AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE" bei.
AD_GROUP_CRITERION_LOW_QUALITY Das Kriterium für die Anzeigengruppe hat einen niedrigen Qualitätsfaktor. Trägt zu "AdGroupCriterionPrimaryStatus.LIMITED" bei.
AD_GROUP_CRITERION_UNDER_REVIEW Das Kriterium für die Anzeigengruppe wird überprüft. Leistet einen Beitrag zu "AdGroupCriterionPrimaryStatus.PENDING".
AD_GROUP_CRITERION_PENDING_REVIEW Die Überprüfung des Kriteriums für die Anzeigengruppe steht noch aus. Trägt zu "AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE" bei.
AD_GROUP_CRITERION_BELOW_FIRST_PAGE_BID Das Gebot für das Kriterium für die Anzeigengruppe liegt unter dem Wert, der für die Auslieferung auf der ersten Seite erforderlich ist. Trägt zu "AdGroupCriterionPrimaryStatus.LIMITED" bei.
AD_GROUP_CRITERION_NEGATIVE Das Kriterium für die Anzeigengruppe ist negativ. Trägt zu "AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE" bei.
AD_GROUP_CRITERION_RESTRICTED Das Kriterium für die Anzeigengruppe ist eingeschränkt. Trägt zu "AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE" bei.
AD_GROUP_CRITERION_PAUSED Der Status des vom Nutzer angegebenen Anzeigengruppenkriteriums ist „Pausiert“. Trägt zu "AdGroupCriterionPrimaryStatus.PAUS" bei.
AD_GROUP_CRITERION_PAUSED_DUE_TO_LOW_ACTIVITY Das Kriterium für die Anzeigengruppe wurde aufgrund einer anhaltenden geringen Aktivität pausiert. Trägt zu "AdGroupCriterionPrimaryStatus.PAUS" bei.
AD_GROUP_CRITERION_REMOVED Der vom Nutzer angegebene Status des Anzeigengruppenkriteriums wird entfernt. Trägt zum Element "AdGroupCriterionPrimaryStatus.REMOVED" bei.

ListingGroupInfo

Ein Kriterium für eine 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 das übergeordnete Element optimiert. Nicht definiert für die Stammgruppe.
parentAdGroupCriterion

string

Ressourcenname des Anzeigengruppenkriteriums, bei dem es sich um die übergeordnete Untergruppe der Eintragsgruppe handelt. Nullwert für die Stammgruppe.
path

object (ListingDimensionPath)

Der Pfad der Dimensionen, über die diese Eintragsgruppe definiert wird.

ListingGroupType

Der Typ der Eintragsgruppe.

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

ListingDimensionPath

Der Pfad der Dimensionen, über die eine Eintragsgruppe definiert wird.

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

object (ListingDimensionInfo)

Der vollständige Pfad der Dimensionen durch die Hierarchie der Eintragsgruppen vom Stamm (mit Ausnahme des Stamms 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 in dieser Version unbekannten Wert dar.
PAID Kostenpflichtige Apps

CustomIntentInfo

Ein benutzerdefiniertes Kriterium mit gemeinsamer Absicht. Für ein Kriterium dieses Typs ist nur eine Ausrichtung möglich.

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

string

Der Ressourcenname von CustomInterest