AdGroupBuilder

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

Métodos

criar

Cria o grupo de anúncios e devolve um objeto de operação utilizado para verificar se o grupo de anúncios foi adicionado com êxito.

Devoluções

withBiddingStrategy(licitação de cadeiaStrategy)

Define a estratégia de licitação do grupo de anúncios.

Argumentos

Devoluções

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

Devoluções

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

Devoluções

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

Devoluções

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

Devoluções

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

Devoluções

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

Devoluções

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

Devoluções

withName(nome da cadeia)

Define o nome do grupo de anúncios.

Argumentos

Devoluções

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

Devoluções

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

Devoluções

withStatus(estado da cadeia)

Define o estado do grupo de anúncios.

Argumentos

Devoluções

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

Devoluções

Consulte também

Campaign.newAdGroupBuilder()