Skriptbeispiele für die Verwaltung von Anzeigen

Artikel
11/13/2024

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

Hinweis

Aktualisieren Sie Ihre erweiterten Textanzeigen bis zum 1. Februar 2023 auf reaktionsfähige Suchanzeigen. Nach diesem Datum können Sie keine neuen erweiterten Textanzeigen mehr erstellen oder bearbeiten. Weitere Informationen finden Sie unter Informationen zu reaktionsfähigen Suchanzeigen.
Vorhandene erweiterte Textanzeigen werden weiterhin bereitgestellt, und Sie können Berichte zu deren Leistung anzeigen.
Sie können Ihre erweiterten Textanzeigen weiterhin anhalten, aktivieren oder entfernen. Andernfalls führen Versuche, erweiterte Textanzeigen hinzuzufügen oder zu aktualisieren, zu einem CampaignServiceAdTypeInvalid Fehler.
Erfahren Sie mehr über diese Änderung.

Anzeigen hinzufügen

Um eine Anzeige hinzuzufügen, rufen Sie zuerst 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 das Übergeben des Namens der Anzeigengruppe in der withCondition -Methode.

Rufen Sie als Nächstes die newAd-Methode der Anzeigengruppe auf, um einen Generator abzurufen, den Sie zum Angeben der Eigenschaften der Anzeige verwenden. Im Gegensatz zu anderen Entitätstypen gibt die newAd Methode ein AdBuilderSpace-Objekt zurück, das Methoden zum Abrufen des Generators für den Typ der Anzeige enthält, die Sie erstellen möchten. In diesem Beispiel wird eine erweiterte Textanzeige hinzugefügt, sodass die expandedTextAdBuilder -Methode aufgerufen wird, um einen Erweiterten Textanzeigen-Generator abzurufen.

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

Beschreibung
FinalUrl
HeadlinePart1
HeadlinePart2

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

Beim Aufrufen der -Methode des Generators build wird die Anzeige asynchron erstellt. Skripts fügt die Anzeige zu einem bestimmten 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 Generator?

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 den gleichen Werten für die Kombination erforderlicher Felder vorhanden ist, fügt der Dienst die Anzeige nicht hinzu, sondern gibt stattdessen die zuvor hinzugefügte Anzeige und die ID zurück. Wenn jedoch die gleichen 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

Sie haben mehrere Optionen, um Anzeigen zu erhalten, je nachdem, wo Sie sich in der Hierarchie befinden.

Abrufen von Anzeigen aus einer Anzeigengruppe

Wenn Sie über ein AdGroup-Objekt verfügen, rufen Sie die -Methode des ads Objekts auf, um die Liste der Anzeigen abzurufen, die zur 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 ads Objekts auf, um die Liste der Anzeigen abzurufen, die zu den Anzeigengruppen in der Kampagne gehören. In diesem Beispiel wird die -Methode der Anzeigenauswahl withCondition verwendet, um die Liste der Anzeigen nach 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 für Kampagnen, Anzeigengruppen oder basierend auf der Anzeigenleistung 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 anzuhalten, rufen Sie die -Methode der pause Anzeige auf. Da sich die pause Methode auf dem Ad-Basisobjekt befindet, müssen Sie das abgeleitete Objekt nicht zuerst abrufen.

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

Um Anzeigen mit einem bestimmten status zu erhalten, 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();
    }
}

Nicht genehmigte Anzeigen erhalten

Ein Beispiel, bei dem abgelehnte Anzeigen angezeigt werden, finden Sie unter Ermitteln von abgelehnten Anzeigen.

Freigeben über