KeywordBuilder

Contiene los métodos para definir y crear una palabra clave. Para obtener información sobre los constructores, consulte Constructores.

Nota:

Todas las palabras clave modificadoras de coincidencia general para anuncios de búsqueda ahora funcionan como palabras clave de coincidencia general en lugar de coincidencia de frase. Obtén más información acerca de los tipos de coincidencia de palabras clave.

Ejemplo de uso:

    var operation = adGroup.newKeywordBuilder()
        .withText("KEYWORD TEXT GOES HERE")
        .withCpc(0.5)
        .withFinalUrl("http://www.contoso.com")
        .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
Compilar	KeywordOperation	Crea la palabra clave y devuelve un objeto de operación que se usa para comprobar si la palabra clave se agregó correctamente.
withCpc (doble cpc)	KeywordBuilder	Establece la puja de CPC máxima de la palabra clave.
withCustomParameters(Object customParameters)	KeywordBuilder	Establece los parámetros personalizados de la palabra clave.
withFinalUrl(string finalUrl)	KeywordBuilder	Establece la dirección URL final de la palabra clave.
withMobileFinalUrl(string mobileFinalUrl)	KeywordBuilder	Establece la dirección URL final de la palabra clave para dispositivos móviles.
withText(string text)	KeywordBuilder	Establece el texto de la palabra clave.
withTrackingTemplate(string trackingTemplate)	KeywordBuilder	Establece la plantilla de seguimiento de la palabra clave.

build

Crea la palabra clave y devuelve un objeto de operación que se usa para comprobar si la palabra clave se agregó correctamente.

Valores devueltos

Tipo	Description
KeywordOperation	Objeto de operación que se usa para comprobar si la palabra clave se agregó correctamente.

withCpc (doble cpc)

Establece la puja de CPC máxima de la palabra clave.

Especifica el importe de la puja que se usará cuando la palabra clave coincida con el término de búsqueda del usuario. Solo se aplica si la estrategia de pujas del grupo de anuncios está establecida en MANUAL_CPC.

Para usar el importe de la oferta especificado en el nivel de grupo de anuncios, no llames a este método.

Para obtener más información sobre los importes de las ofertas, consulte Bid y BiddingScheme.

Argumentos

Nombre	Tipo	Description
CPC	double	La puja de CPC máxima que se aplicará a la palabra clave. La moneda de la cuenta determina los valores de puja mínimos y máximos. Para obtener más información, consulta Monedas de puja y presupuesto.

Valores devueltos

Tipo	Description
KeywordBuilder	Generador de palabras clave con la puja de CPC aplicada.

withCustomParameters(Object customParameters)

Establece los parámetros personalizados de la palabra clave.

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 de la palabra clave. 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
KeywordBuilder	Generador de palabras clave con los parámetros personalizados aplicados.

withFinalUrl(string finalUrl)

Establece la dirección URL final de la palabra clave.

La dirección URL final identifica la página web a la que se dirigirá al usuario cuando haga clic en el anuncio. Si no se especifica, la entidad hereda la dirección URL final de su entidad principal. Por ejemplo, la entidad de palabra clave hereda la URL final del anuncio. Especifica la URL final de la palabra clave para reemplazar la URL final del anuncio.

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

Argumentos

Nombre	Tipo	Description
Url final	string	La URL final que identifica la página web a la que se dirigirá al usuario cuando haga clic en el anuncio.

Valores devueltos

Tipo	Description
KeywordBuilder	Generador de palabras clave con la URL final aplicada.

withMobileFinalUrl(string mobileFinalUrl)

Establece la dirección URL final de la palabra clave 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. Si no se especifica, la entidad hereda la dirección URL final de su entidad principal. Por ejemplo, la entidad de palabra clave hereda la URL final del anuncio. Especifica la URL final de la palabra clave si quieres reemplazar la URL final del anuncio.

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

Para especificar una URL final para dispositivos móviles, primero especifica una URL final para dispositivos no móviles (consulta withFinalUrl()).

Argumentos

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

Valores devueltos

Tipo	Description
KeywordBuilder	Generador de palabras clave con la URL final móvil aplicada.

withText(string text)

Establece el texto de la palabra clave.

Para especificar el tipo de coincidencia de la palabra clave, use la sintaxis siguiente:

• Para una coincidencia amplia, no use la sintaxis de tipo de coincidencia (por ejemplo, keywordBuilder.withText("books")).
• Para el modificador de coincidencia amplia, anteponga el texto con un signo más (+) (por ejemplo, keywordBuilder.withText("+books")). Nota: si intentas crear nuevas palabras clave de modificador de coincidencia amplia (BMM), se guardarán y servirán como palabras clave de coincidencia de frase. Las palabras clave de BMM existentes seguirán funcionando con el comportamiento de coincidencia de frases. Obtén más información acerca de los tipos de coincidencia de palabras clave.
• Para la coincidencia de frases, coloque comillas alrededor del texto (por ejemplo, keywordBuilder.withText("\"books\"")).
• Para obtener una coincidencia exacta, coloque el texto entre corchetes alrededor del texto (por ejemplo, keywordBuilder.withText("[hardcover books]")).

Argumentos

Nombre	Tipo	Descripción
text	string	El texto de la palabra clave. El texto de la palabra clave es obligatorio. El texto puede contener un máximo de 100 caracteres. Especifica el texto de la configuración regional del valor de idioma del grupo de anuncios.

Valores devueltos

Tipo	Description
KeywordBuilder	Generador de palabras clave con el texto de la palabra clave aplicado.

withTrackingTemplate(string trackingTemplate)

Establece la plantilla de seguimiento de la palabra clave.

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 esta palabra clave.

Valores devueltos

Tipo	Description
KeywordBuilder	Generador de palabras clave con la plantilla de seguimiento aplicada.