Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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`);
}
}
Methoden
| Methodenname | Rückgabetyp | Beschreibung |
|---|---|---|
| addDescription(string description, string pinning) | ResponsiveSearchAdBuilder | 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. |
| addHeadline(string headline, string pinning) | ResponsiveSearchAdBuilder | 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. |
| 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) | 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 endgültige URL-Suffix 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 werden soll. |
| 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 Nachverfolgungsvorlage der Anzeige fest. |
addDescription(string description, string pinning)
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 |
| text | string | Der Text dieses Medienobjekts. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| ResponsiveSearchAdBuilder | Anzeigengenerator mit angewendeter Beschreibung. |
addHeadline(string headline, string pinning)
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 |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| ResponsiveSearchAdBuilder | Anzeigengenerator mit angewendeter Überschrift. |
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 |
|---|---|
| ResponsiveSearchAdBuilder | Anzeigen-Generator mit den angewendeten benutzerdefinierten Parametern. |
withDescriptions(object[] descriptions)
Legt die Beschreibungen der Anzeige fest.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| Beschreibungen | AdTextAsset[] | Die Beschreibungen der Anzeige. Informationen zu Grenzwerten und zum Einschließen dynamischer Textzeichenfolgen finden Sie unter Bing Ads-API. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| ResponsiveSearchAdBuilder | Anzeigen-Generator mit den 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-Grenzwerten finden Sie unter Bing Ads-API. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| ResponsiveSearchAdBuilder | Anzeigengenerator mit angewendeter endgültiger URL. |
withFinalUrlSuffix(string finalUrlSuffix)
Legt das endgültige URL-Suffix der Anzeige fest.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| finalUrl | string | Das endgültige URL-Suffix der Anzeige. Informationen zu URL-Grenzwerten finden Sie unter Bing Ads-API. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| ResponsiveSearchAdBuilder | Anzeigengenerator 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 Grenzwerten und zum Einschließen dynamischer Textzeichenfolgen finden Sie unter Bing Ads-API. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| ResponsiveSearchAdBuilder | 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()).
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 |
|---|---|
| ResponsiveSearchAdBuilder | 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 |
|---|---|
| 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 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 |
|---|---|
| ResponsiveSearchAdBuilder | 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 |
|---|---|
| ResponsiveSearchAdBuilder | Anzeigengenerator mit angewendeter Nachverfolgungsvorlage. |