Partilhar via

Registo da Extensão de Anúncios do Ad Group – Em Massa

  • Artigo

Define um registo de associação entre um Grupo de Anúncios e uma Extensão de Anúncio de Vídeo que pode ser carregado e transferido num ficheiro em massa. Para carregar ou transferir o grupo de anúncios ou a extensão de anúncios de vídeo, utilize o registo Ad Group ou Video Ad Extension .

Pode transferir todos os registos da Extensão do Ad Group Video Na conta ao incluir o valor DownloadEntity de AdGroupVideoAdExtensions 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 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
Format Version,,,,,,,,6.0
Ad Group Video Ad Extension,Active,-11,-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 BulkAdGroupVideoAdExtension , 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 BulkAdGroupVideoAdExtension
var bulkAdGroupVideoAdExtension = new BulkAdGroupVideoAdExtension
{
    // 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 = adGroupIdKey,
    },
                
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

uploadEntities.Add(bulkAdGroupVideoAdExtension);

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 da Extensão do Ad Group Video Ad , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Grupo de Anúncios

O nome do grupo de anúncios onde esta extensão de anúncio está associada ou removida.

Adicionar: Só de leitura e Obrigatório
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 .

Campanha

O nome da campanha que contém o grupo de anúncios onde esta extensão de anúncios está associada 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 .

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.

Valor Descrição
Ativo A extensão de anúncios passou na revisão editorial.
ActiveLimited A extensão de anúncios aprovou uma revisão editorial em um ou mais mercados, e um ou mais elementos da extensão de anúncios estão a ser analisados editorialmente noutro mercado. Por exemplo, a extensão de anúncios passou na revisão editorial para o Canadá e ainda está pendente de revisão no Estados Unidos.
Reprovado A extensão de anúncio falhou na revisão editorial.
Inativo Um ou mais elementos da extensão de anúncios estão a ser submetidos a uma revisão editorial.

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 do grupo de anúncios.

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 do grupo de anúncios em que esta extensão de anúncio está associada 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 associar extensões de anúncios 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 .

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 o grupo de anúncios 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 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.