Partilhar via

Registo de Lista Combinada - Em Massa

  • Artigo

Define uma lista combinada que pode ser transferida e carregada num ficheiro em massa.

Uma lista combinada é uma audiência criada a partir de uma combinação de várias audiências existentes.

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 da Lista Combinada na conta ao incluir o valor DownloadEntity de CombinedLists 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 uma nova lista combinada.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Combination Rule
Format Version,,,,,,6.0,,,,,,
Combined List,Active,-10,,ClientIdGoesHere,,,New combined list description,Customer,New Combined List,NOT(123IdGoesHere,234IdGoesHere)&AND(345IdGoesHere,456IdGoesHere)&OR(567IdGoesHere)

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

    // Map properties in the Bulk file to the 
    // CombinedList object of the Campaign Management service.
    CombinedList = new CombinedList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New Combined List",
        // 'Id' column header in the Bulk file
        Id = combinedListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Combined List " + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Combination Rule' column header in the Bulk file
        CombinationRules = new[]
        {
            // Each rule is delimited by a semicolon (;) in the Bulk file
            new CombinationRule
            {
                AudienceIds = new [] { 123, 234 },
                Operator = LogicalOperator.And
            },
            new CombinationRule
            {
                AudienceIds = new [] { 345, 456 },
                Operator = LogicalOperator.And
            },
        },
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // '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(bulkCombinedList);

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

Audiência

O nome da lista combinada.

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

Adicionar: Necessário
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: Só de leitura
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 adicionar ou atualizar a duração combinada da associação à lista, regra ou identificador de etiqueta.

Esta propriedade estará vazia se a etiqueta UET associada à lista combinada tiver o estado Não Verificado ou Inativo, uma vez que a lista combinada não pode receber as informações do cliente do site de que precisa para criar a lista.

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: Só de leitura

Regra de Combinação

Uma regra de combinação inclui condições utilizadas para determinar quem adicionar à sua lista combinada.

Pode combinar audiências personalizadas, listas de clientes, audiências de produtos, audiências semelhantes e listas de remarketing. Não pode incluir outras listas combinadas ou audiências no mercado numa lista combinada.

Pode criar um máximo de 1000 listas combinadas por conta de anúncio e até 5000 por cliente. A regra de combinação de cada lista pode incluir até 100 conjuntos de condições lógicas e cada conjunto pode conter até 100 IDs de audiência.

Com algumas restrições descritas abaixo, pode combinar audiências com estes operadores lógicos:

  • OU: Isto incluirá clientes que estão em qualquer uma destas listas de audiências.
  • E: Isto incluirá apenas os clientes que estão em cada uma destas listas de audiências.
  • NÃO: Isto excluirá os clientes que estão em qualquer uma destas listas de audiências.

Um conjunto de condições lógicas refere-se a um grupo de IDs de audiência qualificados por OU, E ou NÃO. Na API em Massa, cada conjunto é delimitado por um e comercial ('&').

Por exemplo, aqui estão 10 conjuntos para uma regra de combinação, cada um com um ID de audiência: NOT(1)&AND(2)&OU(3)&NOT(4)&AND(5)&OR(6)&NOT(7)&AND(8)&OR(9)&NOT(10)

Eis um exemplo de 10 conjuntos para uma regra de combinação, cada um com dois IDs de audiência: NÃO(1.101)&AND(2.102)&OU(3.103)&NOT(4.104)&AND(5.105))&OR(6.106)&NOT(7.107)&AND(8.108)&OR(9.109)&NOT(10.110)

A avaliação da expressão lógica determina quem será adicionado à lista combinada. Várias combinações são sempre combinadas com uma função E. Isto significa que um cliente tem de cumprir todos os critérios de cada combinação para aparecer nesta lista de audiências de combinação personalizada. Por exemplo, digamos que a regra de combinação está definida como NOT(123.234)&NOT(345.456)&AND(567.678)&OR(789.890)&OR(987.876). A lista combinada incluirá os clientes que a) estão na audiência 567 e 678 e b) estão na audiência 789 ou 890, e c) estão na audiência 987 ou 876, a menos que d) o cliente esteja na audiência 123, 234, 345 ou 456.

Uma lista combinada tem de incluir, pelo menos, uma audiência com os operadores OU ou E. Uma lista combinada não pode utilizar apenas o operador NOT. Nesse caso, deve utilizar antes exclusões de audiência.

As audiências personalizadas e as listas de clientes não podem ser combinadas com outros tipos de audiência.

Não é possível combinar audiências semelhantes através dos operadores AND ou NOT. As audiências semelhantes só podem ser utilizadas numa única condição OR. Por outras palavras, só pode haver um conjunto de audiências que contenha audiências semelhantes e esse conjunto tem de utilizar o operador OR.

São permitidas audiências duplicadas, embora não seja possível combinar o mesmo ID de audiência através do operador E e NÃO.

Se estiver a criar uma nova audiência juntamente com esta Lista Combinada no mesmo Carregamento em massa, a regra de combinação pode incluir um identificador negativo igual ao campo ID da outra nova audiência. Por exemplo, se estiver a criar uma nova Lista de Remarketing e também quiser incluí-la na lista combinada, pode definir o valor de ID da lista de remarketing como -1. No mesmo Carregamento em massa, pode consultar a nova lista de remarketing com -1 na regra de combinação, por exemplo, NOT(123.234)&AND(345.456)&OR(-1,678). Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.

Se estiver a criar uma nova audiência juntamente com esta Lista Combinada no mesmo carregamento em massa, a regra de combinação pode incluir uma chave de referência negativa para o campo de ID negativo da outra nova audiência. Também pode utilizar uma chave de referência lógica para o campo Audiência (nome) da outra nova audiência.

  • Como exemplo de utilização de uma chave de referência negativa, no mesmo carregamento em massa incluem-se uma nova Lista de Remarketing onde o ID está definido como -1. Em seguida, veja a nova lista de remarketing com -1 na regra de combinação, por exemplo, NOT(123.234)&AND(345.456)&OR(-1,678).
  • Como exemplo de utilização de uma chave de referência lógica, no mesmo carregamento em massa incluem-se uma nova Lista de Remarketing em que o nome da Audiência está definido como A Minha Nova Audiência. Em seguida, consulte a nova lista de remarketing com "A Minha Audiência" (entre plicas) na regra de combinação, por exemplo, NOT(123.234)&AND(345.456)&OR('My New Audience',678).

Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.

Adicionar: Necessário
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

Descrição

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

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

Adicionar: Opcional
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 lista combinada.

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 gerado pelo sistema da conta ou do cliente. Se o Âmbito estiver definido como Conta, este é o ID da conta e, caso contrário, é o ID do cliente.

Adicionar: Opcional
Atualização: Só de leitura. Não pode alterar o ID principal.
Eliminar: Só de leitura

Âmbito

O âmbito define que contas podem utilizar esta lista combinada. Se o âmbito estiver definido como Conta, a lista combinada só pode ser associada a campanhas e grupos de anúncios numa conta especificada (ID Principal). Se o âmbito estiver definido como Cliente, a lista combinada pode ser associada a quaisquer campanhas e grupos de anúncios em todas as contas do cliente.

Adicionar: Necessário
Atualização: Só de leitura. Não pode alterar o âmbito.
Eliminar: Só de leitura

Estado

O estado da lista combinada.

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

Adicionar: Opcional. O valor predefinido é Ativo.
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 lista combinada.

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