Enthält die Methoden zum Definieren und Erstellen einer reaktionsfähigen Suchanzeige. Informationen zu Generatoren finden Sie unter Generatoren.
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`);
}
}
Fügt der aktuellen Liste der Beschreibungen die angegebene Beschreibung hinzu. Mindestens 2 Beschreibungen müssen entweder mit dieser oder der addDescription()-Methode angegeben werden.
Fügt der aktuellen Liste der Überschriften die bereitgestellte Überschrift hinzu. Mindestens 3 Überschriften müssen entweder mit dieser oder der addHeadline()-Methode angegeben werden.
Fügt der aktuellen Liste der Beschreibungen die angegebene Beschreibung 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 Grenzwerten und zum Einschließen dynamischer Textzeichenfolgen finden Sie unter Bing Ads-API.
Pinning
string
Die optionale angeheftete Position.
Mögliche Werte für Beschreibungen: DESCRIPTION_1, DESCRIPTION_2
Fügt der aktuellen Liste der Überschriften die bereitgestellte Überschrift 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 Grenzwerten und zum Einschließen dynamischer Textzeichenfolgen finden Sie unter Bing Ads-API.
Pinning
string
Die optionale angeheftete Position.
Mögliche Werte für Überschriften: HEADLINE_1, HEADLINE_2, HEADLINE_3
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.
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.
Anzeigengenerator 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, 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()).
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.
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.
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.