ResponsiveSearchAdBuilder

Enthält die Methoden zum Definieren und Erstellen einer reaktionsfähigen Suchanzeige. Informationen zu Buildern finden Sie unter Builder.

Anwendungsbeispiel:

    var operation = adGroup.newAd().responsiveSearchAdBuilder()
        .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
addDescription(string description, string pinning)	ResponsiveSearchAdBuilder	Fügt die bereitgestellte Beschreibung zur aktuellen Liste der Beschreibungen hinzu. Mindestens 2 Beschreibungen müssen entweder mit dieser oder der addDescription()-Methode angegeben werden.
addHeadline(string, headline, string pinning)	ResponsiveSearchAdBuilder	Fügt die bereitgestellte Überschrift zur aktuellen Liste der Überschriften hinzu. Mindestens 3 Überschriften müssen entweder mit dieser oder der addHeadline()-Methode angegeben werden.
build	AdOperation	Erstellt die Anzeige und gibt ein Vorgangsobjekt zurück, das verwendet wird, um zu überprüfen, ob die Anzeige erfolgreich von Skripts hinzugefügt wurde.
withCustomParameters(Object customParameters)	ResponsiveSearchAdBuilder	Legt die benutzerdefinierten Parameter der Anzeige fest.
withDescriptions(object[] descriptions)	ResponsiveSearchAdBuilder	Legt die Beschreibungen der Anzeige fest.
withFinalUrl(string finalUrl)	ResponsiveSearchAdBuilder	Legt die URL der Angebotsseite der Anzeige fest.
withFinalUrlSuffix(string finalUrlSuffix)	ResponsiveSearchAdBuilder	Legt das Suffix der endgültigen URL der Anzeige fest.
withHeadlines(object[] headlines)	ResponsiveSearchAdBuilder	Legt die Überschriften der Anzeige fest.
withMobileFinalUrl(string mobileFinalUrl)	ResponsiveSearchAdBuilder	Legt die endgültige URL der Anzeige für mobile Geräte fest.
withPath1(string urlPath1)	ResponsiveSearchAdBuilder	Legt den ersten optionalen Pfad fest, der an die Anzeige-URL der Anzeige angefügt wird.
withPath2(string urlPath2)	ResponsiveSearchAdBuilder	Legt den zweiten optionalen Pfad fest, der an die Anzeige-URL der Anzeige angefügt werden soll.
withTrackingTemplate(string trackingTemplate)	ResponsiveSearchAdBuilder	Legt die Vorlage für die Nachverfolgung der Anzeige fest.

addDescription(string description, string pinning)

Fügt die bereitgestellte Beschreibung zur aktuellen Liste der Beschreibungen hinzu. Mindestens 2 Beschreibungen müssen entweder mit dieser oder der addDescription()-Methode angegeben werden.

Argumente

Name	Typ	Beschreibung
description	string	Die hinzuzufügende Anzeigenbeschreibung. Informationen zu Limits und zum Einbinden dynamischer Textzeichenfolgen finden Sie unter Bing Ads API.
Anheften	string	Die optionale angeheftete Position. Mögliche Werte für Beschreibungen sind: DESCRIPTION_1, DESCRIPTION_2
text	string	Der Text dieses Medienobjekts.

Rückgabewerte

Typ	Beschreibung
ResponsiveSearchAdBuilder	Anzeigen-Generator mit angewendeter Beschreibung.

addHeadline(string, headline, string pinning)

Fügt die bereitgestellte Überschrift zur aktuellen Liste der Überschriften hinzu. Mindestens 3 Überschriften müssen entweder mit dieser oder der addHeadline()-Methode angegeben werden.

Argumente

Name	Typ	Beschreibung
Überschrift	string	Die hinzuzufügende Anzeigenüberschrift. Informationen zu Limits und zum Einbinden dynamischer Textzeichenfolgen finden Sie unter Bing Ads API.
Anheften	string	Die optionale angeheftete Position. Mögliche Werte für Überschriften sind: HEADLINE_1, HEADLINE_2 HEADLINE_3

Rückgabewerte

Typ	Beschreibung
ResponsiveSearchAdBuilder	Anzeigen-Generator mit angewendeter Überschrift.

build

Erstellt die Anzeige und gibt ein Vorgangsobjekt zurück, das verwendet wird, um zu überprüfen, ob die Anzeige erfolgreich von Skripts hinzugefügt wurde.

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

Rückgabewerte

Typ	Beschreibung
AdOperation	Ein Vorgangsobjekt, das verwendet wird, um zu überprüfen, ob die Anzeige von Skripts erfolgreich hinzugefügt wurde.

withCustomParameters(Object customParameters)

Legt die benutzerdefinierten Parameter der Anzeige fest.

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 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 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
ResponsiveSearchAdBuilder	Anzeigen-Generator mit angewendeten benutzerdefinierten Parametern.

withDescriptions(object[] descriptions)

Legt die Beschreibungen der Anzeige fest.

Argumente

Name	Typ	Beschreibung
Beschreibungen	AdTextAsset[]	Die Beschreibungen der Anzeigen. Informationen zu Limits und zum Einbinden dynamischer Textzeichenfolgen finden Sie unter Bing Ads API.

Rückgabewerte

Typ	Beschreibung
ResponsiveSearchAdBuilder	Anzeigen-Generator mit angewendeten Beschreibungen.

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-Limits finden Sie unter Bing Ads API.

Rückgabewerte

Typ	Beschreibung
ResponsiveSearchAdBuilder	Anzeigen-Generator mit angewendeter endgültiger URL.

withFinalUrlSuffix(string finalUrlSuffix)

Legt das Suffix der endgültigen URL der Anzeige fest.

Argumente

Name	Typ	Beschreibung
finalUrl	string	Das Suffix der endgültigen URL der Anzeige. Informationen zu URL-Limits finden Sie unter Bing Ads API.

Rückgabewerte

Typ	Beschreibung
ResponsiveSearchAdBuilder	Anzeigen-Generator mit angewendeter endgültiger URL.

withHeadlines(object[] headlines

Legt die Überschriften der Anzeige fest.

Argumente

Name	Typ	Beschreibung
Schlagzeilen	AdTextAsset[]	Die Überschriften der Anzeige. Informationen zu Limits und zum Einbinden dynamischer Textzeichenfolgen finden Sie unter Bing Ads API.

Rückgabewerte

Typ	Beschreibung
ResponsiveSearchAdBuilder	Anzeigen-Generator mit angewendeten Überschriften der Anzeige.

withMobileFinalUrl(string mobileFinalUrl)

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

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

Weitere Informationen finden Sie unter Welche Verfolgungs- oder URL-Parameter stehen zur Verfügung?

Argumente

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

Rückgabewerte

Typ	Beschreibung
ResponsiveSearchAdBuilder	Anzeigen-Generator mit angewendeter endgültiger Mobil-URL.

withPath1(string urlPath1)

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

Argumente

Name	Typ	Beschreibung
mobileFinalUrl	string	Der erste optionale Pfad, der an die Anzeige-URL der Anzeige angefügt werden soll. Microsoft verwendet die Domäne, die als withFinalUrl Anzeige-URL angegeben ist. Wenn die Domäne der endgültigen URL contoso.com und der Pfad "Schuhe" lautet, lautet die Anzeige-URL der Anzeige contoso.com/shoes. Informationen zur Nutzung und zu Beschränkungen finden Sie unter Pfad1.

Rückgabewerte

Typ	Beschreibung
ResponsiveSearchAdBuilder	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 Domäne, die als withFinalUrl Anzeige-URL angegeben ist. Wenn die Domäne der endgültigen URL contoso.com, der erste Pfad "Schuhe" und der zweite Pfad "Damen" ist, lautet die Anzeige-URL der Anzeige contoso.com/shoes/ladies. Informationen zur Nutzung und zu Beschränkungen finden Sie unter Pfad2.

Rückgabewerte

Typ	Beschreibung
ResponsiveSearchAdBuilder	Anzeigen-Generator mit angewendetem Pfad.

withTrackingTemplate(string trackingTemplate)

Legt die Vorlage für die Nachverfolgung der Anzeige 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 diese Anzeige verwendet werden soll.

Rückgabewerte

Typ	Beschreibung
ResponsiveSearchAdBuilder	Anzeigen-Generator mit angewendeter Vorlage für die Nachverfolgung.