Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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. |