Registo de Critério radius de campanha - em massa

Define um critério radius de campanha que pode ser carregado e transferido num ficheiro em massa.

Com critérios radius, pode optar por mostrar anúncios a potenciais clientes em, procurar ou visualizar páginas sobre um raio especificado em torno de um código postal, coordenadas, marco ou área.

Cada critério radius define um raio, latitude e longitude para o ajuste da oferta de critério que o acompanha.

O número máximo de critérios radius que pode especificar por campanha ou grupo de anúncios é 2000.

Nota

Só pode ter um registo critério de intenção de localização de campanha por campanha para determinar a opção de intenção de localização que se aplica a todos os registos critério de localização de campanha da campanha e critério radius de campanha . Quando cria o primeiro critério da campanha, um registo critério de intenção de localização de campanha também será adicionado automaticamente com o Destino predefinido definido para PeopleInOrSearchingForOrViewingPages. Pode adicionar ou atualizar o Critério de Intenção de Localização da Campanha de uma campanha, quer a campanha tenha ou não outros critérios. Não é possível eliminar o Critério de Intenção de Localização de Campanha de uma campanha, embora não tenha qualquer finalidade sem critérios de localização ou raio.

Se forem especificados critérios radius ao nível do grupo de anúncios, os critérios radius ao nível da campanha são ignorados para esse grupo de anúncios. Por outras palavras, os critérios do raio do grupo de anúncios substituem os critérios do raio 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 de Critério radius de campanha na conta ao incluir o valor DownloadEntity de CampaignTargetCriterions 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 radius de campanha se for fornecido um valor de ID Principal válido.

Type,Status,Id,Parent Id,Sub Type,Campaign,Client Id,Modified Time,Target,Bid Adjustment,Name,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,6.0,,,,,,,,
Campaign Radius Criterion,Active,,-111,,,ClientIdGoesHere,,RadiusName,20,,10,Kilometers,,,,,10.5,40.5

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 BulkCampaignRadiusCriterion , 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 BulkCampaignRadiusCriterion
var bulkCampaignRadiusCriterion = new BulkCampaignRadiusCriterion
{
    // '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 
    // BiddableCampaignCriterion object of the Campaign Management service.

    CampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,

        Criterion = new RadiusCriterion
        {
            // 'Latitude' column header in the Bulk file
            LatitudeDegrees = 10.5,

            // 'Longitude' column header in the Bulk file
            LongitudeDegrees = 40.5,

            // 'Name' column header in the Bulk file
            Name = "RadiusName",

            // 'Radius' column header in the Bulk file
            Radius = 10,

            // 'Unit' column header in the Bulk file
            RadiusUnit = DistanceUnit.Kilometers,
        },

        CriterionBid = new BidMultiplier
        {
            // 'Bid Adjustment' column header in the Bulk file
            Multiplier = 20,
        },

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

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

uploadEntities.Add(bulkCampaignRadiusCriterion);

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

• Ajuste da Oferta
• Campanha
• ID de Cliente
• ID
• Latitude
• Longitude
• Hora da Modificação
• Nome
• ID principal
• Raio
• Estado
• Unidade

Ajuste da Oferta

O valor percentual que pretende ajustar a oferta para o critério radius correspondente.

Os valores suportados são negativos noventa (-90) até novecentos positivos (900).

Adicionar: Opcional. O ajuste da oferta será definido como a predefinição de 0 , se não for incluído.
Atualização: Necessário
Eliminar: Só de leitura

Campanha

O nome da campanha em que 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

Latitude

A latitude, em graus, do critério de localização.

A latitude tem de ser maior ou igual a -85,0 e menor ou igual a +85,0.

Especifique a latitude e a longitude como valores decimais. Por exemplo, a latitude e longitude de One Redmond Way, Redmond, WA é 47.755367 e -122.091827, respetivamente. Para obter estes valores, pode introduzir o endereço de uma localização geográfica em Mapas Bing e as coordenadas serão apresentadas abaixo do endereço.

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

Longitude

A longitude, em graus, do critério de localização.

A longitude tem de ser maior ou igual a -180,0 e menor ou igual a +180,0.

Especifique a latitude e a longitude como valores decimais. Por exemplo, a latitude e longitude de One Redmond Way, Redmond, WA é 47.755367 e -122.091827, respetivamente. Para obter estes valores, pode introduzir o endereço de uma localização geográfica em Mapas Bing e as coordenadas serão apresentadas abaixo do endereço.

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

Name

O nome da localização geográfica que está a ser direcionada.

O nome pode conter um máximo de 50 carateres.

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

ID principal

O identificador da campanha em que este critério é aplicado ou removido.

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

Raio

O raio que especifica a área que rodeia a localização geográfica a atingir.

Se o campo Unidade radius estiver definido como Milhas, os valores inteiros positivos de 1 a 500 são aceites.

Se o campo Unidade radius estiver definido como Kms, os valores inteiros positivos de 1 a 800 são aceites.

Nota

O tipo de dados é duplo e pode ser suportado numa versão futura. Atualmente, o serviço só aceita e devolve valores inteiros.

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

Estado

Representa o estado de associação entre a campanha e o critério. Se o critério for aplicado à campanha, 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 uma oferta de critério de localização específica, tem de carregar o Estado, o ID e o ID Principal.

Unidade

A unidade de medida para o raio especificado.

Os valores suportados são Miles (predefinição) e Kms.

Adicionar: Opcional. Se não for especificado, o valor predefinido de Miles será definido.
Atualização: Necessário
Eliminar: Só de leitura