Construtor de Palavras-chave

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 ampla para anúncios da Rede de Pesquisa agora servem como palavras-chave de correspondência ampla em vez de correspondência de frases. Saiba mais sobre tipos de correspondência de palavras-chave.

Exemplo de utilização:

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

Metodologia

Nome do método Tipo de Devolução Descrição
Compilação OperaçãoPalavra-chave Cria a palavra-chave e retorna um objeto de operação usado para verificar se a palavra-chave foi adicionada com êxito.
withCpc(double cpc) Construtor de Palavras-chave Define o lance máximo de CPC da palavra-chave.
withCustomParameters(Object customParameters) Construtor de Palavras-chave Define os parâmetros personalizados da palavra-chave.
withFinalUrl(string finalUrl) Construtor de Palavras-chave Define o URL final da palavra-chave.
withMobileFinalUrl(string mobileFinalUrl) Construtor de Palavras-chave Define o URL final da palavra-chave para dispositivos móveis.
withText(cadeia de texto) Construtor de Palavras-chave Define o texto da palavra-chave.
withTrackingTemplate(string trackingTemplate) Construtor de Palavras-chave Define o modelo de controlo da palavra-chave.

Compilação

Cria a palavra-chave e retorna um objeto de operação usado para verificar se a palavra-chave foi adicionada com êxito.

Devoluções

Tipo Descrição
OperaçãoPalavra-chave Um objeto de operação usado para verificar se a palavra-chave foi adicionada com êxito.

withCpc(double cpc)

Define o lance máximo de CPC da palavra-chave.

Especifica o valor do lance a ser usado quando a palavra-chave corresponde ao termo de pesquisa do usuário. Aplica-se somente se a estratégia de lances do grupo de anúncios estiver definida como MANUAL_CPC.

Para usar o valor do lance especificado no nível do grupo de anúncios, não chame esse método.

Para obter mais informações sobre valores de lance, consulte Bid and BiddingScheme.

Argumentos

Name Tipo Descrição
CPC duplo O lance máximo do CPC a ser aplicado à palavra-chave. A moeda da conta determina os valores mínimos e máximos de lances. Para obter mais informações, consulte Moedas de lance e orçamento.

Devoluções

Tipo Descrição
Construtor de Palavras-chave Construtor de palavras-chave com o lance CPC aplicado.

withCustomParameters(Object customParameters)

Define os parâmetros personalizados da palavra-chave.

Os parâmetros personalizados são úteis na partilha de informações dinâmicas em vários URLs. Para obter mais informações sobre seu uso, consulte Parâmetros personalizados.

Argumentos

Name Tipo Descrição
customParameters Objecto Um mapa de parâmetros até personalizados para aplicar ao URL final da palavra-chave. Por exemplo, {key1: 'value1', key2: 'value2', key3: 'value3'}, onde chave é o nome do parâmetro personalizado e valor é 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
Construtor de Palavras-chave 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 é direcionado quando clica no anúncio. Se não for especificado, a entidade herda o URL final de sua entidade pai. Por exemplo, a entidade da 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, consulte Que parâmetros de rastreamento ou URL posso usar?

Argumentos

Name Tipo Descrição
finalUrl cadeia URL final que identifica a página Web para a qual o utilizador clica no anúncio.

Devoluções

Tipo Descrição
Construtor de Palavras-chave 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 é direcionado quando clica no anúncio. Se não for especificado, a entidade herda o URL final de sua entidade pai. Por exemplo, a entidade da 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, consulte Que parâmetros de rastreamento ou URL posso usar?

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
Construtor de Palavras-chave Construtor de palavras-chave com o URL final móvel aplicado.

withText(cadeia de texto)

Define o texto da palavra-chave.

Para especificar o tipo de correspondência da palavra-chave, utilize a sintaxe seguinte:

  • Para correspondência ampla, utilize a sintaxe sem tipo de correspondência (por exemplo, keywordBuilder.withText("books")).
  • No modificador de correspondência ampla, insira um sinal de adição (+) no texto (por exemplo, keywordBuilder.withText("+books")). Nota: Se você tentar criar novas palavras-chave modificadoras de correspondência ampla (BMM), elas serão salvas e servidas como palavras-chave de correspondência de frase. Suas palavras-chave BMM existentes continuarão a servir no comportamento de correspondência de frases. Saiba mais sobre tipos de correspondência de palavras-chave.
  • Para correspondência de frase, coloque aspas à volta do texto (por exemplo, keywordBuilder.withText("\"books\"")).
  • Para uma correspondência exata, coloque parênteses retos em torno 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 localidade do valor de idioma do grupo de anúncios.

Devoluções

Tipo Descrição
Construtor de Palavras-chave Construtor de palavras-chave com o texto da palavra-chave aplicado.

withTrackingTemplate(string trackingTemplate)

Define o modelo de controlo da palavra-chave.

Os modelos de acompanhamento são usados com o FinalUrl da palavra-chave para criar a URL de destino usada pelo anúncio. Para obter mais informações, consulte Que parâmetros de rastreamento ou URL posso usar?

Argumentos

Name Tipo Descrição
trackingTemplate cadeia O modelo de controlo a utilizar com esta palavra-chave.

Devoluções

Tipo Descrição
Construtor de Palavras-chave Construtor de palavras-chave com o modelo de controlo aplicado.
  • Last updated on