Partilhar via


Registo de Critério de Localização Negativa do Grupo de Anúncios - Em Massa

Define um critério de localização negativa do grupo de anúncios que pode ser carregado e transferido num ficheiro em massa.

Embora os critérios de localização sejam mais frequentemente utilizados para designar as localizações específicas onde pretende mostrar os seus anúncios, o Microsoft Advertising também lhe permite especificar localizações que pretende excluir de ver os seus anúncios.

Cada critério de localização negativo define um código de localização onde não pretende que os anúncios sejam apresentados.

O número máximo de critérios de localização combinados e negativos que pode especificar por campanha ou grupo de anúncios é 10 000.

Se forem especificados critérios de localização ao nível do grupo de anúncios (positivos ou negativos), os critérios de localização ao nível da campanha são ignorados para esse grupo de anúncios. Por outras palavras, os critérios de localização do grupo de anúncios substituem os critérios de localização da campanha e não são aplicados como uma união.

Tenha também em atenção que tem de considerar a localização, a localização negativa e os critérios radius como um conjunto de critérios geográficos. Se o grupo de anúncios tiver critérios geográficos, nenhum dos critérios geográficos da campanha é herdado. Se o grupo de anúncios não tiver critérios geográficos, todos os critérios geográficos da campanha serão herdados. Os critérios geográficos podem ser herdados da campanha, mesmo que o grupo de anúncios tenha um critério de intenção de localização. Se forem utilizados os critérios geográficos do grupo de anúncios, será utilizado o critério de intenção de localização do grupo de anúncios; se os critérios geográficos da campanha forem herdados, será utilizado o critério de intenção de localização da campanha e o critério de intenção de localização do grupo de anúncios será ignorado. Não pode eliminar um critério de intenção de localização de uma campanha ou grupo de anúncios, embora não tenha qualquer finalidade sem critérios de localização ou raio.

Sugestão

Para obter uma descrição geral de como utilizar critérios de destino, consulte Mostrar Anúncios à Audiência de Destino.

Pode transferir todos os registos do Critério de Localização Negativa do Grupo de Anúncios na conta ao incluir o valor DownloadEntity de AdGroupTargetCriterions 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 localização negativa do grupo de anúncios se for fornecido um valor de ID Principal válido.

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Target,Bid Adjustment,Name,OS Names,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,,6.0,,,,,,,,,
Ad Group Negative Location Criterion,Active,,-1111,PostalCode,,,ClientIdGoesHere,,79381,,,,,,,,,,,

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 BulkAdGroupNegativeLocationCriterion , 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 BulkAdGroupNegativeLocationCriterion
var bulkAdGroupNegativeLocationCriterion = new BulkAdGroupNegativeLocationCriterion
{
    // 'Ad Group' column header in the Bulk file is read-only
    AdGroupName = null,

    // 'Campaign' column header in the Bulk file is read-only
    CampaignName = null,

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // NegativeAdGroupCriterion object of the Campaign Management service.

    NegativeAdGroupCriterion = new NegativeAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,

        Criterion = new LocationCriterion
        {
            // 'Target' column header in the Bulk file
            LocationId = 79381,

            // 'Sub Type' column header in the Bulk file
            LocationType = "PostalCode"
        },

        // 'Id' column header in the Bulk file
        Id = null,

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

uploadEntities.Add(bulkAdGroupNegativeLocationCriterion);

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 Critério de Localização Negativa 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 onde este critério é aplicado ou removido.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Campanha

O nome da campanha que contém o grupo de anúncios onde este critério é aplicado ou removido.

Adicionar: Só de leitura
Atualização: Só de leitura
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: Opcional
Eliminar: Opcional

ID

O identificador exclusivo do Critério do Microsoft Advertising.

Adicionar: Só de leitura
Atualização: Só de leitura e Obrigatório
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: Só de leitura
Eliminar: Só de leitura

ID principal

O identificador do grupo de anúncios onde este critério é aplicado ou removido.

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 critérios 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: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

Estado

Representa o estado de associação entre o grupo de anúncios e o critério. Se o critério for aplicado ao grupo de anúncios, o valor deste campo é Ativo. Para eliminar o critério, defina o estado como Eliminado.

Adicionar: Só de leitura. O estado será sempre definido como Ativo quando adicionar critérios. Se carregar outro valor, por exemplo, Foo , o ficheiro de resultados conterá o mesmo valor, embora o critério esteja ativo.
Atualização: Opcional
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado. Para eliminar um critério de localização negativo específico, tem de carregar o Estado, o ID e o ID Principal.

Subtipo

O subtipo de localização que não está a filtrar. Por exemplo, o valor é Cidade se o registo representar um critério de localização da cidade.

Nota

As localizações da vizinhança estão para breve. O subtipo será Bairro.

Podem ser adicionados novos subtipos de localização em qualquer altura. Raramente o tipo de localização será alterado para um determinado ID de localização.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Target

O identificador da localização que não pretende direcionar.

Para obter valores possíveis, veja o campo ID de Localização do ficheiro de localizações geográficas. Pode chamar a operação GetGeoLocationsFileUrl para transferir o ficheiro.

Importante

Verifique o campo Estado no ficheiro de localizações geográficas antes de adicionar ou atualizar um critério de localização. Se o estado for PendingDeprecation, o critério de localização já não é utilizado para filtragem ou exclusões. Os critérios de localização preteridos ainda podem ser obtidos, mas não pode adicionar ou atualizar critérios de localização preteridos.

Adicionar: Necessário
Atualização: Necessário
Eliminar: Só de leitura