Partilhar via

Registo de Audiência Personalizado - Em Massa

  • Artigo

Define uma audiência personalizada que pode ser transferida e carregada num ficheiro em massa.

Nota

Só é suportada a atualização dos campos Audiência (nome da audiência) e Descrição para carregamento. Pode eliminar, mas não pode adicionar uma audiência personalizada com a API de Anúncios do Bing. Dito isto, pode adicionar e eliminar associações e exclusões de audiência personalizadas.

Uma audiência personalizada é um tipo de lista de remarketing que é gerada através da utilização dos seus próprios dados de cliente para criar segmentos de utilizador mais avançados. Pode utilizar audiências personalizadas em conjunto com as suas listas de remarketing, normalmente através do seu fornecedor de gestão de dados (DMP). Quando o seu DMP se ligar à nossa funcionalidade de audiência personalizada, pode importar as suas audiências personalizadas para o Microsoft Advertising para remarketing de pesquisa. Pode utilizar audiências personalizadas separadamente do remarketing, sem necessidade de UET.

Sugestão

Para obter uma descrição geral e mais informações sobre audiências, veja o Guia técnico das APIs de Audiência .

Pode transferir todos os registos de Audiência Personalizada na conta ao incluir o valor DownloadEntity de CustomAudiences 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 atualizaria a descrição de uma audiência personalizada. Nota: para uma audiência personalizada, a duração da associação não é definida na aplicação Web Microsoft Advertising e o Microsoft Advertising é diferido para as definições personalizadas do fornecedor de audiências.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
Custom Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,Updated Custom Audience Description,30,Account,Custom Audience,Search;DynamicSearchAds;Shopping;Audience

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 BulkCustomAudience , 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 BulkCustomAudience
var bulkCustomAudience = new BulkCustomAudience
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // CustomAudience object of the Campaign Management service.
    CustomAudience = new CustomAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "Updated Custom Audience Description",
        // 'Id' column header in the Bulk file
        Id = customAudienceIdKey,
        // 'Audience' column header in the Bulk file
        Name = null,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = null,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCustomAudience);

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 Audiência Personalizada , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Audiência

O nome da audiência personalizada.

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

Adicionar: Não suportado
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Tamanho da Rede da Audiência

O número total de pessoas que são membros ativos desta audiência na rede audiência. Isto dá-lhe uma ideia do número de utilizadores de rede de Audiência que pode direcionar.

O público precisa de ter, pelo menos, 300 pessoas antes de o Microsoft Advertising o utilizar para otimizações.

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

Tamanho da Pesquisa da Audiência

O número total de pessoas que são membros ativos desta audiência na rede de Pesquisa. Isto dá-lhe uma ideia do número de utilizadores de pesquisa que pode direcionar.

O público precisa de ter, pelo menos, 300 pessoas antes de o Microsoft Advertising o utilizar para otimizações.

Esta propriedade ficará vazia até 24 horas enquanto a audiência estiver a ser criada, por exemplo, se tiver importado novas audiências personalizadas do DMP, demora 24 horas a criar a audiência e, entretanto, esta propriedade estará vazia.

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

Descrição

A descrição da audiência personalizada. Utilize uma descrição para o ajudar a lembrar-se da audiência que está a filtrar com esta audiência personalizada.

A descrição pode conter um máximo de 1024 carateres.

Adicionar: Não suportado
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema da audiência personalizada.

Adicionar: Não suportado
Atualização: Necessário
Eliminar: Só de leitura e Obrigatório

Duração da Associação

A duração da associação determina até que ponto o Microsoft Advertising deve procurar ações que correspondam à sua definição de audiência personalizada para adicionar pessoas à sua lista. Para uma audiência personalizada, a duração da associação não é definida na aplicação Web Microsoft Advertising e o Microsoft Advertising é diferido para as definições personalizadas do fornecedor de audiências.

Quando pedir a audiência personalizada através da API de Anúncios do Bing, a duração da associação devolvida será nula.

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

ID principal

O identificador do Microsoft Advertising do cliente que contém a audiência personalizada.

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

Âmbito

O âmbito define que contas podem utilizar esta audiência personalizada. Para uma audiência personalizada, o único âmbito suportado é o Cliente e a audiência personalizada pode ser associada a todas as campanhas e grupos de anúncios em todas as contas do cliente.

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

Estado

O estado de audiência personalizado.

Os valores possíveis são Ativos ou Eliminados.

Adicionar: Não suportado
Atualização: Só de leitura
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.

Tipos de Campanha Suportados

A lista delimitada por ponto e vírgula de tipos de campanha que suportam esta audiência personalizada.

Os valores suportados são Audience, DynamicSearchAds, Search e Shopping. Poderão ser adicionados novos tipos de campanha no futuro, pelo que não deve assumir qualquer dependência num conjunto fixo de valores.

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