Contém os métodos utilizados para definir e adicionar um grupo de anúncios. Para obter informações sobre construtores, consulte Construtores.
Utilização de exemplo:
// Get a campaign to add the ad group to.
var iterator = AdsApp.campaigns()
.withIds(['CAMPAIGN ID GOES HERE'])
.get();
while (iterator.hasNext()) {
var campaign = iterator.next();
// Get the campaign's ad group builder and add an ad group.
var operation = campaign.newAdGroupBuilder()
.withName("AD GROUP NAME GOES HERE")
.withStatus("ENABLED")
.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`);
}
}
}
Construtor de grupo de anúncios com a estratégia de licitação aplicada.
withCpc(double cpc)
Define a oferta cpc do grupo de anúncios.
Especifica o valor da oferta a utilizar quando a palavra-chave corresponde ao termo de pesquisa do utilizador e a estratégia de licitação do grupo de anúncios é MANUAL_CPC. Esta oferta é utilizada se uma entidade de nível inferior, como a palavra-chave, não a substituir.
Argumentos
Name
Tipo
Descrição
cpc
duplo
A oferta máxima do CPC do grupo de anúncios. A moeda da conta determina os valores mínimos e máximos de licitação. Para obter mais informações, veja Moedas de licitação e orçamento.
Construtor de grupo de anúncios com a oferta CPC aplicada.
withCpm(double cpm)
Define a oferta do CPM do grupo de anúncios.
Especifica o valor da oferta a utilizar por 1000 impressões visualizadas e quando a estratégia de licitação do grupo de anúncios é MANUAL_CPM.
Argumentos
Name
Tipo
Descrição
cpm
duplo
A oferta máxima do CPM do grupo de anúncios. A moeda da conta determina os valores mínimos e máximos de licitação. Para obter mais informações, veja Moedas de licitação e orçamento.
Construtor de grupo de anúncios com a oferta CPM aplicada.
withCpv(double cpv)
Define a oferta CPV do grupo de anúncios.
Especifica o valor da oferta a utilizar por vista ou por clique num anúncio de vídeo e quando a estratégia de licitação do grupo de anúncios é MANUAL_CPV.
Argumentos
Name
Tipo
Descrição
cpv
duplo
A oferta de CPV máxima do grupo de anúncios. A moeda da conta determina os valores mínimos e máximos de licitação. Para obter mais informações, veja Moedas de licitação e orçamento.
Construtor de grupo de anúncios com a oferta CPV aplicada.
withCustomParameters(Object customParameters)
Define os parâmetros personalizados do grupo de anúncios para utilizar em URLs finais ou modelos de controlo.
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é três parâmetros personalizados a aplicar ao grupo de anúncios. 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.
Construtor de grupos de anúncios com os parâmetros personalizados aplicados.
withEndDate(string endDate)
Define a data em que os anúncios no grupo de anúncios deixam de servir. Chame este método apenas se quiser que os anúncios no grupo deixem de servir numa data específica.
Argumentos
Name
Tipo
Descrição
endDate
cadeia
A data para parar de servir anúncios. Especifique a data no formulário YYYYMMDD.
Construtor de grupos de anúncios com a data de fim aplicada.
withEndDate(Object endDate)
Define a data em que os anúncios no grupo de anúncios deixam de servir. Chame este método apenas se quiser que os anúncios no grupo deixem de servir numa data específica.
Argumentos
Name
Tipo
Descrição
endDate
Objeto
A data para parar de servir anúncios. Especifique a data com um objeto com os seguintes campos:
ano
mês
dia
Por exemplo: var date = {year: 2018, month: 5, day: 13};
O mês é baseado num, em que 1 é janeiro e 12 é dezembro.
Construtor de grupos de anúncios com a data de fim aplicada.
withLanguage(linguagem de cadeia)
Define o idioma utilizado pelos anúncios neste grupo de anúncios.
Por predefinição, o grupo de anúncios herda o idioma da campanha principal. Especifique um idioma ao nível do grupo de anúncios para substituir o idioma especificado ao nível da campanha ou se a campanha não especificar um idioma (o idioma tem de ser especificado ao nível da campanha e/ou do grupo de anúncios).
Argumentos
Name
Tipo
Descrição
idioma
cadeia
O idioma utilizado pelos anúncios no grupo de anúncios. Por exemplo, inglês. A cadeia não é sensível a maiúsculas e minúsculas. Não utilize um código de idioma de dois carateres. Para obter uma lista de idiomas suportados, consulte Idiomas de Anúncios.
Construtor de grupos de anúncios com a linguagem aplicada.
withName(nome da cadeia)
Define o nome do grupo de anúncios.
Argumentos
Name
Tipo
Descrição
nome
cadeia
O nome do grupo de anúncios. O nome é obrigatório. O nome pode conter um máximo de 256 carateres e tem de ser exclusivo entre todos os grupos de anúncios ativos na campanha.
Construtor de grupos de anúncios com o nome aplicado.
withStartDate(string startDate)
Define a data em que os anúncios no grupo de anúncios começam a servir. Chame este método apenas se quiser que os anúncios no grupo comecem a servir numa data específica; caso contrário, os anúncios começam a servir imediatamente.
Argumentos
Name
Tipo
Descrição
endDate
cadeia
A data para começar a servir anúncios. Especifique a data no formulário YYYYMMDD.
Construtor de grupos de anúncios com a data de início aplicada.
withStartDate(Object startDate)
Define a data em que os anúncios no grupo de anúncios começam a servir. Chame este método apenas se quiser que os anúncios no grupo comecem a servir numa data específica; caso contrário, os anúncios começam a servir imediatamente.
Argumentos
Name
Tipo
Descrição
endDate
Objeto
A data para começar a servir anúncios. Especifique a data com um objeto com os seguintes campos:
ano
mês
dia
Por exemplo: var date = {year: 2018, month: 5, day: 13};
O mês é baseado num, em que 1 é janeiro e 12 é dezembro.
Construtor de grupos de anúncios com o estado aplicado.
withTrackingTemplate(string trackingTemplate)
Define o modelo de controlo do grupo de anúncios.
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 o grupo de anúncios.