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 seus anúncios de texto expandidos para anúncios de pesquisa adaptáveis até 1 de fevereiro de 2023. Após esta data, deixará de poder criar anúncios de texto expandidos novos ou editá-los. Para obter mais informações, consulte Sobre anúncios de pesquisa adaptáveis.
- Os anúncios de texto expandidos existentes continuarão a ser veiculados e você poderá ver relatórios sobre seu desempenho.
- Ainda poderá colocar em pausa, ativar ou remover os seus anúncios de texto expandidos. Caso contrário, as tentativas de adicionar ou atualizar anúncios de texto expandidos resultarão em erro
CampaignServiceAdTypeInvalid .
-
Saiba mais sobre esta alteração.
Exemplo de utilização:
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`);
}
}
Metodologia
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
withDescription(descrição da cadeia)
Define a primeira descrição do anúncio. Este método foi preterido em favor de withDescription1(string description1).
Argumentos
| Name |
Tipo |
Descrição |
| Descrição |
cadeia |
A primeira descrição do anúncio. Para obter informações sobre limites de cópia e incluir cadeias de caracteres de texto dinâmicas, consulte API Bing Ads. |
Devoluções
withDescription1(descrição da cadeia1)
Define a primeira descrição do anúncio. Este método define o mesmo campo que withDescription(string description).
Argumentos
| Name |
Tipo |
Descrição |
| Descrição1 |
cadeia |
A primeira descrição do anúncio. Para obter informações sobre limites de cópia e incluir cadeias de caracteres de texto dinâmicas, consulte API Bing Ads. |
Devoluções
withDescription2(string description2)
Define a segunda descrição do anúncio.
Argumentos
| Name |
Tipo |
Descrição |
| Descrição2 |
cadeia |
A segunda descrição do anúncio. Para obter informações sobre limites de cópia e incluir cadeias de caracteres de texto dinâmicas, consulte API Bing Ads. |
Devoluções
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
withHeadlinePart1(string headlinePart1)
Define a primeira parte do título do anúncio.
Argumentos
| Name |
Tipo |
Descrição |
| títuloPart1 |
cadeia |
A primeira parte do título do anúncio. Quando a Microsoft gera o título do anúncio utilizando as partes 1, 2 e 3 do título, concatena as partes utilizando " - ". Não especifique o travessão em nenhuma parte do 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 incluir cadeias de caracteres de texto dinâmico no título, consulte API Bing Ads. |
Devoluções
withHeadlinePart2(string headlinePart2)
Define a segunda parte do título do anúncio.
Argumentos
| Name |
Tipo |
Descrição |
| títuloPart2 |
cadeia |
A segunda parte do título do anúncio. Quando a Microsoft gera o título do anúncio utilizando as partes 1, 2 e 3 do título, concatena as partes utilizando " - ". Não especifique o travessão em nenhuma parte do 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 incluir cadeias de caracteres de texto dinâmico no título, consulte API Bing Ads. |
Devoluções
withHeadlinePart3(string headlinePart3)
Define a terceira parte do título do anúncio.
Argumentos
| Name |
Tipo |
Descrição |
| títuloPart3 |
cadeia |
A terceira parte do título do anúncio. Quando a Microsoft gera o título do anúncio utilizando as partes 1, 2 e 3 do título, concatena as partes utilizando " - ". Não especifique o travessão em nenhuma parte do 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 incluir cadeias de caracteres de texto dinâmico no título, consulte API Bing Ads. |
Devoluções
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
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
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
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