Partilhar via


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

Define um registo de associação entre um Anúncio de Pesquisa Dinâmica e uma Etiqueta que pode ser carregada e transferida num ficheiro em massa. Para carregar ou transferir o anúncio ou etiqueta de pesquisa dinâmica, utilize o registo De Pesquisa Dinâmica ou Etiqueta .

O registo Dynamic Search Ad Label 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 Dynamic Search Ad Label na conta ao incluir o valor DownloadEntity de DynamicSearchAdLabels 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 aplicaria uma etiqueta a um anúncio de pesquisa dinâmica se fossem fornecidos valores de ID e ID Principal válidos.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Dynamic Search Ad Label,,-22,-11112,,,ClientIdGoesHere,,,,,

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 BulkDynamicSearchAdLabel , 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 BulkDynamicSearchAdLabel
var bulkDynamicSearchAdLabel = new BulkDynamicSearchAdLabel
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // LabelAssociation object of the Campaign Management service.
    LabelAssociation = new LabelAssociation
    {
        // 'Parent Id' column header in the Bulk file
        EntityId = dynamicSearchAdIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkDynamicSearchAdLabel);

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

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

ID

O identificador da etiqueta que é aplicada ou removida do anúncio de pesquisa dinâmica.

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

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de etiqueta existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Etiqueta principal. Isto é recomendado se estiver a aplicar novas etiquetas a anúncios de pesquisa dinâmica no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
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
Eliminar: Só de leitura

ID principal

O identificador do anúncio de pesquisa dinâmica em que esta etiqueta é aplicada ou removida.

Este campo em massa mapeia para o campo ID do registo do AD de Pesquisa Dinâmica .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de anúncio de pesquisa dinâmica existente ou especificar um identificador negativo que seja igual ao campo ID do registo do AD de Pesquisa Dinâmica principal. Isto é recomendado se estiver a aplicar etiquetas a um novo anúncio de pesquisa dinâmica no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Eliminar: Só de leitura e Obrigatório

Estado

Representa o estado aplicado entre o anúncio de pesquisa dinâmica e a etiqueta.

Os valores possíveis são Ativo e Eliminado. Se a etiqueta for aplicada ao anúncio de pesquisa dinâmica, o valor deste campo é Ativo.

Adicionar: Só de leitura
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.