REST Resource: advertisers.adGroups

Ressource: AdGroup

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)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
Felder
name

string

Nur Ausgabe. ID. Der Ressourcenname der Anzeigengruppe.
advertiserId

string (int64 format)

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

string (int64 format)

Nur Ausgabe. Die eindeutige ID der Anzeigengruppe. Wird vom System zugewiesen.
lineItemId

string (int64 format)

Erforderlich. Nicht veränderbar. Die eindeutige ID der Werbebuchung, zu der die Anzeigengruppe gehört.
displayName

string

Erforderlich. Der Anzeigename der Anzeigengruppe.

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

enum (AdGroupFormat)

Erforderlich. Nicht veränderbar. Das Format der Anzeigen in der Anzeigengruppe.
bidStrategy

object (BiddingStrategy)

Optional. Die von der Anzeigengruppe verwendete Gebotsstrategie. In der Gebotsstrategie können nur die Felder youtubeAndPartnersBid und demandGenBid verwendet werden.
entityStatus

enum (EntityStatus)

Erforderlich. Damit wird festgelegt, ob für die Anzeigengruppe Budget ausgegeben und auf Inventar geboten werden kann.

Wenn die übergeordnete Werbebuchung der Anzeigengruppe nicht aktiv ist, kann das Budget der Anzeigengruppe nicht verwendet werden, auch wenn ihr eigener Status ENTITY_STATUS_ACTIVE ist.
targetingExpansion

object (TargetingExpansionConfig)

Optional. Die Einstellungen für das optimierte Targeting der Anzeigengruppe.
productFeedData

object (ProductFeedData)

Optional. Die Einstellungen des Produktfeeds in dieser Anzeigengruppe.
adGroupInventoryControl

object (AdGroupInventoryControl)

Optional. Erforderlich für Demand Gen-Anzeigengruppen. Gibt die Inventarverwaltung der Anzeigengruppe an.
adSource

enum (AdSource)

Optional. Die Quelle der Anzeigen in dieser Anzeigengruppe. Dieses Feld wird nur verwendet, wenn Anzeigen automatisch aus einer bestimmten Quelle generiert werden.
creativeAssignments[]

object (CreativeAssignment)

Optional. Die Creatives, die zum Erstellen von Anzeigen in der Anzeigengruppe verwendet werden.

Dieses Feld kann nur zugewiesen werden, wenn „adSource“ AD_SOURCE_DV360_CREATIVE ist.

AdGroupFormat

Das Format der Anzeigengruppe.

Enums
AD_GROUP_FORMAT_UNSPECIFIED Der Formatwert ist nicht angegeben oder in dieser Version 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 effektive Reichweite, einschließlich In-Stream- und Bumper-Anzeigen.
AD_GROUP_FORMAT_MASTHEAD Masthead-Anzeige, die oben auf der YouTube-Startseite eingeblendet wird.
AD_GROUP_FORMAT_DEMAND_GEN Demand Gen-Anzeigen

ProductFeedData

Die Details des Produktfeeds.

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

enum (ProductMatchType)

Wie Produkte über den Produktfeed ausgewählt werden.
productMatchDimensions[]

object (ProductMatchDimension)

Eine Liste der Dimensionen, die für den Abgleich von Produkten verwendet werden.
isFeedDisabled

boolean

Gibt an, ob die Präsentation von Produkten für den Produktfeed deaktiviert wurde.

ProductMatchType

Die Arten, wie Produkte abgeglichen werden können.

Enums
PRODUCT_MATCH_TYPE_UNSPECIFIED Nicht angegeben oder unbekannt.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Alle Produkte wurden zugeordnet.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Bestimmte Produkte sind ausgewählt.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Produkte anhand ihrer benutzerdefinierten Labels abgleichen.

ProductMatchDimension

Eine Dimension, die zum Abgleich von Produkten verwendet wird.

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
Felder
Die Dimension und der Wert, mit denen das Produkt übereinstimmen muss. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
productOfferId

string

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

object (CustomLabel)

Das benutzerdefinierte Label, das mit allen Produkten mit dem Label übereinstimmen soll.
Ende der sich gegenseitig ausschließenden Felder.

CustomLabel

Der Schlüssel und der 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

Der 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.

AdGroupInventoryControl

Die Inventarverwaltung der Anzeigengruppe.

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
Felder
Die Inventarverwaltung der Anzeigengruppe. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

Die Inventarstrategie.
selectedInventories

object (SelectedInventories)

Die ausgewählten Inventare.
Ende der sich gegenseitig ausschließenden Felder.

AdGroupInventoryStrategy

Die Inventarstrategie für die Anzeigengruppe.

Enums
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED Nicht angegeben oder unbekannt.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY Die Anzeigengruppe ist für das gesamte Inventar von Google und aus dem Displaynetzwerk aktiviert.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY Die Anzeigengruppe ist für das gesamte Google-Inventar aktiviert.

SelectedInventories

Die Inventarverwaltung der Anzeigengruppe.

JSON-Darstellung 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
Felder
allowYoutubeStream

boolean

Gibt an, ob die Anzeigengruppe für YouTube-In-Stream-Inventar aktiviert ist.
allowYoutubeShorts

boolean

Gibt an, ob die Anzeigengruppe für YouTube Shorts-Inventar aktiviert ist.
allowYoutubeFeed

boolean

Gibt an, ob die Anzeigengruppe für YouTube-In-Feed-Inventar aktiviert ist.
allowDiscover

boolean

Gibt an, ob die Anzeigengruppe für Discover-Inventar aktiviert ist.
allowGmail

boolean

Gibt an, ob die Anzeigengruppe für Gmail-Inventar aktiviert ist.
allowGoogleDisplayNetwork

boolean

Gibt an, ob die Anzeigengruppe für das Inventar des Google Displaynetzwerks aktiviert ist.

AdSource

Quelle für die Anzeigen in dieser Anzeigengruppe.

Enums
AD_SOURCE_UNSPECIFIED Nicht angegeben oder unbekannt. Die Standardeinstellung ist „Normale Anzeigenquelle“.
AD_SOURCE_DV360_CREATIVE Aus einem DV360-Creative.

CreativeAssignment

Die Details eines Creatives, das der Anzeigengruppe zugewiesen ist.

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

string (int64 format)

Erforderlich. Die ID des Display & Video 360-Creatives, das der Anzeigengruppe zugewiesen ist.

Methoden

bulkEditAssignedTargetingOptions

 Targeting-Optionen für mehrere Anzeigengruppen gleichzeitig bearbeiten

bulkListAssignedTargetingOptions

 Hier werden die Targeting-Optionen aufgeführt, die mehreren Anzeigengruppen für verschiedene Targeting-Typen zugewiesen sind.

create

 Erstellt eine neue Anzeigengruppe.

delete

 Löscht eine AdGroup.

get

 Ruft eine Anzeigengruppe ab.

list

 Anzeigengruppen auflisten

patch

 Aktualisiert eine vorhandene Anzeigengruppe.