Enthält die Methoden, die zum Definieren und Hinzufügen einer Anzeigengruppe verwendet werden. Informationen zu Generatoren finden Sie unter Generatoren.
Anwendungsbeispiel:
// Get a campaign to add the ad group to.
var iterator = AdsApp.campaigns()
.withIds(['CAMPAIGN ID GOES HERE'])
.get();
while (iterator.hasNext()) {
var campaign = iterator.next();
// Get the campaign's ad group builder and add an ad group.
var operation = campaign.newAdGroupBuilder()
.withName("AD GROUP NAME GOES HERE")
.withStatus("ENABLED")
.build();
// See the Builders topic for performance considerations
// when using the operation object's methods.
if (!operation.isSuccessful()) {
for (var error of operation.getErrors()) {
Logger.log(`${error}\n`);
}
}
}
Ein Vorgangsobjekt, mit dem überprüft wird, ob die Anzeigengruppe erfolgreich hinzugefügt wurde.
withBiddingStrategy(string biddingStrategy)
Legt die Gebotsstrategie der Anzeigengruppe fest.
Argumente
Name
Typ
Beschreibung
biddingStrategy
string
Die Gebotsstrategie, die auf die Anzeigengruppe angewendet werden soll. Im Folgenden sind die möglichen Werte aufgeführt, bei denen die Groß-/Kleinschreibung beachtet wird.
Anzeigengruppen-Generator mit angewendeter Gebotsstrategie.
withCpc(double cpc)
Legt das CPC-Gebot der Anzeigengruppe fest.
Gibt den Gebotsbetrag an, der verwendet werden soll, wenn der Schlüsselwort (keyword) mit dem Suchbegriff des Benutzers übereinstimmt und die Gebotsstrategie der Anzeigengruppe MANUAL_CPC ist. Dieses Gebot wird verwendet, wenn es von einer Entität auf niedrigerer Ebene wie Schlüsselwort (keyword) nicht außer Kraft gesetzt wird.
Argumente
Name
Typ
Beschreibung
Cpc
double
Das maximale CPC-Gebot der Anzeigengruppe. Die Währung des Kontos bestimmt die minimalen und maximalen Gebotswerte. Weitere Informationen finden Sie unter Gebots- und Budgetwährungen.
Anzeigengruppen-Generator mit angewendetem CPC-Gebot.
withCpm(double cpm)
Legt das CPM-Gebot der Anzeigengruppe fest.
Gibt den Gebotsbetrag an, der pro 1.000 angezeigten Impressionen verwendet werden soll, und wann die Gebotsstrategie der Anzeigengruppe MANUAL_CPM ist.
Argumente
Name
Typ
Beschreibung
Cpm
double
Das maximale CPM-Gebot der Anzeigengruppe. Die Währung des Kontos bestimmt die minimalen und maximalen Gebotswerte. Weitere Informationen finden Sie unter Gebots- und Budgetwährungen.
Anzeigengruppen-Generator mit angewendetem CPM-Gebot.
withCpv(double cpv)
Legt das CPV-Gebot der Anzeigengruppe fest.
Gibt den Gebotsbetrag an, der pro Ansicht oder Klick auf eine Videoanzeige verwendet werden soll, und wann die Gebotsstrategie der Anzeigengruppe MANUAL_CPV ist.
Argumente
Name
Typ
Beschreibung
Cpv
double
Das maximale CPV-Gebot der Anzeigengruppe. Die Währung des Kontos bestimmt die minimalen und maximalen Gebotswerte. Weitere Informationen finden Sie unter Gebots- und Budgetwährungen.
Anzeigengruppen-Generator mit angewendetem CPV-Gebot.
withCustomParameters(Object customParameters)
Legt die benutzerdefinierten Parameter der Anzeigengruppe fest, die in endgültigen URLs oder Nachverfolgungsvorlagen verwendet werden sollen.
Benutzerdefinierte Parameter sind hilfreich beim Freigeben dynamischer Informationen über mehrere URLs hinweg. Weitere Informationen zur Verwendung finden Sie unter Benutzerdefinierte Parameter.
Argumente
Name
Typ
Beschreibung
customParameters
Objekt
Eine Zuordnung von bis zu drei benutzerdefinierten Parametern, die auf die Anzeigengruppe angewendet werden sollen. Beispiel: {key1: 'value1', key2: 'value2', key3: 'value3'}, wobei key der Name des benutzerdefinierten Parameters und wert der Wert des Parameters ist. Der Name darf maximal 16 8-Byte-Zeichen enthalten, und der Wert darf maximal 200 8-Byte-Zeichen enthalten.
Anzeigengruppen-Generator mit den angewendeten benutzerdefinierten Parametern.
withEndDate(string endDate)
Legt das Datum fest, an dem anzeigende Anzeigen in der Anzeigengruppe nicht mehr bereitgestellt werden. Rufen Sie diese Methode nur auf, wenn Anzeigen in der Gruppe an einem bestimmten Datum eingestellt werden sollen.
Argumente
Name
Typ
Beschreibung
endDate
string
Das Datum, an dem keine Werbung mehr bereitgestellt werden soll. Geben Sie das Datum im Formular JJJJMMDD an.
Anzeigengruppen-Generator mit angewendetem Enddatum.
withEndDate(Object endDate)
Legt das Datum fest, an dem anzeigende Anzeigen in der Anzeigengruppe nicht mehr bereitgestellt werden. Rufen Sie diese Methode nur auf, wenn Anzeigen in der Gruppe an einem bestimmten Datum eingestellt werden sollen.
Argumente
Name
Typ
Beschreibung
endDate
Objekt
Das Datum, an dem keine Werbung mehr bereitgestellt werden soll. Geben Sie das Datum mithilfe eines -Objekts mit den folgenden Feldern an:
Jahr
Monat
Tag
Beispiel: var date = {year: 2018, month: 5, day: 13};
Der Monat ist einsbasiert, wobei 1 für Januar und 12 für Dezember steht.
Anzeigengruppen-Generator mit angewendetem Enddatum.
withLanguage(string language)
Legt die Sprache fest, die von Anzeigen in dieser Anzeigengruppe verwendet wird.
Standardmäßig erbt die Anzeigengruppe die Sprache von ihrer übergeordneten Kampagne. Geben Sie eine Sprache auf Anzeigengruppenebene an, um die auf Kampagnenebene angegebene Sprache außer Kraft zu setzen, oder wenn die Kampagne keine Sprache angibt (Sprache muss auf Kampagnen- und/oder Anzeigengruppenebene angegeben werden).
Argumente
Name
Typ
Beschreibung
language
string
Die Sprache, die von Anzeigen in der Anzeigengruppe verwendet wird. Deutsch). Bei der Zeichenfolge wird die Groß-/Kleinschreibung nicht beachtet. Verwenden Sie keinen zweistelligen Sprachcode. Eine Liste der unterstützten Sprachen finden Sie unter Anzeigensprachen.
Anzeigengruppen-Generator mit angewendeter Sprache.
withName(Zeichenfolgenname)
Legt den Namen der Anzeigengruppe fest.
Argumente
Name
Typ
Beschreibung
name
string
Der Name der Anzeigengruppe. Der Name ist erforderlich. Der Name darf maximal 256 Zeichen enthalten und muss für alle aktiven Anzeigengruppen in der Kampagne eindeutig sein.
Legt das Datum fest, an dem Anzeigen in der Anzeigengruppe mit der Bereitstellung beginnen. Rufen Sie diese Methode nur auf, wenn Anzeigen in der Gruppe an einem bestimmten Datum angezeigt werden sollen. Andernfalls wird die Anzeige sofort gestartet.
Argumente
Name
Typ
Beschreibung
endDate
string
Das Datum, an dem mit der Bereitstellung von Anzeigen begonnen wird. Geben Sie das Datum im Formular JJJJMMDD an.
Anzeigengruppen-Generator mit angewendetem Startdatum.
withStartDate(Object startDate)
Legt das Datum fest, an dem Anzeigen in der Anzeigengruppe mit der Bereitstellung beginnen. Rufen Sie diese Methode nur auf, wenn Anzeigen in der Gruppe an einem bestimmten Datum angezeigt werden sollen. Andernfalls wird die Anzeige sofort gestartet.
Argumente
Name
Typ
Beschreibung
endDate
Objekt
Das Datum, an dem mit der Bereitstellung von Anzeigen begonnen wird. Geben Sie das Datum mithilfe eines -Objekts mit den folgenden Feldern an:
Jahr
Monat
Tag
Beispiel: var date = {year: 2018, month: 5, day: 13};
Der Monat ist einsbasiert, wobei 1 für Januar und 12 für Dezember steht.
Anzeigengruppen-Generator mit angewendetem status.
withTrackingTemplate(string trackingTemplate)
Legt die Nachverfolgungsvorlage der Anzeigengruppe fest.
Nachverfolgungsvorlagen werden zusammen mit finalUrl des Schlüsselwort (keyword) verwendet, um die ziel-URL zu erstellen, die von der Anzeige verwendet wird. Weitere Informationen finden Sie unter Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?
Argumente
Name
Typ
Beschreibung
trackingTemplate
string
Die Nachverfolgungsvorlage, die mit der Anzeigengruppe verwendet werden soll.