Registo de Lista de Remarketing Baseado na Impressão - Em Massa

Define uma lista de remarketing baseada em impressões que pode ser transferida e carregada num ficheiro em massa.

Pode transferir todos os registos da Lista de Remarketing Baseada em Impressões na conta ao incluir o valor DownloadEntity de ImpressionBasedRemarketingLists 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 exemplo CSV em massa seguinte adicionaria uma nova lista de remarketing baseada na impressão.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Impression Campaign Id,Impression Ad Group Id,Entity Type
Format Version,,,,,,6.0,,,,,,
Impression Based Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name,CampaignIdHere,AdGroupIdHere,AdGroup
Impression Based Remarketing List,Active,-11,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name1,CampaignIdHere,,Campaign

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

    // Map properties in the Bulk file to the 
    // ImpressionBasedRemarketingList object of the Campaign Management service.
    ImpressionBasedRemarketingList = new ImpressionBasedRemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New Impression Based Remarketing List",
        // 'Id' column header in the Bulk file
        Id = impressionBasedRemarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Impression Based Remarketing List" + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Impression Ad Group Id' column header in the Bulk file
        AdGroupId = AdGroupIdHere,
        // 'Impression Campaign Id' column header in the Bulk file
        CampaignId = CampaignIdHere,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
        // 'Entity Type' column header in the Bulk file
        EntityType = ImpressionBasedEntityType.AdGroup
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkImpressionBasedRemarketingList);

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 de Remarketing Baseada em Impressões , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

• Audiência
• Tamanho da Rede da Audiência
• Tamanho da Pesquisa da Audiência
• ID de Cliente
• Descrição
• Tipo de Entidade
• ID
• ID do Grupo de Anúncios Impression
• ID de Campanha de Impressão
• Duração da Associação
• Hora da Modificação
• ID principal
• Âmbito
• Estado
• Tipos de Campanha Suportados

Audiência

O nome da lista de remarketing baseada na impressão.

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 da associação à lista de remarketing baseada na impressão, regra ou identificador de etiqueta.

Esta propriedade estará vazia se a etiqueta UET associada à lista de remarketing baseada na impressão tiver o estado Não Verificado ou Inativo, porque a lista de remarketing baseada na impressão não pode receber as informações do cliente do seu 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

Descrição

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

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

Tipo de Entidade

Este tipo de entidade baseia-se na forma como os utilizadores visualizaram um anúncio. Tem de especificar o tipo de entidade quando cria uma lista de remarketing baseada em impressões. Os valores possíveis são AdGroup ou Campaign.

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

ID

O identificador gerado pelo sistema da lista de remarketing baseada na impressão.

Adicionar: Só de leitura
Atualização: Só de leitura e Obrigatório
Eliminar: Só de leitura e Obrigatório

ID do Grupo de Anúncios Impression

O AdGroupId utilizado para criar a lista de remarketing baseada na impressão.

Adicionar: Se o Tipo de Entidade for AdGroup, é Necessário. Se Tipo de Entidade for Campanha, significa que está vazio.
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

ID de Campanha de Impressão

O CampaignId utilizado para criar a lista de remarketing baseada na impressão.

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

Duração da Associação

Quando cria uma lista de remarketing baseada em impressões, pode especificar até que ponto o Microsoft Advertising deve procurar ações que correspondam à sua definição de lista de remarketing baseada na impressão para adicionar pessoas à sua lista.

A duração mínima é de 1 dia e a duração máxima permitida é de 30 dias.

Adicionar: Opcional
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

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

Modelo de Regra CustomEvents

Para a regra CustomEvents , tem de incluir um ou mais dos seguintes pares de operadores de eventos condicionais: (ActionOperator e Action), (CategoryOperator e Category), (LabelOperator e Label) (ValueOperator e Value). Se for especificada mais do que uma condição, as condições são associadas com o operador lógico E . Por outras palavras, o visitante só será adicionado à sua lista de remarketing baseada na impressão se todas as condições de regra especificadas forem cumpridas.

Por exemplo, digamos que os seguintes eventos personalizados são definidos como uma expressão lógica no ficheiro em massa:

CustomEvents(Category Equals video) e (Action Equals play) e (Label Equals trailer) e (Value Equals 5)

A avaliação da expressão lógica determina quem será adicionado à lista de remarketing baseada na impressão.

Modelo de Regra de PageVisitors

Para a regra PageVisitors , tem de incluir um ou mais grupos de itens de regra.

Importante

Durante o ano civil de 2021, adicionámos suporte para formulário normal conjuntivo (CNF). Anteriormente, o Microsoft Advertising suportava apenas um formulário normal disjuntivo (DNF). O formulário normal predefinido para uma nova regra de visitantes de página permanece DNF. No entanto, tem de garantir que a sua aplicação pode ler e distinguir adequadamente entre CNF e DNF. A aplicação já não deve assumir que a regra é disjuntiva.

Se o formulário normal for conjuntivo (CNF), as condições do item de regra para a mesma página são primeiro associadas com o operador OR lógico. Em seguida, cada resultado da lista de grupos de itens de regra é associado com o operador lógico E . Por outras palavras, o utilizador será adicionado à sua lista de remarketing baseada na impressão se alguma das condições do item de regra especificada em todos os grupos de itens de regra for cumprida.

• Regra 1 E Regra 2
• (Regra 1 OU Regra 2) E Regra 3
• (Regra 1 OU Regra 2) AND (Regra 3 OU Regra 4)

Se o formulário normal for disjuntivo (DNF), as condições do item de regra para a mesma página são primeiro associadas com o operador AND lógico. Em seguida, cada resultado da lista de grupos de itens de regra é associado com o operador lógico OR . Por outras palavras, o utilizador será adicionado à sua lista de remarketing baseada na impressão se todas as condições do item de regra especificadas em qualquer um dos grupos de itens de regra forem cumpridas.

• Regra 1 OU Regra 2
• (Regra 1 E Regra 2) OR Regra 3
• (Regra 1 E Regra 2) OR (Regra 3 E Regra 4)

Para obter um exemplo de avaliação DNF, digamos que os seguintes grupos de itens de regra estão definidos como uma expressão lógica no ficheiro em massa:

PageVisitors((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z))

A avaliação da expressão lógica determina qual dos seguintes utilizadores de exemplo será adicionado à lista de remarketing baseada na impressão.

Utilizador	URL Visitado	URL do Referenciador	Adicionado à Lista
Utilizador 1	A	X	Sim. Avaliação dos resultados da expressão lógica como Verdadeiro. ((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z)) (Falso e Verdadeiro) ou (Verdadeiro) ou (Falso) Falso ou Verdadeiro ou Falso Verdadeiro
Utilizador 2	B	Y	Não. Avaliação dos resultados da expressão lógica como Falso. ((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z)) (Falso e Verdadeiro) ou (Falso) ou (Falso) Falso ou Falso ou Falso Falso
Utilizador 3	C	Z	Sim. Avaliação dos resultados da expressão lógica como Verdadeiro. ((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z)) (Falso e Falso) ou (Verdadeiro) ou (Verdadeiro) Falso ou Verdadeiro ou Verdadeiro Verdadeiro

PageVisitorsWhoDidNotVisitAnotherPage Rule Template

As regras de remarketing são condições utilizadas para determinar quem adicionar à sua lista de remarketing baseada na impressão. Para a regra PageVisitorsWhoDidNotVisitAnotherPage , tem de incluir um ou mais grupos de itens de regra para a página visitada (IncludeRuleItemGroups) e também tem de incluir um ou mais grupos de itens de regra para a página que não deve ter sido visitada (ExcludeRuleItemGroups).

Para cada grupo de itens de regra em IncludeRuleItemGroups, as condições do item de regra para a mesma página são associadas com o operador AND lógico. Em seguida, cada resultado da lista de grupos de itens de regra é associado com o operador lógico OR .

Da mesma forma, para cada grupo de itens de regra em ExcludeRuleItemGroups, as condições do item de regra para a mesma página são associadas com o operador AND lógico. Em seguida, cada resultado da lista de grupos de itens de regra é associado com o operador lógico OR . Por fim, o operador lógico NOT será aplicado ao resultado agregado de grupos de itens de regra de exclusão.

Por outras palavras, o visitante será adicionado à sua lista de remarketing baseada na impressão se alguma das condições do grupo incluir item de regra for cumprida e nenhuma das condições do grupo de itens de regra de exclusão for cumprida.

Por exemplo, digamos que os seguintes grupos de itens de regra estão definidos como uma expressão lógica no ficheiro em massa:

(((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z))) e não (((Url ComeçaCom A) e (ReferrerUrl BeginsWith B)) ou ((Url Contém C)))

A avaliação da expressão lógica determina qual dos seguintes utilizadores de exemplo será adicionado à lista de remarketing baseada na impressão.

Utilizador	URL Visitado	URL do Referenciador	Adicionado à Lista
Utilizador 1	A	X	Sim. Avaliação dos resultados da expressão lógica como Verdadeiro. (((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z))) e não (((Url ComeçaCom A) e (ReferrerUrl BeginsWith B)) ou ((Url Contém C))) ((Falso e Verdadeiro) ou (Verdadeiro) ou (Falso)) e não ((Verdadeiro e Falso) ou (Falso)) (Falso ou Verdadeiro ou Falso) e não (Falso ou Falso) Verdadeiro e não Falso Verdadeiro
Utilizador 2	B	Y	Sim. Avaliação dos resultados da expressão lógica como Verdadeiro. (((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z))) e não (((Url ComeçaCom A) e (ReferrerUrl BeginsWith B)) ou ((Url Contém C))) ((Falso e Verdadeiro) ou (Verdadeiro) ou (Falso)) e não ((Falso e Falso) ou (Falso)) (Falso ou Verdadeiro ou Falso) e não (Falso ou Falso) Verdadeiro e não Falso Verdadeiro
Utilizador 3	C	Z	Não. Avaliação dos resultados da expressão lógica como Falso. (((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z))) e não (((Url ComeçaCom A) e (ReferrerUrl BeginsWith B)) ou ((Url Contém C))) ((Falso e Falso) ou (Verdadeiro) ou (Verdadeiro)) e não ((Falso e Falso) ou (Verdadeiro)) (Falso ou Verdadeiro ou Verdadeiro) e não (Falso ou Verdadeiro) Verdadeiro e não Verdadeiro Falso

PageVisitorsWhoVisitedAnotherPage Rule Template

As regras de remarketing são condições utilizadas para determinar quem adicionar à sua lista de remarketing baseada na impressão. Para a regra PageVisitorsWhoVisitedAnotherPage , tem de incluir um ou mais grupos de itens de regra para a página visitada (RuleItemGroups) e também tem de incluir um ou mais grupos de itens de regra para outra página que tenha de ser visitada (AnotherRuleItemGroups).

Para cada grupo de itens de regra em RuleItemGroups, as condições do item de regra para a mesma página são associadas com o operador AND lógico. Em seguida, cada resultado da lista de grupos de itens de regra é associado com o operador lógico OR .

Da mesma forma, para cada grupo de itens de regra dentro de AnotherRuleItemGroups, as condições do item de regra para a mesma página são associadas com o operador AND lógico. Em seguida, cada resultado da lista de grupos de itens de regra é associado com o operador lógico OR .

Por outras palavras, o visitante será adicionado à sua lista de remarketing baseada na impressão se alguma das condições do grupo de itens de regra for cumprida e qualquer uma das condições do grupo de itens de outra regra for cumprida.

Por exemplo, digamos que os seguintes grupos de itens de regra estão definidos como uma expressão lógica no ficheiro em massa:

((Url Contém X) e (ReferrerUrl NotEquals Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z))) e (((Url ComeçaCom A) e (ReferrerUrl BeginsWith B)) ou ((Url Contém C)))

A avaliação da expressão lógica determina qual dos seguintes utilizadores de exemplo será adicionado à lista de remarketing baseada na impressão.

Utilizador	URL Visitado	URL do Referenciador	Adicionado à Lista
Utilizador 1	A	X	Não. Avaliação dos resultados da expressão lógica como Falso. ((Url Contém X) e (ReferrerUrl NotEquals Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z))) e (((Url ComeçaCom A) e (ReferrerUrl BeginsWith B)) ou ((Url Contém C))) ((Falso e Verdadeiro) ou (Verdadeiro) ou (Falso)) e ((Verdadeiro e Falso) ou (Falso)) (Falso ou Verdadeiro ou Falso) e (Falso ou Falso) Verdadeiro e Falso Falso
Utilizador 2	B	Y	Não. Avaliação dos resultados da expressão lógica como Falso. ((Url Contém X) e (ReferrerUrl NotEquals Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z))) e (((Url ComeçaCom A) e (ReferrerUrl BeginsWith B)) ou ((Url Contém C))) ((Falso e Verdadeiro) ou (Verdadeiro) ou (Falso)) e ((Falso e Falso) ou (Falso)) (Falso ou Verdadeiro ou Falso) e (Falso ou Falso) Verdadeiro e Falso Falso
Utilizador 3	C	Z	Sim. Avaliação dos resultados da expressão lógica como Verdadeiro. ((Url Contém X) e (ReferrerUrl NotEquals Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z))) e (((Url ComeçaCom A) e (ReferrerUrl BeginsWith B)) ou ((Url Contém C))) ((Falso e Verdadeiro) ou (Verdadeiro) ou (Verdadeiro)) e ((Falso e Falso) ou (Verdadeiro)) (Falso ou Verdadeiro ou Verdadeiro) e (Falso ou Verdadeiro) Verdadeiro e Verdadeiro Verdadeiro

Âmbito

O âmbito define que contas podem utilizar esta lista de remarketing baseada na impressão. Se o âmbito estiver definido como Conta, a lista de remarketing baseada na impressão 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 de remarketing baseada na impressão pode ser associada a todas as 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 de remarketing baseado na impressão.

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

Adicionar: Opcional. O valor predefinido é Ativo.
Atualização: Só de leitura
Eliminar: Necessá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 de remarketing baseada em impressão.

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