Compartilhar via


ResponsiveSearchAdBuilder

Contém os métodos para definir e criar um anúncio de pesquisa reativo. Para obter informações sobre construtores, consulte Construtores.

Utilização de exemplo:

    var operation = adGroup.newAd().responsiveSearchAdBuilder()
        .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

Nome do Método Tipo de Devolução Descrição
addDescription(descrição da cadeia, afixação de cadeia) ResponsiveSearchAdBuilder Adiciona a descrição fornecida à lista atual de descrições. Tem de especificar pelo menos 2 descrições com este método ou o método addDescription().
addHeadline(cabeçalho de cadeia, afixação de cadeia) ResponsiveSearchAdBuilder Adiciona o título fornecido à lista atual de cabeçalhos. Tem de especificar, pelo menos, 3 cabeçalhos com este método ou o método addHeadline().
criar AdOperation Cria o anúncio e devolve um objeto de operação utilizado para verificar se os Scripts adicionaram o anúncio com êxito.
withCustomParameters(Object customParameters) ResponsiveSearchAdBuilder Define os parâmetros personalizados do anúncio.
withDescriptions(object[] descriptions) ResponsiveSearchAdBuilder Define as descrições do anúncio.
withFinalUrl(string finalUrl) ResponsiveSearchAdBuilder Define o URL da página de destino do anúncio.
withFinalUrlSuffix(string finalUrlSuffix) ResponsiveSearchAdBuilder Define o sufixo de URL final do anúncio.
withHeadlines(object[] headlines) ResponsiveSearchAdBuilder Define as manchetes do anúncio.
withMobileFinalUrl(string mobileFinalUrl) ResponsiveSearchAdBuilder Define o URL final do anúncio para dispositivos móveis.
withPath1(urlPath1 de cadeia) ResponsiveSearchAdBuilder Define o primeiro caminho opcional a acrescentar ao URL de apresentação do anúncio.
withPath2(urlPath2 de cadeia) ResponsiveSearchAdBuilder Define o segundo caminho opcional a acrescentar ao URL de apresentação do anúncio.
withTrackingTemplate(string trackingTemplate) ResponsiveSearchAdBuilder Define o modelo de controlo do anúncio.

addDescription(descrição da cadeia, afixação de cadeia)

Adiciona a descrição fornecida à lista atual de descrições. Tem de especificar pelo menos 2 descrições com este método ou o método addDescription().

Argumentos

Name Tipo Descrição
descrição cadeia A descrição do anúncio a adicionar. Para obter informações sobre limites e incluindo cadeias de texto dinâmicas, veja API de Anúncios do Bing.
afixação cadeia A localização opcional afixada.

Os valores possíveis para descrições são: DESCRIPTION_1, DESCRIPTION_2
texto cadeia O texto deste elemento.

Devoluções

Tipo Descrição
ResponsiveSearchAdBuilder Ad builder com a descrição aplicada.

addHeadline(cabeçalho de cadeia, afixação de cadeia)

Adiciona o título fornecido à lista atual de cabeçalhos. Tem de especificar, pelo menos, 3 cabeçalhos com este método ou o método addHeadline().

Argumentos

Name Tipo Descrição
cabeçalho cadeia O cabeçalho de anúncio a adicionar. Para obter informações sobre limites e incluindo cadeias de texto dinâmicas, veja API de Anúncios do Bing.
afixação cadeia A localização opcional afixada.

Os valores possíveis para títulos são: HEADLINE_1, HEADLINE_2, HEADLINE_3

Devoluções

Tipo Descrição
ResponsiveSearchAdBuilder Construtor de anúncios com o cabeçalho aplicado.

criar

Cria o anúncio e devolve um objeto de operação utilizado para verificar se os Scripts adicionaram o anúncio com êxito.

Para obter limites sobre o número de anúncios que pode adicionar a um grupo de anúncios, veja Limites da hierarquia de entidades.

Devoluções

Tipo Descrição
AdOperation Um objeto de operação utilizado para verificar se os Scripts adicionaram o anúncio com êxito.

withCustomParameters(Object customParameters)

Define os parâmetros personalizados do anúncio.

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 do anúncio. 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
ResponsiveSearchAdBuilder Ad builder com os parâmetros personalizados aplicados.

withDescriptions(object[] descriptions)

Define as descrições do anúncio.

Argumentos

Name Tipo Descrição
descrições AdTextAsset[] As descrições do anúncio. Para obter informações sobre limites e incluindo cadeias de texto dinâmicas, veja API de Anúncios do Bing.

Devoluções

Tipo Descrição
ResponsiveSearchAdBuilder Ad builder com as descrições aplicadas.

withFinalUrl(string finalUrl)

Define o URL da página de destino do anúncio.

Argumentos

Name Tipo Descrição
finalUrl cadeia O URL da página de destino do anúncio. Para obter informações sobre os limites de URL, veja API de Anúncios do Bing.

Devoluções

Tipo Descrição
ResponsiveSearchAdBuilder Ad builder com o URL final aplicado.

withFinalUrlSuffix(string finalUrlSuffix)

Define o sufixo de URL final do anúncio.

Argumentos

Name Tipo Descrição
finalUrl cadeia O sufixo de URL final do anúncio. Para obter informações sobre os limites de URL, veja API de Anúncios do Bing.

Devoluções

Tipo Descrição
ResponsiveSearchAdBuilder Ad builder com o URL final aplicado.

withHeadlines(object[] headlines

Define as manchetes do anúncio.

Argumentos

Name Tipo Descrição
cabeçalhos AdTextAsset[] As manchetes do anúncio. Para obter informações sobre limites e incluindo cadeias de texto dinâmicas, veja API de Anúncios do Bing.

Devoluções

Tipo Descrição
ResponsiveSearchAdBuilder Construtor de anúncios com as manchetes do anúncio aplicadas.

withMobileFinalUrl(string mobileFinalUrl)

Define o URL final do anúncio para dispositivos móveis.

O URL final identifica a página Web para a qual o utilizador é levado quando clica no anúncio. Para especificar um URL final para dispositivos móveis, primeiro especifique um URL final para dispositivos não móveis (consulte withFinalUrl()).

Para obter mais informações, veja Que parâmetros de controlo ou URL posso utilizar?

Argumentos

Name Tipo Descrição
mobileFinalUrl cadeia O URL final para dispositivos móveis.

Devoluções

Tipo Descrição
ResponsiveSearchAdBuilder Ad builder com o URL final móvel aplicado.

withPath1(urlPath1 de cadeia)

Define o primeiro caminho opcional a acrescentar ao URL de apresentação do anúncio.

Argumentos

Name Tipo Descrição
mobileFinalUrl cadeia O primeiro caminho opcional a acrescentar ao URL de apresentação do anúncio. A Microsoft utiliza o domínio especificado em withFinalUrl como o URL de apresentação. Se o domínio do URL final for contoso.com e o caminho for calçado, o URL de apresentação do anúncio será contoso.com/shoes. Para utilização e limites, veja Path1.

Devoluções

Tipo Descrição
ResponsiveSearchAdBuilder Ad builder com o caminho aplicado.

withPath2(urlPath2 de cadeia)

Define o segundo caminho opcional a acrescentar ao URL de apresentação do anúncio.

Argumentos

Name Tipo Descrição
mobileFinalUrl cadeia O segundo caminho opcional a acrescentar ao URL de apresentação do anúncio. Para especificar o segundo caminho, primeiro especifique o primeiro caminho (consulte withPath1). A Microsoft utiliza o domínio especificado em withFinalUrl como o URL de apresentação. Se o domínio do URL final for contoso.com, o primeiro caminho é sapatos e o segundo caminho são as senhoras, o URL de apresentação do anúncio é contoso.com/shoes/ladies. Para utilização e limites, veja Path2.

Devoluções

Tipo Descrição
ResponsiveSearchAdBuilder Ad builder com o caminho aplicado.

withTrackingTemplate(string trackingTemplate)

Define o modelo de controlo do anúncio.

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 este anúncio.

Devoluções

Tipo Descrição
ResponsiveSearchAdBuilder Ad builder com o modelo de controlo aplicado.