AdGroup

Eine Anzeigengruppe.

JSON-Darstellung 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname der Anzeigengruppe. Ressourcennamen von Anzeigengruppen haben das folgende Format:

customers/{customerId}/adGroups/{adGroupId}
status

enum (AdGroupStatus)

Der Status der Anzeigengruppe.
type

enum (AdGroupType)

Nicht veränderbar. Der Typ der Anzeigengruppe.
adRotationMode

enum (AdGroupAdRotationMode)

Der Modus der Anzeigenrotation der Anzeigengruppe.
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.
optimizedTargetingEnabled

boolean

„True“, wenn das optimierte Targeting aktiviert ist. Optimierte Ausrichtung ersetzt die Zielgruppenerweiterung.
displayCustomBidDimension

enum (TargetingDimension)

Werbetreibende können eine Ausrichtungsdimension angeben, auf der absolute Gebote platziert werden sollen. Dies gilt nur für Kampagnen, die nur auf das Displaynetzwerk und nicht auf die Suche abzielen.
targetingSetting

object (TargetingSetting)

Einstellung für Funktionen im Zusammenhang mit der Ausrichtung.
audienceSetting

object (AudienceSetting)

Nicht veränderbar. Einstellung für zielgruppenbezogene Funktionen.
effectiveTargetCpaSource

enum (BiddingSource)

Nur Ausgabe. Quelle des effektiven Ziel-CPA. Dieses Feld ist schreibgeschützt.
effectiveTargetRoasSource

enum (BiddingSource)

Nur Ausgabe. Quelle des effektiven Ziel-ROAS. Dieses Feld ist schreibgeschützt.
labels[]

string

Nur Ausgabe. Die Ressourcennamen der Labels, die dieser Anzeigengruppe zugeordnet sind.
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Die Asset-Feldtypen, die aus dieser Anzeigengruppe ausgeschlossen werden sollen. Asset-Links mit diesen Feldtypen werden von den übergeordneten Ebenen nicht für diese Anzeigengruppe übernommen.
excludedParentAssetSetTypes[]

enum (AssetSetType)

Die Typen der Asset-Gruppen, die aus dieser Anzeigengruppe ausgeschlossen werden sollen. Links zu Asset-Gruppen mit diesen Typen werden für diese Anzeigengruppe nicht von den übergeordneten Ebenen übernommen. Die Standortgruppentypen (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP und STATIC_LOCATION_GROUP) sind untergeordnete Typen von „LOCATION_SYNC“. Wenn also LOCATION_SYNC für dieses Feld festgelegt ist, dürfen keine Asset-Gruppen für Standortgruppen mit dieser Anzeigengruppe verknüpft werden und keine Standorterweiterungs- und Affiliate-Standorterweiterungen in dieser Anzeigengruppe. Derzeit wird nur LOCATION_SYNC unterstützt.
primaryStatus

enum (AdGroupPrimaryStatus)

Nur Ausgabe. Bietet einen Überblick darüber, warum eine Anzeigengruppe nicht oder nicht optimal ausgeliefert wird.
primaryStatusReasons[]

enum (AdGroupPrimaryStatusReason)

Nur Ausgabe. Enthält Gründe, warum eine Anzeigengruppe nicht oder nicht optimal ausgeliefert wird.
id

string (int64 format)

Nur Ausgabe. 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.
baseAdGroup

string

Nur Ausgabe. Bei Entwurfs- oder Testanzeigengruppen ist das Feld der Ressourcenname der Basisanzeigengruppe, aus der diese Anzeigengruppe erstellt wurde. Wenn ein Entwurfs- oder eine Testanzeigengruppe keine Basisanzeigengruppe hat, ist dieses Feld null.

Bei Basisanzeigengruppen entspricht das Feld dem Ressourcennamen der Anzeigengruppe.

Dieses Feld ist schreibgeschützt.
trackingUrlTemplate

string

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

string

Nicht veränderbar. Die Kampagne, zu der die Anzeigengruppe gehört.
cpcBidMicros

string (int64 format)

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

string (int64 format)

Nur Ausgabe. Der Wert entspricht dem Wert des CPC-Gebots (Cost-per-Click), wenn die Gebotsstrategie entweder „Manueller CPC“, „Auto-optimierter CPC“, „Auf Seite 1 beworben“ oder „Kompetitive Auktionsposition“ oder „Kompetitive Auktionsposition“ ist. Andernfalls ist der Wert null.
cpmBidMicros

string (int64 format)

Das maximale Gebot für CPM (Kosten pro Tausend sichtbare Impressionen).
targetCpaMicros

string (int64 format)

Ziel-CPA (Cost-per-Acquisition) Wenn die Gebotsstrategie der Anzeigengruppe für die Kampagne „TargetCpa“ oder „Maximum Conversions“ (bei festgelegtem Feld „targetCpa“) ist, überschreibt dieses Feld den in der Gebotsstrategie der Kampagne festgelegten Ziel-CPA. Andernfalls wird dieser Wert ignoriert.
cpvBidMicros

string (int64 format)

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

string (int64 format)

Durchschnittlicher Betrag in Mikros, den ein Werbetreibender pro 1.000 Auslieferungen einer Anzeige zu zahlen bereit ist.
targetRoas

number

Die Überschreibung des Ziel-ROAS (Return on Advertising Spend). Wenn die Kampagnen-Gebotsstrategie der Anzeigengruppe TargetRoas oder {8/}ConversionValue (mit festgelegtem targetRoas-Feld) lautet, überschreibt dieses Feld den in der Gebotsstrategie der Kampagne angegebenen Ziel-ROAS. Andernfalls wird dieser Wert ignoriert.
percentCpcBidMicros

string (int64 format)

Der prozentuale CPC-Gebotsbetrag, 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].
finalUrlSuffix

string

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

string (int64 format)

Nur Ausgabe. Der effektive Ziel-CPA (Cost-per-Acquisition). Dieses Feld ist schreibgeschützt.
effectiveTargetRoas

number

Nur Ausgabe. Der effektive Ziel-ROAS (Return on Advertising Spend). Dieses Feld ist schreibgeschützt.

AdGroupStatus

Die möglichen Status einer Anzeigengruppe.

Enums
UNSPECIFIED Der Status wurde nicht angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.
ENABLED Die Anzeigengruppe ist aktiviert.
PAUSED Die Anzeigengruppe ist pausiert.
REMOVED Die Anzeigengruppe wird entfernt.

AdGroupAdRotationMode

Die möglichen Modi der Anzeigenrotation einer Anzeigengruppe.

Enums
UNSPECIFIED Der Modus für die Anzeigenrotation wurde nicht angegeben.
UNKNOWN

Der empfangene Wert ist in dieser Version nicht bekannt.

Dies ist ein reiner Antwortwert.
OPTIMIZE Sie können Anzeigen in Anzeigengruppen basierend auf Klicks oder Conversions optimieren.
ROTATE_FOREVER Immer gleichmäßige Anzeigenrotation.

AudienceSetting

Einstellungen für das Zielgruppen-Targeting.

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

boolean

Nicht veränderbar. Wenn „true“ festgelegt ist, wird in dieser Anzeigengruppe eine Zielgruppenressource für die Ausrichtung auf Zielgruppen verwendet. Bei „false“ können in dieser Anzeigengruppe stattdessen Zielgruppensegmentkriterien verwendet werden.

AdGroupPrimaryStatus

Die möglichen Status einer Anzeigengruppe.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
ELIGIBLE Die Anzeigengruppe kann ausgeliefert werden.
PAUSED Die Anzeigengruppe ist pausiert.
REMOVED Die Anzeigengruppe wird entfernt.
PENDING Die Anzeigengruppe wird möglicherweise künftig ausgeliefert.
NOT_ELIGIBLE Die Anzeigengruppe ist nicht für die Auslieferung qualifiziert.
LIMITED Die Anzeigengruppe kann nur eingeschränkt ausgeliefert werden.

AdGroupPrimaryStatusReason

Mögliche Gründe für den Anzeigengruppenstatus.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
CAMPAIGN_REMOVED Der benutzerdefinierte Kampagnenstatus wird entfernt. Unterstützt "AnzeigengruppenPrimaryStatus.NOT_ELIGIBLE"
CAMPAIGN_PAUSED Der benutzerdefinierte Kampagnenstatus ist „Pausiert“. Unterstützt "AnzeigengruppenPrimaryStatus.NOT_ELIGIBLE"
CAMPAIGN_PENDING Die vom Nutzer angegebene Startzeit für diese Kampagne liegt in der Zukunft. Trägt zu AnzeigengruppenPrimaryStatus.NOT_ELIGIBLE bei
CAMPAIGN_ENDED Die vom Nutzer angegebene Zeit für das Ende dieser Kampagne ist verstrichen. Unterstützt "AnzeigengruppenPrimaryStatus.NOT_ELIGIBLE"
AD_GROUP_PAUSED Der vom Nutzer angegebene Anzeigengruppenstatus ist „Pausiert“. Trägt zu AnzeigengruppenPrimaryStatus.PAUSE bei
AD_GROUP_REMOVED Der benutzerdefinierte Anzeigengruppenstatus wird entfernt. Trägt zu AnzeigengruppenPrimaryStatus.REMOVE bei
AD_GROUP_INCOMPLETE Die Erstellung dieser Anzeigengruppe ist noch nicht abgeschlossen. Unterstützt "AnzeigengruppenPrimaryStatus.NOT_ELIGIBLE"
KEYWORDS_PAUSED Die benutzerdefinierten Keyword-Status in dieser Anzeigengruppe sind alle pausiert. Unterstützt "AnzeigengruppenPrimaryStatus.NOT_ELIGIBLE"
NO_KEYWORDS In dieser Anzeigengruppe sind keine aktiven Keywords vorhanden. Unterstützt "AnzeigengruppenPrimaryStatus.NOT_ELIGIBLE"
AD_GROUP_ADS_PAUSED Die benutzerdefinierten Anzeigenstatus der Anzeigengruppe in dieser Anzeigengruppe sind alle pausiert. Unterstützt "AnzeigengruppenPrimaryStatus.NOT_ELIGIBLE"
NO_AD_GROUP_ADS Diese Anzeigengruppe enthält keine aktiven Anzeigen aus der Anzeigengruppe. Unterstützt "AnzeigengruppenPrimaryStatus.NOT_ELIGIBLE"
HAS_ADS_DISAPPROVED Grund für den Richtlinienstatus, wenn mindestens eine Anzeige abgelehnt wurde. Trägt zu mehreren AnzeigengruppenPrimaryStatus bei
HAS_ADS_LIMITED_BY_POLICY Grund für den Richtlinienstatus, wenn mindestens eine Anzeige durch eine Richtlinie eingeschränkt ist. Trägt zu mehreren AnzeigengruppenPrimaryStatus bei
MOST_ADS_UNDER_REVIEW Grund für den Richtlinienstatus, wenn die Überprüfung der meisten Anzeigen noch aussteht. Unterstützt "AnzeigengruppenPrimaryStatus.PENDING".
CAMPAIGN_DRAFT Die Anzeigengruppe gehört zu einem Kampagnenentwurf. Unterstützt "AnzeigengruppenPrimaryStatus.NOT_ELIGIBLE"
AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY Die Anzeigengruppe wurde pausiert, da sie seit längerer Zeit weniger ausgeliefert wird. Trägt zu AnzeigengruppenPrimaryStatus.PAUSE bei