Registo de Palavras-chave Negativas do Grupo de Anúncios - Em Massa

Define uma palavra-chave negativa atribuída a um grupo de anúncios que pode ser carregada e transferida num ficheiro em massa.

No esquema em massa, cada uma das palavras-chave negativas associadas a um grupo de anúncios é representada individualmente pela sua própria linha. Por exemplo, se um grupo de anúncios tiver duas palavras-chave negativas, são representados por dois registos de Palavras-chave Negativas do Grupo de Anúncios no ficheiro em massa com o Estado definido como Ativo.

Nota

A Palavra-chave Negativa do Grupo de Anúncios pode ser adicionada e eliminada, mas não pode ser atualizada.

Pode transferir todos os registos de Palavras-chave Negativas do Grupo de Anúncios na conta ao incluir o valor DownloadEntity de AdGroupNegativeKeywords 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 do grupo de anúncios 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
Ad Group Negative Keyword,Active,,-1111,,,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 BulkAdGroupNegativeKeyword , 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 BulkAdGroupNegativeKeyword
var bulkAdGroupNegativeKeyword = new BulkAdGroupNegativeKeyword
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // '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(bulkAdGroupNegativeKeyword);

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 do Grupo de Anúncios , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiros em Massa.

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

Grupo de Anúncios

O nome do grupo de anúncios 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 Grupo de Anúncios .

Campanha

O nome da campanha que contém o grupo de anúncios e a 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

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 do grupo de anúncios que contém a palavra-chave negativa.

Este campo em massa mapeia para o campo ID do registo do Grupo de Anúncios .

Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de grupo de anúncios existente ou especificar um identificador negativo que seja igual ao campo ID do registo do Grupo de Anúncios principal. Isto é recomendado se estiver a adicionar novas palavras-chave negativas a um novo grupo de anúncios 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 Grupo de Anúncios .

Estado

Representa o estado de associação entre o grupo de anúncios e a palavra-chave negativa.

Se a palavra-chave negativa estiver associada ao grupo de anúncios, 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. 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 para o grupo de anúncios, 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.