Registo de Palavras-chave Negativos da Campanha - Em Massa

Define uma palavra-chave negativa atribuída a uma campanha que pode ser carregada e transferida num ficheiro em massa.

No esquema em massa, cada uma das palavras-chave negativas associadas a uma campanha é representada individualmente pela sua própria linha. Por exemplo, se uma campanha tiver duas palavras-chave negativas, estas são representadas por dois registos de Palavras-chave Negativas da Campanha no ficheiro em massa com o Estado definido como Ativo.

Nota

A Palavra-chave Negativa da Campanha pode ser adicionada e eliminada, mas não pode ser atualizada.

Pode transferir todos os registos de Palavras-chave Negativas da Campanha na conta ao incluir o valor DownloadEntity de CampaignNegativeKeywords 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 uma nova palavra-chave negativa de campanha se for fornecido um valor de ID Principal válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Campaign Negative Keyword,Active,,-112,,,ClientIdGoesHere,,shoes,Exact,

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 BulkCampaignNegativeKeyword , 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 BulkCampaignNegativeKeyword
var bulkCampaignNegativeKeyword = new BulkCampaignNegativeKeyword
{
    // 'Parent Id' column header in the Bulk file
    CampaignId = campaignIdKey,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // NegativeKeyword object of the Campaign Management service.
    NegativeKeyword = new NegativeKeyword
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Match Type' column header in the Bulk file
        MatchType = MatchType.Exact,
        // 'Text' column header in the Bulk file
        Text = "shoes"
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignNegativeKeyword);

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

• Campanha
• ID de Cliente
• ID
• Palavra-chave
• Tipo de Correspondência
• Hora da Modificação
• ID principal
• Estado

Campanha

O nome da campanha que contém a palavra-chave negativa.

Adicionar: Só de leitura e Obrigatório
Atualização: Não aplicável. Uma palavra-chave negativa pode ser adicionada e eliminada, mas não pode ser atualizada.
Eliminar: Só de leitura e Obrigatório

Nota

Para adicionar 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. Uma palavra-chave negativa pode ser adicionada e eliminada, mas não pode ser atualizada.
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema da palavra-chave negativa.

Adicionar: Só de leitura
Atualização: Não aplicável. Uma palavra-chave negativa pode ser adicionada e eliminada, mas não pode ser atualizada.
Eliminar: Só de leitura e Obrigatório

Palavra-chave

O texto de palavra-chave negativo.

O texto pode conter um máximo de 100 carateres.

Adicionar: Necessário
Atualização: Não aplicável. Uma palavra-chave negativa pode ser adicionada e eliminada, mas não pode ser atualizada.
Eliminar: Só de leitura

Tipo de Correspondência

O tipo de correspondência para comparar a palavra-chave negativa e o termo de pesquisa do utilizador.

Os valores de tipo de correspondência suportados para uma palavra-chave negativa são Expressão e Exato.

Adicionar: Necessário
Atualização: Não aplicável. Uma palavra-chave negativa pode ser adicionada e eliminada, mas não pode ser atualizada.
Eliminar: Só de leitura

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. Uma palavra-chave negativa pode ser adicionada e eliminada, mas não pode ser atualizada.
Eliminar: Só de leitura

ID principal

O identificador gerado pelo sistema da campanha que contém a palavra-chave negativa.

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 novas palavras-chave negativas 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. Uma palavra-chave negativa pode ser adicionada e eliminada, mas não pode ser atualizada.
Eliminar: Só de leitura

Nota

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

Estado

Representa o estado de associação entre a campanha e a palavra-chave negativa.

Se a palavra-chave negativa estiver associada à campanha, o valor deste campo é Ativo.

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

Adicionar: Opcional. O valor predefinido é Ativo.
Atualização: Não aplicável. Uma palavra-chave negativa pode ser adicionada e eliminada, mas não pode ser atualizada.
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado. Para eliminar uma palavra-chave negativa específica, tem de carregar o Estado, o ID e o ID Principal. Para eliminar todas as palavras-chave negativas da campanha, só tem de carregar o Estado e o ID Principal num único registo. Em seguida, opcionalmente, pode adicionar novos registos de palavras-chave negativas para substituir o conjunto eliminado.