REST Resource: advertisers.adGroups

Ressource: Anzeigengruppe

Eine einzelne Anzeigengruppe, die einer Werbebuchung zugeordnet ist.

JSON-Darstellung 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
Felder
name

string

Der Ressourcenname der Anzeigengruppe.
advertiserId

string (int64 format)

Die eindeutige ID des Werbetreibenden, zu dem die Anzeigengruppe gehört.
adGroupId

string (int64 format)

Die eindeutige ID der Anzeigengruppe. Vom System zugewiesen.
lineItemId

string (int64 format)

Die eindeutige ID der Werbebuchung, zu der die Anzeigengruppe gehört
displayName

string

Der Anzeigename der Anzeigengruppe.

Muss UTF-8-codiert sein und darf maximal 255 Byte groß sein.
adGroupFormat

enum (AdGroupFormat)

Das Format der Anzeigen in der Anzeigengruppe.
bidStrategy

object (BiddingStrategy)

Die in der Anzeigengruppe verwendete Gebotsstrategie. In der Gebotsstrategie kann nur das Feld youtubeAndPartnersBid verwendet werden.
entityStatus

enum (EntityStatus)

Damit wird gesteuert, ob für die Anzeigengruppe das Budget und die Gebote für Inventar ausgegeben werden können oder nicht.

Wenn die übergeordnete Werbebuchung der Anzeigengruppe nicht aktiv ist, kann das Budget der Anzeigengruppe nicht ausgegeben werden, auch wenn ihr Status „ENTITY_STATUS_ACTIVE“ lautet.
targetingExpansion

object (TargetingExpansionConfig)

Die Einstellungen für die optimierte Ausrichtung der Anzeigengruppe
productFeedData

object (ProductFeedData)

Die Einstellungen des Produktfeeds in dieser Anzeigengruppe.

AdGroupFormat

Das Format der Anzeigengruppe.

Enums
AD_GROUP_FORMAT_UNSPECIFIED Der Formatwert ist in dieser Version nicht angegeben oder unbekannt.
AD_GROUP_FORMAT_IN_STREAM In-Stream-Anzeigen
AD_GROUP_FORMAT_VIDEO_DISCOVERY In-Feed-Anzeigen
AD_GROUP_FORMAT_BUMPER Bumper-Anzeigen
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Nicht überspringbare In-Stream-Anzeigen
AD_GROUP_FORMAT_AUDIO Nicht überspringbare In-Stream-Audioanzeigen
AD_GROUP_FORMAT_RESPONSIVE Responsive Anzeigen
AD_GROUP_FORMAT_REACH Anzeigengruppen für die effektive Reichweite, einschließlich In-Stream- und Bumper-Anzeigen
AD_GROUP_FORMAT_MASTHEAD Masthead-Anzeige, die auf der oberen Fläche der YouTube-Startseite erscheint.

ProductFeedData

Details zum Produktfeed.

JSON-Darstellung 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Felder
productMatchType

enum (ProductMatchType)

So werden Produkte vom Produktfeed ausgewählt.
productMatchDimensions[]

object (ProductMatchDimension)

Eine Liste der Dimensionen, die zum Abgleich von Produkten verwendet werden.
isFeedDisabled

boolean

Gibt an, ob das Anzeigen von Produkten im Produktfeed deaktiviert wurde.

ProductMatchType

Die Arten der Zuordnungen von Produkten.

Enums
PRODUCT_MATCH_TYPE_UNSPECIFIED Nicht angegeben oder unbekannt.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Alle Produkte stimmen überein.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Bestimmte Produkte sind ausgewählt.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Ordnen Sie Produkte anhand ihrer benutzerdefinierten Labels zu.

ProductMatchDimension

Eine Dimension zum Abgleich von Produkten.

JSON-Darstellung 
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
Felder
Union-Feld dimension. Die Dimension und der Wert, die bzw. der mit dem Produkt abgeglichen werden soll. Für dimension ist nur einer der folgenden Werte zulässig:
productOfferId

string

Die ID des Produktangebots, das mit einem Produkt mit derselben Angebots-ID abgeglichen werden soll.
customLabel

object (CustomLabel)

Das benutzerdefinierte Label, das alle Produkte mit diesem Label abgleichen soll.

CustomLabel

Schlüssel und Wert eines benutzerdefinierten Labels.

JSON-Darstellung 
{
  "key": enum (CustomLabelKey),
  "value": string
}
Felder
key

enum (CustomLabelKey)

Der Schlüssel des Labels.
value

string

Der Wert des Labels.

CustomLabelKey

Schlüssel des benutzerdefinierten Labels

Enums
CUSTOM_LABEL_KEY_UNSPECIFIED Nicht angegeben oder unbekannt.
CUSTOM_LABEL_KEY_0 Schlüsselindex 0.
CUSTOM_LABEL_KEY_1 Schlüsselindex 1.
CUSTOM_LABEL_KEY_2 Schlüsselindex 2.
CUSTOM_LABEL_KEY_3 Schlüsselindex 3.
CUSTOM_LABEL_KEY_4 Schlüsselindex 4.

Methoden

bulkListAdGroupAssignedTargetingOptions

 Listet zugewiesene Ausrichtungsoptionen für mehrere Anzeigengruppen und Ausrichtungstypen auf.

get

 Ruft eine Anzeigengruppe ab.

list

 Listet Anzeigengruppen auf.