Achtung:Sie lesen die Dokumentation für die REST-Schnittstelle der API. Die meisten unserer offiziellen Clientbibliotheken verwenden gRPC. Weitere Informationen

Diese Seite wurde von der Cloud Translation API übersetzt.

AdGroup

JSON-Darstellung
AdGroupStatus
AdGroupType
AdGroupAdRotationMode
AudienceSetting
- JSON-Darstellung

Eine Anzeigengruppe.

JSON-Darstellung

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`) ], "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 }

{
  "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)
  ],
  "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, mit denen Tags für benutzerdefinierte Parameter in `trackingUrlTemplate`, `finalUrls` oder `mobile_final_urls` ersetzt werden.
`optimizedTargetingEnabled`	`boolean` „True“, wenn das optimierte Targeting aktiviert ist. Das optimierte Targeting 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 Targeting-bezogene Funktionen.
`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-Verknüpfungen mit diesen Feldtypen werden für diese Anzeigengruppe nicht von den übergeordneten Ebenen übernommen.
`excludedParentAssetSetTypes[]`	`enum (AssetSetType)` Die Typen der Asset-Gruppen, die aus dieser Anzeigengruppe ausgeschlossen werden sollen. Verknüpfungen 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 von Standortgruppen mit dieser Anzeigengruppe verknüpft werden. Außerdem werden keine Standorterweiterungen und Affiliate-Standorterweiterungen in dieser Anzeigengruppe ausgeliefert. Derzeit wird nur LOCATION_SYNC unterstützt.
`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 manuell oder mit auto-optimiertem CPC, auf Seite 1 beworben oder als Ziel-Kompetitive Auktionsstrategie festgelegt 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 Kampagnengebotsstrategie der Anzeigengruppe „TargetCpa“ oder „MaximumConversions“ lautet (wobei das Feld „targetCpa“ festgelegt ist), überschreibt dieses Feld den in der Gebotsstrategie der Kampagne angegebenen Ziel-CPA. Andernfalls wird dieser Wert ignoriert.
`cpvBidMicros`	`string (int64 format)` Das CPC-Gebot (Cost-per-View).
`targetCpmMicros`	`string (int64 format)` Das ist der durchschnittliche Betrag in Mikroeinheiten, den ein Werbetreibender pro 1.000 Auslieferungen einer Anzeige zu zahlen bereit ist.
`targetRoas`	`number` Der Ziel-ROAS (Return on Advertising Spend) wird überschrieben. Wenn die Kampagnengebotsstrategie der Anzeigengruppe „TargetRoas“ oder „MaximumConversionValue“ lautet (mit festgelegtem Feld „targetRoas“), ü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.

AdGroupType

Aufzählung zur Auflistung der möglichen Typen einer Anzeigengruppe

Enums
`UNSPECIFIED`	Der Typ wurde nicht angegeben.
`UNKNOWN`	Der empfangene Wert ist in dieser Version nicht bekannt. Dies ist ein reiner Antwortwert.
`SEARCH_STANDARD`	Das ist der standardmäßige Anzeigengruppentyp für Suchkampagnen.
`DISPLAY_STANDARD`	Das ist der standardmäßige Anzeigengruppentyp für Displaykampagnen.
`SHOPPING_PRODUCT_ADS`	Der Anzeigengruppentyp für Shopping-Kampagnen mit standardmäßigen Produktanzeigen.
`HOTEL_ADS`	Das ist 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`	Überspringbare TrueView In-Stream-Videoanzeigen
`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 Shopping-Vergleichskampagnen.
`PROMOTED_HOTEL_ADS`	Der Anzeigengruppentyp für gesponserte Hotelanzeigen-Anzeigengruppen.
`VIDEO_RESPONSIVE`	Responsive Videoanzeigengruppen
`VIDEO_EFFICIENT_REACH`	Videokampagnen vom Typ „Effiziente Reichweite“.
`SMART_CAMPAIGN_ADS`	Anzeigengruppentyp für smarte Kampagnen.
`TRAVEL_ADS`	Anzeigengruppentyp für Reisekampagnen

AdGroupAdRotationMode

Die möglichen Modi für die Anzeigenrotation einer Anzeigengruppe.

Enums
`UNSPECIFIED`	Es wurde kein Modus für die Anzeigenrotation angegeben.
`UNKNOWN`	Der empfangene Wert ist in dieser Version nicht bekannt. Dies ist ein reiner Antwortwert.
`OPTIMIZE`	Optimieren Sie Anzeigen der Anzeigengruppe basierend auf Klicks oder Conversions.
`ROTATE_FOREVER`	Immer gleichmäßige Anzeigenrotation.

AudienceSetting

Einstellungen für die Ausrichtung auf Zielgruppen.

JSON-Darstellung
{ "useAudienceGrouped": boolean }

Felder

Felder
`useAudienceGrouped`	`boolean` Nicht veränderbar. Wenn der Wert „true“ ist, wird in dieser Anzeigengruppe eine Ressource vom Typ „Zielgruppe“ für die Ausrichtung auf Zielgruppen verwendet. Bei „false“ können stattdessen in dieser Anzeigengruppe Kriterien für Zielgruppensegmente verwendet werden.

useAudienceGrouped

boolean

Nicht veränderbar. Wenn der Wert „true“ ist, wird in dieser Anzeigengruppe eine Ressource vom Typ „Zielgruppe“ für die Ausrichtung auf Zielgruppen verwendet. Bei „false“ können stattdessen in dieser Anzeigengruppe Kriterien für Zielgruppensegmente verwendet werden.