Compartilhar via

Registo da Extensão de Anúncios de Preços - Em Massa

  • Artigo

Define uma extensão de anúncio que inclui entre 3 e 8 linhas de tabela de preços.

Pode associar uma extensão de anúncio de preço à conta ou a campanhas e grupos de anúncios na conta. Cada entidade (conta, campanha ou grupo de anúncios) pode ser associada a até 20 extensões de anúncios de preço. Utilize os registos Account Price Ad Extension, Ad Group Price Ad Extension e Campaign Price Ad Extension para gerir associações de extensão de anúncios de preços.

Pode transferir todos os registos da Extensão Price Ad na conta ao incluir o valor DownloadEntity de PriceAdExtensions no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . 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 nova Extensão price ad à biblioteca partilhada da conta.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Tracking Template,Final Url Suffix,Custom Parameter,Price Extension Type,Currency Code 1,Currency Code 2,Currency Code 3,Currency Code 4,Currency Code 5,Currency Code 6,Currency Code 7,Currency Code 8,Price Description 1,Price Description 2,Price Description 3,Price Description 4,Price Description 5,Price Description 6,Price Description 7,Price Description 8,Header 1,Header 2,Header 3,Header 4,Header 5,Header 6,Header 7,Header 8,Final Mobile Url 1,Final Mobile Url 2,Final Mobile Url 3,Final Mobile Url 4,Final Mobile Url 5,Final Mobile Url 6,Final Mobile Url 7,Final Mobile Url 8,Final Url 1,Final Url 2,Final Url 3,Final Url 4,Final Url 5,Final Url 6,Final Url 7,Final Url 8,Price 1,Price 2,Price 3,Price 4,Price 5,Price 6,Price 7,Price 8,Price Qualifier 1,Price Qualifier 2,Price Qualifier 3,Price Qualifier 4,Price Qualifier 5,Price Qualifier 6,Price Qualifier 7,Price Qualifier 8,Price Unit 1,Price Unit 2,Price Unit 3,Price Unit 4,Price Unit 5,Price Unit 6,Price Unit 7,Price Unit 8
Format Version,,,,,,,,,,,6.0,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
Price Ad Extension,,-24,,,,ClientIdGoesHere,,,,,,(Monday[09:00-21:00]),FALSE,,,{_promoCode}=PROMO1; {_season}=summer,Events,USD,USD,USD,,,,,,Come to the event,Come to the next event,Come to the final event,,,,,,New Event,Next Event,Final Event,,,,,,,,,,,,,,https://contoso.com,https://contoso.com,https://contoso.com,,,,,,9.99,9.99,9.99,,,,,,From,From,From,,,,,,PerDay,PerDay,PerDay,,,,,

Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo com o BulkServiceManager para carregar e transferir o objeto BulkPriceAdExtension , 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 BulkPriceAdExtension
var bulkPriceAdExtension = new BulkPriceAdExtension
{
    // '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 
    // PriceAdExtension object of the Campaign Management service.
    PriceAdExtension = new PriceAdExtension
    {
        // 'Language' column header in the Bulk file
        Language = "English",
        // 'Id' column header in the Bulk file
        Id = priceAdExtensionIdKey,
        // 'Price Extension Type' column header in the Bulk file
        PriceExtensionType = PriceExtensionType.Events,

        // 'Ad Schedule' column header in the Bulk file
        Scheduling = new Schedule
        {
            // Each day and time range is delimited by a semicolon (;) in the Bulk file
            DayTimeRanges = new[]
            {
                // Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
                new DayTime
                {
                    Day = Day.Monday,
                    StartHour = 9,
                    StartMinute = Minute.Zero,
                    EndHour = 21,
                    EndMinute = Minute.Zero,
                },
            },
            // 'End Date' column header in the Bulk file
            EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
            {
                Month = 12,
                Day = 31,
                Year = DateTime.UtcNow.Year + 1
            },
            // 'Start Date' column header in the Bulk file
            StartDate = null,
            // 'Use Searcher Time Zone' column header in the Bulk file
            UseSearcherTimeZone = false,
        },

        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,

        // TableRows must include between 3 and 8 PriceTableRow
        TableRows = new PriceTableRow[]
        {
            // Each PriceTableRow is mapped to columns with suffix 1..8. 
            // This example shows 3 price table rows i.e., with column suffix from 1..3
            new PriceTableRow
            {
                // 'Currency Code 1' column header in the Bulk file
                CurrencyCode = "USD",
                // 'Price Description 1' column header in the Bulk file
                Description = "Come to the new event",
                // 'Final Url 1' column header in the Bulk file
                FinalUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://www.contoso.com/womenshoesale"
                },
                // 'Final Mobile Url 1' column header in the Bulk file
                FinalMobileUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://mobile.contoso.com/womenshoesale"
                },
                // 'Header 1' column header in the Bulk file
                Header = "New Event",
                // 'Price 1' column header in the Bulk file
                Price = 9.99,
                // 'Price Qualifier 1' column header in the Bulk file
                PriceQualifier = PriceQualifier.From,
                // 'Price Unit 1' column header in the Bulk file
                PriceUnit = PriceUnit.PerDay,
            },
            new PriceTableRow
            {
                // 'Currency Code 2' column header in the Bulk file
                CurrencyCode = "USD",
                // 'Price Description 2' column header in the Bulk file
                Description = "Come to the next event",
                // 'Final Url 2' column header in the Bulk file
                FinalUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://www.contoso.com/womenshoesale"
                },
                // 'Final Mobile Url 2' column header in the Bulk file
                FinalMobileUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://mobile.contoso.com/womenshoesale"
                },
                // 'Header 2' column header in the Bulk file
                Header = "Next Event",
                // 'Price 2' column header in the Bulk file
                Price = 9.99,
                // 'Price Qualifier 2' column header in the Bulk file
                PriceQualifier = PriceQualifier.From,
                // 'Price Unit 2' column header in the Bulk file
                PriceUnit = PriceUnit.PerDay,
            },
            new PriceTableRow
            {
                // 'Currency Code 3' column header in the Bulk file
                CurrencyCode = "USD",
                // 'Price Description 3' column header in the Bulk file
                Description = "Come to the final event",
                // 'Final Url 3' column header in the Bulk file
                FinalUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://www.contoso.com/womenshoesale"
                },
                // 'Final Mobile Url 3' column header in the Bulk file
                FinalMobileUrls = new[] {
                    // Each Url is delimited by a semicolon (;) in the Bulk file
                    "https://mobile.contoso.com/womenshoesale"
                },
                // 'Header 3' column header in the Bulk file
                Header = "Final Event",
                // 'Price 3' column header in the Bulk file
                Price = 9.99,
                // 'Price Qualifier 3' column header in the Bulk file
                PriceQualifier = PriceQualifier.From,
                // 'Price Unit 3' column header in the Bulk file
                PriceUnit = PriceUnit.PerDay,
            },
        },
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
};

uploadEntities.Add(bulkPriceAdExtension);

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

Agenda de Anúncios

A lista de intervalos de dia e hora que pretende que a extensão de anúncios seja apresentada com os seus anúncios. Cada dia e intervalo de tempo inclui o dia agendado da semana, a hora de início/fim e o minuto de início/fim. Cada dia e intervalo de tempo é colocado entre parênteses esquerdo e direito e separado de outros intervalos de dia e hora com um delimitador de ponto e vírgula (;). Dentro de cada dia e intervalo de tempo, o formato é Day[StartHour:StartMinue-EndHour:EndMinute].

Os valores possíveis de StartHour variam entre 00 e 23, em que 00 é equivalente a 00:00 e 12 é 12:00PM.

Os valores possíveis de EndHour variam entre 00 e 24, em que 00 é equivalente a 12:00 E 12 é 12:00PM.

Os valores possíveis de StartMinute e EndMinute variam entre 00 e 60.

O exemplo seguinte demonstra os intervalos de dias e horas durante os dias úteis das 9:00 às 21:00: (Segunda-feira[09:00-21:00]);( Terça-feira[09:00-21:00]); (Quarta-feira[09:00-21:00]); (Quinta-feira[09:00-21:00]); (Sexta-feira[09:00-21:00])

Adicionar: Opcional. Se não definir este campo, a extensão de anúncios será elegível para agendamento em qualquer altura durante as datas de início e de fim do calendário.
Atualização: Opcional. Não é possível atualizar os intervalos de dia e de tempo individuais. Pode atualizar efetivamente os intervalos de dia e hora ao enviar um novo conjunto que deve substituir o conjunto anterior. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
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 de Moeda (1-8)

O ficheiro em massa inclui até 8 colunas de código de moeda, ou seja, uma para cada item de tabela de preços na extensão de anúncio. Os cabeçalhos de coluna do ficheiro em massa são Código de Moeda 1, Código de Moeda 2, Código de Moeda 3, Código de Moeda 4, Código de Moeda 5, Código de Moeda 6, Código de Moeda 7 e Código de Moeda 8.

Os códigos de moeda suportados são ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, GBP, HKD, INR, MXN, NZD, PEN, PHP, PLN, SEK, SGD, USD, TWD e VEF.

Tem de ter entre 3 e 8 itens de tabela de preços por extensão de anúncio de preço. A ordem pela qual as cria é a ordem esperada no anúncio, mas a encomenda não é garantida. Todos os itens de tabela de preços de uma extensão de anúncio de preço têm de estar no mesmo registo de ficheiro em massa. Cada item da tabela de preços é mapeado para o mesmo índice das colunas Código de Moeda, Url Móvel Final, Url Final, Cabeçalho, Preço, Descrição do Preço, Unidade de Preço e Qualificador de Preço . Por exemplo, o primeiro item da tabela de preços está mapeado para as colunas Código de Moeda 1, Url Móvel Final 1, Url Final 1, Cabeçalho 1, Preço 1, Descrição do Preço 1, Unidade de Preço 1 e Qualificador de Preço 1 .

Adicionar: Necessário
Atualização: Necessário
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 três primeiros pares de chave e valor personalizados que incluir e quaisquer parâmetros personalizados adicionais serão ignorados. Para os clientes no piloto de Aumento do Limite de Parâmetros Personalizados Fase 3 (GetCustomerPilotFeatures devolve 635), o Microsoft Advertising aceitará os primeiros oito pares de chave e valor personalizados incluídos 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 200 bytes UTF-8. Para os clientes no piloto de Aumento do Limite de Parâmetros Personalizados Fase 3 (GetCustomerPilotFeatures devolve 635), o Limite de valores aumenta para 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, a definição anterior será removida.
Eliminar: Só de leitura

Localização Editorial

O componente ou propriedade da extensão de anúncio que falhou na revisão editorial.

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

Código do Motivo Editorial

Um código que identifica o motivo da falha. Para obter uma lista de possíveis códigos de motivos, consulte Códigos de Razão Editoriais.

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

Estado Editorial

O estado editorial da extensão de anúncios.

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

Valor Descrição
Ativo A extensão de anúncios passou na revisão editorial.
ActiveLimited A extensão de anúncios aprovou uma revisão editorial em um ou mais mercados, e um ou mais elementos da extensão de anúncios estão a ser analisados editorialmente noutro mercado. Por exemplo, a extensão de anúncios passou na revisão editorial para o Canadá e ainda está pendente de revisão no Estados Unidos.
Reprovado A extensão de anúncio falhou na revisão editorial.
Inativo Um ou mais elementos da extensão de anúncios estão a ser submetidos a uma revisão editorial.

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

Termo Editorial

O termo que falhou na revisão editorial.

Este campo não será definido se uma combinação de termos tiver causado a falha ou se a falha tiver sido baseada numa violação de política.

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

Data de Fim

A cadeia de data de fim agendada da extensão de anúncio formatada como MM/DD/AAAA.

A data de fim é inclusiva. Por exemplo, se definir este campo como 31/12/2020, as extensões de anúncio deixarão de ser apresentadas às 23:59 a 31/12/2020.

Adicionar: Opcional. Se não especificar uma data de fim, a extensão de anúncios continuará a ser entregue, a menos que coloque em pausa as campanhas, grupos de anúncios ou anúncios associados.
Atualização: Opcional. A data de fim pode ser abreviada ou prolongada, desde que a data de início seja nula ou ocorra antes da nova data de fim. Se definir este campo para a cadeia de delete_value , está efetivamente a remover a data de fim. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
Eliminar: Só de leitura

URL Móvel Final (1-8)

O ficheiro em massa inclui até 8 colunas finais de URL móvel, ou seja, uma para cada item de tabela de preços na extensão de anúncio. Os cabeçalhos das colunas de ficheiros em massa são Url 1, Url Móvel Final 2, Url Final mobile 3, Url Móvel Final 4, Url Móvel Final 5, Url Móvel Final 6, Url Móvel Final 7 e Url Móvel Final 8.

As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais.

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

  • Pode especificar até 10 itens para URLs Finais e URLs Móveis Finais; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento.

  • Cada URL é delimitado por um ponto e vírgula e espaço ("; ").

  • A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo "{lpurl}".

  • Cada URL tem de ser um URL bem formado, começando com http:// ou https://.

  • Se especificar URLs Finais para Dispositivos Móveis, também tem de especificar Url Final.

Tem de ter entre 3 e 8 itens de tabela de preços por extensão de anúncio de preço. A ordem pela qual as cria é a ordem esperada no anúncio, mas a encomenda não é garantida. Todos os itens de tabela de preços de uma extensão de anúncio de preço têm de estar no mesmo registo de ficheiro em massa. Cada item da tabela de preços é mapeado para o mesmo índice das colunas Código de Moeda, Url Móvel Final, Url Final, Cabeçalho, Preço, Descrição do Preço, Unidade de Preço e Qualificador de Preço . Por exemplo, o primeiro item da tabela de preços está mapeado para as colunas Código de Moeda 1, Url Móvel Final 1, Url Final 1, Cabeçalho 1, Preço 1, Descrição do Preço 1, Unidade de Preço 1 e Qualificador de Preço 1 .

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

URL Final (1-8)

O ficheiro em massa inclui até 8 colunas de URL finais, ou seja, uma para cada item de tabela de preços na extensão de anúncio. Os cabeçalhos de coluna do ficheiro em massa são Url Final 1, Url Final 2, Url Final 3, Url Final 4, Url Final 5, Url Final 6, Url Final 7 e Url Final 8.

O URL da página de destino a utilizar com o modelo de controlo opcional e os parâmetros personalizados.

As seguintes regras de validação aplicam-se a URLs Finais e URLs Móveis Finais.

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

  • Pode especificar até 10 itens para URLs Finais e URLs Móveis Finais; no entanto, apenas o primeiro item em cada lista é utilizado para entrega. O serviço permite até 10 para potencial compatibilidade de reencaminhamento.

  • Cada URL é delimitado por um ponto e vírgula e espaço ("; ").

  • A utilização de '{' e '}' só tem permissão para delinear etiquetas, por exemplo "{lpurl}".

  • Cada URL tem de ser um URL bem formado, começando com http:// ou https://.

  • Se especificar URLs Finais para Dispositivos Móveis, também tem de especificar Url Final.

Tenha também em atenção que, se os campos Modelo de Controlo ou Parâmetro Personalizado estiverem definidos, o URL final é necessário para cada item de tabela de preços.

Tem de ter entre 3 e 8 itens de tabela de preços por extensão de anúncio de preço. A ordem pela qual as cria é a ordem esperada no anúncio, mas a encomenda não é garantida. Todos os itens de tabela de preços de uma extensão de anúncio de preço têm de estar no mesmo registo de ficheiro em massa. Cada item da tabela de preços é mapeado para o mesmo índice das colunas Código de Moeda, Url Móvel Final, Url Final, Cabeçalho, Preço, Descrição do Preço, Unidade de Preço e Qualificador de Preço . Por exemplo, o primeiro item da tabela de preços está mapeado para as colunas Código de Moeda 1, Url Móvel Final 1, Url Final 1, Cabeçalho 1, Preço 1, Descrição do Preço 1, Unidade de Preço 1 e Qualificador de Preço 1 .

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

O cabeçalho que precede os dados de preços na sua extensão de anúncio de preço. Cada cabeçalho pode conter um máximo de 25 carateres. Cada cabeçalho tem de ligar diretamente ao campo Tipo de Extensão de Preço para a extensão de anúncio de preço.

O ficheiro em massa inclui até 8 colunas de cabeçalho, ou seja, uma para cada item de tabela de preços na extensão de anúncio. Os cabeçalhos das colunas do ficheiro em massa são Cabeçalho 1, Cabeçalho 2, Cabeçalho 3, Cabeçalho 4, Cabeçalho 5, Cabeçalho 6, Cabeçalho 7 e Cabeçalho 8.

Tem de ter entre 3 e 8 itens de tabela de preços por extensão de anúncio de preço. A ordem pela qual as cria é a ordem esperada no anúncio, mas a encomenda não é garantida. Todos os itens de tabela de preços de uma extensão de anúncio de preço têm de estar no mesmo registo de ficheiro em massa. Cada item da tabela de preços é mapeado para o mesmo índice das colunas Código de Moeda, Url Móvel Final, Url Final, Cabeçalho, Preço, Descrição do Preço, Unidade de Preço e Qualificador de Preço . Por exemplo, o primeiro item da tabela de preços está mapeado para as colunas Código de Moeda 1, Url Móvel Final 1, Url Final 1, Cabeçalho 1, Preço 1, Descrição do Preço 1, Unidade de Preço 1 e Qualificador de Preço 1 .

Adicionar: Necessário
Atualização: Necessário
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.

Nota

Esta funcionalidade só está disponível para clientes no piloto Fase 3 do Sufixo de URL Final (GetCustomerPilotFeatures devolve 636). Se não estiver no piloto, esta propriedade será ignorada e não será devolvido nenhum erro.

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

ID

O identificador gerado pelo sistema da extensão de anúncios.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificador negativo para a extensão de anúncios pode, em seguida, ser referenciado no campo ID de tipos de registo dependentes, como Extensão do Anúncio do Preço do Grupo do Ad e Extensão do Anúncio do Preço da Campanha. Isto é recomendado se estiver a adicionar novas extensões de anúncios e novos registos dependentes no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Idioma

O idioma da cópia de anúncios da sua extensão de anúncio de preço.

Para obter valores possíveis, veja Idiomas de Anúncios.

Adicionar: Necessário
Atualização: Necessário
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

ID principal

O identificador gerado pelo sistema da conta que contém a extensão de anúncios.

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

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

Preço (1-8)

O preço que está a anunciar.

O ficheiro em massa inclui até 8 colunas de preços, ou seja, uma para cada item de tabela de preços na extensão de anúncio. Os cabeçalhos das colunas de ficheiros em massa são Preço 1, Preço 2, Preço 3, Preço 4, Preço 5, Preço 6, Preço 7 e Preço 8.

Tem de ter entre 3 e 8 itens de tabela de preços por extensão de anúncio de preço. A ordem pela qual as cria é a ordem esperada no anúncio, mas a encomenda não é garantida. Todos os itens de tabela de preços de uma extensão de anúncio de preço têm de estar no mesmo registo de ficheiro em massa. Cada item da tabela de preços é mapeado para o mesmo índice das colunas Código de Moeda, Url Móvel Final, Url Final, Cabeçalho, Preço, Descrição do Preço, Unidade de Preço e Qualificador de Preço . Por exemplo, o primeiro item da tabela de preços está mapeado para as colunas Código de Moeda 1, Url Móvel Final 1, Url Final 1, Cabeçalho 1, Preço 1, Descrição do Preço 1, Unidade de Preço 1 e Qualificador de Preço 1 .

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

Descrição do Preço (1-8)

A descrição tem de fornecer mais informações sobre o cabeçalho que também está definido neste objeto. Cada descrição pode conter um máximo de 25 carateres.

O ficheiro em massa inclui até 8 colunas de descrição de preço, ou seja, uma para cada item de tabela de preços na extensão de anúncio. Os cabeçalhos de coluna de ficheiros em massa são Descrição do Preço 1, Descrição do Preço 2, Descrição do Preço 3, Descrição do Preço 4, Descrição do Preço 5, Descrição do Preço 6, Descrição do Preço 7 e Descrição do Preço 8.

Tem de ter entre 3 e 8 itens de tabela de preços por extensão de anúncio de preço. A ordem pela qual as cria é a ordem esperada no anúncio, mas a encomenda não é garantida. Todos os itens de tabela de preços de uma extensão de anúncio de preço têm de estar no mesmo registo de ficheiro em massa. Cada item da tabela de preços é mapeado para o mesmo índice das colunas Código de Moeda, Url Móvel Final, Url Final, Cabeçalho, Preço, Descrição do Preço, Unidade de Preço e Qualificador de Preço . Por exemplo, o primeiro item da tabela de preços está mapeado para as colunas Código de Moeda 1, Url Móvel Final 1, Url Final 1, Cabeçalho 1, Preço 1, Descrição do Preço 1, Unidade de Preço 1 e Qualificador de Preço 1 .

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

Tipo de Extensão de Preço

O tipo da extensão de anúncio de preço.

Os valores possíveis incluem: Marcas, Eventos, Localizações, Bairros, ProductCategories, ProductTiers, ServiceCategories, Serviços, ServiceTiers e Desconhecido. (Desconhecido está reservado para utilização futura e não pode ser definido.)

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

Qualificador de Preço (1-8)

O qualificador de preço para um determinado produto ou serviço, por exemplo, a partir de um preço específico e até um preço máximo.

Os valores possíveis incluem: Average, From, UpTo, None e Unknown. (Desconhecido está reservado para utilização futura e não pode ser definido.)

O ficheiro em massa inclui até 8 colunas de qualificação de preço, ou seja, uma para cada item de tabela de preços na extensão de anúncio. Os cabeçalhos das colunas de ficheiros em massa são Qualificador de Preço 1, Qualificador de Preço 2, Qualificador de Preço 3, Qualificador de Preço 4, Qualificador de Preço 5, Qualificador de Preço 6, Qualificador de Preço 7 e Qualificador de Preço 8.

Tem de ter entre 3 e 8 itens de tabela de preços por extensão de anúncio de preço. A ordem pela qual as cria é a ordem esperada no anúncio, mas a encomenda não é garantida. Todos os itens de tabela de preços de uma extensão de anúncio de preço têm de estar no mesmo registo de ficheiro em massa. Cada item da tabela de preços é mapeado para o mesmo índice das colunas Código de Moeda, Url Móvel Final, Url Final, Cabeçalho, Preço, Descrição do Preço, Unidade de Preço e Qualificador de Preço . Por exemplo, o primeiro item da tabela de preços está mapeado para as colunas Código de Moeda 1, Url Móvel Final 1, Url Final 1, Cabeçalho 1, Preço 1, Descrição do Preço 1, Unidade de Preço 1 e Qualificador de Preço 1 .

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

Unidade de Preço (1-8)

A unidade de preço permite-lhe especificar o custo em termos de hora, dia, semana, etc.

Os valores possíveis incluem: PerDay, PerHour, PerMonth, PerNight, PerWeek, PerYear, None e Unknown. (Desconhecido está reservado para utilização futura e não pode ser definido.)

O ficheiro em massa inclui até 8 colunas de unidade de preço, ou seja, uma para cada item de tabela de preços na extensão de anúncio. Os cabeçalhos de coluna de ficheiros em massa são Unidade de Preço 1, Unidade de Preço 2, Unidade de Preço 3, Unidade de Preço 4, Unidade de Preço 5, Unidade de Preço 6, Unidade de Preço 7 e Unidade de Preço 8.

Tem de ter entre 3 e 8 itens de tabela de preços por extensão de anúncio de preço. A ordem pela qual as cria é a ordem esperada no anúncio, mas a encomenda não é garantida. Todos os itens de tabela de preços de uma extensão de anúncio de preço têm de estar no mesmo registo de ficheiro em massa. Cada item da tabela de preços é mapeado para o mesmo índice das colunas Código de Moeda, Url Móvel Final, Url Final, Cabeçalho, Preço, Descrição do Preço, Unidade de Preço e Qualificador de Preço . Por exemplo, o primeiro item da tabela de preços está mapeado para as colunas Código de Moeda 1, Url Móvel Final 1, Url Final 1, Cabeçalho 1, Preço 1, Descrição do Preço 1, Unidade de Preço 1 e Qualificador de Preço 1 .

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

Países do Publisher

A lista de países ou regiões publicadores cujas diretrizes editoriais não permitem o termo especificado.

Num ficheiro em massa, a lista de países ou regiões do publicador é delimitada com um ponto e vírgula (;).

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

Data de Início

A cadeia de data de início agendada da extensão de anúncio formatada como MM/DD/AAAA.

A data de início é inclusiva. Por exemplo, se definir StartDate como 5/05/2020, as extensões de anúncios começarão a ser apresentadas às 00:00 a 5/05/2020.

Adicionar: Opcional. Se não especificar uma data de início, a extensão de anúncio é imediatamente elegível para ser agendada.
Atualização: Opcional. A data de início pode ser abreviada ou prolongada, desde que a data de fim seja nula ou ocorra após a nova data de início. Se definir este campo para a cadeia de delete_value , está efetivamente a remover a data de início e a extensão de anúncio é imediatamente elegível para ser agendada. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
Eliminar: Só de leitura

Estado

O estado da extensão de anúncios.

Os valores possíveis são Ativos ou Eliminados.

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: Obrigatório. O Estado tem de ser definido como Eliminado.

Modelo de Controlo

O modelo de controlo a utilizar para os URLs dos itens da tabela de preços.

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, a definição anterior será removida.
Eliminar: Só de leitura

Utilizar Fuso Horário do Searcher

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 as extensões de anúncios sejam apresentadas no fuso horário do utilizador de pesquisa 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 o fuso horário da conta será utilizado.
Atualização: Opcional. Se definir este campo para a cadeia de delete_value, está efetivamente a repor para o valor predefinido falso. Os campos Agenda de Anúncios, Data de Fim, Data de Início e Utilizar Fuso Horário do Searcher dependem uns dos outros e são atualizados em conjunto. Se deixar todos estes campos vazios durante a atualização, nenhum deles será atualizado. Se incluir valores para qualquer um destes campos, os valores anteriores para todos estes campos serão removidos ou substituídos. Para remover todas as definições de agendamento anteriores, defina cada um destes campos como delete_value.
Eliminar: Só de leitura

Versão

O número de vezes que o conteúdo da extensão de anúncios foi atualizado. A versão é definida como 1 quando adiciona a extensão e é incrementada sempre que é revista.

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