Partilhar via

Registo de Destino de Pesquisa Dinâmica do Grupo de Anúncios do Ad - Em massa

  • Artigo

Define um Destino de Anúncios de Pesquisa Dinâmica do Grupo de Anúncios que pode ser carregado e transferido num ficheiro em massa.

O registo Ad Group Dynamic Search Ad Target 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".

Pode transferir todos os registos do Ad Group Dynamic Search Ad Target na conta ao incluir o valor DownloadEntity de AdGroupDynamicSearchAdTargets 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 destino de anúncios de pesquisa dinâmica do grupo de anúncios se for fornecido um valor de ID Principal válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Tracking Template,Custom Parameter,Dynamic Ad Target Condition 1,Dynamic Ad Target Condition 2,Dynamic Ad Target Condition 3,Dynamic Ad Target Value 1,Dynamic Ad Target Value 2,Dynamic Ad Target Value 3
Format Version,,,,,,,,,6.0,,,,,,,,
Ad Group Dynamic Search Ad Target,Paused,,-1113,,,ClientIdGoesHere,,0.5,Bulk Ad Group Dynamic Search Ad Target,,{_promoCode}=PROMO1; {_season}=summer,Url,Category,PageContent,contoso.com,US/CA/SFO,flowers

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 BulkAdGroupDynamicSearchAdTarget , 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 BulkAdGroupDynamicSearchAdTarget
var bulkAdGroupDynamicSearchAdTarget = new BulkAdGroupDynamicSearchAdTarget
{
    // Map properties in the Bulk file to the 
    // BiddableAdGroupCriterion object of the Campaign Management service.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new Webpage
        {
            Parameter = new WebpageParameter
            {
                // Set Conditions null if you want to target all webpages
                Conditions = new []
                {
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 1' column header in the Bulk file
                        Argument = "contoso.com",
                        // 'Dynamic Ad Target Condition 1' column header in the Bulk file
                        Operand = WebpageConditionOperand.Url
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 2' column header in the Bulk file
                        Argument = "US/CA/SFO",
                        // 'Dynamic Ad Target Condition 2' column header in the Bulk file
                        Operand = WebpageConditionOperand.Category
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 3' column header in the Bulk file
                        Argument = "flowers",
                        // 'Dynamic Ad Target Condition 3' column header in the Bulk file
                        Operand = WebpageConditionOperand.PageContent
                    },
                },
                // 'Name' column header in the Bulk file
                CriterionName = "Bulk Ad Group Dynamic Search Ad Target"
            }
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file
            Amount = 0.50
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // '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"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupDynamicSearchAdTarget);

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 Destino de Anúncios de Pesquisa Dinâmica do Grupo de Anúncios , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Grupo de Anúncios

O nome do grupo de anúncios que contém o destino de anúncio dinâmico (critério de página Web).

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 .

Licitação

O montante a licitar no leilão.

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

Campanha

O nome da campanha que contém o grupo de anúncios e o destino de anúncio dinâmico (critério de página Web).

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

Nota

Se não definir nenhum dos campos de valor, operador ou condição de destino de anúncio dinâmico, está a filtrar efetivamente todas as páginas Web.

Condição de Destino de Anúncio Dinâmico 1

O primeiro de até 3 operandos de condição de página Web. A condição é cumprida se a propriedade da página Web referenciada por este campo contiver ou for igual ao valor De Destino de Anúncio Dinâmico 1 .

Os valores possíveis incluem Categoria, CustomLabel, PageContent, PageTitle e Url.

Adicionar: Opcional. Se não definir nenhum dos campos de valor ou condição de destino de anúncio dinâmico, está efetivamente a filtrar todas as páginas Web. Só pode ter um destino de anúncio dinâmico por grupo de anúncios para todas as páginas Web.
Atualização: Não permitido. Não é possível atualizar os campos de valor ou condição de destino de anúncio dinâmico. Para atualizar as condições da página Web, tem de eliminar o destino de anúncio dinâmico e adicionar um novo.
Eliminar: Só de leitura

Condição de Destino de Anúncio Dinâmico 2

O segundo de até 3 operandos de condição de página Web. A condição é cumprida se a propriedade da página Web referenciada por este campo contiver ou for igual ao valor 2 do Valor de Destino do Anúncio Dinâmico .

Os valores possíveis incluem Categoria, CustomLabel, PageContent, PageTitle e Url.

Adicionar: Opcional. Se não definir nenhum dos campos de valor ou condição de destino de anúncio dinâmico, está efetivamente a filtrar todas as páginas Web. Só pode ter um destino de anúncio dinâmico por grupo de anúncios para todas as páginas Web.
Atualização: Não permitido. Não é possível atualizar os campos de valor ou condição de destino de anúncio dinâmico. Para atualizar as condições da página Web, tem de eliminar o destino de anúncio dinâmico e adicionar um novo.
Eliminar: Só de leitura

Condição de Destino de Anúncio Dinâmico 3

O terceiro de até 3 operandos de condição de página Web. A condição é cumprida se a propriedade da página Web referenciada por este campo contiver ou for igual ao valor De Destino de Anúncio Dinâmico 1 .

Os valores possíveis incluem Categoria, CustomLabel, PageContent, PageTitle e Url.

Adicionar: Opcional. Se não definir nenhum dos campos de valor ou condição de destino de anúncio dinâmico, está efetivamente a filtrar todas as páginas Web. Só pode ter um destino de anúncio dinâmico por grupo de anúncios para todas as páginas Web.
Atualização: Não permitido. Não é possível atualizar os campos de valor ou condição de destino de anúncio dinâmico. Para atualizar as condições da página Web, tem de eliminar o destino de anúncio dinâmico e adicionar um novo.
Eliminar: Só de leitura

Operador de Destino de Anúncio Dinâmico 1

O primeiro de até 3 operadores de condição de página Web. A condição é cumprida se a propriedade da página Web referenciada por este campo contiver ou for igual ao valor De Destino de Anúncio Dinâmico 1 .

Os valores possíveis incluem Contém e É Igual a.

Adicionar: Opcional. Se não definir nenhum dos campos de valor, operador ou condição de destino de anúncio dinâmico, está a filtrar efetivamente todas as páginas Web. Se definir a Condição de Destino de Anúncio Dinâmico 1 e não definir o Operador de Destino de Anúncio Dinâmico 1, utilizaremos o operador predefinido para o operando selecionado. Se quiser criar URL Igual a, o operador tem de ser transmitido. Atualização: Não permitido. Não é possível atualizar o operador de destino de anúncio dinâmico ou os campos de valor. Para atualizar as condições da página Web, tem de eliminar o destino de anúncio dinâmico e adicionar um novo.
Eliminar: Só de leitura

Operador de Destino de Anúncio Dinâmico 2

O segundo de até 3 operadores de condição de página Web. A condição é cumprida se a propriedade da página Web referenciada por este campo contiver ou for igual ao valor 2 do Valor de Destino do Anúncio Dinâmico .

Os valores possíveis incluem Contém e É Igual a.

Adicionar: Opcional. Se não definir nenhum dos campos de valor, operador ou condição de destino de anúncio dinâmico, está a filtrar efetivamente todas as páginas Web. Se definir a Condição de Destino de Anúncio Dinâmico21 e não definir o Operador de Destino de Anúncio Dinâmico 2, utilizaremos o operador predefinido para o operando selecionado. Se quiser criar URL Igual a, o operador tem de ser transmitido. Atualização: Não permitido. Não é possível atualizar o operador de destino de anúncio dinâmico ou os campos de valor. Para atualizar as condições da página Web, tem de eliminar o destino de anúncio dinâmico e adicionar um novo.
Eliminar: Só de leitura

Operador de Destino de Anúncio Dinâmico 3

O terceiro de até 3 operadores de condição de página Web. A condição é cumprida se a propriedade da página Web referenciada por este campo contiver ou for igual ao valor 3 do Valor de Destino do Anúncio Dinâmico .

Os valores possíveis incluem Contém e É Igual a.

Adicionar: Opcional. Se não definir nenhum dos campos de valor, operador ou condição de destino de anúncio dinâmico, está a filtrar efetivamente todas as páginas Web. Se definir a Condição de Destino de Anúncio Dinâmico 3 e não definir o Operador de Destino de Anúncio Dinâmico 3, utilizaremos o operador predefinido para o operando selecionado. Se quiser criar URL Igual a, o operador tem de ser transmitido. Atualização: Não permitido. Não é possível atualizar o operador de destino de anúncio dinâmico ou os campos de valor. Para atualizar as condições da página Web, tem de eliminar o destino de anúncio dinâmico e adicionar um novo.
Eliminar: Só de leitura

Valor de Destino de Anúncio Dinâmico 1

O primeiro de até 3 argumentos de condição ou critério de página Web.

Pode definir esta cadeia para o URL, categoria, título da página ou conteúdo da página do seu site. Por exemplo, se o campo Condição de Destino de Anúncio Dinâmico 1 estiver definido como URL, poderá definir este campo como contoso.com/flowers.

Adicionar: Opcional. Se não definir nenhum dos campos de valor ou condição de destino de anúncio dinâmico, está efetivamente a filtrar todas as páginas Web. Só pode ter um destino de anúncio dinâmico por grupo de anúncios para todas as páginas Web.
Atualização: Não permitido. Não é possível atualizar os campos de valor ou condição de destino de anúncio dinâmico. Para atualizar as condições da página Web, tem de eliminar o destino de anúncio dinâmico e adicionar um novo.
Eliminar: Só de leitura

Valor de Destino de Anúncio Dinâmico 2

O segundo de até 3 argumentos de condição ou critério de página Web.

Pode definir esta cadeia para o URL, categoria, título da página ou conteúdo da página do seu site. Por exemplo, se o campo Condição de Destino de Anúncio Dinâmico 2 estiver definido como URL, poderá definir este campo como contoso.com/flowers.

Adicionar: Opcional. Se não definir nenhum dos campos de valor ou condição de destino de anúncio dinâmico, está efetivamente a filtrar todas as páginas Web. Só pode ter um destino de anúncio dinâmico por grupo de anúncios para todas as páginas Web.
Atualização: Não permitido. Não é possível atualizar os campos de valor ou condição de destino de anúncio dinâmico. Para atualizar as condições da página Web, tem de eliminar o destino de anúncio dinâmico e adicionar um novo.
Eliminar: Só de leitura

Valor de Destino de Anúncio Dinâmico 3

O terceiro de até 3 argumentos de condição ou critério de página Web.

Pode definir esta cadeia para o URL, categoria, título da página ou conteúdo da página do seu site. Por exemplo, se o campo Condição de Destino de Anúncio Dinâmico 3 estiver definido como URL, poderá definir este campo como contoso.com/flowers.

Adicionar: Opcional. Se não definir nenhum dos campos de valor ou condição de destino de anúncio dinâmico, está efetivamente a filtrar todas as páginas Web. Só pode ter um destino de anúncio dinâmico por grupo de anúncios para todas as páginas Web.
Atualização: Não permitido. Não é possível atualizar os campos de valor ou condição de destino de anúncio dinâmico. Para atualizar as condições da página Web, tem de eliminar o destino de anúncio dinâmico e adicionar um novo.
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema do destino de anúncio dinâmico (critério de página Web).

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

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

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

Name

O nome do critério que pode utilizar para identificar os critérios, por exemplo, pode filtrar ou ordenar alfabeticamente.

O comprimento do nome do critério tem de estar entre 1 e 2048, inclusive.

Adicionar: Opcional. Se não especificar nenhum nome, por predefinição, o nome será definido para uma lista concatenada de condições. Cada condição será delimitada pela palavra-chave e . Por exemplo, se as condições forem a) Url contém flor , b) Url contém livro e c) PageContent contém seattle, então o nome de critério predefinido será Url contém flor e Url contém livro e PageContent contém seattle. Se todos os campos de condição e valor estiverem vazios, está efetivamente a filtrar todas as páginas Web e o nome será definido como Todas as páginas Web.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se especificar a palavra-chave delete_value , o nome do critério será atualizado para o valor predefinido, ou seja, Todas as páginas Web ou uma lista concatenada de critérios.
Eliminar: Só de leitura

ID principal

O identificador gerado pelo sistema do grupo de anúncios que contém o destino de anúncio dinâmico (critério de página Web).

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 destinos de anúncios dinâmicos 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 .

Estado

O estado do destino de anúncio dinâmico (critério de página Web).

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.

Modelo de Controlo

Os modelos de controlo podem ser utilizados em conjunto com o URL da página de destino que é gerado dinamicamente a partir do domínio que especificou para a sua campanha de Anúncios de Pesquisa Dinâmica. Ao combinar o domínio com o modelo de controlo, o URL da página de destino é montado onde um utilizador é direcionado depois de clicar no anúncio.

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