Freigeben über


ExpandedTextAdBuilder

Enthält die Methoden zum Definieren und Erstellen einer erweiterten Textanzeige. Informationen zu Generatoren finden Sie unter Generatoren.

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.

Anwendungsbeispiel:

    var operation = adGroup.newAd().expandedTextAdBuilder()
        .withHeadlinePart1('FIRST PART OF TITLE GOES HERE')
        .withHeadlinePart2('SECOND PART OF TITLE GOES HERE')
        .withDescription('AD TEXT GOES HERE')
        .withFinalUrl('LANDING PAGE URL GOES HERE')
        .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
Bauen AdOperation Erstellt die Anzeige und gibt ein Vorgangsobjekt zurück, mit dem überprüft wird, ob Skripts die Anzeige erfolgreich hinzugefügt haben.
withCustomParameters(Object customParameters) ExpandedTextAdBuilder Legt die benutzerdefinierten Parameter der Anzeige fest.
withDescription(string description) ExpandedTextAdBuilder Legt die erste Beschreibung der Anzeige fest. Diese Methode ist zugunsten von withDescription1(string description1)veraltet.
withDescription1(string description1) ExpandedTextAdBuilder Legt die erste Beschreibung der Anzeige fest. Diese Methode legt dasselbe Feld wie withDescription(string description)fest.
withDescription2(string description2) ExpandedTextAdBuilder Legt die zweite Beschreibung der Anzeige fest.
withFinalUrl(string finalUrl) ExpandedTextAdBuilder Legt die URL der Angebotsseite der Anzeige fest.
withHeadlinePart1(string headlinePart1) ExpandedTextAdBuilder Legt den ersten Teil des Titels der Anzeige fest.
withHeadlinePart2(string headlinePart2) ExpandedTextAdBuilder Legt den zweiten Teil des Titels der Anzeige fest.
withHeadlinePart3(string headlinePart3) ExpandedTextAdBuilder Legt den dritten Teil des Titels der Anzeige fest.
withMobileFinalUrl(string mobileFinalUrl) ExpandedTextAdBuilder Legt die endgültige URL der Anzeige für mobile Geräte fest.
withPath1(string urlPath1) ExpandedTextAdBuilder Legt den ersten optionalen Pfad fest, der an die Anzeige-URL der Anzeige angefügt werden soll.
withPath2(string urlPath2) ExpandedTextAdBuilder Legt den zweiten optionalen Pfad fest, der an die Anzeige-URL der Anzeige angefügt werden soll.
withTrackingTemplate(string trackingTemplate) ExpandedTextAdBuilder Legt die Nachverfolgungsvorlage der Anzeige fest.

build

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

Informationen zu den Grenzwerten für die Anzahl von Anzeigen, die Sie einer Anzeigengruppe hinzufügen können, finden Sie unter Grenzwerte für Entitätshierarchien.

Rückgabewerte

Typ Beschreibung
AdOperation Ein Vorgangsobjekt, mit dem überprüft wird, ob Scripts die Anzeige erfolgreich hinzugefügt hat.

withCustomParameters(Object customParameters)

Legt die benutzerdefinierten Parameter der Anzeige fest.

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 benutzerdefinierten Parametern, die auf die endgültige URL der Anzeige 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.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigen-Generator mit den angewendeten benutzerdefinierten Parametern.

withDescription(string description)

Legt die erste Beschreibung der Anzeige fest. Diese Methode ist zugunsten von withDescription1(string description1)veraltet.

Argumente

Name Typ Beschreibung
description string Die erste Beschreibung der Anzeige. Informationen zu Kopiergrenzwerten und zum Einschließen dynamischer Textzeichenfolgen finden Sie unter Bing Ads-API.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigengenerator mit angewendeter Beschreibung.

withDescription1(string description1)

Legt die erste Beschreibung der Anzeige fest. Diese Methode legt dasselbe Feld wie withDescription(string description)fest.

Argumente

Name Typ Beschreibung
description1 string Die erste Beschreibung der Anzeige. Informationen zu Kopiergrenzwerten und zum Einschließen dynamischer Textzeichenfolgen finden Sie unter Bing Ads-API.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigengenerator mit angewendeter Beschreibung.

withDescription2(string description2)

Legt die zweite Beschreibung der Anzeige fest.

Argumente

Name Typ Beschreibung
description2 string Die zweite Beschreibung der Anzeige. Informationen zu Kopiergrenzwerten und zum Einschließen dynamischer Textzeichenfolgen finden Sie unter Bing Ads-API.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigengenerator mit angewendeter Beschreibung.

withFinalUrl(string finalUrl)

Legt die URL der Angebotsseite der Anzeige fest.

Argumente

Name Typ Beschreibung
finalUrl string Die URL der Angebotsseite der Anzeige. Informationen zu URL-Grenzwerten finden Sie unter Bing Ads-API.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigengenerator mit angewendeter endgültiger URL.

withHeadlinePart1(string headlinePart1)

Legt den ersten Teil des Titels der Anzeige fest.

Argumente

Name Typ Beschreibung
headlinePart1 string Der erste Teil des Titels der Anzeige. Wenn Microsoft den Titel der Anzeige mit den Teilen 1, 2 und 3 des Titels generiert, verkettet es die Teile mit " - ". Geben Sie den Bindestrich nicht in Titelteilen an. Jeder Teil des Titels muss mindestens ein Wort enthalten. Informationen zu zusätzlichen Titelbeschränkungen und zum Einschließen dynamischer Textzeichenfolgen in den Titel finden Sie unter Bing Ads-API.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigengenerator, auf den Teil 1 des Titels der Anzeige angewendet wurde.

withHeadlinePart2(string headlinePart2)

Legt den zweiten Teil des Titels der Anzeige fest.

Argumente

Name Typ Beschreibung
headlinePart2 string Der zweite Teil des Titels der Anzeige. Wenn Microsoft den Titel der Anzeige mit den Teilen 1, 2 und 3 des Titels generiert, verkettet es die Teile mit " - ". Geben Sie den Bindestrich nicht in Titelteilen an. Jeder Teil des Titels muss mindestens ein Wort enthalten. Informationen zu zusätzlichen Titelbeschränkungen und zum Einschließen dynamischer Textzeichenfolgen in den Titel finden Sie unter Bing Ads-API.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigengenerator, auf den Teil 1 des Titels der Anzeige angewendet wurde.

withHeadlinePart3(string headlinePart3)

Legt den dritten Teil des Titels der Anzeige fest.

Argumente

Name Typ Beschreibung
headlinePart3 string Der dritte Teil des Titels der Anzeige. Wenn Microsoft den Titel der Anzeige mit den Teilen 1, 2 und 3 des Titels generiert, verkettet es die Teile mit " - ". Geben Sie den Bindestrich nicht in Titelteilen an. Jeder Teil des Titels muss mindestens ein Wort enthalten. Informationen zu zusätzlichen Titelbeschränkungen und zum Einschließen dynamischer Textzeichenfolgen in den Titel finden Sie unter Bing Ads-API.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigengenerator, auf den Teil 1 des Titels der Anzeige angewendet wurde.

withMobileFinalUrl(string mobileFinalUrl)

Legt die endgültige URL der Anzeige für mobile Geräte fest.

Die endgültige URL identifiziert die Webseite, auf die der Benutzer weitergeleitet wird, wenn er auf die Anzeige klickt. Um eine endgültige URL für mobile Geräte anzugeben, geben Sie zunächst eine endgültige URL für nicht mobile Geräte an (siehe withFinalUrl()).

Weitere Informationen finden Sie unter Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?

Argumente

Name Typ Beschreibung
mobileFinalUrl string Die endgültige URL für mobile Geräte.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigengenerator mit angewendeter endgültiger MOBILE-URL.

withPath1(string urlPath1)

Legt den ersten optionalen Pfad fest, der an die Anzeige-URL der Anzeige angefügt werden soll.

Argumente

Name Typ Beschreibung
mobileFinalUrl string Der erste optionale Pfad, der an die Anzeige-URL der Anzeige angefügt werden soll. Microsoft verwendet die in withFinalUrl angegebene Domäne als Anzeige-URL. Wenn die Domäne der endgültigen URL contoso.com und der Pfad schuhe ist, wird die Anzeige-URL der Anzeige contoso.com/shoes. Informationen zu Nutzung und Grenzwerten finden Sie unter Path1.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigen-Generator mit angewendetem Pfad.

withPath2(string urlPath2)

Legt den zweiten optionalen Pfad fest, der an die Anzeige-URL der Anzeige angefügt werden soll.

Argumente

Name Typ Beschreibung
mobileFinalUrl string Der zweite optionale Pfad, der an die Anzeige-URL der Anzeige angefügt werden soll. Um den zweiten Pfad anzugeben, geben Sie zuerst den ersten Pfad an (siehe withPath1). Microsoft verwendet die in withFinalUrl angegebene Domäne als Anzeige-URL. Wenn die Domäne der endgültigen URL contoso.com ist, der erste Pfad schuhe und der zweite Pfad "Ladies" lautet, wird die Anzeige-URL der Anzeige contoso.com/shoes/ladies. Informationen zu Nutzung und Grenzwerten finden Sie unter Path2.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigen-Generator mit angewendetem Pfad.

withTrackingTemplate(string trackingTemplate)

Legt die Nachverfolgungsvorlage der Anzeige 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 Mit dieser Anzeige zu verwendende Nachverfolgungsvorlage.

Rückgabewerte

Typ Beschreibung
ExpandedTextAdBuilder Anzeigengenerator mit angewendeter Nachverfolgungsvorlage.