Registo do Grupo de Anúncios - Em Massa

Define um grupo de anúncios que pode ser carregado e transferido num ficheiro em massa.

Pode transferir todos os registos do Grupo de Anúncios na conta ao incluir o valor DownloadEntity de AdGroups no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para incluir os campos Relevância da Palavra-chave, Relevância da Página de Destino, Experiência do Utilizador da Página de Destino e Classificação de Qualidade nos registos de Campanha transferidos, também tem de incluir o âmbito QualityScoreData . Para obter mais detalhes sobre o Serviço em massa, incluindo as melhores práticas, veja Transferência e Carregamento em Massa.

O seguinte exemplo de CSV em Massa adicionaria um novo grupo de anúncios se fosse fornecido o ID de campanha correto.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Network Distribution,Ad Rotation,Cpc Bid,Language,Bid Adjustment,Name,Tracking Template,Final Url Suffix,Custom Parameter,Bid Strategy Type,Target Setting
Format Version,,,,,,,,,,,,,,,6.0,,,,,
Ad Group,Active,,-111,ParentCampaignNameGoesHere,Women's Red Shoe Sale,ClientIdGoesHere,,11/12/2020,12/31/2021,OwnedAndOperatedAndSyndicatedSearch,RotateAdsEvenly,0.1,English,10,,https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl},,{_promoCode}=PROMO1; {_season}=summer,ManualCpc,Audience

Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo com o BulkServiceManager para carregar e transferir o objeto BulkAdGroup , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroup
var bulkAdGroup = new BulkAdGroup
{
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Parent Id' column header in the Bulk file
    CampaignId = campaignIdKey,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                  
    // Map properties in the Bulk file to the 
    // AdGroup object of the Campaign Management service.
    AdGroup = new AdGroup
    {
        // 'Ad Rotation' column header in the Bulk file
        AdRotation = new AdRotation
        {
            Type = AdRotationType.RotateAdsEvenly
        },
        // 'Ad Schedule Use Searcher Time Zone' column header in the Bulk file
        AdScheduleUseSearcherTimeZone = true,
        // 'Bid Adjustment' column header in the Bulk file
        AudienceAdsBidAdjustment = 10,
        // 'Bid Strategy Type' column header in the Bulk file
        BiddingScheme = new ManualCpcBiddingScheme { },
        // 'Cpc Bid' column header in the Bulk file
        CpcBid = new Bid
        {
            Amount = 0.10
        },
        // 'End Date' column header in the Bulk file
        EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
        {
            Month = 12,
            Day = 31,
            Year = DateTime.UtcNow.Year + 1
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Language' column header in the Bulk file
        Language = "English",
        // 'Ad Group' column header in the Bulk file
        Name = "Women's Red Shoe Sale",
        // 'Network Distribution' column header in the Bulk file
        Network = Network.OwnedAndOperatedAndSyndicatedSearch,
        // 'Privacy Status' column header in the Bulk file
        PrivacyStatus = null,
        // 'Target Setting' column header in the Bulk file
        Settings = new []
        {
            new TargetSetting
            {
                // Each target setting detail is delimited by a semicolon (;) in the Bulk file
                Details = new []
                {
                    new TargetSettingDetail
                    {
                        CriterionTypeGroup = CriterionTypeGroup.Audience,
                        TargetAndBid = true
                    }
                }
            }
        },
        // 'Start Date' column header in the Bulk file
        StartDate = new Microsoft.BingAds.V13.CampaignManagement.Date
        {
            Month = DateTime.UtcNow.Month,
            Day = DateTime.UtcNow.Day,
            Year = DateTime.UtcNow.Year
        },
        // 'Status' column header in the Bulk file
        Status = AdGroupStatus.Paused,
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
};

uploadEntities.Add(bulkAdGroup);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Para um registo do Grupo de Anúncios , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

• Grupo de Anúncios
• Tipo de Grupo de Anúncios
• Rotação de Anúncios
• Ad Schedule Use Searcher Time Zone
• Ajuste da Oferta
• Valor de Aumento da Oferta
• Opção de Licitação
• Tipo de Estratégia de Oferta
• Campanha
• ID de Cliente
• Oferta do Cpc
• Parâmetro Personalizado
• Data de Fim
• Sufixo de URL Final
• Definições de Limite de Frequência
• ID
• Tipo de Estratégia de Oferta Herdada
• Relevância da Palavra-chave
• Relevância da Página de Destino
• Experiência de Utilizador da Página de Destino
• Idioma
• Oferta Máxima
• Hora da Modificação
• Distribuição de Rede
• ID principal
• Estado de Privacidade
• Pontuação de Qualidade
• Data de Início
• Estado
• Definição de Destino
• Modelo de Controlo
• Utilizar Segmentação Otimizada
• Utilizar a Segmentação Preditiva

Grupo de Anúncios

O nome do grupo de anúncios.

O nome tem de ser exclusivo entre todos os grupos de anúncios ativos na campanha. O nome pode conter um máximo de 256 carateres.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Tipo de Grupo de Anúncios

O tipo de grupo de anúncios.

Numa campanha mista em que o Tipo de Campanha é "Pesquisa", o ID da Experimentação não está definido e a campanha já tem definições de anúncios de pesquisa dinâmica válidas (compostas pelos campos Idioma do Domínio, Descrição Dinâmica Ativada, IDs de Feed de Páginas, Origem e Site ), os valores possíveis são "SearchDynamic" e "SearchStandard". Caso contrário, o tipo de grupos de anúncios nas campanhas de "Pesquisa" só pode ser definido como "SearchStandard". Se o tipo de grupo de anúncios for "SearchDynamic", só pode adicionar anúncios de pesquisa dinâmicos neste grupo de anúncios. Se o tipo de grupo de anúncios for "SearchStandard", pode adicionar anúncios de texto expandidos ou anúncios de pesquisa reativos neste grupo de anúncios.

O tipo de grupos de anúncios nas campanhas "DynamicSearchAds" só pode ser definido como "SearchDynamic". Não precisa de definir o tipo de grupo de anúncios para campanhas "DynamicSearchAds", mas tenha em atenção que quando obter grupos de anúncios, este campo será definido como "SearchDynamic".

Este campo pode ser definido como HotelAds para tipos de campanha "Hotel" ou "Pesquisa".

Não é possível definir este campo para os tipos de campanha "Audiência" ou "Compras". Quando obtém um grupo de anúncios em campanhas não suportadas, este campo estará vazio.

Adicionar: Opcional. O valor predefinido para campanhas de Pesquisa é "SearchStandard". O valor predefinido para campanhas "DynamicSearchAds" é "SearchDynamic".
Atualização: Só de leitura. Não é possível atualizar o tipo de grupo de anúncios.
Eliminar: Só de leitura

Rotação de Anúncios

A rotação de anúncios define a frequência com que o Microsoft Advertising seleciona os anúncios a servir, se tiver vários anúncios num grupo de anúncios. Uma vez que não é possível mostrar mais do que um anúncio da sua conta de cada vez, a rotação de anúncios prioriza anúncios que parecem estatisticamente mais propensos a ter um melhor desempenho.

Nota

A rotação de anúncios não se aplica aos Anúncios de Produtos.

Os valores possíveis são OptimizeForClicks e RotateAdsEvenly.

Se definido como OptimizeForClicks, o Microsoft Advertising prioriza o anúncio do grupo de anúncios que parece ter a melhor hipótese de ter um bom desempenho, com base em características ou fatores de leilão, como palavra-chave, termo de pesquisa, dispositivo ou localização. Os anúncios com melhor desempenho serão apresentados com mais frequência e os outros serão servidos com menos frequência, se for o caso.

Se estiver definido como RotateAdsEvenly, o Microsoft Advertising fornece mais equilíbrio na rotação entre os seus anúncios. Ou seja, os anúncios num grupo de anúncios específico têm uma hipótese semelhante de serem apresentados em resposta à consulta de um searcher. Os anúncios são priorizados mais baixos se tiverem uma qualidade de anúncios mais baixa e, portanto, podem ser apresentados com menos frequência ou não.

• A definição RotateAdsEvenly pode permitir que os anúncios de baixo desempenho apresentem tantas vezes como anúncios com melhor desempenho. Isto pode afetar o desempenho do grupo de anúncios.
• A definição RotateAdsEvenly será ignorada se a campanha do grupo de anúncios utilizar uma estratégia de licitação automatizada, ou seja, MaxClicks, MaxConversions, TargetCpa ou TargetRoas, uma vez que estas estratégias de oferta priorizam anúncios com melhor desempenho.

Adicionar: Opcional. O valor predefinido é OptimizeForClicks.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Ad Schedule Use Searcher Time Zone

Determina se deve utilizar o fuso horário da conta ou o fuso horário do utilizador de pesquisa onde os anúncios podem ser entregues.

Defina esta propriedade como VERDADEIRO se quiser que os anúncios sejam apresentados no fuso horário do utilizador de pesquisa e, caso contrário, defina-o como FALSO.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de VERDADEIRO será definido e será utilizado o fuso horário do utilizador de pesquisa. Após 30 de setembro de 2020, se não especificar este campo ou o deixar vazio, o valor predefinido de FALSO é definido e é utilizado o fuso horário da conta.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Ajuste da Oferta

O valor percentual pelo qual ajustar a sua oferta para anúncios de audiência acima ou abaixo do grupo de anúncios base ou oferta de palavras-chave.

Nota

Esta propriedade não está disponível com campanhas de compras inteligentes.

Os valores suportados são negativos de cem (-100) até 900 positivos. Definir o ajuste da oferta para -100 por cento impedirá que os anúncios de audiência sejam apresentados para este grupo de anúncios.

Defina este campo como zero (0) se não quiser qualquer ajuste de licitação para anúncios de audiência. Se este campo estiver vazio, herdará a definição Ajuste da Oferta da Campanha do grupo de anúncios.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se o grupo de anúncios já tiver um ajuste de licitação de anúncios de audiência e pretender removê-lo para herdar efetivamente a definição de Ajuste da Oferta da Campanha do grupo de anúncios, defina este campo como delete_value. A palavra-chave delete_value remove a definição anterior.
Eliminar: Só de leitura

Valor de Aumento da Oferta

A percentagem de aumento de oferta predefinida que verá na aplicação Web Microsoft Advertising para novos grupos de produtos.

Esta definição de destino ao nível do grupo de anúncios não é utilizada diretamente no leilão. O Ajuste da Oferta do grupo de produtos é utilizado para impulsionar a Oferta do seu parceiro.

Nota

Esta definição só é aplicável a grupos de anúncios em Campanhas comerciais para Marcas.

Adicionar: Necessário se a Opção de Licitação estiver definida como BidBoost e, caso contrário, não poderá definir este campo.
Atualização: Opcional se a Opção de Licitação estiver definida como BidBoost e, caso contrário, poderá não definir este campo.
Eliminar: Só de leitura

Opção de Licitação

Determina se pretende ampliar ou não a oferta do seu parceiro.

Nota

Esta definição só é aplicável a grupos de anúncios em Campanhas comerciais para Marcas.

Os valores suportados são BidBoost e BidValue. Um grupo de anúncios de valor de licitação permite-lhe licitar produtos que o seu parceiro de merchandising não visa. Um aumento de oferta permite-lhe ampliar a oferta do seu parceiro através do campo Definação de Licitação do grupo de produtos (veja também o grupo de anúncios Bid Boost Value) e os campos Oferta Máxima do grupo de anúncios. Só deve utilizar o BidBoost se o seu parceiro utilizar o BidValue.

Tome nota do seguinte impacto que esta definição tem nos registos de Partição de Produtos do Grupo de Anúncios bidíveis, ou seja, em que o campo É Excluído é FALSO e o Subtipo é Unidade.

• Se este elemento estiver definido como BidValue, o leilão utilizará o campo Licitação da Partição de Produto do Grupo de Anúncios.
• Se este elemento estiver definido como BidBoost, o leilão utilizará o campo Ajuste da Oferta da Partição de Produto do Grupo de Anúncios.

Adicionar: Opcional. Se este campo não estiver definido, a opção de licitação Campanhas de Compras para Marcas predefinida para o grupo de anúncios é BidValue.
Atualização: Só de leitura. Se tentar alterar a opção de licitação anterior, será devolvido um erro.
Eliminar: Só de leitura

Tipo de Estratégia de Oferta

O tipo de estratégia de oferta para a forma como pretende gerir as suas ofertas.

O tipo de estratégia de oferta para grupos de anúncios e palavras-chave é "InheritFromParent".

Nota

A partir de abril de 2021, não pode definir estratégias de licitação para grupos de anúncios ou palavras-chave. Se tentar definir estratégias de licitação para grupos de anúncios ou palavras-chave, o pedido será ignorado sem erros. Grupos de anúncios e palavras-chave herdarão a estratégia de licitação da sua campanha.

Para obter detalhes sobre estratégias de licitação suportadas por tipo de campanha, veja Estratégias de Orçamento e Licitação.

Adicionar: Opcional. Se não definir este campo, a função InheritFromParent é utilizada por predefinição.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Campanha

O nome da campanha que contém o grupo de anúncios.

Adicionar: Só de leitura e Obrigatório
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Campanha .

ID de Cliente

Utilizado para associar registos no ficheiro de carregamento em massa a registos no ficheiro de resultados. O valor deste campo não é utilizado ou armazenado pelo servidor; é simplesmente copiado do registo carregado para o registo de resultados correspondente. Pode ser qualquer cadeia válida até 100 de comprimento.

Adicionar: Opcional
Atualização: Opcional
Eliminar: Só de leitura

Oferta do Cpc

A oferta predefinida a utilizar quando a consulta do utilizador e as palavras-chave do grupo de anúncios correspondem através de uma comparação ampla, exata ou de correspondência de expressões.

O intervalo de licitação mínimo e máximo depende da moeda da conta. Para obter mais informações, veja Moedas.

Especificar uma oferta ampla, exata ou de correspondência de expressão ao nível da palavra-chave substitui o valor da oferta de pesquisa do grupo de anúncios para o tipo de correspondência correspondente.

Adicionar: Opcional. Se não definir uma oferta, esta será definida para o mínimo consoante a moeda da sua conta.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Parâmetro Personalizado

A sua coleção personalizada de parâmetros de chave e valor para controlo de URLs.

Num ficheiro em massa, a lista de parâmetros personalizados é formatada da seguinte forma.

• Formate cada par de parâmetros personalizado como Key=Value, por exemplo {_promoCode}=PROMO1.

• O Microsoft Advertising aceitará os primeiros oito pares de chave e valor personalizados que incluir e, se incluir mais de 8 parâmetros personalizados, será devolvido um erro. Cada par chave e valor é delimitado por um ponto e vírgula e espaço ("; "), por exemplo {_promoCode}=PROMO1; {_season}=verão.

• Uma Chave não pode conter um ponto e vírgula. Se um Valor contiver um ponto e vírgula, tem de ser escapado como '\;'. Além disso, se o Valor contiver uma barra invertida, também terá de ser escapado como "\".

• A Chave não pode exceder os 16 bytes UTF-8 e o Valor não pode exceder os 250 bytes UTF-8. A Chave é necessária e o Valor é opcional. O tamanho máximo da Chave não inclui as chavetas e o caráter de sublinhado, ou seja, "{", "_" e "}".

  Nota

  Com o serviço em massa, a Chave tem de ser formatada com chavetas adjacentes e um caráter de sublinhado à esquerda, por exemplo, se a Chave for promoCode, tem de ser formatada como {_promoCode}. Com o serviço Gestão de Campanhas, não pode especificar as chavetas adjacentes e o caráter de sublinhado.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para remover todos os parâmetros personalizados, defina este campo como delete_value. A palavra-chave delete_value remove a definição anterior. Para remover um subconjunto de parâmetros personalizados, especifique os parâmetros personalizados que pretende manter e omita os que não pretende manter. O novo conjunto de parâmetros personalizados substituirá qualquer conjunto de parâmetros personalizados anterior.
Eliminar: Só de leitura

Data de Fim

A data em que os anúncios no grupo de anúncios irão expirar.

Se não especificar uma data de fim, os anúncios não expirarão. A data de fim pode ser prolongada para tornar os anúncios de um grupo de anúncios elegíveis para entrega, mesmo depois de o grupo de anúncios expirar.

A data de fim é inclusiva. Por exemplo, se definir Data de Fim para 31/12/2020, os anúncios no grupo de anúncios expirarão às 23:59 a 31/12/2020. A hora baseia-se no fuso horário que especificar ao nível da campanha.

Adicionar: Opcional. Para não definir uma data de fim ao adicionar um grupo de anúncios, não defina este campo.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para eliminar a data de fim atual e definir efetivamente nenhuma data de fim, defina este campo como a cadeia "delete_value". Quando recuperar o grupo de anúncios da próxima vez, este campo não será definido.
Eliminar: Só de leitura

Sufixo de URL Final

O sufixo de URL final pode incluir parâmetros de controlo que serão anexados ao final do URL da página de destino. Recomendamos que coloque os parâmetros de controlo de que a página de destino necessita num sufixo de URL final para que os seus clientes sejam sempre enviados para a sua página de destino. Para obter mais detalhes e regras de validação, veja Sufixo de URL Final nos guias técnicos.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura

Definições de Limite de Frequência

A matriz de definições de limite de frequência. Contém CapValue, TimeGranularity. Só é permitido um elemento (sem limitação de frequência múltipla).

Exemplo de Código

[{""CapValue"": 10, ""TimeGranularity"": ""DAY""}]

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema do grupo de anúncios.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificadores negativos para o grupo de anúncios pode, em seguida, ser referenciado no campo ID Principal de tipos de registo dependentes, como anúncios, palavras-chave ou critério. Isto é recomendado se estiver a adicionar novos grupos de anúncios e novos registos dependentes no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Tipo de Estratégia de Oferta Herdada

O tipo de estratégia de oferta que é herdado da campanha principal.

Este valor é igual ao campo Tipo de Estratégia de Oferta da campanha principal. Os valores possíveis são EnhancedCpc, ManualCpc, MaxClicks, MaxConversions, TargetCpa e TargetRoas.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Relevância da Palavra-chave

Uma classificação numérica que indica a probabilidade de os seus anúncios serem clicados e quão bem a sua palavra-chave compete com outras palavras-chave direcionadas para o mesmo tráfego. Esta classificação prevê se é provável que a palavra-chave conduza a um clique nos seus anúncios, tendo em conta o desempenho da palavra-chave no passado relativamente à posição do seu anúncio.

Nota

A Palavra-chave Relevância é equivalente à etiqueta Taxa de Click-Through Esperada utilizada na aplicação Web Microsoft Advertising.

Uma classificação de 3 é Acima da Média; uma classificação de 2 é Média; e uma classificação de 1 é considerada Abaixo da Média.

Se especificar um período de tempo que abrange vários dias, a classificação será a mesma para cada dia no período de tempo e o valor é a classificação calculada mais recente.

Normalmente, os dados desta coluna são atualizados 14 a 18 horas após o fim do dia UTC.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Relevância da Página de Destino

Uma classificação numérica que indica a relevância do anúncio e da página de destino para a consulta de pesquisa do cliente ou outras entradas.

Nota

A Relevância da Página de Destino é equivalente à etiqueta Relevância do Anúncio utilizada na aplicação Web Microsoft Advertising.

Uma classificação de 3 é Acima da Média; uma classificação de 2 é Média; e uma classificação de 1 é considerada Abaixo da Média.

Se especificar um período de tempo que abrange vários dias, a classificação será a mesma para cada dia no período de tempo e o valor é a classificação calculada mais recente.

Normalmente, os dados desta coluna são atualizados 14 a 18 horas após o fim do dia UTC.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Experiência de Utilizador da Página de Destino

Uma classificação numérica que indica se é provável que a sua página de destino proporcione uma boa experiência aos clientes que clicam no seu anúncio e acedem ao seu site.

Nota

A Experiência de Utilizador da Página de Destino é equivalente à etiqueta Experiência de Página de Destino utilizada na aplicação Web Microsoft Advertising.

Uma classificação de 3 é Acima da Média; uma classificação de 2 é Média; e uma classificação de 1 é considerada Abaixo da Média.

Se especificar um período de tempo que abrange vários dias, a classificação será a mesma para cada dia no período de tempo e o valor é a classificação calculada mais recente.

Normalmente, os dados desta coluna são atualizados 14 a 18 horas após o fim do dia UTC.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Idioma

A definição de idioma de anúncios determina o idioma que irá utilizar quando escrever os seus anúncios e deve ser o idioma dos seus clientes.

Importante

Se os idiomas estiverem definidos ao nível do grupo de anúncios e da campanha, o idioma ao nível do grupo de anúncios substituirá o idioma ao nível da campanha.

As cadeias linguísticas suportadas para campanhas de Pesquisa e Compras são: búlgaro, croata, checo, dinamarquês, neerlandês, inglês, estónio, finlandês, francês, alemão, grego, húngaro, italiano, letão, lituano, maltês, norueguês, polaco, português, romeno, esloveno, esloveno, espanhol, sueco e tradicionalchinês.

Nota

Os seguintes idiomas ainda não estão disponíveis para todos: búlgaro, croata, checo, estónio, grego, húngaro, letão, lituano, maltês, polaco, romeno, esloveno.

Para campanhas de Anúncios de Pesquisa Dinâmica, as definições de idioma ao nível da campanha e do grupo de anúncios são ignoradas a favor do idioma do domínio do site. Deve definir os idiomas de campanha como "Todos" e deixar o idioma ao nível do grupo de anúncios vazio.

Para grupos de anúncios em Campanhas de audiência, o idioma ao nível do grupo de anúncios não é suportado e tem de definir o campo Idioma da campanha do grupo de anúncios como "Todos".

Adicionar: Opcional se a campanha tiver um ou mais idiomas definidos e, caso contrário, o idioma for necessário para a maioria dos tipos de campanha. Não tem permissão para definir este elemento para grupos de anúncios em Campanhas de audiência.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para remover o idioma e diferir para os idiomas ao nível da campanha, defina este campo como delete_value. A palavra-chave delete_value remove a definição anterior.
Eliminar: Só de leitura

Oferta Máxima

A quantidade plana da sua oferta para Campanhas de Compras para Marcas.

Nota

Esta definição só é aplicável a grupos de anúncios em Campanhas comerciais para Marcas.

Adicionar: Necessário se a Opção de Licitação estiver definida como BidBoost e, caso contrário, não poderá definir este campo.
Atualização: Opcional se a Opção de Licitação estiver definida como BidBoost e, caso contrário, poderá não definir este campo.
Eliminar: Só de leitura

Hora da Modificação

A data e hora em que a entidade foi atualizada pela última vez. O valor está em Hora Universal Coordenada (UTC).

Nota

O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Distribuição de Rede

As redes de pesquisa onde pretende que os seus anúncios sejam apresentados.

Os valores de rede suportados para grupos de anúncios na maioria dos tipos de campanha são OwnedAndOperatedAndSyndicatedSearch, OwnedAndOperatedOnly e SyndicatedSearchOnly. A predefinição é OwnedAndOperatedAndSyndicatedSearch. Para obter mais informações sobre redes e distribuição de anúncios, veja o artigo de ajuda Acerca da Distribuição de Anúncios .

Para grupos de anúncios em campanhas de Audiência, a rede ao nível do grupo de anúncios não é suportada e este campo estará vazio. Os grupos de anúncios estão na Rede de Audiências da Microsoft.

Para grupos de anúncios em campanhas de compras inteligentes, não pode definir a rede. O serviço irá definir a rede como OwnedAndOperatedAndSyndicatedSearch.

Para grupos de anúncios em campanhas de compras para marcas, a rede InHousePromotion (apenas Rede de Revendedor) é suportada para além de OwnedAndOperatedAndSyndicatedSearch, OwnedAndOperatedOnly e SyndicatedSearchOnly.

Se selecionar uma das opções de pesquisa sindicadas, pode chamar a operação SetNegativeSitesToAdGroups ou SetNegativeSitesToCampaigns para impedir que os anúncios sejam apresentados em sites de pesquisa sindicados específicos.

Adicionar: Opcional. A predefinição é OwnedAndOperatedAndSyndicatedSearch.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

ID principal

O identificador gerado pelo sistema da campanha que contém o grupo de anúncios.

Este campo em massa mapeia para o campo ID do registo campanha .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de campanha existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Campanha principal. Isto é recomendado se estiver a adicionar novos grupos de anúncios a uma nova campanha no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Campanha .

Estado de Privacidade

Indica se os critérios de destino do grupo de anúncios são ou não demasiado estreitos para grupos de anúncios em campanhas de Audiência.

Estado	Descrição
Ativo	O grupo de anúncios é elegível para servir.
Pendente	A avaliação de privacidade ainda está em curso e o grupo de anúncios ainda não é elegível para servir.
TargetingTooNarrow	O grupo de anúncios não é elegível para servir porque os critérios de destino do grupo de anúncios, por exemplo, Critério de Nome da Empresa do Grupo de Anúncios estão definidos de forma demasiado estreita. Atualize os critérios de destino ou listas de remarketing para alargar a audiência e aumentar os utilizadores exclusivos estimados.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Pontuação de Qualidade

A pontuação numérica mostra-lhe o quão competitivos são os seus anúncios no marketplace ao medir a relevância das suas palavras-chave e páginas de destino para os termos de pesquisa dos clientes. A classificação de qualidade é calculada pela Microsoft Advertising com as subcontas Relevância da Palavra-chave, Relevância da Página de Destino e Experiência do Utilizador da Página de Destino . Se disponível, a classificação de qualidade pode variar entre um mínimo de 1 e um máximo de 10.

A classificação de qualidade baseia-se nos últimos 30 dias para o tráfego de pesquisa detido e operado. Uma pontuação de qualidade pode ser atribuída sem quaisquer impressões, no caso em que uma oferta de palavra-chave não ganhou nenhum leilão. O tráfego para redes sindicadas não afeta a classificação de qualidade. O valor no ficheiro será "" (cadeia vazia) se a classificação não tiver sido calculada. Isto pode ocorrer se não existirem impressões para a palavra-chave durante 30 dias ou mais.

Normalmente, a classificação de qualidade é atualizada 14 a 18 horas após o fim do dia UTC. As palavras-chave em todos os fusos horários receberão uma classificação de qualidade para o dia UTC correspondente.

Se executar o relatório várias vezes num dia, os valores de classificação de qualidade podem mudar de relatório para relatório com base no momento em que executa o relatório relativamente à data de cálculo das classificações.

Se especificar um período de tempo que abrange vários dias, a classificação de qualidade é a classificação calculada atual e mais recente e será reportada como a mesma para cada dia no período de tempo. Utilize a pontuação de qualidade histórica para descobrir como a pontuação de qualidade pode ter mudado ao longo do tempo. A classificação de qualidade histórica é um instantâneo diário da classificação de qualidade sem interrupção. Para obter mais informações sobre a classificação de qualidade histórica, veja a coluna HistoricQualityScore em Atributos de Relatório e Estatísticas de Desempenho.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Data de Início

A data em que os anúncios no grupo de anúncios podem começar a servir; caso contrário, o serviço pode começar a servir os anúncios no grupo de anúncios no dia em que o grupo de anúncios se tornar ativo.

A data de início é inclusiva. Por exemplo, se definir Data de Início para 5/05/2020, os anúncios no grupo de anúncios começarão às 00:00 a 5/05/2020. A hora baseia-se no fuso horário que especificar ao nível da campanha.

Adicionar: Opcional. Se não definir este campo ou se a data que submeter for anterior à data de hoje, a data de hoje será definida e o serviço pode começar a servir os anúncios no grupo de anúncios assim que o estado do grupo de anúncios estiver ativo.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Não é possível atualizar a data de início depois de o grupo de anúncios ser submetido, ou seja, depois de chegar a data de início.
Eliminar: Só de leitura

Estado

O estado do grupo de anúncios.

Os valores possíveis são Ativo, Eliminado, Expirado e Em Pausa. O estado Expirado é só de leitura.

Adicionar: Opcional. O valor predefinido é Pausado.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.

Definição de Destino

As definições de destino aplicáveis aos tipos de critério, por exemplo, audiências associadas a este grupo de anúncios.

Inclua o nome do grupo do tipo de critério neste campo se pretender a opção "destino e licitação". Neste caso, apenas forneceremos anúncios a pessoas que cumpram pelo menos um dos seus critérios, permitindo-lhe fazer ajustes de licitação para critérios específicos.

Exclua o nome do grupo do tipo de critério deste campo se pretender a opção "apenas licitação". Neste caso, iremos fornecer anúncios a todas as pessoas que cumpram os seus outros critérios de filtragem, permitindo-lhe fazer ajustes de licitação para critérios específicos.

Cada nome de grupo de tipo de critério é delimitado no ficheiro em massa por ponto e vírgula (";"), por exemplo Idade; Audiência; CompanyName; Género; Indústria; JobFunction. Quando transfere o ficheiro em massa, apenas os tipos configurados para utilizar a opção "destino e licitação" serão incluídos neste campo.

Se o Tipo de Campanha estiver definido como Audiência, os valores suportados para este campo são Age, Audience, CompanyName, Gender, Industry e JobFunction. Caso contrário, o único valor atualmente suportado para outros tipos de campanha, por exemplo, Campanhas de pesquisa é "Audiência". Por outras palavras, a opção "destino e licitação" para o tipo de critério Audiência é suportada com todos os tipos de campanha, enquanto a opção "destino e licitação" para os grupos de critério Age, CompanyName, Gender, Industry e JobFunction só é suportada com o tipo de campanha Audiência. Os novos valores podem ser suportados no futuro, pelo que não deve depender de um conjunto fixo de valores. Dito isto, quaisquer valores possíveis para este campo também devem ser definidos no conjunto de valores CriterionTypeGroup da API de Gestão de Campanhas.

Nota

Não confunda o tipo de campanha Audiência com o nome do grupo tipo de critério Audiência.

Grupo tipo critério	Campanhas Suportadas	Descrição
Idade	Audiência	Se incluir o nome do grupo tipo critério Idade neste campo, só iremos fornecer anúncios a pessoas que cumpram pelo menos um dos critérios de idade, permitindo-lhe fazer ajustes de oferta para intervalos de idade específicos. Esta definição garante que as pessoas que veem os seus anúncios cumprem os critérios de idade. Se excluir o nome do grupo do tipo de critério Idade deste campo, iremos fornecer anúncios a todas as pessoas que cumpram os seus outros critérios de filtragem, permitindo-lhe fazer ajustes de licitação para intervalos de idade específicos. Esta definição permite-lhe licitar de forma mais (ou menos) agressiva para as pessoas que cumprem critérios de idade específicos, sem restringir os seus anúncios a essas pessoas.
Audiência	Todos	Inclua o nome do grupo tipo de critério audiência neste campo se quiser mostrar anúncios apenas a pessoas incluídas na audiência, com a opção de alterar o valor da oferta. Os anúncios neste grupo de anúncios só serão apresentados às pessoas incluídas na audiência. Exclua o nome do grupo tipo de critério Audiência deste campo se quiser mostrar anúncios a pessoas que procuram o seu anúncio, com a opção de alterar o valor da oferta para as pessoas incluídas na audiência. Os anúncios neste grupo de anúncios podem ser apresentados a todos, mas o ajuste da oferta será aplicado às pessoas incluídas na audiência.
NomedaEmpresa	Audiência	Se incluir o nome do grupo do tipo de critério CompanyName neste campo, apenas iremos fornecer anúncios a pessoas que cumpram, pelo menos, um dos critérios da sua empresa, permitindo-lhe fazer ajustes de oferta para empresas específicas. Esta definição garante que as pessoas que veem os seus anúncios cumprem os critérios da sua empresa. Se excluir o nome do grupo do tipo de critério CompanyName deste campo, iremos fornecer anúncios a todas as pessoas que cumpram os seus outros critérios de segmentação, permitindo-lhe fazer ajustes de licitação para empresas específicas. Esta definição permite-lhe licitar de forma mais (ou menos) agressiva para as pessoas que cumprem critérios específicos da empresa, sem restringir os seus anúncios a essas pessoas.
Sexo	Audiência	Se incluir o nome do grupo Tipo de critério de género neste campo, só iremos fornecer anúncios a pessoas que cumpram os seus critérios de género, permitindo-lhe fazer ajustes de propostas para um género específico. Esta definição garante que as pessoas que veem os seus anúncios cumprem os seus critérios de género. Se excluir o nome do grupo Tipo de critério de género deste campo, iremos fornecer anúncios a todas as pessoas que cumpram os seus outros critérios de filtragem, permitindo-lhe fazer ajustes de licitação para um género específico. Esta definição permite-lhe licitar de forma mais (ou menos) agressiva para as pessoas que cumprem critérios de género específicos, sem restringir os seus anúncios a essas pessoas.
Indústria	Audiência	Se incluir o nome do grupo do tipo de critério da Indústria neste campo, apenas iremos fornecer anúncios a pessoas que cumpram pelo menos um dos critérios da sua indústria, permitindo-lhe fazer ajustes de oferta para indústrias específicas. Esta definição garante que as pessoas que veem os seus anúncios cumprem os critérios da sua indústria. Se excluir o nome do grupo tipo de critério da Indústria deste campo, iremos fornecer anúncios a todas as pessoas que cumpram os seus outros critérios de filtragem, permitindo-lhe fazer ajustes de oferta para setores específicos. Esta definição permite-lhe licitar de forma mais (ou menos) agressiva para as pessoas que cumprem critérios específicos do setor, sem restringir os seus anúncios a essas pessoas.
JobFunction	Audiência	Se incluir o nome do grupo do tipo de critério JobFunction neste campo, só iremos fornecer anúncios a pessoas que cumpram, pelo menos, um dos critérios da função de trabalho, permitindo-lhe fazer ajustes de licitação para funções de trabalho específicas. Esta definição garante que as pessoas que veem os seus anúncios cumprem os critérios da função de trabalho. Se excluir o nome do grupo do tipo de critério JobFunction deste campo, iremos fornecer anúncios a todas as pessoas que cumpram os seus outros critérios de filtragem, permitindo-lhe fazer ajustes de licitação para funções de trabalho específicas. Esta definição permite-lhe licitar de forma mais (ou menos) agressiva para as pessoas que cumprem critérios de função de trabalho específicos, sem restringir os seus anúncios a essas pessoas.

Uma entidade como uma lista de remarketing pode ser associada a vários grupos de anúncios e as definições de destino de cada grupo de anúncios (por exemplo, o nome do grupo de critérios de audiência para listas de remarketing) são aplicadas de forma independente para entrega. Por exemplo, a mesma lista de remarketing pode ser associada ao Grupo A do Ad e ao Grupo Ad B. O campo Definição de Destino para cada grupo de anúncios é definido de forma independente e, por conseguinte, a mesma lista de remarketing pode ser associada através da opção "destino e licitação" para o Grupo Ad enquanto está associado através da opção "apenas licitação" para o Grupo B do Ad.

Adicionar: Opcional. Se o nome do grupo do tipo de critério for excluído deste campo, a predefinição será efetivamente "apenas licitação".
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Para remover todos os nomes de grupos do tipo de critério, defina este campo como delete_value. A palavra-chave delete_value remove a definição anterior. Para remover um subconjunto de nomes de grupos de tipos de critério, especifique os nomes dos grupos do tipo de critério que pretende manter e omita os que não pretende manter. O novo conjunto de nomes de grupos de tipos de critério substituirá todos os grupos de critérios anteriores que foram definidos para o grupo de anúncios.
Eliminar: Só de leitura

Modelo de Controlo

O modelo de controlo a utilizar como predefinição para todos os URLs no seu grupo de anúncios.

As seguintes regras de validação aplicam-se aos modelos de controlo. Para obter mais detalhes sobre os modelos e parâmetros suportados, consulte o artigo de ajuda do Microsoft Advertising Que parâmetros de controlo ou URL posso utilizar?

• Os modelos de controlo definidos para entidades de nível inferior, por exemplo, os anúncios substituem os conjuntos de entidades de nível superior, por exemplo, campanha. Para obter mais informações, veja Limites de Entidades.

• O comprimento do modelo de controlo está limitado a 2048 carateres. A cadeia de protocolo HTTP ou HTTPS conta para o limite de 2048 carateres.

• O modelo de controlo tem de ser um URL bem formado, começando por um dos seguintes: http://, https://, {lpurl} ou {unescapedlpurl}.

• O Microsoft Advertising não valida se existem parâmetros personalizados. Se utilizar parâmetros personalizados no seu modelo de controlo e estes não existirem, o URL da página de destino incluirá os marcadores de posição de chave e valor dos parâmetros personalizados sem substituição. Por exemplo, se o seu modelo de controlo for https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}, e nem {_season} nem {_promocode} estiverem definidos na campanha, grupo de anúncios, critério, palavra-chave ou nível de anúncio, o URL da página de destino será o mesmo.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura

Utilizar Segmentação Otimizada

UseOptimizedTargeting será preterido. Em alternativa , utilize UsePredictiveTargeting .

Utilizar a Segmentação Preditiva

Indica se a segmentação preditiva está ativada para um AdGroup.

Nota: UsePredictiveTargeting só está disponível para campanhas de Audiência.

Adicionar: Opcional.
Atualização: Opcional.