Partilhar via


Registo de Campanha - Em Massa

Define uma campanha que pode ser carregada e transferida num ficheiro em massa.

Pode transferir todos os registos de Campanha na conta ao incluir o valor DownloadEntity de Campanhas 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 uma campanha de Pesquisa.

Type,Status,Id,Parent Id,Campaign,Website,Client Id,Modified Time,Budget Id,Budget Name,Budget,Budget Type,Bid Adjustment,Name,Country Code,Store Id,Campaign Type,Language,Target Setting,Priority,Tracking Template,Final Url Suffix,Custom Parameter,Bid Strategy Type,Domain Language,Source
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,,,
Campaign,Active,-111,0,Women's Shoes,,ClientIdGoesHere,,PacificTimeUSCanadaTijuana,,,50,DailyBudgetStandard,10,,,,Search,All,Audience,,,,{_promoCode}=PROMO1; {_season}=summer,EnhancedCpc,,

Se estiver a utilizar os SDKs Bing Ads para .NET, Java ou Python, pode poupar tempo ao utilizar o BulkServiceManager para carregar e transferir o objeto BulkCampaign , 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 BulkCampaign
var bulkCampaign = new BulkCampaign
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // Campaign object of the Campaign Management service.
    Campaign = new Campaign
    {        
        // 'Ad Schedule Use Searcher Time Zone' column header in the Bulk file
        AdScheduleUseSearcherTimeZone = true,
        // 'Bid Strategy Type' column header in the Bulk file
        BiddingScheme = new EnhancedCpcBiddingScheme { },
        // 'Budget Id' column header in the Bulk file
        BudgetId = null,
        // 'Budget Type' column header in the Bulk file
        BudgetType = BudgetLimitType.DailyBudgetStandard,
        // 'Campaign Type' column header in the Bulk file
        CampaignType = CampaignType.Search,
        // 'Budget' column header in the Bulk file
        DailyBudget = 50,
        // 'Experiment Id' column header in the Bulk file
        ExperimentId = null,
        // 'Id' column header in the Bulk file
        Id = campaignIdKey,
        // 'Language' column header in the Bulk file
        Languages = new string[] { "All" },
        // 'Campaign' column header in the Bulk file
        Name = "Women's Shoes",
        // 'Bid Adjustment' column header in the Bulk file
        AudienceAdsBidAdjustment = 10,
        Settings = new Setting[] 
        {
            // 'Target Setting' column header in the Bulk file
            new TargetSetting
            {
                // Each target setting detail is delimited by a semicolon (;) in the Bulk file
                Details = new TargetSettingDetail[]
                {
                    new TargetSettingDetail
                    {
                        CriterionTypeGroup = CriterionTypeGroup.Audience,
                        TargetAndBid = false
                    }
                }
            }
        },
        // 'Status' column header in the Bulk file
        Status = CampaignStatus.Active,
        // 'Sub Type' column header in the Bulk file
        SubType = null,
        // '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"
                },
            },
        },
        // 'URL Expansion Opt Out' column header in the Bulk file
        UrlExpansionOptOut = false,
    },
};

uploadEntities.Add(bulkCampaign);

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 campanha , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Cabeçalho da Coluna Tipos de Campanha Suportados
ID da Aplicação Compras
App Store Compras
Recursos de Imagem Gerados Automaticamente optam por não participar Máximo de Desempenho
Recursos de Texto Gerados Automaticamente optam por não participar Máximo de Desempenho
Chamada automatizada para a ação optar ativamente por não participar Procurar
Ad Schedule Use Searcher Time Zone Todos
Ajuste da Oferta Todos
Comissão de Estratégia de Licitação Hotel
ID da Estratégia de Licitação Procurar
Compras
Bid Strategy ManualCpc Audiência
Hotel
Estratégia de Oferta MaxCpc Procurar
Compras
Nome da Estratégia de Licitação Procurar
Compras
Percentagem de Estratégia de LicitaçãoCpc Hotel
TargetAdPosition da Estratégia de Licitação Procurar
Bid Strategy TargetCostPerSale Máximo de Desempenho
Compras
TargetCpa da Estratégia de Licitação Máximo de Desempenho
Procurar
TargetImpressionShare da Estratégia de Licitação Procurar
TargetRoas da Estratégia de Licitação Máximo de Desempenho
Procurar
Compras
Tipo de Estratégia de Oferta Todos
Orçamento Todos
ID do Orçamento Todos
Nome do Orçamento Todos
Tipo de Orçamento Todos
Campanha Todos
Tipo de Campanha Todos
ID de Cliente Todos
Código do País Máximo de Desempenho
Compras
Anúncios de Exclusão de Responsabilidade Ativados Procurar
Idioma do Domínio Procurar
Descrição Dinâmica Ativada Procurar
ID da Experimentação Procurar
Etiqueta do Feed Máximo de Desempenho
Procurar
Sufixo de URL Final Todos
ID Todos
Relevância da Palavra-chave Todos
Relevância da Página de Destino Todos
Experiência de Utilizador da Página de Destino Todos
Idioma Todos
Anúncios de Inventário Local Ativados Compras
Hora da Modificação Todos
IDs do Feed de Páginas Máximo de Desempenho
Procurar
ID principal Todos
Priority Máximo de Desempenho
Compras
Pontuação de Qualidade Todos
Recursos Gerados Automaticamente RSA Ativados Procurar
Código do País de Vendas Máximo de Desempenho
Procurar
Anúncios a Comprar Ativados Compras
Source (Origem) Procurar
Estado Todos
ID da Loja Audiência
Máximo de Desempenho
Compras
Subtipo Compras
Definição de Destino Todos
Modelo de Controlo Todos
Optar aTivamente por Não Participar na Expansão do URL Máximo de Desempenho
Modo de Url de Visualização da Vanity Pharma Procurar
Descrição do Site da Vanity Pharma Procurar
Web site Procurar

ID da Aplicação

O identificador exclusivo da aplicação móvel.

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

App Store

A loja de aplicações na qual a aplicação móvel está distribuída. Pode ser AppleAppStore, GoogleAppStore ou MicrosoftAppStore.

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

Recursos de Imagem Gerados Automaticamente optam por não participar

Se for falso, os recursos de imagem serão gerados dinamicamente. Se for verdadeiro (optou ativamente por não participar), os recursos de imagem não serão gerados dinamicamente. Este campo aplica-se apenas às campanhas Performance Max.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de falso será definido. Este campo aplica-se apenas às campanhas Performance Max.
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

Recursos de Texto Gerados Automaticamente optam por não participar

Se for falso, os recursos de texto serão gerados dinamicamente. Se for verdadeiro (optou ativamente por não participar), os recursos de texto não serão gerados dinamicamente.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de falso será definido.
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

Chamada automatizada para a ação optar ativamente por não participar

Se for falso, o recurso de chamada à ação será selecionado automaticamente para anúncios multimédia na campanha. As definições de chamada de anúncios individuais à ação serão ignoradas. Se for verdadeiro (optou ativamente por não participar), o recurso de chamada à ação não será selecionado automaticamente. Este campo aplica-se apenas a campanhas de Pesquisa.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de falso será definido. Este campo aplica-se apenas a campanhas de Pesquisa.
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 FALSO será definido e o fuso horário da conta será utilizado. 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 está disponível em campanhas de Pesquisa se o cliente estiver ativado para a Rede de Audiências da Microsoft. 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 esta campanha.

Defina este campo como zero (0) se não quiser qualquer ajuste de licitação para anúncios de audiência.

Adicionar: Opcional. Se não definir este campo, será utilizado o ajuste predefinido da oferta do sistema. O ajuste da oferta predefinida do sistema é atualmente zero (0) e está sujeito a alterações.
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. Se definir este campo como delete_value , será utilizado efetivamente o ajuste da oferta predefinida do sistema. O ajuste da oferta predefinida do sistema é atualmente zero (0) e está sujeito a alterações.
Eliminar: Só de leitura

Comissão de Estratégia de Licitação

O montante da comissão que pretende pagar por estadia.

A estratégia de proposta da Comissão exige o povoamento do campo Bid Strategy CommissionRate.

Para obter mais detalhes, veja Estratégias de Orçamento e Licitação.

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 da Estratégia de Licitação

O identificador gerado pelo sistema da Estratégia de Licitação que esta campanha partilha com outras campanhas na conta.

Se o campo estiver vazio, a campanha não está a utilizar uma estratégia de oferta de portefólio. Se o campo não estiver vazio e o valor for superior a zero, a campanha está a utilizar uma estratégia de oferta de portefólio. Se a campanha estiver a utilizar uma estratégia de oferta de portefólio e preferir que utilize a sua própria estratégia de licitação, defina este campo como "0" (zero).

Nota

As estratégias de oferta de portefólio não são suportadas com campanhas de compras inteligentes.

Adicionar: Opcional. Pode especificar um identificador de estratégia de oferta existente ou especificar um identificador negativo que seja igual ao campo ID de um registo de Estratégia de Oferta . Isto é recomendado se estiver a aplicar uma nova estratégia de oferta de portefólio 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: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Bid Strategy ManualCpc

Defina o seu grupo de anúncios e ofertas de palavras-chave e o Microsoft Advertising utiliza estas ofertas sempre.

Para obter mais detalhes, veja Estratégias de Orçamento e Licitação.

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

Estratégia de Oferta MaxCpc

O custo máximo por clique que pretende gastar com o tipo de estratégia de oferta correspondente.

Este campo só é utilizado se o campo Tipo de Estratégia de Oferta estiver definido como MaxClicks, MaxConversions, TargetCpa, TargetImpressionShare ou TargetRoas e, caso contrário, este campo for ignorado.

Para obter mais detalhes, veja Estratégias de Orçamento e Licitação.

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

Nome da Estratégia de Licitação

O nome da estratégia de licitação.

Se o campo estiver vazio, a campanha não está a utilizar uma estratégia de oferta de portefólio.

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

Percentagem de Estratégia de LicitaçãoCpc

Uma percentagem do preço total do hotel por noite, incluindo impostos e taxas.

A estratégia de licitação PercentCPC requer o povoamento do campo PercentMaxCPC da Estratégia de Oferta.

Para obter mais detalhes, veja Estratégias de Orçamento e Licitação.

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

TargetAdPosition da Estratégia de Licitação

A posição do anúncio de destino onde pretende que os anúncios sejam apresentados.

Este campo só é utilizado se o campo Tipo de Estratégia de Oferta estiver definido como TargetImpressionShare e, caso contrário, este campo for ignorado.

Para obter mais detalhes, veja Estratégias de Orçamento e Licitação.

Adicionar: Necessário se o campo Tipo de Estratégia de Oferta estiver definido como TargetImpressionShare e, caso contrário, este campo for ignorado.
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

Bid Strategy TargetCostPerSale

O custo de destino por venda (CPS) que pretende utilizar pelo Microsoft Advertising para maximizar as conversões.

Para obter mais detalhes, veja Estratégias de Orçamento e Licitação.

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

TargetCpa da Estratégia de Licitação

O custo de destino por aquisição (CPA) que pretende utilizar pelo Microsoft Advertising para maximizar as conversões.

Para campanhas Performance Max, este campo só é utilizado se o campo Tipo de Estratégia de Oferta estiver definido como MaxConversion. Para todas as outras campanhas, este campo só é utilizado se o campo Tipo de Estratégia de Oferta estiver definido como TargetCpa. Caso contrário, este campo é ignorado.

Para obter mais detalhes, veja Estratégias de Orçamento e Licitação.

Adicionar: Opcional para campanhas Performance Max se o campo Tipo de Estratégia de Oferta estiver definido como MaxConversion. Necessário para todas as outras campanhas se o campo Tipo de Estratégia de Oferta estiver definido como TargetCpa. Caso contrário, este campo é ignorado. 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

TargetImpressionShare da Estratégia de Licitação

A partilha de impressão de destino para a posição de anúncio onde pretende que os seus anúncios sejam apresentados.

Este campo só é utilizado se o campo Tipo de Estratégia de Oferta estiver definido como TargetImpressionShare e, caso contrário, este campo for ignorado.

Para obter mais detalhes, veja Estratégias de Orçamento e Licitação.

Adicionar: Necessário se o campo Tipo de Estratégia de Oferta estiver definido como TargetImpressionShare e, caso contrário, este campo for ignorado.
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

TargetRoas da Estratégia de Licitação

O retorno de destino dos gastos com anúncios (ROAS) que pretende utilizar pelo Microsoft Advertising para maximizar as conversões.

Os valores ROAS de destino suportados variam entre 0,01 (1 por cento) e 1.000,00 (100 000 por cento).

Para campanhas Performance Max, este campo só é utilizado se o campo Tipo de Estratégia de Oferta estiver definido como MaxConversionValue. Para todas as outras campanhas, este campo só é utilizado se o campo Tipo de Estratégia de Oferta estiver definido como TargetRoas. Caso contrário, este campo é ignorado.

Para obter mais detalhes, veja Estratégias de Orçamento e Licitação.

Adicionar: Opcional para campanhas De Desempenho Máximo se o campo Tipo de Estratégia de Oferta estiver definido como TargetRoas. Necessário para todas as outras campanhas se o campo Tipo de Estratégia de Oferta estiver definido como TargetRoas. Caso contrário, este campo é ignorado. 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 Estratégia de Oferta

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

Os valores possíveis do tipo de estratégia de oferta são Comissão, EnhancedCpc, ManualCpc, MaxClicks, MaxConversions, PercentCpc, TargetCpa, TargetImpressionShare e TargetRoas. Para obter detalhes sobre estratégias de licitação suportadas por tipo de campanha, veja Estratégias de Orçamento e Licitação.

Importante

A partir de maio de 2024, já não pode utilizar a estratégia de licitação manual do CPC para campanhas nativas de audiência. Só pode utilizar o CPC manual para campanhas de exibição e vídeo da audiência e para campanhas de alojamento. Converteremos automaticamente quaisquer campanhas nativas manuais do público CPC em CPC melhorado. Se tentar definir o CPC manual para qualquer outro tipo de campanha, o pedido será ignorado sem erros e a estratégia de licitação será definida como CPC melhorado.

A partir de abril de 2021, não pode definir estratégias de licitação para grupos de anúncios ou palavras-chave. As estratégias de licitação só podem ser definidas ao nível da campanha. 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.

Se utilizar o tipo de estratégia de licitação "Comissão", pode incluir opcionalmente o campo Comissão de Estratégia de Licitação .

Se utilizar o tipo de estratégia de oferta "ManualCpc", pode incluir opcionalmente o campo Bid Strategy ManualCpc .

Se utilizar o tipo de estratégia de oferta "MaxClicks", pode incluir opcionalmente o campo MaxCpc da Estratégia de Oferta .

Se utilizar o tipo de estratégia de oferta "MaxConversions", pode incluir opcionalmente o campo MaxCpc da Estratégia de Oferta .

Se utilizar o tipo de estratégia de oferta "PercentCpc", pode incluir opcionalmente o campo PercentCpc da Estratégia de Licitação .

Se utilizar o tipo de estratégia de oferta "TargetCostPerSale", pode incluir opcionalmente o campo TargetCostPerSale da Estratégia de Oferta .

Se utilizar o tipo de estratégia de oferta "TargetCpa", tem de incluir o campo TargetCpa da Estratégia de Oferta .

Se utilizar o tipo de estratégia de oferta "TargetImpressionShare", tem de incluir os campos TargetAdPosition da Estratégia de Licitação e TargetImpressionShare da Estratégia de Licitação . Opcionalmente, pode incluir o campo MaxCpc da Estratégia de Oferta .

Se utilizar o tipo de estratégia de oferta "TargetRoas", tem de incluir o campo TargetRoas da Estratégia de Licitação . Opcionalmente, pode incluir o campo MaxCpc da Estratégia de Oferta .

Importante

Para alguns tipos de estratégia de oferta, as suas definições de oferta e rotação de anúncios são ignoradas e o controlo de conversão (através da etiqueta Deteção de Eventos Universal e um objetivo de conversão) é necessário. Para obter mais informações, incluindo localizações suportadas, consulte Permitir que o Microsoft Advertising faça a gestão das suas ofertas com estratégias de licitação.

Adicionar: Opcional. O valor predefinido das campanhas Search e DynamicSearchAds é EnhancedCpc. O tipo de estratégia de oferta predefinido para a maioria das campanhas de Compras é EnhancedCpc; no entanto, o único tipo de estratégia de oferta suportado para campanhas de compras inteligentes é MaxConversionValue. O único valor suportado para campanhas de Audiência é ManualCpc. O valor predefinido das campanhas Performance Max é MaxConversions. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se atualizar o tipo de estratégia de oferta, todos os valores existentes nos campos MaxCpc da Estratégia de Oferta, TargetCpa de Estratégia de Oferta, TargetAdPosition de Estratégia de Oferta, TargetImpressionShare e TargetRoas da Estratégia de Licitação serão eliminados.
Eliminar: Só de leitura

Orçamento

O montante orçamental da campanha.

Aviso

O seu orçamento é um destino; os gastos reais podem ser superiores ou inferiores. As variações são causadas por vários fatores, como diferentes volumes de tráfego em dias diferentes da semana, ou deteção automática e reembolso de cliques de fraude que podem devolver dinheiro a uma campanha dentro de algumas horas após o clique. O Microsoft Advertising antecipa e compensa automaticamente as flutuações e, normalmente, mantém a utilização excessiva inferior a 100% acima do limite diário.

Tenha também em atenção que o Microsoft Advertising não requer que o orçamento da sua campanha seja superior ao grupo de anúncios e às ofertas de palavras-chave. Por outras palavras, as propostas de grupo de anúncios e palavras-chave são validadas independentemente do orçamento da campanha.

No contexto dos orçamentos partilhados, o montante do orçamento é uma propriedade só de leitura que é sempre devolvida independentemente de a campanha utilizar ou não um orçamento partilhado. Quando uma campanha está associada a um orçamento partilhado, o montante devolvido é o do orçamento partilhado. Para determinar se a campanha utiliza um orçamento partilhado, verifique o valor do campo ID do Orçamento .

Com as campanhas de experimentação, não pode atualizar o Orçamento, o Tipo de Orçamento ou o Estado. O orçamento e o estado de uma campanha de experimentação são sempre herdados das definições de campanha base.

Adicionar: Necessário se o ID do Orçamento não estiver definido. Só de leitura se a campanha utilizar um orçamento partilhado.
Atualização: Opcional se o BudgetId não estiver definido. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Não permitido se a campanha utilizar um orçamento partilhado. Se tentar atualizar o montante orçamental de uma campanha com um orçamento partilhado, o serviço devolverá o código de erro CampaignServiceCannotUpdateSharedBudget .
Eliminar: Só de leitura

ID do Orçamento

O identificador gerado pelo sistema do Orçamento que esta campanha partilha com outras campanhas na conta.

Se o campo estiver vazio, a campanha não está a utilizar um orçamento partilhado. Se o campo não estiver vazio e o valor for superior a zero, a campanha está a utilizar um orçamento partilhado. Se a campanha estiver a utilizar um orçamento partilhado e preferir que utilize o seu próprio montante orçamental, defina este campo como "0" (zero) e defina o campo Orçamento para um montante orçamental válido.

Nota

Este valor corresponde ao campo ID do registo De orçamento .

Nota

Os orçamentos partilhados não são suportados com campanhas de compras inteligentes. Com campanhas de compras inteligentes, tem de definir o montante diário do Orçamento .

Adicionar: Opcional. Pode especificar um identificador de orçamento existente ou especificar um identificador negativo que seja igual ao campo ID de um registo de Orçamento . Isto é recomendado se estiver a aplicar um novo orçamento partilhado 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: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Nome do Orçamento

O nome do orçamento partilhado.

Este valor corresponde ao campo Nome do Orçamento do registo Orçamento . Só pode definir este valor com o registo Orçamento .

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

Tipo de Orçamento

O tipo de orçamento determina como o orçamento é gasto.

Os valores possíveis são DailyBudgetAccelerated e DailyBudgetStandard. O tipo de orçamento DailyBudgetAccelerated só está disponível para campanhas de Audiência que utilizam orçamentos de nível de campanha não partilhados.

No contexto dos orçamentos partilhados, o tipo de orçamento é uma propriedade só de leitura que é sempre devolvida independentemente de a campanha utilizar ou não um orçamento partilhado. Para determinar se a campanha utiliza um orçamento partilhado, verifique o valor do campo ID do Orçamento .

Com as campanhas de experimentação, não pode atualizar o Orçamento, o Tipo de Orçamento ou o Estado. O orçamento e o estado de uma campanha de experimentação são sempre herdados das definições de campanha base.

Adicionar: Necessário se o ID do Orçamento não estiver definido. Só de leitura se a campanha utilizar um orçamento partilhado.
Atualização: Opcional se o BudgetId não estiver definido. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Não permitido se a campanha utilizar um orçamento partilhado. Se tentar atualizar o tipo de orçamento de uma campanha com um orçamento partilhado, o serviço devolverá o código de erro CampaignServiceCannotUpdateSharedBudget .
Eliminar: Só de leitura

Campanha

O nome da campanha.

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

Nota

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

Tipo de Campanha

O tipo de campanha.

O tipo de campanha determina se a campanha é uma campanha do Microsoft Shopping, campanha de Anúncios de Pesquisa Dinâmica, Campanha de alojamento, Campanha de pesquisa ou campanha Performance Max. Os valores possíveis incluem Audience, DynamicSearchAds, Hotel, Shopping, Search e PerformanceMax.

Nota

Já não pode adicionar, atualizar ou obter campanhas que apenas suportam anúncios de pesquisa dinâmicos. O tipo de campanha das suas campanhas existentes foi atualizado de "DynamicSearchAds" para "Search". Os grupos de anúncios são agora considerados grupos de anúncios "dinâmicos", mas não existem alterações estruturais, ou seja, contêm os mesmos destinos automáticos e anúncios de pesquisa dinâmicos como anteriormente.

Adicionar: Opcional. Se não for especificado, é utilizado o valor predefinido de Pesquisa . Se o tipo de campanha for Compras , também tem de incluir os campos Código do País, Prioridade e ID da Loja . Se o tipo de campanha for DynamicSearchAds , também tem de incluir os campos Idioma do Domínio e Site .
Atualização: Só de leitura
Eliminar: Só de leitura

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

Código do País

O código de país para a loja do Centro de Comerciantes da Microsoft.

O catálogo da loja Microsoft Merchant Center será filtrado para incluir apenas produtos para o país ou região especificado.

Para obter a lista de códigos de país suportados, utilize a operação GetBSCCountries . Por exemplo, os códigos de país suportados incluem "AU" (Austrália), "AT" (Áustria), "BE" (Bélgica), "CA" (Canadá), "CH" (Suíça), "DE" (Alemanha), "ES" (Espanha), "FR" (França), "GB" (Reino Unido), "IN" (Índia), "IT" (Itália), "NL" (Países Baixos), "SE" (Suécia) e "EUA" (Estados Unidos).

Adicionar: Necessário se o campo Tipo de Campanha estiver definido como Compras ou se o campo Tipo de Campanha estiver definido como PerformanceMax e uma loja estiver associada à campanha. Não pode incluir esta coluna para outros tipos de campanha.
Atualização: Só de leitura
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

Canal de Destino

Reservado para utilização futura.

Idioma do Domínio

O idioma das páginas do site que pretende direcionar para anúncios de pesquisa dinâmica.

O idioma do seu site determina onde os seus anúncios são elegíveis para serem apresentados. Por exemplo, um anúncio em língua alemã pode aparecer na Alemanha, Áustria e Suíça, mas não em Espanha. Se o seu site contiver páginas em vários idiomas e quiser anunciar todas estas páginas, deve criar uma campanha separada para cada idioma.

Os idiomas de domínio suportados são neerlandês, inglês, francês, alemão, italiano, espanhol e sueco.

Tenha em atenção que, se definir o Idioma da campanha ou o Idioma do grupo de anúncios, estes serão ignorados.

Nota

As experimentações não são suportadas para campanhas mistas com definições de anúncios de pesquisa dinâmica. As campanhas de experimentação e as campanhas base de experimentações não podem incluir definições de anúncios de pesquisa dinâmica (compostas pelos campos IDs de Feed de Páginas, Origem e Site da Descrição Dinâmica Ativada). Se pretender utilizar esta campanha para experimentações, não inclua definições de anúncios de pesquisa dinâmica. Se uma experimentação existente já se basear nesta campanha, não poderá atualizar a campanha para incluir definições de anúncios de pesquisa dinâmica.

Adicionar: Necessário se o campo Tipo de Campanha estiver definido como DynamicSearchAds. Opcional se a conta estiver no piloto da funcionalidade de campanhas mistas , se o campo Tipo de Campanha estiver definido como Pesquisa e se o campo ID da Experimentação não estiver definido. Não pode incluir esta coluna para outros tipos de campanha.
Atualização: Só de leitura. Não é possível atualizar a linguagem de domínio.
Eliminar: Só de leitura

Anúncios de Exclusão de Responsabilidade Ativados

Esta é uma campanha de exclusão de responsabilidade quando definida como verdadeira. As campanhas de exclusão de responsabilidade só podem conter anúncios de texto expandidos (EXTA) ou anúncios de pesquisa reativa (RSA).

Nota: esta será sempre uma campanha de exclusão de responsabilidade assim que estiver definida como verdadeira. Só pode definir Exclusão de ResponsabilidadeAdsEnabled durante a criação do anúncio.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de falso será definido e os anúncios de exclusão de responsabilidade não serão ativados para esta campanha.
Atualização: Só de leitura. Não pode atualizar Exclusão de ResponsabilidadeAdsEnabled após a criação da campanha.
Eliminar: Só de leitura

Descrição Dinâmica Ativada

Nota

Nem todos têm esta funcionalidade ainda. Se não o fizer, não se preocupe.

Determina se pretende gerar automaticamente texto de anúncio de pesquisa dinâmica para além do texto de anúncio que fornecer. Durante a entrega de anúncios, vamos utilizar a inteligência artificial para escolher o melhor texto de anúncio disponível a partir destas opções.

Defina este elemento como verdadeiro se pretender ativar o texto de anúncio de pesquisa dinâmica e, caso contrário, defina-o como falso.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de falso será definido e o texto de anúncio de pesquisa dinâmica não será ativado. 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 da Experimentação

O identificador gerado pelo sistema da Experimentação.

Este campo só está definido para campanhas de experimentação, ou seja, campanhas que foram criadas para testes A/B com base noutra campanha de Pesquisa. As campanhas base não irão conter um ID de experimentação. Da mesma forma, depois de uma experiência ter sido formada para uma campanha independente, este campo estará vazio, apesar de a campanha ter sido anteriormente uma campanha de experimentação.

Com as campanhas de experimentação, não pode atualizar o Orçamento, o Tipo de Orçamento ou o Estado. O orçamento e o estado de uma campanha de experimentação são sempre herdados das definições de campanha base. Se quiser alterar o orçamento de uma experimentação, terá de alterar o orçamento da campanha base. A alteração do valor será dividida com base na definição TrafficSplitPercent da experimentação.

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

Etiqueta do Feed

Permite-lhe anunciar todos os produtos com a mesma etiqueta de feed numa campanha Compras ou Performance Max.

  • Só pode haver uma etiqueta de feed por campanha.
  • FeedLabel e SalesCountryCode são mutuamente exclusivos. Só pode definir uma destas propriedades.
  • Cada etiqueta de feed pode ter um máximo de 20 carateres.
  • Não pode utilizar o FeedLabel com campanhas do Shopping CoOp.

Adicionar: Opcional
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

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

ID

O identificador gerado pelo sistema da campanha.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificador negativo para a campanha pode, em seguida, ser referenciado no campo ID Principal de tipos de registo dependentes, como grupos de anúncios ou critério. Isto é recomendado se estiver a adicionar novas campanhas 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

Nota

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

É Campanha de Vários Canais

Reservado para utilização futura.

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.

Pode especificar múltiplos idiomas individualmente na lista ou incluir apenas uma cadeia de idioma neste campo definida como "Todos" se pretender direcionar todos os idiomas.

As cadeias linguísticas suportadas para campanhas de Pesquisa e Compras são: All, Bulgarian, 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, Eslovaco, Esloveno, Espanhol, Sueco e TradicionalChinês. Cada idioma neste campo em massa é delimitado por um ponto e vírgula (";"), por exemplo , inglês; Francês; Alemão.

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 Audiência, tem de incluir todos os idiomas, ou seja, definir este campo como "Todos".

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.

Adicionar: Necessário para campanhas de Audiência e, caso contrário, este campo é opcional. Se não existir nenhum idioma de campanha definido, será necessário o idioma de cada grupo de anúncios na campanha.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Assim que os idiomas de campanha estiverem definidos, não pode eliminá-los todos. A lista de idiomas que especificar durante a atualização substitui as definições anteriores, ou seja, não acrescenta ao conjunto de idiomas existente.
Eliminar: Só de leitura

Anúncios de Inventário Local Ativados

Determina se os anúncios de inventário local estão ativados para a loja Microsoft Merchant Center.

Nem todos têm esta funcionalidade ainda. Se não o fizer, não se preocupe. Está a chegar em breve.

Defina esta propriedade como VERDADEIRO se quiser ativar anúncios de inventário local e, caso contrário, defina-a como FALSO.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de FALSO será definido e os anúncios de inventário local não serão ativados.
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

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

IDs do Feed de Páginas

Os identificadores de feed de páginas para anúncios de pesquisa dinâmica e campanhas Performance Max.

Cada identificador de feed de página é delimitado no ficheiro em massa por ponto e vírgula (";").

Para anúncios de pesquisa dinâmica, a Origem determina se o Microsoft Advertising irá ou não utilizar os feeds de página associados.

Sugestão

Veja o Guia técnico dos Feeds de Página para obter uma descrição geral da implementação.

Nota

As experimentações não são suportadas para campanhas mistas com definições de anúncios de pesquisa dinâmica. As campanhas de experimentação e as campanhas base de experimentações não podem incluir definições de anúncios de pesquisa dinâmica (compostas pelos campos IDs de Feed de Páginas, Origem e Site da Descrição Dinâmica Ativada). Se pretender utilizar esta campanha para experimentações, não inclua definições de anúncios de pesquisa dinâmica. Se uma experimentação existente já se basear nesta campanha, não poderá atualizar a campanha para incluir definições de anúncios de pesquisa dinâmica.

Adicionar: Opcional se o campo Tipo de Campanha estiver definido como Pesquisa ou Máximo de Desempenho e se o campo ID da Experimentação não estiver definido. Não pode incluir esta coluna para outros tipos de campanha.
Atualização: Opcional se o campo Tipo de Campanha estiver definido como Pesquisa ou Máximo de Desempenho e se o campo ID da Experimentação não estiver definido. Não pode incluir esta coluna para outros tipos de campanha. 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 principal

O identificador gerado pelo sistema da conta que contém a campanha.

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

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

Priority

Ajuda a determinar que campanha do Microsoft Shopping serve anúncios, caso duas ou mais campanhas utilizem o feed do catálogo de produtos da mesma loja microsoft Merchant Center.

Um valor de prioridade superior indica uma prioridade mais alta. Os valores suportados para a maioria das campanhas de compras são 0, 1 e 2. Para campanhas de compras inteligentes ( sub type de campanha definido como ShoppingSmartAds), tem de definir a prioridade como 3. Para as campanhas Performance Max, tem de definir a prioridade como 4.

Nota

Se criar uma campanha do Microsoft Shopping na aplicação Web Microsoft Advertising, a prioridade predefinida selecionada é "Baixa", que é o equivalente a "0".

Adicionar: Necessário se o campo Tipo de Campanha estiver definido como Compras ou se o campo Tipo de Campanha estiver definido como PerformanceMax e uma loja estiver associada à campanha. Não pode incluir esta coluna para outros tipos de campanha.
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

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

Recursos Gerados Automaticamente RSA Ativados

Determina se pretende gerar automaticamente recursos de anúncios de pesquisa reativos, além do texto de anúncio que fornecer. Durante a entrega de anúncios, vamos utilizar a inteligência artificial para escolher os melhores recursos disponíveis a partir destas opções.

Adicionar: Opcional. O valor predefinido de false será definido se não for especificado de outra forma.
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

Código do País de Vendas

O código de país para a loja do Centro de Comerciantes da Microsoft.

O catálogo da loja Microsoft Merchant Center será filtrado para incluir apenas produtos para o país/região especificado.

Para obter a lista de códigos de país suportados, utilize a operação GetBSCCountries . Por exemplo, os códigos de país suportados incluem "AU" (Austrália), "AT" (Áustria), "BE" (Bélgica), "CA" (Canadá), "CH" (Suíça), "DE" (Alemanha), "ES" (Espanha), "FR" (França), "GB" (Reino Unido), "IN" (Índia), "IT" (Itália), "NL" (Países Baixos), "SE" (Suécia) e "EUA" (Estados Unidos).

FeedLabel e SalesCountryCode são mutuamente exclusivos. Só pode definir uma destas propriedades.

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

Anúncios a Comprar Ativados

Determina se os anúncios comercializáveis estão ativados para a loja Microsoft Merchant Center.

Nem todos têm esta funcionalidade ainda. Se não o fizer, não se preocupe. Está a chegar em breve.

Defina esta propriedade como VERDADEIRO se pretender ativar anúncios em loja e, caso contrário, defina-a como FALSO.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de FALSO será definido e os anúncios que podem ser armazenados não serão ativados.
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

Source (Origem)

Determina se deve utilizar o índice do Bing, os URLs fornecidos pelo anunciante ou ambos para anúncios de pesquisa dinâmicos.

Os valores possíveis estão na tabela abaixo.

Valor Descrição
AdvertiserSuppliedUrls Utilizar URLs apenas do meu feed de página. Apenas os URLs especificados no ficheiro de feed serão servidos a partir desta campanha. Tenha em atenção que se escolher esta opção e os IDs dos Feeds de Página não estiverem definidos , a campanha não servirá anúncios de pesquisa dinâmicos. Recomendamos que utilize esta opção para campanhas altamente específicas com cópia de anúncios personalizada.
Todos Utilize URLs do índice do Bing do meu site e do meu feed de páginas. Serão utilizadas páginas de ambas as origens, mas será dada prioridade aos URLs no ficheiro de feed.
SystemIndex Utilizar o índice do Bing do meu site. Este é o comportamento predefinido das campanhas publicitárias de pesquisa dinâmica no Bing.

Nota

As experimentações não são suportadas para campanhas mistas com definições de anúncios de pesquisa dinâmica. As campanhas de experimentação e as campanhas base de experimentações não podem incluir definições de anúncios de pesquisa dinâmica (compostas pelos campos IDs de Feed de Páginas, Origem e Site da Descrição Dinâmica Ativada). Se pretender utilizar esta campanha para experimentações, não inclua definições de anúncios de pesquisa dinâmica. Se uma experimentação existente já se basear nesta campanha, não poderá atualizar a campanha para incluir definições de anúncios de pesquisa dinâmica.

Adicionar: Opcional se o campo Tipo de Campanha estiver definido como DynamicSearchAds. Opcional se a conta estiver no piloto da funcionalidade de campanhas mistas , se o campo Tipo de Campanha estiver definido como Pesquisa e se o campo ID da Experimentação não estiver definido. Não pode incluir esta coluna para outros tipos de campanha. Por predefinição, apenas o índice do Bing é utilizado, ou seja, um valor vazio é efetivamente o mesmo que especificar SystemIndex.
Atualização: Opcional se o campo Tipo de Campanha estiver definido como DynamicSearchAds. Opcional se a conta estiver no piloto da funcionalidade de campanhas mistas , se o campo Tipo de Campanha estiver definido como Pesquisa e se o campo ID da Experimentação não estiver definido. Não pode incluir esta coluna para outros tipos de campanha. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Estado

O estado da campanha.

Os valores possíveis para transferência e carregamento são Ativos, Em Pausa e Eliminados. Além disso, os valores BudgetAndManualPaused, BudgetPaused e Suspended são só de leitura através da transferência em massa.

Com as campanhas de experimentação, não pode atualizar o Orçamento, o Tipo de Orçamento ou o Estado. O orçamento e o estado de uma campanha de experimentação são sempre herdados das definições de campanha base.

Valor Descrição
Ativo A campanha está ativa, o que indica que os anúncios da campanha podem ser servidos.
BudgetAndManualPaused A campanha está em pausa, o que indica que os anúncios da campanha não servirão. Este estado resulta quando um utilizador define o estado da campanha como em pausa após o serviço interromper a campanha porque o orçamento está esgotado.
BudgetPaused A campanha está em pausa, o que indica que os anúncios da campanha não servirão. O serviço define este estado quando o orçamento está esgotado. O serviço irá definir o estado novamente como Ativo quando o orçamento for restaurado.
Eliminado A campanha é eliminada. Este estado destina-se apenas a utilização interna. Uma vez que todas as operações Get não devolvem objetos eliminados, não verá um objeto com este estado.
Em pausa A campanha está em pausa, o que indica que os anúncios da campanha não servirão.
Suspenso A sua campanha foi suspensa devido a atividades suspeitas e nenhum anúncio é elegível para entrega.
Contacte o Suporte de Publicidade da Microsoft.

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

ID da Loja

O identificador exclusivo da loja Microsoft Merchant Center que contém um feed de catálogo de produtos que pretende utilizar para a campanha.

Depois de escolher uma loja para uma campanha, não pode alterá-la. Se, em algum momento, quiser utilizar uma loja diferente, terá de criar uma nova campanha de compras com uma nova definição de compras.

Com as Campanhas de Compras para Marcas , uma única campanha pode visar todos os seus parceiros retalhistas e não há necessidade de criar campanhas individuais para cada retalhista. Recomendamos que defina esta opção para o ID da loja global da sua conta de gestor ( Subtipo de loja definido como GlobalStore). Ao direcionar inicialmente todas as lojas ligadas através da definição de compras de campanha, pode carregar até 10 registos de Critérios da Loja Negativa de Campanha para excluir revendedores específicos conforme necessário.

Para obter os identificadores da loja, chame a operação GetBMCStoresByCustomerId .

Adicionar: Necessário se o campo Tipo de Campanha estiver definido como Compras ou se o campo Tipo de Campanha estiver definido como PerformanceMax e uma loja estiver associada à campanha. Não pode incluir esta coluna para outros tipos de campanha.
Atualização: Só de leitura
Eliminar: Só de leitura

Subtipo

O subtipo de campanha.

Se o subtipo não estiver definido, a campanha é criada de acordo com o tipo de campanha.

Se o subtipo estiver definido como AudienceVideoAds e o tipo de campanha for Audiência, a campanha é uma campanha de audiência de vídeo.

Se o subtipo estiver definido como ShoppingSmartAds, a campanha é uma campanha do Microsoft Smart Shopping.

Se o subtipo estiver definido como ShoppingSponsoredProductAd, a campanha é uma campanha de compras da Microsoft para marcas.

Adicionar: Opcional e não aplicável para a maioria dos tipos de campanha. Para campanhas de compras inteligentes da Microsoft, tem de definir o subtipo como ShoppingSmartAds. Para campanhas de compras da Microsoft para marcas , tem de definir o subtipo como ShoppingSponsoredProductAd.
Atualização: Só de leitura
Eliminar: Só de leitura

Definição de Destino

As definições de destino aplicáveis aos tipos de critério, por exemplo, audiências associadas a esta campanha.

Nota

Nem todos têm esta funcionalidade ainda. Se não o fizer, não se preocupe. Está a chegar em breve.

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 (";"). 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.

O único valor do tipo de critério atualmente suportado para a definição de destino de nível de campanha é "Audiência". A opção "destino e licitação" para o tipo de critério Audiência é suportada com todos os tipos de campanha. 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
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 nesta campanha 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 nesta campanha podem mostrar a todos, mas o ajuste da oferta será aplicado às pessoas incluídas na plateia.

Uma entidade como uma lista de remarketing pode ser associada a múltiplas campanhas e as definições de destino de cada campanha (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 à Campanha A e à Campanha B. O campo Definição de Destino para cada campanha é 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 a Campanha A enquanto está associada através da opção "apenas licitação" para a Campanha B.

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 a campanha.
Eliminar: Só de leitura

Modelo de Controlo

O modelo de controlo a utilizar como predefinição para todos os URLs na sua campanha.

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

Modo de Url de Visualização da Vanity Pharma

Define um conjunto de valores para VanityPharmaDisplayUrlMode. Este é o modo de exibição para URLs da vanity pharma para uma campanha.

Nota

A VanityPharmaDisplayUrlMode está reservada para utilização piloto limitada (por exemplo, clientes farmacêuticos).

Adicionar: opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de ManufacturerWebsiteUrl será definido.
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.

Descrição do Site da Vanity Pharma

O texto que aparece no URL de apresentação de um anúncio de texto quando WebsiteDescription é o modo de apresentação selecionado para URLs de pharma personalizados para a campanha.

Nota

A VanityPharmaWebsiteDescription está reservada para utilização piloto limitada (por exemplo, clientes farmacêuticos).

Adicionar: opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de Não especificado será definido.
Atualização: opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Se não estiver definido nenhum valor, mas o valor para VanityPharmaDisplayURLMode estiver definido como ManufacturerWebsiteUrl, o valor não especificado será definido.
Se não estiver definido nenhum valor, mas o valor para VanityPharmaDisplayURLMode estiver definido como WebsiteDescription, o serviço de campanha devolverá o código de erro TBD.
Se um valor diferente de Não Especificado estiver definido, mas o valor para VanityPharmaDisplayURLMode estiver definido como ManufacturerWebsiteUrl, o serviço de campanha devolverá o código de erro TBD.
Eliminar: só de leitura

Optar aTivamente por Não Participar na Expansão do URL

Se for falso, todo o domínio será visado. Se for verdadeiro (optou ativamente por não participar), só serão visados os URLs finais nos grupos de recursos e no feed. Este campo aplica-se apenas às campanhas Performance Max.

Adicionar: Opcional. Se não especificar este campo ou o deixar vazio, o valor predefinido de falso será definido. 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

Web site

O nome de domínio do site que pretende direcionar para anúncios de pesquisa dinâmica.

O comprimento da cadeia está limitado a 2048 carateres. Se o nome de domínio incluir www , será cortado e não será utilizado.

Nota

As experimentações não são suportadas para campanhas mistas com definições de anúncios de pesquisa dinâmica. As campanhas de experimentação e as campanhas base de experimentações não podem incluir definições de anúncios de pesquisa dinâmica (compostas pelos campos IDs de Feed de Páginas, Origem e Site da Descrição Dinâmica Ativada). Se pretender utilizar esta campanha para experimentações, não inclua definições de anúncios de pesquisa dinâmica. Se uma experimentação existente já se basear nesta campanha, não poderá atualizar a campanha para incluir definições de anúncios de pesquisa dinâmica.

Adicionar: Necessário se o campo Tipo de Campanha estiver definido como DynamicSearchAds. Opcional se a conta estiver no piloto da funcionalidade de campanhas mistas , se o campo Tipo de Campanha estiver definido como Pesquisa e se o campo ID da Experimentação não estiver definido. Não pode incluir esta coluna para outros tipos de campanha.
Atualização: Só de leitura. Não é possível atualizar o nome de domínio.
Eliminar: Só de leitura