Registo da Extensão de Anúncio da Imagem de Conta - Em Massa
Define um registo de associação entre uma Conta e uma Extensão de Anúncio de Imagem que pode ser carregada e transferida num ficheiro em massa. Para carregar ou transferir a extensão de anúncio de conta ou imagem, utilize o registo Conta ou Extensão do Ad de Imagem .
Pode transferir todos os registos da Extensão de Anúncio da Imagem de Conta na conta ao incluir o valor DownloadEntity de AccountImageAdExtensions 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 associaria uma extensão de anúncio de imagem a uma conta se o ID válido fosse fornecido.
Type,Status,Id,Parent Id,Client Id,Modified Time,Name
Format Version,,,,,,6.0
Account Image Ad Extension,Active,-11,,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 BulkAccountImageAdExtension , 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 BulkAccountImageAdExtension
var bulkAccountImageAdExtension = new BulkAccountImageAdExtension
{
// Map properties in the Bulk file to the
// AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
{
// 'Id' column header in the Bulk file
AdExtensionId = imageAdExtensionIdKey,
// 'Parent Id' column header in the Bulk file
EntityId = accountIdKey,
},
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active,
};
uploadEntities.Add(bulkAccountImageAdExtension);
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 Extensão de Anúncio de Imagem de Conta , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
- ID de Cliente
- Localização Editorial
- Código do Motivo Editorial
- Estado Editorial
- Termo Editorial
- ID
- Hora da Modificação
- ID principal
- Países do Publisher
- Estado
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
Localização Editorial
O componente ou propriedade da extensão de anúncio que falhou na revisão editorial.
Adicionar: Só de leitura
Eliminar: Só de leitura
Código do Motivo Editorial
Um código que identifica o motivo da falha. Para obter uma lista de possíveis códigos de motivos, consulte Códigos de Razão Editoriais.
Adicionar: Só de leitura
Eliminar: Só de leitura
Estado Editorial
O estado editorial da extensão de anúncios.
Os valores possíveis estão descritos na tabela abaixo.
Adicionar: Só de leitura
Eliminar: Só de leitura
Termo Editorial
O termo que falhou na revisão editorial.
Este campo não será definido se uma combinação de termos tiver causado a falha ou se a falha tiver sido baseada numa violação de política.
Adicionar: Só de leitura
Eliminar: Só de leitura
ID
O identificador da extensão de anúncios que está associada ou removida da conta.
Este campo em massa mapeia para o campo ID do registo Da Extensão do Anúncio de Imagem .
Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de extensão de anúncio existente ou especificar um identificador negativo que seja igual ao campo ID do registo da Extensão do AD de Imagem principal. Isto é recomendado se estiver a adicionar novas extensões e associações 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 da conta onde esta extensão de anúncio está associada ou removida.
Este campo em massa mapeia para o campo ID do registo conta .
Adicionar: Só de leitura
Eliminar: Só de leitura
Países do Publisher
A lista de países ou regiões publicadores cujas diretrizes editoriais não permitem o termo especificado.
Num ficheiro em massa, a lista de países ou regiões do publicador é delimitada com um ponto e vírgula (;).
Adicionar: Só de leitura
Eliminar: Só de leitura
Estado
Representa o estado de associação entre a conta e a extensão de anúncios.
Os valores possíveis são Ativo e Eliminado. Se a extensão de anúncio estiver associada à conta, o valor deste campo é Ativo.
Adicionar: Só de leitura
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.