KeywordBuilder
Contiene los métodos para definir y crear una palabra clave. Para obtener información sobre los generadores, vea Generadores.
Nota:
Todas las palabras clave del modificador de coincidencia amplia para los anuncios de búsqueda ahora sirven como palabras clave de coincidencia amplia en lugar de coincidencia de frases. Obtenga más información sobre 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 | Descripción |
|---|---|---|
| Construir | KeywordOperation | Crea la palabra clave y devuelve un objeto operation usado para comprobar si la palabra clave se agregó correctamente. |
| withCpc(double 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 operation usado para comprobar si la palabra clave se agregó correctamente.
Valores devueltos
| Tipo | Descripción |
|---|---|
| KeywordOperation | Objeto de operación que se usa para comprobar si la palabra clave se agregó correctamente. |
withCpc(double 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 la cantidad de puja especificada en el nivel de grupo de anuncios, no llame a este método.
Para obtener más información sobre los importes de la oferta, consulte Bid and BiddingScheme.
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| Cpc | double | La puja de CPC máxima que se va a aplicar a la palabra clave . La moneda de la cuenta determina los valores de puja mínimo y máximo. Para obtener más información, consulte Monedas de puja y presupuesto. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| 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, 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 de la palabra clave. 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 |
|---|---|
| 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 lleva al usuario cuando hace clic en el anuncio. Si no se especifica, la entidad hereda la dirección URL final de su entidad primaria. Por ejemplo, la entidad de palabra clave hereda la dirección URL final del anuncio. Especifique la dirección URL final de la palabra clave para invalidar la dirección URL final del anuncio.
Para obtener más información, consulte ¿Qué parámetros de seguimiento o dirección URL puedo usar?
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| finalUrl | string | La dirección URL final que identifica la página web a la que se lleva al usuario cuando hace clic en el anuncio. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| KeywordBuilder | Generador de palabras clave con la dirección 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 lleva al usuario cuando hace clic en el anuncio. Si no se especifica, la entidad hereda la dirección URL final de su entidad primaria. Por ejemplo, la entidad de palabra clave hereda la dirección URL final del anuncio. Especifique la dirección URL final de la palabra clave si desea invalidar la dirección URL final del anuncio.
Para obtener más información, consulte ¿Qué parámetros de seguimiento o dirección URL puedo usar?
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()).
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| mobileFinalUrl | string | La dirección URL final de los dispositivos móviles. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| KeywordBuilder | Generador de palabras clave con la dirección 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 ninguna 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 intenta crear nuevas palabras clave de modificador de coincidencia amplia (BMM), se guardarán y se servirán como palabras clave de coincidencia de frases. Las palabras clave de BMM existentes seguirán sirviendo en el comportamiento de coincidencia de frases. Obtenga más información sobre los tipos de coincidencia de palabras clave. - Para la coincidencia de frases, coloque comillas alrededor del texto (por ejemplo,
keywordBuilder.withText("\"books\"")). - Para una coincidencia exacta, coloque corchetes alrededor del texto (por ejemplo,
keywordBuilder.withText("[hardcover books]")).
Argumentos
| Nombre | Tipo | Descripción |
|---|---|---|
| text | string | Texto de la palabra clave. Se requiere el texto de la palabra clave. El texto puede contener un máximo de 100 caracteres. Especifique el texto en la configuración regional del valor de idioma del grupo de anuncios. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| KeywordBuilder | Generador de palabras clave con el texto de palabra clave aplicado. |
withTrackingTemplate(string trackingTemplate)
Establece la plantilla de seguimiento de la palabra clave.
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 esta palabra clave. |
Valores devueltos
| Tipo | Descripción |
|---|---|
| KeywordBuilder | Generador de palabras clave con la plantilla de seguimiento aplicada. |