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