Compartilhar via

Registo da Extensão do Fragmento Estruturado de Campanha – Em Massa

  • Artigo

Define um registo de associação entre uma Campanha e uma Extensão do Ad fragmento estruturado que pode ser carregado e transferido num ficheiro em massa. Para carregar ou transferir a campanha ou a extensão de anúncios de fragmentos estruturados, utilize o registo Campaign ou Structured Snippet Ad Extension(Extensão do Fragmento Estruturado ).

Pode transferir todos os registos da Extensão do Fragmento Estruturado da Campanha na conta ao incluir o valor DownloadEntity de CampaignStructuredSnippetAdExtensions 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 fragmento estruturado a uma campanha 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
Campaign Structured Snippet 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 com o BulkServiceManager para carregar e transferir o objeto BulkCampaignStructuredSnippetAdExtension , 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 BulkCampaignStructuredSnippetAdExtension
var bulkCampaignStructuredSnippetAdExtension = new BulkCampaignStructuredSnippetAdExtension
{
    // 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 = structuredSnippetAdExtensionIdKey,
        // 'Parent Id' column header in the Bulk file
        EntityId = campaignIdKey,
    },
                
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

uploadEntities.Add(bulkCampaignStructuredSnippetAdExtension);

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 Fragmento estruturado de campanha , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Campanha

O nome da campanha em que esta extensão de anúncios 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 a 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 da campanha.

Este campo em massa mapeia para o campo ID do registo Da Extensão do Fragmento Estruturado do 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 Ad do Fragmento Estruturado 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 campanha em que esta extensão de anúncio está associada ou removida.

Este campo em massa mapeia para o campo ID do registo campanha .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de campanha existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Campanha principal. Isto é recomendado se estiver a associar extensões de anúncios a uma nova campanha 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 a 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 a campanha 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 à campanha, o valor deste campo é Ativo.

Adicionar: Só de leitura
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.