Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Contiene los métodos para definir y crear un anuncio de búsqueda con capacidad de respuesta. Para obtener información sobre los generadores, vea Generadores.
Ejemplo de uso:
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`);
}
}
Métodos
| Nombre del método | Tipo de valor devuelto | Descripción |
|---|---|---|
| addDescription(string description, string pinning) | ResponsiveSearchAdBuilder | Agrega la descripción proporcionada a la lista actual de descripciones. Se deben especificar al menos 2 descripciones mediante este o el método addDescription(). |
| addHeadline(string headline, string pinning) | ResponsiveSearchAdBuilder | Agrega el título proporcionado a la lista actual de titulares. Se deben especificar al menos 3 titulares mediante este o el método addHeadline(). |
| Construir | AdOperation | Crea el anuncio y devuelve un objeto de operación que se usa para comprobar si scripts agregaron correctamente el anuncio. |
| withCustomParameters(Object customParameters) | ResponsiveSearchAdBuilder | Establece los parámetros personalizados del anuncio. |
| withDescriptions(object[] descriptions) | ResponsiveSearchAdBuilder | Establece las descripciones del anuncio. |
| withFinalUrl(string finalUrl) | ResponsiveSearchAdBuilder | Establece la dirección URL de la página de aterrizaje del anuncio. |
| withFinalUrlSuffix(string finalUrlSuffix) | ResponsiveSearchAdBuilder | Establece el sufijo url final del anuncio. |
| withHeadlines(object[] headlines) | ResponsiveSearchAdBuilder | Establece los titulares del anuncio. |
| withMobileFinalUrl(string mobileFinalUrl) | ResponsiveSearchAdBuilder | Establece la dirección URL final del anuncio para dispositivos móviles. |
| withPath1(string urlPath1) | ResponsiveSearchAdBuilder | Establece la primera ruta de acceso opcional que se anexará a la dirección URL para mostrar del anuncio. |
| withPath2(string urlPath2) | ResponsiveSearchAdBuilder | Establece la segunda ruta de acceso opcional que se anexará a la dirección URL para mostrar del anuncio. |
| withTrackingTemplate(string trackingTemplate) | ResponsiveSearchAdBuilder | Establece la plantilla de seguimiento del anuncio. |
addDescription(string description, string pinning)
Agrega la descripción proporcionada a la lista actual de descripciones. Se deben especificar al menos 2 descripciones mediante este o el método addDescription().
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| description | string | Descripción del anuncio que se va a agregar. Para obtener información sobre los límites e incluir cadenas de texto dinámico, consulte Bing Ads API. |
| Fijación | string | Ubicación anclada opcional. Los valores posibles para las descripciones son: DESCRIPTION_1, DESCRIPTION_2 |
| text | string | Texto de este recurso. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| ResponsiveSearchAdBuilder | Generador de anuncios con la descripción aplicada. |
addHeadline(string headline, string pinning)
Agrega el título proporcionado a la lista actual de titulares. Se deben especificar al menos 3 titulares mediante este o el método addHeadline().
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| Titular | string | Título del anuncio que se va a agregar. Para obtener información sobre los límites e incluir cadenas de texto dinámico, consulte Bing Ads API. |
| Fijación | string | Ubicación anclada opcional. Los valores posibles para los titulares son: HEADLINE_1, HEADLINE_2, HEADLINE_3 |
Valores devueltos
| Tipo | Descripción |
|---|---|
| ResponsiveSearchAdBuilder | Generador de anuncios con el título aplicado. |
build
Crea el anuncio y devuelve un objeto de operación que se usa para comprobar si scripts agregaron correctamente el anuncio.
Para conocer los límites del número de anuncios que puedes agregar a un grupo de anuncios, consulta Límites de jerarquía de entidades.
Valores devueltos
| Tipo | Descripción |
|---|---|
| AdOperation | Objeto de operación que se usa para comprobar si scripts agregaron correctamente el anuncio. |
withCustomParameters(Object customParameters)
Establece los parámetros personalizados del anuncio.
Los parámetros personalizados son útiles para compartir información dinámica entre varias direcciones URL. Para obtener más información sobre su uso, vea Parámetros personalizados.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| customParameters | Objeto | Mapa de hasta parámetros personalizados que se aplicarán a la dirección URL final del anuncio. Por ejemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, donde key es el nombre y el valor del parámetro personalizado es el valor del parámetro. El nombre puede contener un máximo de 16 caracteres de 8 bytes y el valor puede contener un máximo de 200 caracteres de 8 bytes. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| ResponsiveSearchAdBuilder | Generador de anuncios con los parámetros personalizados aplicados. |
withDescriptions(object[] descriptions)
Establece las descripciones del anuncio.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| Descripciones | AdTextAsset[] | Descripciones del anuncio. Para obtener información sobre los límites e incluir cadenas de texto dinámico, consulte Bing Ads API. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| ResponsiveSearchAdBuilder | Generador de anuncios con las descripciones aplicadas. |
withFinalUrl(string finalUrl)
Establece la dirección URL de la página de aterrizaje del anuncio.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| finalUrl | string | Dirección URL de la página de aterrizaje del anuncio. Para obtener información sobre los límites de direcciones URL, consulte Bing Ads API. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| ResponsiveSearchAdBuilder | Generador de anuncios con la dirección URL final aplicada. |
withFinalUrlSuffix(string finalUrlSuffix)
Establece el sufijo url final del anuncio.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| finalUrl | string | Sufijo url final del anuncio. Para obtener información sobre los límites de direcciones URL, consulte Bing Ads API. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| ResponsiveSearchAdBuilder | Generador de anuncios con la dirección URL final aplicada. |
titulares withHeadlines(object[]
Establece los titulares del anuncio.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| Encabezados | AdTextAsset[] | Los titulares del anuncio. Para obtener información sobre los límites e incluir cadenas de texto dinámico, consulte Bing Ads API. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| ResponsiveSearchAdBuilder | Generador de anuncios con los titulares del anuncio aplicados. |
withMobileFinalUrl(string mobileFinalUrl)
Establece la dirección URL final del anuncio para dispositivos móviles.
La dirección URL final identifica la página web a la que se lleva al usuario cuando hace clic en el anuncio. Para especificar una dirección URL final para dispositivos móviles, especifique primero una dirección URL final para dispositivos que no sean móviles (consulte withFinalUrl()).
Para obtener más información, consulte ¿Qué parámetros de seguimiento o dirección URL puedo usar?
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| mobileFinalUrl | string | La dirección URL final de los dispositivos móviles. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| ResponsiveSearchAdBuilder | Generador de anuncios con la dirección URL final móvil aplicada. |
withPath1(string urlPath1)
Establece la primera ruta de acceso opcional que se anexará a la dirección URL para mostrar del anuncio.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| mobileFinalUrl | string | La primera ruta de acceso opcional que se anexará a la dirección URL para mostrar del anuncio. Microsoft usa el dominio especificado en withFinalUrl como la dirección URL de presentación. Si el dominio de la dirección URL final está contoso.com y la ruta de acceso es calzado, la dirección URL de presentación del anuncio se contoso.com/shoes. Para obtener información sobre el uso y los límites, consulte Path1. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| ResponsiveSearchAdBuilder | Generador de anuncios con la ruta de acceso aplicada. |
withPath2(string urlPath2)
Establece la segunda ruta de acceso opcional que se anexará a la dirección URL para mostrar del anuncio.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| mobileFinalUrl | string | La segunda ruta de acceso opcional que se anexará a la dirección URL para mostrar del anuncio. Para especificar la segunda ruta de acceso, especifique primero la primera ruta de acceso (consulte withPath1). Microsoft usa el dominio especificado en withFinalUrl como la dirección URL de presentación. Si se contoso.com el dominio de la dirección URL final, la primera ruta es zapatos y la segunda ruta de acceso es damas, la dirección URL de presentación del anuncio se contoso.com/shoes/ladies. Para obtener información sobre el uso y los límites, consulte Path2. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| ResponsiveSearchAdBuilder | Generador de anuncios con la ruta de acceso aplicada. |
withTrackingTemplate(string trackingTemplate)
Establece la plantilla de seguimiento del anuncio.
Las plantillas de seguimiento se usan con finalUrl de la palabra clave para crear la dirección URL de destino usada por el anuncio. Para obtener más información, consulte ¿Qué parámetros de seguimiento o dirección URL puedo usar?
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| trackingTemplate | string | Plantilla de seguimiento que se va a usar con este anuncio. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| ResponsiveSearchAdBuilder | Generador de anuncios con la plantilla de seguimiento aplicada. |