AdsApp

Dies ist das Objekt der obersten Ebene, das für den Zugriff auf und die Verwaltung eines einzelnen Kontos verwendet wird.

Hinweis

Dieses Objekt ersetzt das BingAdsApp-Objekt . In naher Zukunft wird Scripts die BingAdsApp weiterhin für die Abwärtskompatibilität unterstützen. Es wird jedoch empfohlen, Ihre Skripts so schnell wie möglich zu aktualisieren, um dieses Objekt zu verwenden.

Methoden

Methodenname	Rückgabetyp	Beschreibung
adGroups	AdGroupSelector	Ruft eine Auswahl ab, die zum Filtern der Liste der Anzeigengruppen in diesem Konto verwendet wird.
Anzeigen	AdSelector	Ruft eine Auswahl ab, die zum Filtern der Liste der Anzeigen in diesem Konto verwendet wird.
Budgets erstellen	BudgetSelector	Ruft einen Selektor ab, der zum Filtern der Liste der gemeinsamen Budgets in diesem Konto verwendet wird.
Kampagnen	CampaignSelector	Ruft eine Auswahl ab, die zum Filtern der Liste der Kampagnen in diesem Konto verwendet wird.
createLabel(string name, string description, string backgroundColor)	void	Erstellt eine Beschriftung.
currentAccount	Account	Ruft das Konto ab, das das Skript gerade verarbeitet.
getExecutionInfo	ExecutionInfo	Gibt Informationen über die Umgebung zurück, in der das Skript derzeit ausgeführt wird.
Schlüsselbegriffe	KeywordSelector	Ruft einen Selektor ab, der zum Filtern der Keyword-Liste in diesem Konto verwendet wird.
Bezeichnungen	LabelSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Bezeichnungen in diesem Konto verwendet wird.
negativeKeywordLists	NegativeKeywordListSelector	Ruft einen Selektor ab, der zum Filtern der Liste mit auszuschließenden Schlüsselwörtern (Keyword) in diesem Konto verwendet wird.
newNegativeKeywordListBuilder	NegativeKeywordListBuilder	Ruft einen Generator ab, der verwendet wird, um diesem Konto eine Liste mit negativen Schlüsselwörtern (Keyword) hinzuzufügen.
performanceMaxCampaigns	CampaignSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Kampagnen mit maximaler Leistung in diesem Konto verwendet wird.
productGroups	ProductGroupSelector	Ruft eine Auswahl ab, die zum Filtern der Liste der Produktgruppen in diesem Konto verwendet wird.
shoppingAdGroups	AdGroupSelector	Ruft eine Auswahl ab, die zum Filtern der Liste der Anzeigengruppen verwendet wird, die für Shopping in diesem Konto verwendet werden.
shoppingCampaigns	CampaignSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Kampagnen verwendet wird, die für Einkäufe in diesem Konto verwendet werden.
userLists	UserListSelector	Ruft einen Selektor ab, der zum Filtern der Liste der Benutzerlisten in diesem Konto verwendet wird.

adGroups

Ruft eine Auswahl ab, die zum Filtern der Liste der Anzeigengruppen in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
AdGroupSelector	Ein Selektor, der zum Filtern der Liste der Anzeigengruppen im aktuellen Konto verwendet wird.

Anzeigen

Ruft eine Auswahl ab, die zum Filtern der Liste der Anzeigen in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
AdSelector	Ein Selektor, der zum Filtern der Anzeigenliste im aktuellen Konto verwendet wird.

Budgets erstellen

Ruft einen Selektor ab, der zum Filtern der Liste der gemeinsamen Budgets in diesem Konto verwendet wird.

Mit dieser Methode werden nur gemeinsame Budgets zurückgegeben. Um nicht freigegebene Budgets (einzelne Kampagnenbudgets) abzurufen, rufen Sie die getBudget-Methode der jeweiligen Kampagne auf. Das Budget der Kampagne wird nicht freigegeben, wenn die Methode "false" isExplicitlyShared zurückgibt.

Rückgabewerte

Typ	Beschreibung
BudgetSelector	Ein Selektor, der zum Filtern der Liste der gemeinsamen Budgets im aktuellen Konto verwendet wird.

Kampagnen

Ruft eine Auswahl ab, die zum Filtern der Liste der Kampagnen in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
CampaignSelector	Ein Selektor, der zum Filtern der Liste der Kampagnen im aktuellen Konto verwendet wird.

createLabel(string name, string description, string backgroundColor)

Erstellt eine Beschriftung.

Informationen zu Grenzwerten für die Anzahl der Bezeichnungen, die Sie pro Konto erstellen können, finden Sie unter Limits. Ein Beispiel, das einem Konto eine Bezeichnung hinzufügt, finden Sie unter Verwenden von Bezeichnungen.

Argumente

Name	Typ	Beschreibung
backgroundColor	string	Optional. Die Hintergrundfarbe, die in der Benutzeroberfläche für die Bezeichnung verwendet werden soll. Sie können die Farbe angeben mit: Eine Drei-Byte-Hexadezimalzahl im Format #RRGGBB. Beispielsweise #CB0400. Einer der 16 bekannten CSS-Farbnamen. Zum Beispiel Aqua, Gelb und Fuchsia. Berücksichtigen Sie bei der Farbauswahl die Barrierefreiheit. Wenn nicht angegeben, wird eine zufällige Farbe für Sie ausgewählt.
description	string	Optional. Eine Beschreibung, die die Verwendung der Bezeichnung beschreibt. Die maximale Größe beträgt 200 Zeichen. Wenn Sie backgroundColorangeben, müssen Sie eine Beschreibung oder eine leere Zeichenfolge ("") angeben.
name	string	Erforderlich. Der Name der Bezeichnung. Der Name muss zwischen Groß- und Kleinschreibung unterscheiden und innerhalb des Kontos eindeutig sein. Die maximale Größe beträgt 80 Zeichen. Die Methode schneidet führende und nachgestellte Leerzeichen aus dem Namen ab.

Rückgabewerte

Typ	Beschreibung
void	Gibt Nothing zurück.

currentAccount

Ruft das Konto ab, das das Skript gerade verarbeitet.

Hinweis

Um diese Methode in einem Szenario mit mehreren Konten anzuwenden, wählen Sie zunächst ein Konto aus, das Sie verwalten möchten. Wenn Sie diese Methode aufrufen, bevor Sie ein Konto auswählen, gibt der Aufruf null zurück.

Rückgabewerte

Typ	Beschreibung
Account	Das Konto, das das Skript gerade verarbeitet. Informationen zur Verwendung in einem Szenario mit mehreren Konten finden Sie in der Auswahlmethode von AccountsApp.

getExecutionInfo

Gibt Informationen über die Umgebung zurück, in der das Skript derzeit ausgeführt wird.

Rückgabewerte:

Typ	Beschreibung
ExecutionInfo	Informationen über die Umgebung, in der das Skript derzeit ausgeführt wird.

"keywords"

Ruft einen Selektor ab, der zum Filtern der Keyword-Liste in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
KeywordSelector	Ein Selektor, der zum Filtern der Keyword-Liste im aktuellen Konto verwendet wird.

Bezeichnungen

Ruft einen Selektor ab, der zum Filtern der Liste der Bezeichnungen in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
LabelSelector	Ein Selektor, der zum Filtern der Liste der Bezeichnungen im aktuellen Konto verwendet wird.

negativeKeywordLists

Ruft einen Selektor ab, der zum Filtern der Liste mit auszuschließenden Schlüsselwörtern (Keyword) in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
NegativeKeywordListSelector	Ein Selektor, der zum Filtern der Liste mit negativen Schlüsselworten (Keyword) im aktuellen Konto verwendet wird.

newNegativeKeywordListBuilder

Ruft einen Generator ab, der verwendet wird, um diesem Konto eine Liste mit negativen Schlüsselwörtern (Keyword) hinzuzufügen.

Rückgabewerte

Typ	Beschreibung
NegativeKeywordListBuilder	Ein Builder, der verwendet wurde, um dem aktuellen Konto eine Liste mit negativen Schlüsselwörtern (Keyword) hinzuzufügen.

performanceMaxCampaigns

Ruft einen Selektor ab, der zum Filtern der Liste der Kampagnen verwendet wird, die für Performance Max in diesem Konto verwendet werden.

Rückgabewerte

Typ	Beschreibung
CampaignSelector	Ein Selektor, der zum Filtern der Liste der Kampagnen verwendet wird, die im aktuellen Konto für Performance Max verwendet werden.

productGroups

Ruft eine Auswahl ab, die zum Filtern der Liste der Produktgruppen in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
ProductGroupSelector	Ein Selektor, der zum Filtern der Liste der Produktgruppen im aktuellen Konto verwendet wird.

shoppingAdGroups

Ruft eine Auswahl ab, die zum Filtern der Liste der Anzeigengruppen verwendet wird, die für Shopping in diesem Konto verwendet werden.

Rückgabewerte

Typ	Beschreibung
AdGroupSelector	Ein Selektor, der zum Filtern der Liste der Anzeigengruppen verwendet wird, die für Einkäufe im aktuellen Konto verwendet werden.

shoppingCampaigns

Ruft einen Selektor ab, der zum Filtern der Liste der Kampagnen verwendet wird, die für Einkäufe in diesem Konto verwendet werden.

Rückgabewerte

Typ	Beschreibung
CampaignSelector	Ein Selektor, der zum Filtern der Liste der Kampagnen verwendet wird, die für Einkäufe im aktuellen Konto verwendet werden.

userLists

Ruft einen Selektor ab, der zum Filtern der Liste der Benutzerlisten in diesem Konto verwendet wird.

Rückgabewerte

Typ	Beschreibung
UserListSelector	Ein Selektor, der zum Filtern der Liste der Benutzerlisten im aktuellen Konto verwendet wird.

Siehe auch

Zugriff für ein einzelnes Konto