Remarketing List Record - Bulk

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

Pode transferir todos os registos da Lista de Remarketing na conta ao incluir o valor DownloadEntity de RemarketingLists 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 de remarketing.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Remarketing Rule
Format Version,,,,,,6.0,,,,,,
Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New list with CustomEventsRule,30,Account,TagIdHere,Remarketing List with CustomEventsRule,CustomEvents(Action Equals play) and (Category Equals video) and (Label Equals trailer) and (Value Equals 5.00)

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

    // Map properties in the Bulk file to the 
    // RemarketingList object of the Campaign Management service.
    RemarketingList = new RemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New list with CustomEventsRule",
        // 'Id' column header in the Bulk file
        Id = remarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Remarketing List with CustomEventsRule " + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Remarketing Rule' column header in the Bulk file
        Rule = new CustomEventsRule
        {
            // The rule definition is translated to the following logical expression: 
            // CustomEvents(Category Equals video) and (Action Equals play) and (Label Equals trailer) 
            // and (Value Equals 5)
            Action = "play",
            ActionOperator = StringOperator.Equals,
            Category = "video",
            CategoryOperator = StringOperator.Equals,
            Label = "trailer",
            LabelOperator = StringOperator.Equals,
            Value = 5.00m,
            ValueOperator = NumberOperator.Equals,
        },
        // '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,
        // 'UET Tag Id' column header in the Bulk file
        TagId = tagIdKey
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkRemarketingList);

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 Lista de Remarketing , 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
• ID
• Duração da Associação
• Hora da Modificação
• ID principal
• Regra de Remarketing
• Âmbito
• Estado
• Tipos de Campanha Suportados
• ID da Etiqueta UET

Audiência

O nome da lista de remarketing.

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, regra ou identificador de etiqueta.

Esta propriedade estará vazia se a etiqueta UET associada à lista de remarketing tiver o estado Não Verificado ou Inativo, porque a lista de remarketing 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

Descrição

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

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 de remarketing.

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

Duração da Associação

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

A duração mínima é de 1 dia e a duração máxima permitida é de 180 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).

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

Regra de Remarketing

Um modelo de regra inclui condições utilizadas para determinar quem adicionar à sua lista de remarketing.

Pode escolher um dos quatro tipos de regras para direcionar diferentes audiências: CustomEventsRule, PageVisitorsRule, PageVisitorsWhoDidNotVisitAnotherPageRule e PageVisitorsWhoVisitedAnotherPageRule. Para obter detalhes sobre o formato de cada regra no ficheiro em massa, consulte as secções CustomEvents, PageVisitors, PageVisitorsWhoDidNotVisitAnotherPage e PageVisitorsWhoVisitedAnotherPage rule template comments below.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se quiser manter qualquer um dos itens de regra anteriores, tem de defini-los explicitamente novamente durante a atualização. Pode optar por alterar o tipo de regra durante a atualização.
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 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.

Modelo de Regra de PageVisitors

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

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

PageVisitorsWhoDidNotVisitAnotherPage Rule Template

As regras de remarketing são condições utilizadas para determinar quem adicionar à sua lista de remarketing. 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 se alguma das condições do grupo incluir item de regra for cumprida e nenhuma das condições do grupo de itens da 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.

PageVisitorsWhoVisitedAnotherPage Rule Template

As regras de remarketing são condições utilizadas para determinar quem adicionar à sua lista de remarketing. 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 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.

Âmbito

O âmbito define que contas podem utilizar esta lista de remarketing. Se o âmbito estiver definido como Conta, a lista de remarketing 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 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 de remarketing.

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.

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

ID da Etiqueta UET

O identificador do Microsoft Advertising da etiqueta Deteção de Eventos Universais (UET) que é utilizada com a lista de remarketing.

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