Record elenco remarketing - Bulk

Definisce un elenco di remarketing che può essere scaricato e caricato in un file bulk.

Nota

Microsoft Advertising genererà automaticamente gruppi di destinatari simili per gli elenchi di remarketing se si è un partecipante pilota. Non è possibile creare o modificare gruppi di destinatari simili per un elenco di remarketing. Detto questo, è possibile aggiungere ed eliminare associazioni ed esclusioni di elenchi di remarketing simili. Se si elimina l'elenco di remarketing di origine, verranno eliminati anche i destinatari simili. Se un pubblico simile è associato a una campagna o a un gruppo di annunci, non puoi eliminare l'elenco di remarketing di origine. Per altri dettagli, vedere Elenco remarketing simile .

Consiglio

Per una panoramica e altre informazioni sui gruppi di destinatari, vedere la guida tecnica sulle API audience .

È possibile scaricare tutti i record dell'elenco remarketing nell'account includendo il valore DownloadEntity di RemarketingLists nella richiesta di servizio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Inoltre, la richiesta di download deve includere l'ambito EntityData . Per altre informazioni sul servizio bulk, incluse le procedure consigliate, vedere Download e caricamento in blocco.

Nell'esempio csv bulk seguente viene aggiunto un nuovo elenco di 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 si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkRemarketingList , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.

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();

Per un record dell'elenco di remarketing , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

• Gruppo di destinatari
• Dimensioni della rete del gruppo di destinatari
• Dimensioni della ricerca del gruppo di destinatari
• Client Id
• Descrizione
• Id
• Durata appartenenza
• Ora modifica
• Parent Id
• Regola di remarketing
• Ambito
• Stato
• Tipi di campagna supportati
• UET Tag Id

Gruppo di destinatari

Nome dell'elenco di remarketing.

Il nome può contenere un massimo di 128 caratteri.

Aggiungere: Obbligatorio
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Sola lettura

Dimensioni della rete del gruppo di destinatari

Numero totale di persone che sono membri attivi di questo gruppo di destinatari nella rete Audience. In questo modo si ha un'idea del numero di utenti di rete audience che è possibile definire come target.

Il pubblico deve avere almeno 300 persone prima che Microsoft Advertising lo usi per le ottimizzazioni.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

Dimensioni della ricerca del gruppo di destinatari

Numero totale di persone che sono membri attivi di questo gruppo di destinatari nella rete di ricerca. In questo modo si ha un'idea del numero di utenti di ricerca di destinazione.

Il pubblico deve avere almeno 300 persone prima che Microsoft Advertising lo usi per le ottimizzazioni.

Questa proprietà sarà vuota per un massimo di 24 ore durante la compilazione del gruppo di destinatari, ad esempio se si aggiunge o si aggiorna la durata, la regola o l'identificatore di tag dell'elenco di remarketing.

Questa proprietà sarà vuota se il tag UET associato all'elenco di remarketing ha lo stato Non verificato o Inattivo, perché l'elenco di remarketing non può ricevere le informazioni sul cliente dal sito Web necessario per compilare l'elenco.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

ID Client

Usato per associare i record nel file di caricamento bulk ai record nel file dei risultati. Il valore di questo campo non viene utilizzato o archiviato dal server; viene semplicemente copiato dal record caricato nel record di risultati corrispondente. Può essere qualsiasi stringa valida fino a 100 di lunghezza.

Aggiungere: Opzionale
Aggiornare: Opzionale
Cancellare: Sola lettura

Descrizione

Descrizione dell'elenco di remarketing. Usare una descrizione per ricordare il gruppo di destinatari di questo elenco di remarketing.

La descrizione può contenere un massimo di 1.024 caratteri.

Aggiungere: Opzionale
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Cancellare: Sola lettura

Id

Identificatore generato dal sistema dell'elenco di remarketing.

Aggiungere: Sola lettura
Aggiornare: Sola lettura e Obbligatorio
Cancellare: Sola lettura e Obbligatorio

Durata appartenenza

Quando si crea un elenco di remarketing, è possibile specificare quanto tempo fa Microsoft Advertising deve cercare le azioni che corrispondono alla definizione dell'elenco di remarketing per aggiungere persone all'elenco.

La durata minima è 1 giorno e la durata massima consentita è di 180 giorni.

Aggiungere: Opzionale
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Sola lettura

Ora modifica

Data e ora dell'ultimo aggiornamento dell'entità. Il valore è espresso nell'ora UTC (Coordinated Universal Time).

Nota

Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

Parent Id

Identificatore generato dal sistema dell'account o del cliente. Se l'ambito è impostato su Account, questo è l'ID account e in caso contrario è l'ID cliente.

Aggiungere: Opzionale
Aggiornare: Sola lettura. Non è possibile modificare l'ID padre.
Cancellare: Sola lettura

Regola di remarketing

Un modello di regola include le condizioni usate per determinare chi aggiungere all'elenco di remarketing.

È possibile scegliere uno dei quattro tipi di regole per gruppi di destinatari diversi: CustomEventsRule, PageVisitorsRule, PageVisitorsWhoDidNotVisitAnotherPageRule e PageVisitorsWhoVisitedAnotherPageRule. Per informazioni dettagliate sul formato di ogni regola nel file bulk, vedere le sezioni del modello di regola CustomEvents, PageVisitors, PageVisitorsWhoDidNotVisitAnotherPage e PageVisitorsWhoVisitedAnotherPage .

Aggiungere: Obbligatorio
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si desidera mantenere uno qualsiasi degli elementi della regola precedente, è necessario impostarli di nuovo in modo esplicito durante l'aggiornamento. È possibile scegliere di modificare il tipo di regola durante l'aggiornamento.
Cancellare: Sola lettura

Modello di regola CustomEvents

Per la regola CustomEvents , è necessario includere una o più delle coppie di operatori di eventi condizionali seguenti: (ActionOperator e Action), (CategoryOperator e Category), (LabelOperator ed Label), (ValueOperator e Value). Se viene specificata più di una condizione, le condizioni vengono unite in join usando l'operatore AND logico. In altre parole, il visitatore verrà aggiunto all'elenco di remarketing solo se vengono soddisfatte tutte le condizioni della regola specificate.

Si supponga, ad esempio, che gli eventi personalizzati seguenti siano impostati come espressione logica nel file bulk:

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

La valutazione dell'espressione logica determina chi verrà aggiunto all'elenco di remarketing.

Modello di regola PageVisitors

Per la regola PageVisitors , è necessario includere uno o più gruppi di elementi delle regole.

Importante

Durante l'anno civile 2021 è stato aggiunto il supporto per la forma normale congiuntiva (CNF). In precedenza Microsoft Advertising supportava solo il formato normale disgiuntivo (DNF). Il modulo normale predefinito per una nuova regola per i visitatori della pagina rimane DNF. Tuttavia, è necessario assicurarsi che l'applicazione possa leggere e distinguere in modo appropriato tra CNF e DNF. L'applicazione non deve più presumere che la regola sia disgiuntiva.

Se il formato normale è congiuntivo (CNF), le condizioni dell'elemento della regola per la stessa pagina vengono unite per la prima volta tramite l'operatore OR logico. Quindi, ogni risultato dell'elenco dei gruppi di elementi delle regole viene unito usando l'operatore AND logico. In altre parole, l'utente verrà aggiunto all'elenco di remarketing se viene soddisfatta una delle condizioni specificate per l'elemento della regola all'interno di tutti i gruppi di elementi delle regole.

• Regola 1 E regola 2
• (Regola 1 O Regola 2) REGOLA AND 3
• (Regola 1 O Regola 2) AND (Regola 3 O Regola 4)

Se il formato normale è disgiuntivo (DNF), le condizioni dell'elemento della regola per la stessa pagina vengono prima unite in join usando l'operatore AND logico. Quindi, ogni risultato dell'elenco dei gruppi di elementi delle regole viene unito usando l'operatore OR logico. In altre parole, l'utente verrà aggiunto all'elenco di remarketing se vengono soddisfatte tutte le condizioni specificate per l'elemento della regola all'interno di uno qualsiasi dei gruppi di elementi delle regole.

• Regola 1 O Regola 2
• (Regola 1 E regola 2) Regola OR 3
• (Regola 1 E regola 2) OR (Regola 3 E Regola 4)

Per un esempio di valutazione DNF, si supponga che i gruppi di elementi delle regole seguenti siano impostati come espressione logica nel file bulk:

PageVisitors((Url Contains X) and (ReferrerUrl DoesNotContain Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))

La valutazione dell'espressione logica determina quale degli utenti di esempio seguenti verrà aggiunto all'elenco di remarketing.

Utente	URL visitato	Referrer Url	Aggiunta all'elenco
Utente 1	A	X	Sì. Valutazione dei risultati dell'espressione logica come True. ((Url contiene X) e (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z)) (False e True) o (True) o (False) False o True o False Vero
Utente 2	B	Y	No. Valutazione dei risultati dell'espressione logica come False. ((Url contiene X) e (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z)) (False e True) o (False) o (False) False o False o False Falso
Utente 3	C	Z	Sì. Valutazione dei risultati dell'espressione logica come True. ((Url contiene X) e (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z)) (False e False) o (True) o (True) False o True o True Vero

Modello di regola PageVisitorsWhoDidNotVisitAnotherPage

Le regole di remarketing sono condizioni usate per determinare chi aggiungere all'elenco di remarketing. Per la regola PageVisitorsWhoDidNotVisitAnotherPage , è necessario includere uno o più gruppi di elementi delle regole per la pagina visitata (IncludeRuleItemGroups) e includere anche uno o più gruppi di elementi delle regole per la pagina che non devono essere stati visitati (ExcludeRuleItemGroups).

Per ogni gruppo di elementi della regola all'interno di IncludeRuleItemGroups, le condizioni dell'elemento della regola per la stessa pagina vengono unite in join usando l'operatore AND logico. Quindi, ogni risultato dell'elenco dei gruppi di elementi delle regole viene unito usando l'operatore OR logico.

Analogamente, per ogni gruppo di elementi delle regole all'interno di ExcludeRuleItemGroups, le condizioni dell'elemento regola per la stessa pagina vengono unite in join usando l'operatore AND logico. Quindi, ogni risultato dell'elenco dei gruppi di elementi delle regole viene unito usando l'operatore OR logico. Infine, l'operatore NOT logico verrà applicato al risultato aggregato dei gruppi di elementi delle regole di esclusione.

In altre parole, il visitatore verrà aggiunto all'elenco di remarketing se viene soddisfatta una qualsiasi delle condizioni del gruppo di elementi della regola di inclusione e non viene soddisfatta alcuna condizione del gruppo di elementi della regola di esclusione.

Si supponga, ad esempio, che i gruppi di elementi delle regole seguenti siano impostati come espressione logica nel file bulk:

(((Url Contiene X) e (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) e non (((Url BeginsWith A) e (ReferrerUrl BeginsWith B)) o ((Url contiene C)))

La valutazione dell'espressione logica determina quale degli utenti di esempio seguenti verrà aggiunto all'elenco di remarketing.

Utente	URL visitato	Referrer Url	Aggiunta all'elenco
Utente 1	A	X	Sì. Valutazione dei risultati dell'espressione logica come True. (((Url Contiene X) e (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) e non (((Url BeginsWith A) e (ReferrerUrl BeginsWith B)) o ((Url contiene C))) ((False e True) o (True) o (False)) e not ((True e False) o (False)) (False o True o False) e non (False o False) True e non False Vero
Utente 2	B	Y	Sì. Valutazione dei risultati dell'espressione logica come True. (((Url Contiene X) e (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) e non (((Url BeginsWith A) e (ReferrerUrl BeginsWith B)) o ((Url contiene C))) ((False e True) o (True) o (False)) e not ((False e False) o (False)) (False o True o False) e non (False o False) True e non False Vero
Utente 3	C	Z	No. Valutazione dei risultati dell'espressione logica come False. (((Url Contiene X) e (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) e non (((Url BeginsWith A) e (ReferrerUrl BeginsWith B)) o ((Url contiene C))) ((False e False) o (True) o (True)) e not ((False e False) o (True)) (False o True o True) e non (False o True) True e non True Falso

Modello di regola PageVisitorsWhoVisitedAnotherPage

Le regole di remarketing sono condizioni usate per determinare chi aggiungere all'elenco di remarketing. Per la regola PageVisitorsWhoVisitedAnotherPage , è necessario includere uno o più gruppi di elementi delle regole per la pagina visitata (RuleItemGroups) e includere anche uno o più gruppi di elementi delle regole per un'altra pagina che deve essere stata visitata (AnotherRuleItemGroups).

Per ogni gruppo di elementi delle regole all'interno di RuleItemGroups, le condizioni dell'elemento della regola per la stessa pagina vengono unite in join usando l'operatore AND logico. Quindi, ogni risultato dell'elenco dei gruppi di elementi delle regole viene unito usando l'operatore OR logico.

Analogamente per ogni gruppo di elementi delle regole all'interno di AnotherRuleItemGroups, le condizioni dell'elemento regola per la stessa pagina vengono unite in join usando l'operatore AND logico. Quindi, ogni risultato dell'elenco dei gruppi di elementi delle regole viene unito usando l'operatore OR logico.

In altre parole, il visitatore verrà aggiunto all'elenco di remarketing se vengono soddisfatte le condizioni del gruppo di elementi della regola e vengono soddisfatte le condizioni di un altro gruppo di elementi della regola.

Si supponga, ad esempio, che i gruppi di elementi delle regole seguenti siano impostati come espressione logica nel file bulk:

(((Url Contiene X) e (ReferrerUrl NotEquals Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) e (((Url BeginsWith A) e (ReferrerUrl BeginsWith B)) o ((Url Contiene C)))

La valutazione dell'espressione logica determina quale degli utenti di esempio seguenti verrà aggiunto all'elenco di remarketing.

Utente	URL visitato	Referrer Url	Aggiunta all'elenco
Utente 1	A	X	No. Valutazione dei risultati dell'espressione logica come False. (((Url Contiene X) e (ReferrerUrl NotEquals Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) e (((Url BeginsWith A) e (ReferrerUrl BeginsWith B)) o ((Url Contiene C))) ((False e True) o (True) o (False)) e ((True e False) o (False)) (False o True o False) e (False o False) True e False Falso
Utente 2	B	Y	No. Valutazione dei risultati dell'espressione logica come False. (((Url Contiene X) e (ReferrerUrl NotEquals Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) e (((Url BeginsWith A) e (ReferrerUrl BeginsWith B)) o ((Url Contiene C))) ((False e True) o (True) o (False)) e ((False e False) o (False)) (False o True o False) e (False o False) True e False Falso
Utente 3	C	Z	Sì. Valutazione dei risultati dell'espressione logica come True. (((Url Contiene X) e (ReferrerUrl NotEquals Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))) e (((Url BeginsWith A) e (ReferrerUrl BeginsWith B)) o ((Url Contiene C))) ((False e True) o (True) o (True)) e ((False e False) o (True)) (False o True o True) e (False o True) True e True Vero

Ambito

L'ambito definisce gli account che possono usare questo elenco di remarketing. Se l'ambito è impostato su Account, l'elenco di remarketing può essere associato solo a campagne e gruppi di annunci all'interno di un account specificato (ID padre). Se l'ambito è impostato su Cliente, l'elenco di remarketing può essere associato a qualsiasi campagna e gruppo di annunci in tutti gli account del cliente.

Aggiungere: Obbligatorio
Aggiornare: Sola lettura. Non è possibile modificare l'ambito.
Cancellare: Sola lettura

Stato

Stato dell'elenco di remarketing.

I valori possibili sono Attivo o Eliminato.

Aggiungere: Opzionale. Il valore predefinito è Attivo.
Aggiornare: Sola lettura
Cancellare: Obbligatorio. Lo stato deve essere impostato su Eliminato.

Tipi di campagna supportati

Elenco delimitato da punto e virgola dei tipi di campagna che supportano questo elenco di remarketing.

I valori supportati sono Audience, DynamicSearchAds, Search e Shopping. In futuro potrebbero essere aggiunti nuovi tipi di campagna, quindi non è consigliabile assumere alcuna dipendenza da un set fisso di valori.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

UET Tag Id

Identificatore microsoft advertising del tag UET (Universal Event Tracking) usato con l'elenco di remarketing.

Aggiungere: Obbligatorio
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Sola lettura