Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Enthält die Methoden zum Definieren und Hinzufügen einer Anzeigengruppe. Informationen zu Buildern finden Sie unter Builder.
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`);
}
}
}
Methoden
| Methodenname | Rückgabetyp | Beschreibung |
|---|---|---|
| build | AdGroupOperation | Erstellt die Anzeigengruppe und gibt ein Vorgangsobjekt zurück, mit dem überprüft wird, ob die Anzeigengruppe erfolgreich hinzugefügt wurde. |
| withBiddingStrategy(string biddingStrategy) | AdGroupBuilder | Legt die Gebotsstrategie der Anzeigengruppe fest. |
| withCpc(double cpc) | AdGroupBuilder | Legt das maximale CPC-Gebot der Anzeigengruppe fest. |
| withCpm(double cpm) | AdGroupBuilder | Legt das maximale CPM-Gebot der Anzeigengruppe fest. |
| withCpv(double cpv) | AdGroupBuilder | Legt das maximale CPV-Gebot der Anzeigengruppe fest. |
| withCustomParameters(Object customParameters) | AdGroupBuilder | Legt die benutzerdefinierten Parameter der Anzeigengruppe fest. |
| withEndDate(string endDate) | AdGroupBuilder | Legt das Datum fest, an dem Anzeigen in der Anzeigengruppe nicht mehr geschaltet werden. |
| withEndDate(Object endDate) | AdGroupBuilder | Legt das Datum fest, an dem Anzeigen in der Anzeigengruppe nicht mehr geschaltet werden. |
| withLanguage(string language) | AdGroupBuilder | Legt die Sprache fest, die von dieser Anzeigengruppe verwendet wird. |
| withName(string name) | AdGroupBuilder | Legt den Namen der Anzeigengruppe fest. |
| withStartDate(string startDate) | AdGroupBuilder | Legt das Datum fest, an dem die Anzeigen in der Anzeigengruppe eingeblendet werden. |
| withStartDate(Object startDate) | AdGroupBuilder | Legt das Datum fest, an dem die Anzeigen in der Anzeigengruppe eingeblendet werden. |
| withStatus(string status) | AdGroupBuilder | Legt den Status der Anzeigengruppe fest. |
| withTrackingTemplate(string trackingTemplate) | AdGroupBuilder | Legt die Vorlage für die Nachverfolgung der Anzeigengruppe fest. |
build
Erstellt die Anzeigengruppe und gibt ein Vorgangsobjekt zurück, mit dem überprüft wird, ob die Anzeigengruppe erfolgreich hinzugefügt wurde.
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupOperation | Ein Vorgangsobjekt, das verwendet wird, um zu überprüfen, 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 für die Groß-/Kleinschreibung aufgeführt.
|
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit angewendeter Gebotsstrategie. |
withCpc(double cpc)
Legt das CPC-Gebot der Anzeigengruppe fest.
Gibt den Gebotsbetrag an, der verwendet werden soll, wenn die Schlüsselwort (keyword) mit dem Suchbegriff des Benutzers übereinstimmt und die Gebotsstrategie der Anzeigengruppe MANUAL_CPC ist. Dieses Gebot wird verwendet, wenn es nicht von einer Entität auf niedrigerer Ebene wie dem Schlüsselwort (Keyword) außer Kraft gesetzt wird.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| CPC | double | Das maximale CPC-Gebot der Anzeigengruppe. Die Währung des Kontos bestimmt die Mindest- und Höchstgebotswerte. Weitere Informationen finden Sie unter Gebots- und Budgetwährungen. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit angewendetem CPC-Gebot. |
withCpm(double cpm)
Legt das CPM-Gebot der Anzeigengruppe fest.
Gibt den pro 1.000 angezeigten Impressionen zu verwendenden Gebotsbetrag an und den Zeitpunkt, zu dem 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 Mindest- und Höchstgebotswerte. Weitere Informationen finden Sie unter Gebots- und Budgetwährungen. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Builder, auf das das CPM-Gebot angewendet wird. |
withCpv(double cpv)
Legt das CPV-Gebot der Anzeigengruppe fest.
Gibt den Gebotsbetrag an, der pro Ansicht oder pro Klick auf eine Videoanzeige verwendet werden soll, und legt fest, 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 Mindest- und Höchstgebotswerte. Weitere Informationen finden Sie unter Gebots- und Budgetwährungen. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit angewendetem CPV-Gebot. |
withCustomParameters(Object customParameters)
Legt die benutzerdefinierten Parameter der Anzeigengruppe fest, die in endgültigen URLs oder Vorlagen für die Nachverfolgung verwendet werden sollen.
Benutzerdefinierte Parameter sind hilfreich, um dynamische Informationen über mehrere URLs hinweg freizugeben. Weitere Informationen zu seiner Verwendung finden Sie unter Benutzerdefinierte Parameter.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| customParameters | Objekt | Eine Zuordnung mit 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 der 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. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit angewendeten benutzerdefinierten Parametern. |
withEndDate(string endDate)
Legt das Datum fest, an dem Anzeigen in der Anzeigengruppe nicht mehr geschaltet werden. Verwenden Sie diese Methode nur, wenn die Anzeigen in der Gruppe nur an einem bestimmten Datum nicht mehr geschaltet werden sollen.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| endDate | string | Das Datum, an dem keine Anzeigen mehr geschaltet werden. Geben Sie das Datum im Formular "JJJJMMTT" an. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit angewendetem Enddatum. |
withEndDate(Object endDate)
Legt das Datum fest, an dem Anzeigen in der Anzeigengruppe nicht mehr geschaltet werden. Verwenden Sie diese Methode nur, wenn die Anzeigen in der Gruppe nur an einem bestimmten Datum nicht mehr geschaltet werden sollen.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| endDate | Objekt | Das Datum, an dem keine Anzeigen mehr geschaltet werden. Geben Sie das Datum mit einem Objekt mit den folgenden Feldern an:
Beispiel: var date = {year: 2018, month: 5, day: 13};Es handelt sich um einen Monat, wobei 1 für Januar und 12 für Dezember steht. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit angewendetem Enddatum. |
withLanguage(string language)
Legt die Sprache fest, die von den Anzeigen in dieser Anzeigengruppe verwendet wird.
Standardmäßig erbt die Anzeigengruppe die Sprache von der ü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 (die 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. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit der angewendeten Sprache. |
withName(string name)
Legt den Namen der Anzeigengruppe fest.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| name | string | Der Name der Anzeigengruppe. Der Name ist erforderlich. Der Name darf aus maximal 256 Zeichen bestehen und muss unter allen aktiven Anzeigengruppen in der Kampagne eindeutig sein. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit angewendetem Namen. |
withStartDate(string startDate)
Legt das Datum fest, an dem die Anzeigen in der Anzeigengruppe eingeblendet werden. Verwenden Sie diese Methode nur, wenn die Anzeigen in der Gruppe nur an einem bestimmten Datum geschaltet werden sollen. Andernfalls werden Anzeigen sofort geschaltet.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| endDate | string | Das Datum für die erste Schaltung von Anzeigen. Geben Sie das Datum im Formular "JJJJMMTT" an. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit angewendetem Startdatum. |
withStartDate(Object startDate)
Legt das Datum fest, an dem die Anzeigen in der Anzeigengruppe eingeblendet werden. Verwenden Sie diese Methode nur, wenn die Anzeigen in der Gruppe nur an einem bestimmten Datum geschaltet werden sollen. Andernfalls werden Anzeigen sofort geschaltet.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| endDate | Objekt | Das Datum für die erste Schaltung von Anzeigen. Geben Sie das Datum mit einem Objekt mit den folgenden Feldern an:
Beispiel: var date = {year: 2018, month: 5, day: 13};Es handelt sich um einen Monat, wobei 1 für Januar und 12 für Dezember steht. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit angewendetem Startdatum. |
withStatus(string status)
Legt den Status der Anzeigengruppe fest.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| status | Zeichenfolge | Der Status der Anzeigengruppe. Im Folgenden sind die möglichen Werte für die Groß-/Kleinschreibung aufgeführt.
|
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit dem angewendeten Status. |
withTrackingTemplate(string trackingTemplate)
Legt die Vorlage für die Nachverfolgung der Anzeigengruppe fest.
Vorlagen für die Nachverfolgung werden mit der FinalUrl des Schlüsselworts (Keyword) verwendet, um die von der Anzeige verwendete Ziel-URL zu erstellen. Weitere Informationen finden Sie unter Welche Verfolgungs- oder URL-Parameter stehen zur Verfügung?
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| trackingTemplate | string | Die Vorlage für die Nachverfolgung, die für die Anzeigengruppe verwendet werden soll. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| AdGroupBuilder | Anzeigengruppen-Generator mit angewendeter Vorlage für die Nachverfolgung. |