ResponsiveSearchAdBuilder

Contiene los métodos para definir y crear un anuncio de búsqueda con capacidad de respuesta. Para obtener información sobre los constructores, consulte Constructores.

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	Description
addDescription(string description, string pinning)	ResponsiveSearchAdBuilder	Agrega la descripción proporcionada a la lista actual de descripciones. Se deben especificar al menos 2 descripciones utilizando este método o el método addDescription().
addHeadline(string headline, string pinning)	ResponsiveSearchAdBuilder	Agrega el titular proporcionado a la lista actual de titulares. Se deben especificar al menos 3 titulares utilizando este método o el método addHeadline().
Compilar	AdOperation	Crea el anuncio y devuelve un objeto de operación que se usa para comprobar si Scripts agregó 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 destino del anuncio.
withFinalUrlSuffix(string finalUrlSuffix)	ResponsiveSearchAdBuilder	Establece el sufijo de la URL final del anuncio.
withHeadlines(object[] headlines)	ResponsiveSearchAdBuilder	Establece los titulares del anuncio.
withMobileFinalUrl(string mobileFinalUrl)	ResponsiveSearchAdBuilder	Establece la URL final del anuncio para dispositivos móviles.
withPath1(string urlPath1)	ResponsiveSearchAdBuilder	Establece la primera ruta opcional para anexar a la dirección URL visible del anuncio.
withPath2(string urlPath2)	ResponsiveSearchAdBuilder	Establece la segunda ruta opcional para anexar a la dirección URL visible 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 utilizando este método 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 y la inclusión de cadenas de texto dinámico, consulte API de Bing Ads.
anclaje	string	La ubicación anclada opcional. Los valores posibles para las descripciones son: DESCRIPTION_1, DESCRIPTION_2
text	string	El texto de este recurso.

Valores devueltos

Tipo	Description
ResponsiveSearchAdBuilder	Ad Builder con la descripción aplicada.

addHeadline(string headline, string pinning)

Agrega el titular proporcionado a la lista actual de titulares. Se deben especificar al menos 3 titulares utilizando este método o el método addHeadline().

Argumentos

Nombre	Tipo	Description
Título	string	El título del anuncio que se va a agregar. Para obtener información sobre los límites y la inclusión de cadenas de texto dinámico, consulte API de Bing Ads.
anclaje	string	La ubicación anclada opcional. Los valores posibles para los titulares son: HEADLINE_1, HEADLINE_2 HEADLINE_3

Valores devueltos

Tipo	Description
ResponsiveSearchAdBuilder	Creador de anuncios con el titular aplicado.

build

Crea el anuncio y devuelve un objeto de operación que se usa para comprobar si Scripts agregó 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 la jerarquía de entidades.

Valores devueltos

Tipo	Description
AdOperation	Objeto de operación que se usa para comprobar si Scripts agregó 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, consulte Parámetros personalizados.

Argumentos

Nombre	Tipo	Description
customParameters	Objeto	Asignación de parámetros personalizados para aplicar a la URL final del anuncio. Por ejemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, donde clave es el nombre del parámetro personalizado y valor 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	Description
ResponsiveSearchAdBuilder	Generador de anuncios con los parámetros personalizados aplicados.

withDescriptions(object[] descriptions)

Establece las descripciones del anuncio.

Argumentos

Nombre	Tipo	Description
Descripciones	AdTextAsset[]	Las descripciones del anuncio. Para obtener información sobre los límites y la inclusión de cadenas de texto dinámico, consulte API de Bing Ads.

Valores devueltos

Tipo	Description
ResponsiveSearchAdBuilder	Generador de anuncios con las descripciones aplicadas.

withFinalUrl(string finalUrl)

Establece la dirección URL de la página de destino del anuncio.

Argumentos

Nombre	Tipo	Description
Url final	string	La dirección URL de la página de destino del anuncio. Para obtener información sobre los límites de URL, consulta la API de Bing Ads.

Valores devueltos

Tipo	Description
ResponsiveSearchAdBuilder	Generador de anuncios con la URL final aplicada.

withFinalUrlSuffix(string finalUrlSuffix)

Establece el sufijo de la URL final del anuncio.

Argumentos

Nombre	Tipo	Description
Url final	string	El sufijo de URL final del anuncio. Para obtener información sobre los límites de URL, consulta la API de Bing Ads.

Valores devueltos

Tipo	Description
ResponsiveSearchAdBuilder	Generador de anuncios con la URL final aplicada.

withHeadlines(object[] headlines

Establece los titulares del anuncio.

Argumentos

Nombre	Tipo	Description
titulares	AdTextAsset[]	Los titulares del anuncio. Para obtener información sobre los límites y la inclusión de cadenas de texto dinámico, consulte API de Bing Ads.

Valores devueltos

Tipo	Description
ResponsiveSearchAdBuilder	Creador de anuncios con los titulares del anuncio aplicados.

withMobileFinalUrl(string mobileFinalUrl)

Establece la URL final del anuncio para dispositivos móviles.

La dirección URL final identifica la página web a la que se dirigirá al usuario cuando haga clic en el anuncio. Para especificar una URL final para dispositivos móviles, primero especifica una URL final para dispositivos no móviles (consulta withFinalUrl()).

Para obtener más información, consulta ¿Qué parámetros de seguimiento o de URL puedo usar?

Argumentos

Nombre	Tipo	Description
mobileFinalUrl	string	La URL final para dispositivos móviles.

Valores devueltos

Tipo	Description
ResponsiveSearchAdBuilder	Creador de anuncios con la URL final móvil aplicada.

withPath1(string urlPath1)

Establece la primera ruta opcional para anexar a la dirección URL visible del anuncio.

Argumentos

Nombre	Tipo	Description
mobileFinalUrl	string	La primera ruta opcional que se anexa a la dirección URL para mostrar del anuncio. Microsoft usa el dominio especificado en withFinalUrl como dirección URL para mostrar. Si se contoso.com el dominio de la URL final y la ruta de acceso es zapatos, la dirección URL visible del anuncio es contoso.com/shoes. Para conocer el uso y los límites, consulta Ruta 1.

Valores devueltos

Tipo	Description
ResponsiveSearchAdBuilder	Creador de anuncios con la ruta aplicada.

withPath2(string urlPath2)

Establece la segunda ruta opcional para anexar a la dirección URL visible del anuncio.

Argumentos

Nombre	Tipo	Description
mobileFinalUrl	string	La segunda ruta opcional que se va a anexar a la dirección URL visible del anuncio. Para especificar la segunda ruta, especifique primero la primera ruta (consulte withPath1). Microsoft usa el dominio especificado en withFinalUrl como dirección URL para mostrar. Si el dominio de la URL final es contoso.com, la primera ruta es zapatos y la segunda ruta es mujeres, la URL visible del anuncio es contoso.com/shoes/ladies. Para obtener información sobre el uso y los límites, consulte Path2.

Valores devueltos

Tipo	Description
ResponsiveSearchAdBuilder	Creador de anuncios con la ruta aplicada.

withTrackingTemplate(string trackingTemplate)

Establece la plantilla de seguimiento del anuncio.

Las plantillas de seguimiento se usan con la FinalUrl de la palabra clave para crear la URL de destino que usa el anuncio. Para obtener más información, consulta ¿Qué parámetros de seguimiento o de URL puedo usar?

Argumentos

Nombre	Tipo	Description
trackingTemplate	string	La plantilla de seguimiento que se usará con este anuncio.

Valores devueltos

Tipo	Description
ResponsiveSearchAdBuilder	Generador de anuncios con la plantilla de seguimiento aplicada.