Condividi tramite

Record del gruppo di destinatari del prodotto - Bulk

  • Articolo

Definisce un gruppo di destinatari del prodotto che può essere scaricato e caricato in un file bulk.

Nota

Gli elenchi di remarketing dinamici erano in precedenza noti come destinatari di prodotti in Microsoft Advertising. Nell'interfaccia utente di Microsoft Advertising verrà visualizzato "Elenco di remarketing dinamico", ma per evitare modifiche di rilievo, gli oggetti oggetti API sono ancora denominati "destinatari del prodotto".

Gli elenchi di remarketing dinamici associano i clienti a prodotti specifici in base a ciò che hanno esaminato, considerato o già acquistato sul tuo sito Web. È possibile usare elenchi di remarketing dinamici sia nelle campagne di ricerca che nelle campagne per i destinatari (non tutti hanno ancora campagne per il pubblico).

Gli elenchi di remarketing dinamici funzionano meglio sia con le campagne Shopping che con quelle basate su feed, ad esempio quelle campagne che sfruttano un ID negozio di Microsoft Merchant Center.

Importante

Assicurarsi di modificare lo script corrispondente all'ID tag UET nel sito Web in modo da includere i ecomm_prodid parametri e ecomm_pagetype . Il parametro ecomm_prodid è l'ID prodotto del prodotto nella pagina. È univoco per ogni elemento e deve corrispondere all'id o all'attributo item_group_id nel feed di prodotti. Solo caratteri numerici e alfanumerici (inclusi i trattini), con un massimo di 50 caratteri. Il parametro ecomm_pagetype identifica il tipo di pagina visitata dall'utente. Opzioni valide: home, searchresults, category, product, cart, purchase, other.

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

Consiglio

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

È possibile scaricare tutti i record del gruppo di destinatari di prodotti nell'account includendo il valore DownloadEntity di ProductAudiences 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 gruppo di destinatari di prodotti.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Product Audience Type,Supported Campaign Types
Format Version,,,,,,6.0,,,,,,,
Product Audience,Active,-10,ParentIdHere,ClientIdGoesHere,,,New product audience,30,Account,TagIdHere,My Product Audience,GeneralVisitors,Search;DynamicSearchAds;Shopping;Audience

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkProductAudience , 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 BulkProductAudience
var bulkProductAudience = new BulkProductAudience
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ProductAudience object of the Campaign Management service.
    ProductAudience = new ProductAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New product audience",
        // 'Id' column header in the Bulk file
        Id = productAudienceIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "My Product Audience",
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Product Audience Type' column header in the Bulk file
        ProductAudienceType = ProductAudienceType.GeneralVisitors,
        // '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(bulkProductAudience);

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 gruppo di destinatari di prodotti , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

Gruppo di destinatari

Nome del gruppo di destinatari del prodotto.

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 dell'appartenenza al gruppo di destinatari del prodotto, la regola o l'identificatore di tag.

Questa proprietà sarà vuota se il tag UET associato al gruppo di destinatari del prodotto ha lo stato Non verificato o Inattivo, perché il gruppo di destinatari del prodotto non può ricevere le informazioni sui clienti dal sito Web di cui ha bisogno 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 del gruppo di destinatari del prodotto. Usa una descrizione che ti aiuta a ricordare il gruppo di destinatari a cui stai rivolgendo il pubblico di questo prodotto.

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 del gruppo di destinatari del prodotto.

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

Durata appartenenza

Quando crei un gruppo di destinatari di prodotti, puoi specificare quanto tempo fa Microsoft Advertising deve cercare le azioni che corrispondono alla definizione del gruppo di destinatari del prodotto 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

Tipo di gruppo di destinatari del prodotto

Determina chi aggiungere al gruppo di destinatari del prodotto.

I valori possibili sono GeneralVisitors, ProductSearchers, ProductViewers, ShoppingCartAbandoners e PastBuyers.

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

Ambito

L'ambito definisce gli account che possono usare questo gruppo di destinatari del prodotto. Se l'ambito è impostato su Account, il gruppo di destinatari del prodotto può essere associato solo a campagne e gruppi di annunci all'interno di un account specificato (ID padre). Se l'ambito è impostato su Cliente, il gruppo di destinatari del prodotto 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 del gruppo di destinatari del prodotto.

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 gruppo di destinatari di prodotti.

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 il gruppo di destinatari del prodotto.

Importante

Assicurarsi di modificare lo script UET nel sito Web per includere i prodid parametri e pagetype .

window.uetq = window.uetq || [];
window.uetq.push({'prodid': 'PRODUCT_ID', 'pagetype': 'PAGE_TYPE'});

Aggiungere: Obbligatorio
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
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 al gruppo di destinatari del prodotto 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 al gruppo di destinatari del prodotto.

Modello di regola PageVisitors

Per la regola PageVisitors , è necessario includere uno o più gruppi di elementi delle regole. Con ogni gruppo di elementi della regola, 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. In altre parole, l'utente verrà aggiunto al gruppo di destinatari del prodotto se vengono soddisfatte tutte le condizioni dell'elemento regola specificate all'interno di uno qualsiasi dei gruppi di elementi delle regole.

Si supponga, ad esempio, 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 al gruppo di destinatari del prodotto.

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 al gruppo di destinatari del prodotto. 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 al gruppo di destinatari del prodotto se viene soddisfatta una delle condizioni del gruppo di elementi delle regole 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 al gruppo di destinatari del prodotto.

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 al gruppo di destinatari del prodotto. 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 al gruppo di destinatari del prodotto se vengono soddisfatte le condizioni del gruppo di elementi delle regole e vengono soddisfatte le condizioni di un altro gruppo di elementi delle regole.

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 al gruppo di destinatari del prodotto.

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