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.
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
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
É 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
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