Registo de Etiqueta de Grupo de Anúncios - Em Massa
Define um registo de associação entre um Grupo de Anúncios e uma Etiqueta que pode ser carregada e transferida num ficheiro em massa. Para carregar ou transferir o grupo de anúncios ou a etiqueta, utilize o Grupo de Anúncios ou o registo Etiqueta .
Pode transferir todos os registos da Etiqueta de Grupo do Ad na conta ao incluir o valor DownloadEntity de AdGroupLabels 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 grupo de anúncios 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,,,
Ad Group Label,,-22,-1111,,,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 BulkAdGroupLabel , 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 BulkAdGroupLabel
var bulkAdGroupLabel = new BulkAdGroupLabel
{
// '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 = adGroupIdKey,
// 'Id' column header in the Bulk file
LabelId = labelIdKey
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkAdGroupLabel);
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 Grupo de Anúncios , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
Nota
Os campos Grupo de Anúncios e Campanha não são devolvidos no ficheiro de transferência.
Grupo de Anúncios
O nome do grupo de anúncios onde esta etiqueta é aplicada ou removida.
Adicionar: Só de leitura
Eliminar: Só de leitura
Nota
Para adicionar e eliminar, tem de especificar o ID Principal ou ambos os campos Grupo de Anúncios e Campanha .
Campanha
O nome da campanha que contém o grupo de anúncios onde esta etiqueta é aplicada ou removida.
Adicionar: Só de leitura
Eliminar: Só de leitura
Nota
Para adicionar e eliminar, tem de especificar o ID Principal ou ambos os campos Grupo de Anúncios e Campanha . Para transferência em massa, os campos Grupo de Anúncios e Campanha não são devolvidos.
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 grupo de anúncios.
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 grupos de anúncios 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 grupo de anúncios onde esta etiqueta é aplicada ou removida.
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 aplicar etiquetas 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.
Eliminar: Só de leitura e Obrigatório
Nota
Para adicionar e eliminar, tem de especificar o ID Principal ou ambos os campos Grupo de Anúncios e Campanha . Para transferência em massa, os campos Grupo de Anúncios e Campanha não são devolvidos.
Estado
Representa o estado aplicado entre o grupo de anúncios e a etiqueta.
Os valores possíveis são Ativo e Eliminado. Se a etiqueta for aplicada ao grupo de anúncios, o valor deste campo será Ativo.
Adicionar: Só de leitura
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.