ResponsiveSearchAdBuilder

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

Exemplo de utilização:

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

Metodologia

Nome do método	Tipo de Devolução	Descrição
addDescription(descrição da cadeia, fixação da cadeia)	ResponsiveSearchAdBuilder	Adiciona a descrição fornecida à lista atual de descrições. Pelo menos 2 descrições devem ser especificadas usando este ou o método addDescription().
addHeadline(cabeçalho da cadeia, fixação da cadeia)	ResponsiveSearchAdBuilder	Adiciona o título fornecido à lista atual de títulos. Pelo menos 3 headlines devem ser especificados usando este ou o método addHeadline().
Compilação	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 os títulos do anúncio.
withMobileFinalUrl(string mobileFinalUrl)	ResponsiveSearchAdBuilder	Define o URL final do anúncio para dispositivos móveis.
withPath1(string urlPath1)	ResponsiveSearchAdBuilder	Define o primeiro caminho opcional a acrescentar ao URL de visualização do anúncio.
withPath2(string urlPath2)	ResponsiveSearchAdBuilder	Define o segundo caminho opcional a acrescentar ao URL de visualização do anúncio.
withTrackingTemplate(string trackingTemplate)	ResponsiveSearchAdBuilder	Define o modelo de acompanhamento do anúncio.

addDescription(descrição da cadeia, fixação da cadeia)

Adiciona a descrição fornecida à lista atual de descrições. Pelo menos 2 descrições devem ser especificadas usando este 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 incluir cadeias de caracteres de texto dinâmicas, consulte API Bing Ads.
afixar	cadeia	A localização afixada opcional. Os valores possíveis para descrições são: DESCRIPTION_1, DESCRIPTION_2
texto	cadeia	O texto deste ativo.

Devoluções

Tipo	Descrição
ResponsiveSearchAdBuilder	Construtor de anúncios com a descrição aplicada.

addHeadline(cabeçalho da cadeia, fixação da cadeia)

Adiciona o título fornecido à lista atual de títulos. Pelo menos 3 headlines devem ser especificados usando este ou o método addHeadline().

Argumentos

Name	Tipo	Descrição
manchete	cadeia	O título do anúncio a adicionar. Para obter informações sobre limites e incluir cadeias de caracteres de texto dinâmicas, consulte API Bing Ads.
afixar	cadeia	A localização afixada opcional. 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 título aplicado.

Compilação

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 você pode adicionar a um grupo de anúncios, consulte Limites hierárquicos de entidades.

Devoluções

Tipo	Descrição
AdOperation	Um objeto de operação usado 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 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 a aplicar ao URL final do anúncio. 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
ResponsiveSearchAdBuilder	Construtor de anúncios 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 incluir cadeias de caracteres de texto dinâmicas, consulte API Bing Ads.

Devoluções

Tipo	Descrição
ResponsiveSearchAdBuilder	Construtor de anúncios 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	URL da página de destino do anúncio. Para obter informações sobre limites de URL, consulte API do Bing Ads.

Devoluções

Tipo	Descrição
ResponsiveSearchAdBuilder	Construtor de anúncios 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 final do URL do anúncio. Para obter informações sobre limites de URL, consulte API do Bing Ads.

Devoluções

Tipo	Descrição
ResponsiveSearchAdBuilder	Construtor de anúncios com o URL final aplicado.

withHeadlines(object[] headlines

Define os títulos do anúncio.

Argumentos

Name	Tipo	Descrição
títulos	AdTextAsset[]	As manchetes do anúncio. Para obter informações sobre limites e incluir cadeias de caracteres de texto dinâmicas, consulte API Bing Ads.

Devoluções

Tipo	Descrição
ResponsiveSearchAdBuilder	Criador de anúncios com os títulos do anúncio aplicados.

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 é direcionado 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, consulte Que parâmetros de rastreamento ou URL posso usar?

Argumentos

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

Devoluções

Tipo	Descrição
ResponsiveSearchAdBuilder	Construtor de anúncios com o URL final móvel aplicado.

withPath1(string urlPath1)

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

Argumentos

Name	Tipo	Descrição
mobileFinalUrl	cadeia	O primeiro caminho opcional a acrescentar ao URL de visualização do anúncio. A Microsoft utiliza o domínio especificado como withFinalUrl URL de apresentação. Se o domínio do URL final for contoso.com e o caminho for calçado, o URL de visualização do anúncio é contoso.com/shoes. Para informações sobre utilização e limites, consulte Caminho1.

Devoluções

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

withPath2(string urlPath2)

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

Argumentos

Name	Tipo	Descrição
mobileFinalUrl	cadeia	O segundo caminho opcional a acrescentar ao URL de visualização do anúncio. Para especificar o segundo caminho, primeiro especifique o primeiro caminho (consulte withPath1). A Microsoft utiliza o domínio especificado como withFinalUrl URL de apresentação. Se o domínio do URL final for contoso.com, o primeiro caminho for sapatos e o segundo caminho for senhoras, o URL de exibição do anúncio será contoso.com/shoes/ladies. Para obter informações sobre utilização e limites, consulte Caminho2.

Devoluções

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

withTrackingTemplate(string trackingTemplate)

Define o modelo de acompanhamento do anúncio.

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

Devoluções

Tipo	Descrição
ResponsiveSearchAdBuilder	Construtor de anúncios com o modelo de acompanhamento aplicado.