Partilhar via

Registo de Exclusão de Responsabilidade da Campanha - Em Massa

  • Artigo

Define um registo de associação entre uma Campanha e uma Exclusão de Responsabilidade que pode ser carregada e transferida num ficheiro em massa. Para carregar ou transferir a campanha ou exclusão de responsabilidade, utilize o registo Campanha ou Exclusão de Responsabilidade .

Pode transferir todos os registos da Extensão de Exclusão de Responsabilidade da Campanha na conta ao incluir o valor DownloadEntity de CampaignDisclaimerAdExtensions 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 exclusão de responsabilidade 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 Disclaimer 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 BulkCampaignDisclaimerAdExtension , 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 BulkCampaignDisclaimerAdExtension
var bulkCampaignDisclaimerAdExtension = new BulkCampaignDisclaimerAdExtension
{
    // 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 = disclaimerAdExtensionIdKey,
        // '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(bulkCampaignDisclaimerAdExtension);

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 Exclusão de Responsabilidade da Campanha , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Campanha

O nome da campanha em que este registo está associado ou removido.

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 do registo 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 do registo.

Os valores possíveis estão descritos na tabela abaixo.

Valor Descrição
Ativo O disco passou na revisão editorial.
ActiveLimited O recorde passou na revisão editorial em um ou mais mercados, e um ou mais elementos do registo estão a ser analisados editorialmente noutro mercado. Por exemplo, o registo passou na revisão editorial para o Canadá e ainda está pendente de revisão no Estados Unidos.
Reprovado O registo falhou na revisão editorial.
Inativo Um ou mais elementos do registo 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 do registo que está associado ou removido da campanha.

Este campo em massa mapeia para o campo ID do registo de Exclusão de Responsabilidade .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de registo existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Exclusão de Responsabilidade principal. Isto é recomendado se estiver a adicionar novos registos e associações 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 este registo está associado ou removido.

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 registos 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 o registo.

Os valores possíveis são Ativo e Eliminado. Se o registo estiver associado à campanha, o valor deste campo é Ativo.

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