Partilhar via


Registo de Palavras-chave Negativas Partilhadas - Em Massa

Define uma palavra-chave negativa que é partilhada numa lista de palavras-chave negativas e que pode ser transferida e carregada num ficheiro em massa.

Pode transferir todos os registos de Palavras-chave Negativas Partilhadas na conta ao incluir o valor DownloadEntity de SharedNegativeKeywords 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 a uma lista de palavras-chave negativas com um ID de lista de palavras-chave negativos válido (ID Principal).

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

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 BulkSharedNegativeKeyword , 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 BulkSharedNegativeKeyword
var bulkSharedNegativeKeyword = new BulkSharedNegativeKeyword
{
    // '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"
    },

    // 'Parent Id' column header in the Bulk file
    NegativeKeywordListId = negativeKeywordListIdKey,

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkSharedNegativeKeyword);

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

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 lista de palavras-chave negativas que contém a palavra-chave negativa.

Este campo em massa mapeia para o campo ID do registo Lista de Palavras-chave Negativas .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de lista de palavras-chave negativos existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Lista de Palavras-chave Negativas principais. Isto é recomendado se estiver a adicionar novas palavras-chave negativas a uma nova lista de palavras-chave negativas 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

Estado

Representa o estado de associação entre a lista de palavras-chave negativas e a palavra-chave negativa.

Se a palavra-chave negativa estiver associada à lista de palavras-chave negativas, o valor deste campo será 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.