Partilhar via

Registo de Anúncios de Texto - Em Massa

  • Artigo

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

Importante

A partir de abril de 2020, a entrega de anúncios de texto em standart (STA) não é suportada.

Os Anúncios de Texto Padrão foram preteridos a favor de Anúncios de Texto Expandido (EXTAs). O suporte para adicionar e atualizar anúncios de texto padrão (STAs) terminou a 31 de julho de 2017. Agora, os anunciantes podem obter e eliminar, mas já não podem adicionar novas STAs ou atualizar anúncios de texto padrão existentes. Uma exceção à regra é que ainda pode atualizar o estado STA, por exemplo, de Ativo para Em Pausa. Caso contrário, as tentativas de adicionar ou atualizar STAs resultarão no erro CampaignServiceAdTypeInvalid .

Pode transferir todos os registos de Anúncios de Texto na conta ao incluir o valor DownloadEntity de TextAds 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 um novo anúncio de texto se fosse fornecido um valor de ID Principal válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Text Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,contoso.com,,,All,False,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,{_promoCode}=PROMO1; {_season}=summer,,,,

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 BulkTextAd , 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 BulkTextAd
var bulkTextAd = new BulkTextAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // TextAd object of the Campaign Management service.
    TextAd = new TextAd
    {
        // 'Ad Format Preference' column header in the Bulk file
        AdFormatPreference = "All",
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Device Preference' column header in the Bulk file
        DevicePreference = 0,
        // 'Display Url' column header in the Bulk file
        DisplayUrl = "contoso.com",
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/womenshoesale"
        },
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/womenshoesale"
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales!",
        // 'Title' column header in the Bulk file
        Title = "Contoso Quick Setup",
        // '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(bulkTextAd);

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

Preferência de Formato de Anúncio

O campo Preferência de Formato de Anúncio é utilizado para indicar se prefere ou não que a cópia de anúncio seja apresentada aos utilizadores como um anúncio de pesquisa ou audiência. Os anúncios de pesquisa tendem a ser escritos como uma chamada à ação, enquanto os anúncios de audiência devem ser escritos num estilo mais informativo. Embora tenha a opção de utilizar anúncios de texto de pesquisa como anúncios de audiência, designar um anúncio como formato preferencial de anúncios de Audiência permite-lhe otimizar as mensagens para entrega nativa.

Importante

Tem de definir pelo menos um anúncio de texto por grupo de anúncios que não prefira anúncios de audiência. Caso contrário, a cópia de anúncios de todos os anúncios de texto será elegível para anúncios de pesquisa e audiência.

Os valores possíveis são Audience Ad e All. Se estiver definido como Tudo, o anúncio será elegível para os formatos de anúncio de pesquisa e audiência. Se estiver definido como Anúncio de Audiência, o anúncio só será elegível para o formato de anúncio de audiência.

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

Grupo de Anúncios

O nome do grupo de anúncios que contém o anúncio.

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

Nota

Para atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

Campanha

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

Adicionar: Não suportado
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: Não suportado
Atualização: Opcional
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: Não suportado
Atualização: Não suportado
Eliminar: Só de leitura

Preferência do Dispositivo

Este campo determina se a preferência é que os anúncios de texto sejam apresentados em todos os dispositivos ou apenas em dispositivos móveis.

Os valores possíveis são All e Mobile, que diferem dos valores utilizados no serviço de gestão de campanhas.

O valor predefinido é Tudo.

No ficheiro de transferência e carregamento de resultados em massa, este campo nunca estará vazio. Se não tiver especificado uma preferência de dispositivo, será devolvido o valor predefinido de Todos .

Importante

Tem de definir pelo menos um anúncio de texto por grupo de anúncios que não seja preferencial para dispositivos móveis. Caso contrário, a cópia de anúncios de todos os anúncios de texto será elegível para todos os dispositivos.

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

Apresentar URL

O URL a apresentar no anúncio.

O subdiretório do URL de apresentação pode conter cadeias de texto dinâmicas, como {keyword}; no entanto, o nome do anfitrião do URL não pode conter texto dinâmico. Para obter mais informações, consulte o artigo Ajuda do Microsoft Advertising Personalizar automaticamente os seus anúncios com parâmetros de texto dinâmicos.

O comprimento máximo de entrada do URL é de 200 carateres e pode conter cadeias de texto dinâmicas. No entanto, o anúncio não será apresentado se o URL exceder os 35 carateres após a substituição de texto dinâmico ocorrer.

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

Estatuto de Recurso Editorial

Determina se pode recorrer das questões encontradas pela revisão editorial.

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

Valor Descrição
Apelativo A questão editorial é apelativa.
Recurso Pendente A questão editorial é recorrida e foi apresentado um recurso.
Não Aplicável A questão editorial não é apelativa.

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

Localização Editorial

O componente ou propriedade do anúncio que falhou na revisão editorial.

Adicionar: Não suportado
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: Não suportado
Atualização: Só de leitura
Eliminar: Só de leitura

Estado Editorial

O estado editorial do anúncio.

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

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

Adicionar: Não suportado
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: Não suportado
Atualização: Só de leitura
Eliminar: Só de leitura

Final Url

O URL da página de destino.

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, é necessário, pelo menos, um URL Final.

Nota

Este URL é utilizado apenas se a palavra-chave não especificar um URL final.

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

ID

O identificador gerado pelo sistema do anúncio.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificador negativo para o anúncio pode, em seguida, ser referenciado no campo ID Principal de tipos de registo dependentes, como Etiqueta de Anúncio de Texto. Isto é recomendado se estiver a adicionar novos 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

Url Final do Dispositivo Móvel

O URL da página de destino móvel.

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.

Nota

Este URL só é utilizado se a palavra-chave não especificar um Url Final móvel.

Adicionar: Não suportado
Atualização: Não suportado
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: Não suportado
Atualização: Só de leitura
Eliminar: Só de leitura

ID principal

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

Este campo em massa mapeia para o campo ID do registo do Grupo de Anúncios .

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

Nota

Para atualizar e eliminar, tem de especificar o campo ID Principal ou Grupo de Anúncios .

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: Não suportado
Atualização: Só de leitura
Eliminar: Só de leitura

Estado

O estado do anúncio.

Os valores possíveis são Ativo, Em Pausa ou Eliminado.

Adicionar: Não suportado
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.

Text

A cópia de anúncios.

O texto tem de conter pelo menos uma palavra e pode conter cadeias de texto dinâmicas, como {keyword}. Para obter mais informações, consulte o artigo Ajuda do Microsoft Advertising Personalizar automaticamente os seus anúncios com parâmetros de texto dinâmicos.

O comprimento máximo de entrada da cópia é de 300 carateres e pode conter cadeias de texto dinâmicas. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder os 80 carateres após a substituição de texto dinâmico ocorrer. Tenha em atenção que para grupos de anúncios que utilizam chinês tradicional, o comprimento máximo de entrada da cópia é de 150 carateres e o texto está limitado a 40 carateres após a substituição.

O texto não pode conter o caráter newline (\n).

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

Cargo

O título do anúncio.

O título tem de conter, pelo menos, uma palavra. A cópia e o título combinados do anúncio têm de ter, pelo menos, três palavras.

O título pode conter cadeias de texto dinâmicas, como {keyword}. Para obter mais informações, consulte o artigo Ajuda do Microsoft Advertising Personalizar automaticamente os seus anúncios com parâmetros de texto dinâmicos.

O comprimento máximo de entrada do título é de 80 carateres e pode conter cadeias de texto dinâmicas. O anúncio não será apresentado ou o texto predefinido será utilizado se o comprimento exceder os 25 carateres após a substituição de texto dinâmico ocorrer. Tenha em atenção que, para grupos de anúncios que utilizam chinês tradicional, o título está limitado a 15 carateres após a substituição.

O título não pode conter o caráter newline (\n).

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

Modelo de Controlo

O modelo de controlo a utilizar como predefinição para o URL especificado com FinalUrls.

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: Não suportado
Atualização: Não suportado
Eliminar: Só de leitura