Registo de Etiqueta de Anúncios de Texto - Em Massa
Define um registo de associação entre um Anúncio de Texto e uma Etiqueta que pode ser carregado e transferido num ficheiro em massa. Para carregar ou transferir o anúncio de texto ou etiqueta, utilize o registo De Texto ou Etiqueta .
Pode transferir todos os registos de Etiqueta de Anúncios de Texto na conta ao incluir o valor DownloadEntity de TextAdLabels 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 texto 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,,,
Text Ad Label,,-22,-11112,,,ClientIdGoesHere,,,,,
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 BulkTextAdLabel , 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 BulkTextAdLabel
var bulkTextAdLabel = new BulkTextAdLabel
{
// '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 = textAdIdKey,
// 'Id' column header in the Bulk file
LabelId = labelIdKey
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkTextAdLabel);
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 Texto , 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 texto.
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 texto 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 texto em que esta etiqueta é aplicada ou removida.
Este campo em massa mapeia para o campo ID do registo de Anúncio de Texto .
Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de anúncio de texto existente ou especificar um identificador negativo que seja igual ao campo ID do registo do AD de Texto principal. Isto é recomendado se estiver a aplicar etiquetas a um novo anúncio de texto 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 texto e a etiqueta.
Os valores possíveis são Ativo e Eliminado. Se a etiqueta for aplicada ao anúncio de texto, o valor deste campo é Ativo.
Adicionar: Só de leitura
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.