Contiene los métodos para definir y crear un anuncio de texto expandido. Para obtener información sobre los constructores, consulte Constructores.
Nota:
-
Actualiza los anuncios de texto expandidos a anuncios de búsqueda de respuesta antes del 1 de febrero de 2023. Después de esta fecha, ya no podrás crear anuncios de texto expandido ni editar los existentes. Para obtener más información, consulta Acerca de los anuncios de búsqueda dinámicos.
- Los anuncios de texto expandido existentes seguirán apareciendo y podrás seguir viendo informes sobre su rendimiento.
- Aún podrás pausar, habilitar o quitar los anuncios de texto expandidos. De lo contrario, los intentos de agregar o actualizar anuncios de texto expandido producirán un
CampaignServiceAdTypeInvalid error.
-
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
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 |
|
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 a 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 y la inclusión de cadenas de texto dinámico, consulte la API de Bing Ads. |
Valores devueltos
withDescription1(string description1)
Establece la primera descripción del anuncio. Este método establece el mismo campo que withDescription(string description).
Argumentos
| Nombre |
Tipo |
Description |
| description1 |
string |
La primera descripción del anuncio. Para obtener información sobre los límites de copia y la inclusión de cadenas de texto dinámico, consulte la API de Bing Ads. |
Valores devueltos
withDescription2(string description2)
Establece la segunda descripción del anuncio.
Argumentos
| Nombre |
Tipo |
Description |
| description2 |
string |
La segunda descripción del anuncio. Para obtener información sobre los límites de copia y la inclusión de cadenas de texto dinámico, consulte la API de Bing Ads. |
Valores devueltos
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
withHeadlinePart1(string headlinePart1)
Establece la primera parte del título del anuncio.
Argumentos
| Nombre |
Tipo |
Description |
| headlinePart1 |
string |
La primera parte del título del anuncio. Cuando Microsoft genera el título del anuncio con las partes 1, 2 y 3 del título, concatena las partes mediante " -". 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ítulos adicionales y la inclusión de cadenas de texto dinámicas en el título, consulta Microsoft Advertising API. |
Valores devueltos
| Tipo |
Description |
|
ExpandedTextAdBuilder |
Generador de anuncios con la parte 1 del título del anuncio aplicada. |
withHeadlinePart2(string headlinePart2)
Establece la segunda parte del título del anuncio.
Argumentos
| Nombre |
Tipo |
Description |
| titularParte2 |
string |
La segunda parte del título del anuncio. Cuando Microsoft genera el título del anuncio con las partes 1, 2 y 3 del título, concatena las partes mediante " -". 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ítulos adicionales y la inclusión de cadenas de texto dinámicas en el título, consulta Microsoft Advertising API. |
Valores devueltos
| Tipo |
Description |
|
ExpandedTextAdBuilder |
Generador de anuncios con la parte 1 del título del anuncio aplicada. |
withHeadlinePart3(string headlinePart3)
Establece la tercera parte del título del anuncio.
Argumentos
| Nombre |
Tipo |
Description |
| titularParte3 |
string |
La tercera parte del título del anuncio. Cuando Microsoft genera el título del anuncio con las partes 1, 2 y 3 del título, concatena las partes mediante " -". 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ítulos adicionales y la inclusión de cadenas de texto dinámicas en el título, consulta Microsoft Advertising API. |
Valores devueltos
| Tipo |
Description |
|
ExpandedTextAdBuilder |
Generador de anuncios con la parte 1 del título del anuncio aplicada. |
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
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
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
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