Registo da Extensão do Ad de Vídeo de Conta - Em Massa
Define um registo de associação entre uma Conta e uma Extensão de Anúncio de Vídeo que pode ser carregado e transferido num ficheiro em massa. Para carregar ou transferir a extensão de anúncios de conta ou vídeo, utilize o registo Conta ou Extensão do Video Ad .
Pode transferir todos os registos da Extensão do Vídeo de Conta na conta ao incluir o valor DownloadEntity de AccountVideoAdExtensions 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 exemplo CSV em massa seguinte associaria uma extensão de anúncio de vídeo 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 Video Ad Extension,Active,-11,,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 BulkAccountVideoAdExtension , 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 BulkAccountVideoAdExtension
var bulkAccountVideoAdExtension = new BulkAccountVideoAdExtension
{
// 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 = videoAdExtensionIdKey,
// '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(bulkAccountVideoAdExtension);
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 Vídeo 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 Video Ad .
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 Video Ad 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.