Partilhar via

Registo de Anúncios de Pesquisa Dinâmica - Em Massa

  • Artigo

Define um anúncio de pesquisa dinâmico que pode ser transferido e carregado num ficheiro em massa.

Com os anúncios de pesquisa dinâmicos, o URL de manchete e apresentação é gerado automaticamente com base no domínio e idioma do site que pretende direcionar. A combinação dos elementos Path1, Path2 e Text torna o anúncio de pesquisa dinâmica exclusivo. Opcionalmente, pode fornecer um cabeçalho estático através de feeds de página.

Nota

Esta funcionalidade está atualmente disponível nos seguintes países: Albânia (AL), Andorra (AD), Argentina (AR), Aruba, Austrália (AU), Áustria (AT), Bahamas (BS), Bangladesh(BD), Bélgica (BE), Bolívia(BO), Bósnia e Herzegovina (BA), Brasil (BR), Brunei(BN), Bulgária (BG), Canadá (CA), Ilhas Caimão(KY), Chile(CL), Colômbia(CO), Costa Rica(CR), Croácia (RH), Chipre (CY), República Checa (CZ), Dinamarca (DK), Dominica(DM), República Dominicana(DO), Equador(EC), El Salvador(SV), Estónia (EE), Fiji (FJ), Finlândia (FI), França (FR), Guiana Francesa(GF), Polinésia Francesa (PF), Alemanha (DE), Grécia (DE), Grécia (GR), Guam (GU), Guatemala (GT), Guiana (GY), Haiti (HT), Honduras (HN), Hungria (HU), Islândia (IS), Índia (IN), Indonésia (ID), Irlanda (IE), Itália (IT), Letónia (LV), Liechtenstein (LI), Lituânia (LT), Luxemburgo (LU), Malásia (MY), Maldivas (MV), Malta (MT), Martinica (MQ), México (MX), Mónaco (MC), Mongólia (MN), Montenegro (ME), Montserrat (MS), Nepal (NP), Países Baixos (NL), Novo Caledónia (NC), Nova Zelândia (NZ), República da Macedónia do Norte (MK), Noruega (NO), Panamá (PA), Paraguai (PY), Papua Nova Guiné (PG), Peru (PE), Filipinas (PH), Polónia (PO), Portugal (PT), Porto Rico, Roménia (RO), São Marino (SM), Sérvia (RS), Singapura(SG), Eslováquia (SK), Eslovénia (SI), África do Sul (ZA), Espanha (ES), Espanha(ES), Sri Lanka(LK), Suécia (SE), Suíça () CH), Tailândia(TH), Trinidad e Tobago(TT), Türkiye (TR), Cidade do Vaticano (VA), Vietname(VN), Reino Unido (Reino Unido), Estados Unidos (EUA), Uruguai (UY) e Venezuela(VE).

O registo do AD de Pesquisa Dinâmica só pode ser criado em campanhas de pesquisa que tenham definições de anúncios de pesquisa dinâmica válidas (compostas pelos campos Idioma de Domínio, Descrição Dinâmica Ativada, IDs do Feed de Páginas, Origem e Site ). O ID de Experimentação da campanha tem de ser definido e o Tipo de Grupo de Anúncios tem de ser definido como "SearchDynamic".

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.

Pode transferir todos os registos do Dynamic Search Ad na conta ao incluir o valor DownloadEntity de DynamicSearchAds 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 pesquisa dinâmica 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,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,,
Dynamic Search Ad,Active,,-1113,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,,,,,,,,,,,,{_promoCode}=PROMO1; {_season}=summer,,,seattle,shoe sale

Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo ao utilizar o BulkServiceManager para carregar e transferir o objeto BulkDynamicSearchAd , 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 BulkDynamicSearchAd
var bulkDynamicSearchAd = new BulkDynamicSearchAd
{
    // '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 
    // DynamicSearchAd object of the Campaign Management service.
    DynamicSearchAd = new DynamicSearchAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Path 1' column header in the Bulk file
        Path1 = "seattle",
        // 'Path 2' column header in the Bulk file
        Path2 = "shoe sale",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // '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(bulkDynamicSearchAd);

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

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

Para um registo do AD de Pesquisa Dinâmica , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa. A combinação dos campos Caminho 1, Caminho 2 e Texto torna o anúncio de pesquisa dinâmica exclusivo.

Grupo de Anúncios

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

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

Nota

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

Campanha

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

Adicionar: Só de leitura
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

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

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: Só de leitura
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: 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 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: 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

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 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 Pesquisa Dinâmica. 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

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 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: Só de leitura e Obrigatório. Tem de especificar um identificador de grupo de anúncios existente ou especificar um identificador negativo que seja igual ao campo ID do registo do Grupo de Anúncios principal. Isto é recomendado se estiver a adicionar novos anúncios a um novo grupo de anúncios 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
Eliminar: Só de leitura

Nota

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

Caminho 1

A primeira parte do caminho opcional que será anexada à parte do domínio do URL de apresentação. O URL de apresentação, por exemplo , www.contoso.com será gerado a partir do domínio do URL de apresentação. Em seguida, se tiver especificado um valor para o Caminho 1 , será acrescentado ao URL de apresentação. Se também tiver especificado um valor para o Caminho 2, também será acrescentado ao URL de apresentação após o Caminho 1. Por exemplo, se o seu domínio estiver contoso.com, o Caminho 1 está definido como subdiretório1 e o Caminho 2 está definido como subdiretório2, o URL apresentado será www.contoso.com/subdirectory1/subdirectory2.

O comprimento máximo de entrada do caminho é de 15 carateres. Tenha em atenção que para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada do caminho é de 7 carateres.

O caminho pode conter funções SE e contagem decrescente . Independentemente do comprimento total de todos os parâmetros de contagem decrescente sem título, a contagem decrescente apresentada final utilizará sempre 8 carateres do total de carateres disponíveis. Para obter mais detalhes, veja Personalizadores de Contagem Decrescente.

O caminho não pode conter os carateres de barra (/) ou newline (\n).

Se o caminho incluir um espaço, será substituído por um caráter de sublinhado (_) quando o anúncio for apresentado.

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

Caminho 2

A segunda parte do caminho opcional que será anexada à parte do domínio do URL de apresentação. O URL de apresentação, por exemplo , www.contoso.com será gerado a partir do domínio das definições de nível de campanha de anúncios de pesquisa dinâmica. Em seguida, se tiver especificado um valor para o Caminho 1 , será acrescentado ao URL de apresentação. Se também tiver especificado um valor para o Caminho 2, também será acrescentado ao URL de apresentação após o Caminho 1. Por exemplo, se o seu domínio estiver contoso.com, o Caminho 1 está definido como subdiretório1 e o Caminho 2 está definido como subdiretório2, o URL apresentado será www.contoso.com/subdirectory1/subdirectory2.

Só pode especificar o Caminho 2 se o Caminho 1 também estiver definido.

O comprimento máximo de entrada do caminho é de 15 carateres. Tenha em atenção que para idiomas com carateres de largura dupla, por exemplo, chinês tradicional, o comprimento máximo de entrada do caminho é de 7 carateres.

O caminho pode conter funções SE e contagem decrescente . Independentemente do comprimento total de todos os parâmetros de contagem decrescente sem título, a contagem decrescente apresentada final utilizará sempre 8 carateres do total de carateres disponíveis. Para obter mais detalhes, veja Personalizadores de Contagem Decrescente.

O caminho não pode conter os carateres de barra (/) ou newline (\n). Se o caminho incluir um espaço, será substituído por um caráter de sublinhado (_) quando o anúncio for apresentado.

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

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

Estado

O estado do anúncio.

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

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.

Text

A primeira parte da descrição do anúncio.

O texto tem de conter, pelo menos, uma palavra.

O comprimento máximo de entrada da cópia é de 90 carateres. 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 45 carateres.

O texto pode conter funções SE e contagem decrescente . Independentemente do comprimento total de todos os parâmetros de contagem decrescente sem título, a contagem decrescente apresentada final utilizará sempre 8 carateres do total de carateres disponíveis. Para obter mais detalhes, veja Personalizadores de Contagem Decrescente.

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

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

Texto Parte 2

A segunda parte da descrição do anúncio.

O texto tem de conter, pelo menos, uma palavra.

O comprimento máximo de entrada da cópia é de 90 carateres. 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 45 carateres.

O texto pode conter funções SE e contagem decrescente . Independentemente do comprimento total de todos os parâmetros de contagem decrescente sem título, a contagem decrescente apresentada final utilizará sempre 8 carateres do total de carateres disponíveis. Para obter mais detalhes, veja Personalizadores de Contagem Decrescente.

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

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

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