Enthält die Methoden zum Definieren und Erstellen einer erweiterten Textanzeige. Informationen zu Buildern finden Sie unter Builder.
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.
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
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 |
|
ExpandedTextAdBuilder |
Anzeigen-Generator mit 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 Kopierlimits und einschließlich dynamischer Textzeichenfolgen finden Sie unter Bing Ads API. |
Rückgabewerte
withDescription1(string description1)
Legt die erste Beschreibung der Anzeige fest. Diese Methode legt das gleiche Feld wie withDescription(string description) fest.
Argumente
| Name |
Typ |
Beschreibung |
| Beschreibung1 |
string |
Die erste Beschreibung der Anzeige Informationen zu Kopierlimits und einschließlich dynamischer Textzeichenfolgen finden Sie unter Bing Ads API. |
Rückgabewerte
withDescription2(string description2)
Legt die zweite Beschreibung der Anzeige fest.
Argumente
| Name |
Typ |
Beschreibung |
| Beschreibung2 |
string |
Die zweite Beschreibung der Anzeige Informationen zu Kopierlimits und einschließlich dynamischer Textzeichenfolgen finden Sie unter Bing Ads API. |
Rückgabewerte
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
withHeadlinePart1(string headlinePart1)
Legt den ersten Teil des Anzeigentitels fest.
Argumente
| Name |
Typ |
Beschreibung |
| headlinePart1 |
string |
Der erste Teil des Anzeigentitels. Wenn Microsoft den Anzeigentitel anhand der Teile 1, 2 und 3 des Titels generiert, werden die Teile mit " - " verkettet. 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 Einfügen dynamischer Textzeichenfolgen in den Titel finden Sie unter Bing Ads API. |
Rückgabewerte
withHeadlinePart2(string headlinePart2)
Legt den zweiten Teil des Anzeigentitels fest.
Argumente
| Name |
Typ |
Beschreibung |
| headlinePart2 |
string |
Der zweite Teil des Anzeigentitels. Wenn Microsoft den Anzeigentitel anhand der Teile 1, 2 und 3 des Titels generiert, werden die Teile mit " - " verkettet. 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 Einfügen dynamischer Textzeichenfolgen in den Titel finden Sie unter Bing Ads API. |
Rückgabewerte
withHeadlinePart3(string headlinePart3)
Legt den dritten Teil des Anzeigentitels fest.
Argumente
| Name |
Typ |
Beschreibung |
| headlinePart3 |
string |
Der dritte Teil des Anzeigentitels. Wenn Microsoft den Anzeigentitel anhand der Teile 1, 2 und 3 des Titels generiert, werden die Teile mit " - " verkettet. 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 Einfügen dynamischer Textzeichenfolgen in den Titel finden Sie unter Bing Ads API. |
Rückgabewerte
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
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
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
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 |
|
ExpandedTextAdBuilder |
Anzeigen-Generator mit angewendeter Vorlage für die Nachverfolgung. |