Partilhar via


Registo de Critérios do Arquivo Negativo da Campanha - Em Massa

Define um Critério de Arquivo Negativo de Campanha que pode ser carregado e transferido num ficheiro em massa.

Cada Critério da Loja Negativa de Campanha exclui uma loja do Microsoft Merchant Center da sua campanha de compras para marcas. Cada campanha pode ter um máximo de 10 lojas excluídas.

Pode transferir todos os registos de Critérios do Arquivo Negativo da Campanha na conta ao incluir o valor DownloadEntity de CampaignNegativeStoreCriterions 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 adicionaria um novo critério de arquivo negativo de campanha se for fornecido um valor de ID Principal válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Store Id,Name
Format Version,,,,,,,,,6.0
Campaign Negative Store Criterion,Active,,-114,,,ClientIdGoesHere,,StoreIdGoesHere,

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 BulkCampaignNegativeStoreCriterion , 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 BulkCampaignNegativeStoreCriterion
var bulkCampaignNegativeStoreCriterion = new BulkCampaignNegativeStoreCriterion
{
    // Map properties in the Bulk file to the 
    // NegativeCampaignCriterion object of the Campaign Management service.
    NegativeCampaignCriterion = new NegativeCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new StoreCriterion
        {
            // 'Store Id' column header in the Bulk file
            StoreId = StoreIdGoesHere,
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignNegativeStoreCriterion);

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 critério de Arquivo Negativo de Campanha , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Campanha

O nome da campanha que contém o critério da loja.

Adicionar: Só de leitura e Obrigatório
Atualização: Não aplicável. Um arquivo negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Só de leitura e Obrigatório

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou 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
Atualização: Não aplicável. Um arquivo negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema do critério do arquivo.

Adicionar: Só de leitura
Atualização: Não aplicável. Um arquivo negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
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
Atualização: Não aplicável. Um arquivo negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Só de leitura

ID principal

O identificador gerado pelo sistema da campanha que contém o critério da loja.

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 adicionar novos destinos de anúncios dinâmicos 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.
Atualização: Não aplicável. Um arquivo negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Só de leitura

Nota

Para adicionar, atualizar e eliminar, tem de especificar o campo ID Principal ou Campanha .

Estado

O estado do critério do arquivo.

Os valores possíveis são Ativos ou Eliminados.

Adicionar: Opcional. O valor predefinido é Ativo.
Atualização: Não aplicável. Um arquivo negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.

ID da Loja

O identificador gerado pelo sistema do arquivo do Centro de Comerciantes da Microsoft a excluir.

Adicionar: Necessário
Atualização: Não aplicável. Um arquivo negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Só de leitura