KeywordBuilder
Contém os métodos para definir e criar uma palavra-chave. Para obter informações sobre construtores, consulte Construtores.
Nota
Todas as palavras-chave modificadoras de correspondência abrangente para anúncios de pesquisa servem agora como palavras-chave de correspondência ampla em vez de correspondência de expressões. Saiba mais sobre os tipos de correspondência de palavras-chave.
Utilização de exemplo:
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
| Nome do Método | Tipo de Devolução | Descrição |
|---|---|---|
| criar | KeywordOperation | Cria a palavra-chave e devolve um objeto de operação utilizado para verificar se a palavra-chave foi adicionada com êxito. |
| withCpc(double cpc) | KeywordBuilder | Define a oferta máxima do CPC da palavra-chave. |
| withCustomParameters(Object customParameters) | KeywordBuilder | Define os parâmetros personalizados da palavra-chave. |
| withFinalUrl(string finalUrl) | KeywordBuilder | Define o URL final da palavra-chave. |
| withMobileFinalUrl(string mobileFinalUrl) | KeywordBuilder | Define o URL final da palavra-chave para dispositivos móveis. |
| withText(texto de cadeia) | KeywordBuilder | Define o texto da palavra-chave. |
| withTrackingTemplate(string trackingTemplate) | KeywordBuilder | Define o modelo de controlo da palavra-chave. |
criar
Cria a palavra-chave e devolve um objeto de operação utilizado para verificar se a palavra-chave foi adicionada com êxito.
Devoluções
| Tipo | Descrição |
|---|---|
| KeywordOperation | Um objeto de operação utilizado para verificar se a palavra-chave foi adicionada com êxito. |
withCpc(double cpc)
Define a oferta máxima do CPC da palavra-chave.
Especifica o valor da oferta a utilizar quando a palavra-chave corresponde ao termo de pesquisa do utilizador. Aplica-se apenas se a estratégia de licitação do grupo de anúncios estiver definida como MANUAL_CPC.
Para utilizar o valor da oferta especificado ao nível do grupo de anúncios, não chame este método.
Para obter mais informações sobre os montantes de licitação, veja Bid and Bid (Licitação) E Bid (Bid and BidScheme).
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| cpc | duplo | A oferta máxima do CPC a aplicar à palavra-chave. A moeda da conta determina os valores mínimos e máximos de licitação. Para obter mais informações, veja Moedas de licitação e orçamento. |
Devoluções
| Tipo | Descrição |
|---|---|
| KeywordBuilder | Construtor de palavras-chave com a oferta CPC aplicada. |
withCustomParameters(Object customParameters)
Define os parâmetros personalizados da palavra-chave.
Os parâmetros personalizados são úteis para partilhar informações dinâmicas em vários URLs. Para obter mais informações sobre a utilização, veja Parâmetros Personalizados.
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| customParameters | Objeto | Um mapa de até parâmetros personalizados a aplicar ao URL final da palavra-chave. Por exemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, em que a chave é o nome e o valor do parâmetro personalizado é o valor do parâmetro. O nome pode conter um máximo de 16 carateres de 8 bytes e o valor pode conter um máximo de 200 carateres de 8 bytes. |
Devoluções
| Tipo | Descrição |
|---|---|
| KeywordBuilder | Construtor de palavras-chave com os parâmetros personalizados aplicados. |
withFinalUrl(string finalUrl)
Define o URL final da palavra-chave.
O URL final identifica a página Web para a qual o utilizador é levado quando clica no anúncio. Se não for especificado, a entidade herda o URL final da entidade principal. Por exemplo, a entidade de palavra-chave herda o URL final do anúncio. Especifique o URL final da palavra-chave para substituir o URL final do anúncio.
Para obter mais informações, veja Que parâmetros de controlo ou URL posso utilizar?
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| finalUrl | cadeia | O URL final que identifica a página Web para a qual o utilizador é levado quando clica no anúncio. |
Devoluções
| Tipo | Descrição |
|---|---|
| KeywordBuilder | Construtor de palavras-chave com o URL final aplicado. |
withMobileFinalUrl(string mobileFinalUrl)
Define o URL final da palavra-chave para dispositivos móveis.
O URL final identifica a página Web para a qual o utilizador é levado quando clica no anúncio. Se não for especificado, a entidade herda o URL final da entidade principal. Por exemplo, a entidade de palavra-chave herda o URL final do anúncio. Especifique o URL final da palavra-chave se quiser substituir o URL final do anúncio.
Para obter mais informações, veja Que parâmetros de controlo ou URL posso utilizar?
Para especificar um URL final para dispositivos móveis, primeiro especifique um URL final para dispositivos não móveis (consulte withFinalUrl()).
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| mobileFinalUrl | cadeia | O URL final para dispositivos móveis. |
Devoluções
| Tipo | Descrição |
|---|---|
| KeywordBuilder | Construtor de palavras-chave com o URL final móvel aplicado. |
withText(texto de cadeia)
Define o texto da palavra-chave.
Para especificar o tipo de correspondência da palavra-chave, utilize a seguinte sintaxe:
- Para uma correspondência ampla, não utilize sintaxe do tipo de correspondência (por exemplo,
keywordBuilder.withText("books")). - Para um modificador de correspondência abrangente, prepare o texto com um sinal de adição (+) (por exemplo,
keywordBuilder.withText("+books")). Nota: se tentar criar novas palavras-chave do modificador de correspondência abrangente (BMM), estas serão guardadas e servidas como palavras-chave de correspondência de expressões. As palavras-chave do BMM existentes continuarão a servir sob o comportamento de correspondência de expressões. Saiba mais sobre os tipos de correspondência de palavras-chave. - Para a correspondência de expressões, coloque aspas à volta do texto (por exemplo,
keywordBuilder.withText("\"books\"")). - Para a correspondência exata, coloque parênteses retos à volta do texto (por exemplo,
keywordBuilder.withText("[hardcover books]")).
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| texto | cadeia | O texto da palavra-chave. O texto da palavra-chave é obrigatório. O texto pode conter um máximo de 100 carateres. Especifique o texto na região do valor de idioma do grupo de anúncios. |
Devoluções
| Tipo | Descrição |
|---|---|
| KeywordBuilder | Construtor de palavras-chave com o texto de palavra-chave aplicado. |
withTrackingTemplate(string trackingTemplate)
Define o modelo de controlo da palavra-chave.
Os modelos de controlo são utilizados com o FinalUrl da palavra-chave para criar o URL de destino utilizado pelo anúncio. Para obter mais informações, veja Que parâmetros de controlo ou URL posso utilizar?
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| trackingTemplate | cadeia | O modelo de controlo a utilizar com esta palavra-chave. |
Devoluções
| Tipo | Descrição |
|---|---|
| KeywordBuilder | Construtor de palavras-chave com o modelo de controlo aplicado. |