Partilhar via


Registo de Critérios da Idade do Grupo Ad - Em massa

Define um critério de idade de grupo de anúncios que pode ser carregado e transferido num ficheiro em massa.

Pode direcionar os clientes por idade para que os seus anúncios sejam apresentados com mais frequência às pessoas que estarão interessadas nos mesmos.

Cada critério de idade define um intervalo de idade para o ajuste da oferta de critério que o acompanha.

O número máximo de critérios de idade que pode especificar por campanha ou grupo de anúncios é cinco, ou seja, um para cada uma das faixas etárias suportadasZozoToTwentyFour, TwentyFiveToThirtyFour, ThirtyFiveToFourtyNine, FiftyToSixtyFour e SixtyFiveAndAbove.

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

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 da Idade do Grupo do Ad 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 idade 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 Age Criterion,Active,,-1111,,,,ClientIdGoesHere,,EighteenToTwentyFour,20,,,,,,,,,,

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 BulkAdGroupAgeCriterion , 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 BulkAdGroupAgeCriterion
var bulkAdGroupAgeCriterion = new BulkAdGroupAgeCriterion
{
    // '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 
    // BiddableAdGroupCriterion object of the Campaign Management service.

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

        Criterion = new AgeCriterion
        {
            // 'Target' column header in the Bulk file
            AgeRange = AgeRange.EighteenToTwentyFour,
        },

        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 = AdGroupCriterionStatus.Active,
    }
};

uploadEntities.Add(bulkAdGroupAgeCriterion);

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 Idade 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

Ajuste da Oferta

O valor percentual que pretende ajustar a oferta para o Destino 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 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.

Nota

Anteriormente com a versão 10 da API de Gestão de Campanhas, era possível associar um identificador de destino a várias campanhas e grupos de anúncios através das operações AddTargetsToLibrary, SetTargetToCampaign e SetTargetToAdGroup. Depois de uma campanha ou grupo de anúncios ter sido desassociado do destino partilhado, o identificador de critério seria definido como 0 (zero) no ficheiro de transferência em massa ou no ficheiro de resultados de carregamento em massa.

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 uma oferta de critério de idade específica, tem de carregar o Estado, o ID e o ID Principal.

Target

O intervalo de idade que pretende direcionar com o Ajuste de Licitação correspondente.

Os valores suportados são EighteenToTwentyFour, TwentyFiveToThirtyFour, ThirtyFiveToFourtyNine, FiftyToSixtyFour e SixtyFiveAndAbove. Também pode visar pessoas desconhecidas cuja idade não é conhecida.

Nota

Em muitos países ou regiões, os anunciantes online não devem visar utilizadores com menos de 18 anos. O Microsoft Advertising não fornece publicidade baseada em interesses a crianças cuja data de nascimento na sua conta Microsoft as identifique como menores de 13 anos. Para obter mais informações, consulte a Declaração de Privacidade da Microsoft.

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