Eine Anzeigengruppe.
JSON-Darstellung |
---|
{ "resourceName": string, "status": enum ( |
Felder | |
---|---|
resourceName |
Nicht veränderbar. Der Ressourcenname der Anzeigengruppe. Ressourcennamen von Anzeigengruppen haben das folgende Format:
|
status |
Der Status der Anzeigengruppe. |
type |
Nicht veränderbar. Der Typ der Anzeigengruppe. |
adRotationMode |
Der Modus der Anzeigenrotation der Anzeigengruppe. |
urlCustomParameters[] |
Die Liste der Zuordnungen, mit denen Tags für benutzerdefinierte Parameter in |
optimizedTargetingEnabled |
„True“, wenn das optimierte Targeting aktiviert ist. Das optimierte Targeting ersetzt die Zielgruppenerweiterung. |
displayCustomBidDimension |
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 |
Einstellung für Targeting-bezogene Funktionen. |
audienceSetting |
Nicht veränderbar. Einstellung für zielgruppenbezogene Funktionen. |
effectiveTargetCpaSource |
Nur Ausgabe Quelle des effektiven Ziel-CPA. Dieses Feld ist schreibgeschützt. |
effectiveTargetRoasSource |
Nur Ausgabe Quelle des effektiven Ziel-ROAS. Dieses Feld ist schreibgeschützt. |
labels[] |
Nur Ausgabe Die Ressourcennamen der Labels, die dieser Anzeigengruppe zugeordnet sind. |
excludedParentAssetFieldTypes[] |
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[] |
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 |
Nur Ausgabe Die ID der Anzeigengruppe. |
name |
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 |
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 |
Die URL-Vorlage zum Erstellen einer Tracking-URL. |
campaign |
Nicht veränderbar. Die Kampagne, zu der die Anzeigengruppe gehört. |
cpcBidMicros |
Das maximale CPC-Gebot (Cost-per-Click). |
effectiveCpcBidMicros |
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 |
Das maximale Gebot für CPM (Kosten pro Tausend sichtbare Impressionen). |
targetCpaMicros |
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 |
Das CPC-Gebot (Cost-per-View). |
targetCpmMicros |
Das ist der durchschnittliche Betrag in Mikroeinheiten, den ein Werbetreibender pro 1.000 Auslieferungen einer Anzeige zu zahlen bereit ist. |
targetRoas |
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 |
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 |
URL-Vorlage zum Anhängen von Parametern an die finale URL |
effectiveTargetCpaMicros |
Nur Ausgabe Der effektive Ziel-CPA (Cost-per-Acquisition). Dieses Feld ist schreibgeschützt. |
effectiveTargetRoas |
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 | |
---|---|
useAudienceGrouped |
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. |