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).

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.