Compartir a través de


ExpandedTextAdBuilder

Contiene los métodos para definir y crear un anuncio de texto expandido. Para obtener información sobre los generadores, vea Generadores.

Nota:

  • Actualiza tus anuncios de texto expandidos a anuncios de búsqueda adaptables antes del 1 de febrero de 2023. Después de esta fecha, ya no podrás crear anuncios de texto expandidos nuevos ni editarlos. Para obtener más información, consulte Acerca de los anuncios de búsqueda con capacidad de respuesta.
  • Los anuncios de texto expandidos existentes seguirán publicándose y podrás ver informes sobre su rendimiento.
  • Seguirás siendo capaz de pausar, habilitar o quitar tus anuncios de texto expandido. De lo contrario, los intentos de agregar o actualizar anuncios de texto expandido producirán un CampaignServiceAdTypeInvalid error.
  • Obtenga más información sobre este cambio.

Ejemplo de uso:

    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`);
        }
    }

Métodos

Nombre del método Tipo de valor devuelto Descripción
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) ExpandedTextAdBuilder Establece los parámetros personalizados del anuncio.
withDescription(string description) ExpandedTextAdBuilder Establece la primera descripción del anuncio. Este método está en desuso en favor de withDescription1(string description1).
withDescription1(string description1) ExpandedTextAdBuilder Establece la primera descripción del anuncio. Este método establece el mismo campo que withDescription(string description).
withDescription2(string description2) ExpandedTextAdBuilder Establece la segunda descripción del anuncio.
withFinalUrl(string finalUrl) ExpandedTextAdBuilder Establece la dirección URL de la página de aterrizaje del anuncio.
withHeadlinePart1(string headlinePart1) ExpandedTextAdBuilder Establece la primera parte del título del anuncio.
withHeadlinePart2(string headlinePart2) ExpandedTextAdBuilder Establece la segunda parte del título del anuncio.
withHeadlinePart3(string headlinePart3) ExpandedTextAdBuilder Establece la tercera parte del título del anuncio.
withMobileFinalUrl(string mobileFinalUrl) ExpandedTextAdBuilder Establece la dirección URL final del anuncio para dispositivos móviles.
withPath1(string urlPath1) ExpandedTextAdBuilder Establece la primera ruta de acceso opcional que se anexará a la dirección URL para mostrar del anuncio.
withPath2(string urlPath2) ExpandedTextAdBuilder Establece la segunda ruta de acceso opcional que se anexará a la dirección URL para mostrar del anuncio.
withTrackingTemplate(string trackingTemplate) ExpandedTextAdBuilder Establece la plantilla de seguimiento del anuncio.

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
ExpandedTextAdBuilder Generador de anuncios con los parámetros personalizados aplicados.

withDescription(string description)

Establece la primera descripción del anuncio. Este método está en desuso en favor de withDescription1(string description1).

Argumentos

Nombre Tipo Descripción
description string La primera descripción del anuncio. Para obtener información sobre los límites de copia e incluir cadenas de texto dinámico, consulte Bing Ads API.

Valores devueltos

Tipo Descripción
ExpandedTextAdBuilder Generador de anuncios con la descripción aplicada.

withDescription1(string description1)

Establece la primera descripción del anuncio. Este método establece el mismo campo que withDescription(string description).

Argumentos

Nombre Tipo Descripción
description1 string La primera descripción del anuncio. Para obtener información sobre los límites de copia e incluir cadenas de texto dinámico, consulte Bing Ads API.

Valores devueltos

Tipo Descripción
ExpandedTextAdBuilder Generador de anuncios con la descripción aplicada.

withDescription2(string description2)

Establece la segunda descripción del anuncio.

Argumentos

Nombre Tipo Descripción
description2 string Segunda descripción del anuncio. Para obtener información sobre los límites de copia e incluir cadenas de texto dinámico, consulte Bing Ads API.

Valores devueltos

Tipo Descripción
ExpandedTextAdBuilder Generador de anuncios con la descripción aplicada.

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
ExpandedTextAdBuilder Generador de anuncios con la dirección URL final aplicada.

withHeadlinePart1(string headlinePart1)

Establece la primera parte del título del anuncio.

Argumentos

Nombre Tipo Descripción
headlinePart1 string La primera parte del título del anuncio. Cuando Microsoft genera el título del anuncio mediante las partes 1, 2 y 3 del título, concatena las partes con " - ". No especifique el guion en ninguna parte del título. Cada parte del título debe contener al menos una palabra. Para obtener información sobre los límites de título adicionales e incluir cadenas de texto dinámico en el título, consulte Bing Ads API.

Valores devueltos

Tipo Descripción
ExpandedTextAdBuilder Generador de anuncios con la parte 1 del título del anuncio aplicado.

withHeadlinePart2(string headlinePart2)

Establece la segunda parte del título del anuncio.

Argumentos

Nombre Tipo Descripción
headlinePart2 string La segunda parte del título del anuncio. Cuando Microsoft genera el título del anuncio mediante las partes 1, 2 y 3 del título, concatena las partes con " - ". No especifique el guion en ninguna parte del título. Cada parte del título debe contener al menos una palabra. Para obtener información sobre los límites de título adicionales e incluir cadenas de texto dinámico en el título, consulte Bing Ads API.

Valores devueltos

Tipo Descripción
ExpandedTextAdBuilder Generador de anuncios con la parte 1 del título del anuncio aplicado.

withHeadlinePart3(string headlinePart3)

Establece la tercera parte del título del anuncio.

Argumentos

Nombre Tipo Descripción
headlinePart3 string La tercera parte del título del anuncio. Cuando Microsoft genera el título del anuncio mediante las partes 1, 2 y 3 del título, concatena las partes con " - ". No especifique el guion en ninguna parte del título. Cada parte del título debe contener al menos una palabra. Para obtener información sobre los límites de título adicionales e incluir cadenas de texto dinámico en el título, consulte Bing Ads API.

Valores devueltos

Tipo Descripción
ExpandedTextAdBuilder Generador de anuncios con la parte 1 del título del anuncio aplicado.

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
ExpandedTextAdBuilder 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
ExpandedTextAdBuilder 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
ExpandedTextAdBuilder 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
ExpandedTextAdBuilder Generador de anuncios con la plantilla de seguimiento aplicada.