Skriptbeispiele für die Verwaltung von Anzeigen

Die folgenden Abschnitte zeigen Beispiele für Skripts, die verschiedene Aktionen gegen Anzeigen ausführen.

Hinweis

  • Aktualisieren Sie Ihre erweiterten Textanzeigen bis zum 1. Februar 2023 auf responsive Suchanzeigen. Nach diesem Datum können Sie keine neuen erweiterten Textanzeigen mehr erstellen und keine vorhandenen erweiterten Textanzeigen mehr bearbeiten. Weitere Informationen finden Sie unter Informationen zu responsiven Suchanzeigen.
  • Vorhandene erweiterte Textanzeigen werden weiterhin geschaltet, und Sie können Berichte zu deren Leistung anzeigen.
  • Sie können weiterhin erweiterte Textanzeigen pausieren, aktivieren oder entfernen. Andernfalls führt der Versuch, erweiterte Textanzeigen hinzuzufügen oder zu aktualisieren, zu einem CampaignServiceAdTypeInvalid Fehler.
  • Erfahren Sie mehr über diese Änderung.

Hinzufügen von Anzeigen

Wenn Sie eine Anzeige hinzufügen möchten, rufen Sie zunächst die Anzeigengruppe ab, der Sie die Anzeige hinzufügen möchten. Verwenden Sie das AdGroupSelector-Objekt , um die Anzeigengruppe auszuwählen. Die Verwendung der withIds Methode bietet eine bessere Leistung als die Übergabe des Namens der Anzeigengruppe in der withCondition Methode.

Rufen Sie als Nächstes die newAd-Methode der Anzeigengruppe auf, um einen Generator zu erhalten, mit dem Sie die Eigenschaften der Anzeige angeben können. Im Gegensatz zu anderen Entitätstypen gibt die newAd Methode ein AdBuilderSpace-Objekt zurück, das Methoden zum Abrufen des Generators für den anzuzeigenden Anzeigentyp enthält. In diesem Beispiel wird eine erweiterte Textanzeige hinzugefügt, sodass die expandedTextAdBuilder Methode zum Abrufen eines Generators für erweiterte Textanzeigen aufgerufen wird.

Für erweiterte Textanzeigen müssen Sie die folgenden Eigenschaften angeben:

  • Beschreibung
  • FinalUrl
  • ÜberschriftTeil1
  • ÜberschriftTeil2

Die Kombination dieser Eigenschaften definiert eine erweiterte Textanzeige eindeutig. Die übrigen Eigenschaften sind optional.

Durch Aufrufen der Builder-Methode build wird die Anzeige asynchron erstellt. Skripts fügen die Anzeige zu einem Zeitpunkt hinzu, bevor das Skript beendet wird oder wenn Sie eine der Methoden des Buildvorgangs aufrufen. Informationen zu diesem Prozess finden Sie unter Was ist ein Builder?

function main() {
    var adGroupId = "AD GROUP ID GOES HERE";
    var adGroup = getAdGroup(adGroupId);

    if (adGroup != null) {

        // Get an expanded text ad builder, specify the ad's 
        // properties, and add the ad to the build queue.
        var operation = adGroup.newAd().expandedTextAdBuilder()
            .withDescription("AD COPY GOES HERE")
            .withFinalUrl("https://contoso.com")
            .withHeadlinePart1("AD TITLE PART 1 GOES HERE")
            .withHeadlinePart2("AD TITLE PART 2 GOES HERE")
            .build();

        if (!operation.isSuccessful()) {
            for (var error of operation.getErrors()) {
                Logger.log(error);
            }
        }
    }
    else {
        Logger.log(`Failed to get ad group, ${adGroupId}.`);
    }
}

function getAdGroup(id) {
    var adGroups = AdsApp.adGroups()
        .withIds([id])
        .get();

    if (adGroups.hasNext()) {
        return adGroups.next();
    }
    else {
        return null;
    }
}

Wenn eine zuvor hinzugefügte Anzeige mit denselben Werten für die Kombination aus Pflichtfeldern vorhanden ist, fügt der Dienst die Anzeige nicht hinzu, sondern gibt die zuvor hinzugefügte Anzeige und ID zurück. Wenn jedoch dieselben Anzeigen in derselben Buildwarteschlange verarbeitet werden, schlägt die zweite Anzeige mit CampaignServiceDuplicateAd fehl. Da beispielsweise die Anzeigen im folgenden Beispiel identisch sind, schlägt eine davon fehl.

    if (adGroup != null) {
        var adOperation = adGroup.newAd().expandedTextAdBuilder()
            .withDescription("ad copy")
            .withFinalUrl("https://contoso.com")
            .withHeadlinePart1("title part 1")
            .withHeadlinePart2("title part 2")
            .build();

        operations.push(adOperation);

        adOperation = adGroup.newAd().expandedTextAdBuilder()
            .withDescription("ad copy")
            .withFinalUrl("https://contoso.com")
            .withHeadlinePart1("title part 1")
            .withHeadlinePart2("title part 2")
            .build();

        operations.push(adOperation);
        
        for (var operation of operations) {
            if (!operation.isSuccessful()) {
                for (var error of operation.getErrors()) {
                    Logger.log(error);
                }
            }
        }
    }

Anzeigen abrufen

Je nachdem, wo Sie sich in der Hierarchie befinden, haben Sie mehrere Möglichkeiten, Anzeigen zu erhalten.

Abrufen von Anzeigen aus einer Anzeigengruppe

Wenn Sie über ein AdGroup-Objekt verfügen, rufen Sie die Methode des Objekts ads auf, um die Liste der Anzeigen abzurufen, die zu der Anzeigengruppe gehören. In diesem Beispiel werden alle Anzeigen in der Gruppe abgerufen und gedruckt, Sie können jedoch die Methoden der Anzeigenauswahl verwenden, um die Liste der Anzeigen zu filtern.

function main() {
    var adGroups = AdsApp.adGroups()
        .withIds(["AD GROUP ID GOES HERE"])
        .get();

    if (adGroups.hasNext()) {
        var adGroup = adGroups.next();

        var ads = adGroup.ads().get();
        
        while (ads.hasNext()) {
            var ad = ads.next();

            if (ad.isType().expandedTextAd()) {
                var expandedAd = ad.asType().expandedTextAd();
            }
        }
    } 
}

Abrufen von Anzeigen aus einer Kampagne

Wenn Sie über ein Campaign-Objekt verfügen, rufen Sie die Methode des Objekts ads auf, um die Liste der Anzeigen abzurufen, die zu den Anzeigengruppen in der Kampagne gehören. In diesem Beispiel wird die Methode der withCondition Anzeigenauswahl verwendet, um die Liste der Anzeigen nach Anzeigen in Anzeigengruppen zu filtern, die den Namen "foo" enthalten.

function main() {
    var campaigns = AdsApp.campaigns()
        .withIds(["CAMPAIGN ID GOES HERE"])
        .get();

    while (campaigns.hasNext()) {
        var campaign = campaigns.next();

        var ads = campaign.ads()
            .withCondition("AdGroupName CONTAINS_IGNORE_CASE 'foo'")
            .get();
        
        while (ads.hasNext()) {
            var ad = ads.next();

            if (ad.isType().expandedTextAd()) {
                var expandedAd = ad.asType().expandedTextAd();
            }
        }
    } 
}

Abrufen aller Anzeigen im Konto

Um alle Anzeigen in einem Konto abzurufen, rufen Sie die ads Methode für das AdsApp-Objekt auf. Sie können die Methoden der Anzeigenauswahl verwenden, um die Liste der Anzeigen nach Kampagnen, Anzeigengruppen oder basierend auf der Anzeigen-Performance zu filtern. In diesem Beispiel werden alle Anzeigen aus dem Konto abgerufen.

function main() {
    var ads = AdsApp.ads().get();

    while (ads.hasNext()) {
        var ad = ads.next();

        if (ad.isType().expandedTextAd()) {
            var expandedAd = ad.asType().expandedTextAd();
        }
    }
}

Anhalten einer Anzeige

Um eine Anzeige zu pausieren, rufen Sie die Methode der pause Anzeige auf. Da sich die pause Methode auf das Ad-Basisobjekt bezieht, müssen Sie nicht zuerst das abgeleitete Objekt abrufen.

Wenn Sie eine Anzeige aktivieren oder entfernen möchten, rufen Sie einfach die Anzeige enable oder remove Methode auf. Um zu überprüfen, ob die Anzeige aktiviert oder angehalten ist, rufen Sie die isEnabled ODER-Methode isPaused auf.

Um Anzeigen mit einem bestimmten Status abzurufen, verwenden Sie die Methode der withCondition Anzeigenauswahl. Beispiel: withCondition("Status = PAUSED).

function main() {
    var ads = AdsApp.ads()
        .forDateRange("LAST_WEEK")
        .withCondition("AdGroupName CONTAINS_IGNORE_CASE 'foo'")
        .withCondition('Status = ENABLED')
        .withCondition('Clicks < 5')
        .get();
 
    while (ads.hasNext()) {
        var ad = ads.next();
        ad.pause();
    }
}

Abgelehnte Anzeigen erhalten

Ein Beispiel, bei dem Anzeigen abgelehnt werden, finden Sie unter Entdecken abgelehnter Anzeigen.

  • Last updated on