Registo de Etiqueta - Em Massa

Artigo
12/21/2023

Define uma etiqueta que pode ser carregada e transferida num ficheiro em massa.

As etiquetas permitem-lhe organizar campanhas, grupos de anúncios, anúncios e palavras-chave em grupos com base no que for importante para si. Em seguida, pode filtrar e executar relatórios nas suas etiquetas para obter os dados mais significativos para si.

Pode transferir todos os registos de Etiqueta na conta ao incluir o valor DownloadEntity de Labels 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 etiqueta.

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

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

    // Map properties in the Bulk file to the 
    // Label object of the Campaign Management service.
    Label = new Label
    {
        // 'Color' column header in the Bulk file
        ColorCode = "#FFFFFF",
        // 'Description' column header in the Bulk file
        Description = "Label Description",
        // 'Id' column header in the Bulk file
        Id = labelIdKey,
        // 'Label' column header in the Bulk file
        Name = "Label Name " + DateTime.UtcNow
    },

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

uploadEntities.Add(bulkLabel);

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

Cor
ID de Cliente
Descrição
ID
Etiqueta
Hora da Modificação
Estado

Cor

A cor da etiqueta como um código hexadecimal.

O valor hexadecimal tem de ter o prefixo "#". Por exemplo, pode utilizar o valor de #FFFFFF para uma etiqueta branca.

A cor pode ser visualizada na aplicação Web Microsoft Advertising. A sua aplicação pode apresentar a cor ou utilizar o valor hexadecimal para categorizar um conjunto de etiquetas.

Adicionar: Opcional. Se não especificar nenhuma cor, o valor será atribuído aleatoriamente para cada etiqueta.
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Pode atualizar o código de cores, mas não pode removê-lo.
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

Descrição

A descrição da etiqueta.

A descrição da etiqueta pode ter entre 1 e 200 carateres de comprimento.

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

ID

O identificador gerado pelo sistema da etiqueta.

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

Etiqueta

O nome da etiqueta.

O nome da etiqueta sensível às maiúsculas e minúsculas pode ter entre 1 e 80 carateres e tem de ser exclusivo em todas as etiquetas na conta.

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

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

Estado

O estado da etiqueta.

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.

Partilhar via