Contém os métodos para definir e criar um anúncio de texto expandido. Para obter informações sobre construtores, consulte Construtores.
Nota
Atualize os anúncios de texto expandidos para anúncios de pesquisa reativos até 1 de fevereiro de 2023. Após esta data, deixará de poder criar anúncios de texto expandido novos ou editar existentes. Para obter mais informações, consulte Acerca dos anúncios de pesquisa reativos.
Os anúncios de texto expandido existentes continuarão a servir e poderá ver relatórios sobre o desempenho dos mesmos.
Continuará a poder colocar em pausa, ativar ou remover os anúncios de texto expandidos. Caso contrário, as tentativas de adicionar ou atualizar anúncios de texto expandido resultarão num CampaignServiceAdTypeInvalid erro.
var operation = adGroup.newAd().expandedTextAdBuilder()
.withHeadlinePart1('FIRST PART OF TITLE GOES HERE')
.withHeadlinePart2('SECOND PART OF TITLE GOES HERE')
.withDescription('AD TEXT GOES HERE')
.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`);
}
}
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.
A primeira parte do título do anúncio. Quando a Microsoft gera o título do anúncio com as partes 1, 2 e 3 do título, concatena as partes com " - ". Não especifique o travessão em partes de título. Cada parte do título tem de conter, pelo menos, uma palavra. Para obter informações sobre limites de título adicionais e incluindo cadeias de texto dinâmicas no título, veja API de Anúncios do Bing.
Construtor de anúncios com a parte 1 do título do anúncio aplicado.
withHeadlinePart2(cabeçalho de cadeiaPart2)
Define a segunda parte do título do anúncio.
Argumentos
Name
Tipo
Descrição
cabeçalhoPart2
cadeia
A segunda parte do título do anúncio. Quando a Microsoft gera o título do anúncio com as partes 1, 2 e 3 do título, concatena as partes com " - ". Não especifique o travessão em partes de título. Cada parte do título tem de conter, pelo menos, uma palavra. Para obter informações sobre limites de título adicionais e incluindo cadeias de texto dinâmicas no título, veja API de Anúncios do Bing.
Construtor de anúncios com a parte 1 do título do anúncio aplicado.
withHeadlinePart3(cabeçalho de cadeiaPart3)
Define a terceira parte do título do anúncio.
Argumentos
Name
Tipo
Descrição
cabeçalhoPart3
cadeia
A terceira parte do título do anúncio. Quando a Microsoft gera o título do anúncio com as partes 1, 2 e 3 do título, concatena as partes com " - ". Não especifique o travessão em partes de título. Cada parte do título tem de conter, pelo menos, uma palavra. Para obter informações sobre limites de título adicionais e incluindo cadeias de texto dinâmicas no título, veja API de Anúncios do Bing.
Construtor de anúncios com a parte 1 do título do anúncio aplicado.
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()).
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.
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.
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?