Partilhar via


Registo de Site Negativo do Grupo de Anúncios - Em Massa

Define um site negativo atribuído a um grupo de anúncios que pode ser carregado e transferido num ficheiro em massa.

No esquema em massa, cada um dos sites negativos associados a um grupo de anúncios é representado individualmente pela sua própria linha. Por exemplo, se tiver dois sites negativos, estes são representados por dois registos de Site Negativo do Grupo de Anúncios no ficheiro em massa com o Estado definido como Ativo. Ao carregar ou transferir registos para uma lista atualizada de sites negativos associados, um registo terá o Estado definido como Eliminado com um campo de Web site vazio. Isto indica que foram efetuadas algumas alterações à lista e que os registos do Site Negativo do Grupo de Anúncios que se seguem estão ativos.

Nota

O Site Negativo do Grupo de Anúncios pode ser adicionado e eliminado, mas não pode ser atualizado.

Pode transferir todos os registos de Site Negativo do Grupo de Anúncios na conta ao incluir o valor DownloadEntity de AdGroupNegativeSites 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 site negativo do grupo de anúncios se fosse fornecido um valor de ID Principal válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Website,Client Id,Modified Time,Name
Format Version,,,,,,,,,6.0
Ad Group Negative Site,Active,,-1111,,,contoso.com,ClientIdGoesHere,,

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 BulkAdGroupNegativeSite , 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 BulkAdGroupNegativeSites
var bulkAdGroupNegativeSites = new BulkAdGroupNegativeSites
{
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,

    // Map properties in the Bulk file to the 
    // AdGroupNegativeSites object of the Campaign Management service.
    AdGroupNegativeSites = new AdGroupNegativeSites
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        NegativeSites = new[]
        {
            // 'Website' column header in the Bulk file
            "contoso.com",
        }
    },
                
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

// BulkAdGroupNegativeSites does not support 'Client Id' and
// replaces all negative sites for the ad group, whereas BulkAdGroupNegativeSite
// enables you to add or delete one negative site at a time.

// Map properties in the Bulk file to the BulkAdGroupNegativeSite
var bulkAdGroupNegativeSite = new BulkAdGroupNegativeSite
{
    // '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",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
    // 'Website' column header in the Bulk file
    Website = "contoso.com",
};

uploadEntities.Add(bulkAdGroupNegativeSite);

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

Grupo de Anúncios

O nome do grupo de anúncios que contém o site negativo.

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

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

ID principal

O identificador gerado pelo sistema do grupo de anúncios que contém o site negativo.

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 novos sites negativos 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. Um site negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
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 o site negativo.

Se o site negativo estiver associado ao grupo de anúncios, 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. Um site negativo pode ser adicionado e eliminado, mas não pode ser atualizado.
Eliminar: Necessário. O Estado tem de ser definido como Eliminado. Para eliminar um site negativo específico, tem de carregar o Estado, o ID Principal e o Site. Para eliminar todos os sites negativos do 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 site negativos para substituir o conjunto eliminado.

Web site

O URL do site onde não pretende que os anúncios sejam apresentados.

Cada URL tem de especificar o nome de domínio, por exemplo, contoso.com que pode incluir até três subdomínios e dois subdiretórios. A contagem de subdomínios inclui o prefixo www . Por exemplo, one.two.three.contoso.com/1/2, www.two.three.contoso.com/1/2 e one.two.contoso.co.uk/1/2 são URLs válidos, enquanto one.two.three.contoso.co.uk/1/2 (demasiados subdomínios) e one.two.three.contoso.com/1/2/3 (demasiados subdiretórios) não são. Não são permitidos URLs de site negativos duplicados por campanha ou grupo de anúncios.

Só pode excluir sites para sites de pesquisa sindicados. A rede do grupo de anúncios tem de ser definida como OwnedAndOperatedAndSyndicatedSearch.

Os URLs de site negativos especificados ao nível do grupo de anúncios são utilizados em vez de urLs de site negativos especificados ao nível da campanha. Se associar listas de exclusão de sites a uma conta de anúncio (disponível através do serviço Gestão de Campanhas), a lista de sites negativos é utilizada para além dos sites negativos da campanha ou sites negativos do grupo de anúncios.

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