AdGroupBuilder

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`);
            }
        }
    }

Methoden

build

Erstellt die Anzeigengruppe und gibt ein Vorgangsobjekt zurück, mit dem überprüft wird, ob die Anzeigengruppe erfolgreich hinzugefügt wurde.

Rückgabewerte

withBiddingStrategy(string biddingStrategy)

Legt die Gebotsstrategie der Anzeigengruppe fest.

Argumente

Rückgabewerte

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

Rückgabewerte

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

Rückgabewerte

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

Rückgabewerte

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

Rückgabewerte

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

Rückgabewerte

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

Rückgabewerte

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

Rückgabewerte

withName(Zeichenfolgenname)

Legt den Namen der Anzeigengruppe fest.

Argumente

Rückgabewerte

withStartDate(string 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

Rückgabewerte

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

Rückgabewerte

withStatus(string status)

Legt die status der Anzeigengruppe fest.

Argumente

Rückgabewerte

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

Rückgabewerte

Siehe auch

Campaign.newAdGroupBuilder()