Record di partizione del prodotto del gruppo di annunci - Bulk

Definisce una partizione del prodotto del gruppo di annunci che può essere caricata e scaricata in un file bulk.

È possibile caricare i record della partizione del prodotto gruppo di annunci per più gruppi di annunci nello stesso file bulk, purché le regole di convalida siano soddisfatte come descritto di seguito.

• È necessario specificare almeno il nodo radice per la struttura ad albero del gruppo di partizioni del prodotto. Il nodo radice del gruppo di partizioni del prodotto deve avere il campo Product Condition 1 impostato su "All" e Product Value 1 null o vuoto. Se si esegue un'offerta su tutti i prodotti nel catalogo in modo uniforme, impostare il campo Sottotipo su Unità. Se si partizionano le offerte in base a condizioni di prodotto più specifiche, impostare il campo Sottotipo su Suddivisione, l'ID criterio padre su Null o vuoto e l'ID su un valore negativo. Il valore negativo verrà usato come ID criterio padre per tutti i nodi figlio.

• Il nodo radice è considerato di livello 0 e un albero può avere rami fino a 7 livelli in profondità.

• Per ogni richiesta di caricamento, è possibile includere un massimo di 20.000 nodi dell'albero della partizione del prodotto per gruppo di annunci. Il numero di nodi dell'intero albero della partizione del prodotto per un gruppo di annunci non può superare i 20.000.

• I nodi dell'albero della partizione del prodotto per lo stesso albero (stesso gruppo di annunci) devono essere raggruppati nel file.

• L'ordine dei nodi di partizione del prodotto non è garantito durante il download e i nodi padre potrebbero essere forniti dopo i nodi figlio; tuttavia, tutti i nodi per lo stesso gruppo di annunci verranno raggruppati nel file.

• Se si crea o si modifica la struttura ad albero, i nodi dell'albero di partizione del prodotto padre devono essere ordinati prima dei nodi dell'albero di partizione del prodotto figlio; tuttavia, l'ordine non è rilevante per le modifiche non strutturali, ad esempio l'aggiornamento dell'offerta. Ad esempio, se si desidera aggiornare le offerte senza aggiungere, eliminare o aggiornare la struttura ad albero, è sufficiente caricare i campi ID, ID padre e Offerta .

• Per aggiornare il campo Product Condition 1, Product Value 1 o Is Excluded , è necessario eliminare il nodo dell'albero di partizione del prodotto esistente e caricare un nuovo nodo dell'albero di partizione del prodotto che otterrà un nuovo identificatore.

• Se un'azione ha esito negativo, anche tutte le azioni rimanenti che potrebbero avere avuto esito positivo avranno esito negativo.

• Tutte le azioni di aggiunta ed eliminazione del nodo di partizione del prodotto devono comportare una struttura ad albero completa.

• Ogni percorso dal nodo radice alla fine di un ramo deve terminare con un nodo foglia (Sub Type=Unit). Ogni unità deve avere un'offerta, a meno che il campo Escluso non sia TRUE, il che significa che il nodo è un criterio di gruppo di annunci negativo.

• Ogni suddivisione deve avere almeno un nodo foglia che effettua un'offerta nella parte restante delle condizioni della suddivisione, ad esempio usare lo stesso operando delle unità di pari livello e impostare il valore product 1 null o vuoto.

• Se si aggiungono partizioni con più livelli in cui non esiste ancora né l'elemento padre né il valore figlio, usare un valore int negativo come riferimento per identificare l'elemento padre. Impostare, ad esempio, sia l'ID dell'elemento padre che il campo Id criterio padre dell'elemento figlio sullo stesso valore negativo. Gli ID negativi sono validi solo per la durata della chiamata. Gli identificatori di sistema univoci per ogni criterio del gruppo di annunci aggiunto correttamente vengono restituiti nel file dei risultati del caricamento.

• I campi Url di offerta e destinazione sono applicabili solo se il campo È escluso è FALSE, il che significa che il nodo è un criterio del gruppo di annunci che può essere offerto. Questi campi vengono tuttavia ignorati per i nodi di partizione di suddivisione . Questi elementi sono rilevanti solo per i nodi di partizione Unit (foglia).

• Per sospendere qualsiasi partizione del prodotto, devi sospendere l'intero gruppo di annunci aggiornando il campo Stato del gruppo di annunci in Pausa. È possibile sospendere l'intera campagna aggiornando il campo Stato della campagna in Pausa.

• Per un'azione Eliminata è sufficiente specificare l'ID e l'ID padre.

• Se si elimina una partizione del prodotto padre, verranno eliminati anche tutti i relativi elementi figlio e discendenti.

• Non è possibile specificare condizioni di prodotto duplicate in un ramo.

Consiglio

Per una panoramica e altre informazioni sulle campagne di shopping Microsoft, vedere le guide tecniche sugli annunci di prodotto e sulle campagne per lo shopping intelligente .

È possibile scaricare tutti i record della partizione del prodotto del gruppo ad nell'account includendo il valore DownloadEntity di AdGroupProductPartitions 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 aggiunta una nuova partizione del prodotto del gruppo di annunci se viene specificato un valore id padre valido.

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Product Condition 1,Product Value 1,Is Excluded,Parent Criterion Id,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,6.0,,,,,,,
Ad Group Product Partition,Paused,,-1112,,,,ClientIdGoesHere,,0.5,,All,,FALSE,,,,{_promoCode}=PROMO1; {_season}=summer

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAdGroupProductPartition , 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 BulkAdGroupProductPartition
var bulkAdGroupProductPartition = new BulkAdGroupProductPartition
{
    // Map properties in the Bulk file to the BiddableAdGroupCriterion or
    // NegativeAdGroupCriterion object of the Campaign Management service.
    // Use the BiddableAdGroupCriterion to set the 'Is Excluded' field in the Bulk file to True,
    // and otherwise use the NegativeAdGroupCriterion to set the 'Is Excluded' field to False.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new ProductPartition { 
            Condition = new ProductCondition
            {
                // 'Product Value 1' column header in the Bulk file
                Attribute = null,
                // 'Product Condition 1' column header in the Bulk file
                Operand = "All",
            },
            // 'Parent Criterion Id' column header in the Bulk file
            ParentCriterionId = null
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
            Amount = 0.50
        },
        // 'Destination Url' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        DestinationUrl = null,
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // 'Tracking Template' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupProductPartition);

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

• Gruppo di annunci
• Offerta
• Rettifica dell'offerta
• Campagna
• Client Id
• Parametro personalizzato
• URL di destinazione
• Suffisso URL finale
• Id
• È escluso
• Ora modifica
• ID criterio padre
• Parent Id
• Condizione del prodotto 1
• Valore prodotto 1
• Stato
• Sottotipo
• Modello di rilevamento

Gruppo di annunci

Nome del gruppo di annunci che contiene la partizione del prodotto.

Aggiungere: Sola lettura e Obbligatorio
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

Nota

Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Gruppo di annunci .

Offerta

Importo da presentare all'asta.

Nota

Per i gruppi di annunci in Microsoft Shopping Campaigns configurati per i prodotti sponsorizzati, questo campo non è applicabile se l'opzione di offerta del gruppo di annunci è impostata su BidBoost. Per altre informazioni, vedere Rettifica offerta .

Aggiungere: Obbligatorio se è escluso è FALSE e il sottotipo è Unità e in caso contrario l'offerta non è consentita.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura

Rettifica dell'offerta

Percentuale (maggiore di zero) che consente la flessione dell'offerta di Prodotti sponsorizzati.

Si supponga, ad esempio, che il partner presenti un'offerta di $5 USD nel gruppo di prodotti (tramite il campo Bid ). Se la rettifica dell'offerta (questo campo) è impostata su 20 (percentuale) e l'offerta massima del gruppo di annunci è 0,50 (50 centesimi), la quota sarà di 50 centesimi e non di 1 USD.

Questo campo è applicabile solo se l'opzione di offerta del gruppo di annunci è impostata su BidBoost. Se l'opzione di offerta del gruppo di annunci è impostata su BidValue, l'asta usa l'offerta del gruppo di prodotti.

I valori supportati sono negativi da novanta (-90) a 900 positivi (900).

Nota

Questa impostazione è applicabile solo ai gruppi di annunci in Microsoft Shopping Campaigns configurati per i prodotti sponsorizzati. I prodotti sponsorizzati sono disponibili solo nel Stati Uniti e sono attualmente in versione beta aperta.

Aggiungere: Opzionale. La rettifica dell'offerta verrà impostata sul valore predefinito 0 se non inclusa.
Aggiornamento: Obbligatorio
Elimina: Sola lettura

Campagna

Nome della campagna che contiene il gruppo di annunci e la partizione del prodotto.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: 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
Aggiornamento: Opzionale
Elimina: Sola lettura

Parametro personalizzato

Raccolta personalizzata di parametri chiave e valore per il rilevamento url.

In un file bulk l'elenco dei parametri personalizzati viene formattato come segue.

• Formattare ogni coppia di parametri personalizzata come Key=Value, ad esempio {_promoCode}=PROMO1.

• Microsoft Advertising accetterà le prime 8 coppie chiave parametro e valore personalizzate incluse e, se si includono più di 8 parametri personalizzati, verrà restituito un errore.

• Ogni coppia chiave/valore è delimitata da un punto e virgola e da uno spazio ("; "), ad esempio {_promoCode}=PROMO1; {_season}=summer.

• Una chiave non può contenere un punto e virgola. Se un valore contiene un punto e virgola, deve essere preceduto da caratteri di escape come '\;'. Inoltre, se il valore contiene una barra rovesciata, deve anche essere preceduto da escape come '\'.

• La chiave non può superare i 16 byte UTF-8 e il valore non può superare i 250 byte UTF-8. La chiave è obbligatoria e il valore è facoltativo. Le dimensioni massime della chiave non includono le parentesi graffe e il carattere di sottolineatura, ad esempio '{', '_' e '}'.

  Nota

  Con il servizio bulk la chiave deve essere formattata con parentesi graffe circostanti e un carattere di sottolineatura iniziale, ad esempio se la chiave è promoCode, deve essere formattata come {_promoCode}. Con il servizio Campaign Management non è possibile specificare le parentesi graffe e il carattere di sottolineatura circostanti.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per rimuovere tutti i parametri personalizzati, impostare questo campo su delete_value. La parola chiave delete_value rimuove l'impostazione precedente. Per rimuovere un subset di parametri personalizzati, specificare i parametri personalizzati che si desidera mantenere e omettere eventuali parametri che non si desidera mantenere. Il nuovo set di parametri personalizzati sostituirà qualsiasi set di parametri personalizzato precedente.
Elimina: Sola lettura

URL di destinazione

URL della pagina Web a cui l'utente viene indirizzato quando fa clic sull'annuncio.

Se attualmente si usano gli URL di destinazione, è necessario sostituirli con Modelli di rilevamento. Per altre informazioni, vedere Rilevamento url con URL aggiornati.

L'URL può contenere parametri dinamici, ad esempio {MatchType}. Per un elenco dei parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?.

L'URL può contenere un massimo di 1.024 caratteri. Se l'URL non specifica un protocollo, il sistema usa il protocollo HTTP quando un utente fa clic sull'annuncio. Se l'URL specifica il protocollo HTTP quando si aggiunge un annuncio, il servizio rimuoverà la stringa del protocollo http:// (la stringa del protocollo HTTP non viene conteggiata rispetto al limite di 1.024 caratteri); tuttavia, il servizio non rimuoverà una stringa di protocollo HTTPS (https://) dall'URL.

Nota

Questo URL di destinazione viene usato se specificato; in caso contrario, l'URL di destinazione è determinato dal valore corrispondente del 'Link' specificato per l'offerta del prodotto nel catalogo di Microsoft Merchant Center.

Aggiungere: Opzionale
Aggiornamento: 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.
Elimina: Sola lettura

Suffisso URL finale

Il suffisso URL finale può includere parametri di rilevamento che verranno aggiunti alla fine dell'URL della pagina di destinazione. È consigliabile inserire parametri di rilevamento richiesti dalla pagina di destinazione in un suffisso URL finale in modo che i clienti vengano sempre inviati alla pagina di destinazione. Per altri dettagli e regole di convalida, vedere Suffisso URL finale nelle guide tecniche.

Aggiungere: Opzionale
Aggiornamento: 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.
Elimina: Sola lettura

Id

Identificatore generato dal sistema della partizione del prodotto.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

È escluso

Determina se la partizione del prodotto rappresenta un criterio di offerta o negativo.

Se impostato su TRUE , si tratta di un criterio negativo e in caso contrario, se FALSE è un criterio che può essere offerto.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
Elimina: 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
Aggiornamento: Sola lettura
Elimina: Sola lettura

ID criterio padre

Identificatore del criterio della partizione del prodotto padre.

Nota

Questo campo non è applicabile per il nodo di partizione del prodotto radice dell'albero, che non ha alcun elemento padre.

Aggiungere: Sola lettura e Obbligatorio
Aggiornamento: Sola lettura
Elimina: Sola lettura

Parent Id

Identificatore generato dal sistema del gruppo di annunci che contiene la partizione del prodotto.

Questo campo bulk viene mappato al campo Id del record gruppo di annunci .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore del gruppo di annunci esistente o un identificatore negativo uguale al campo Id del record gruppo di annunci padre. Questa operazione è consigliata se si aggiungono nuove partizioni di prodotto a un nuovo gruppo di annunci nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

Nota

Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Gruppo di annunci .

Condizione del prodotto 1

Operando della condizione. Gli operandi includono in modo implicito l'operatore uguale. Ad esempio, è possibile leggere Brand come Brand=.

Usare la condizione del prodotto 1 come operando per il valore del prodotto 1.

È possibile specificare più condizioni del prodotto per ogni campagna e gruppo di annunci Microsoft Shopping. Ogni condizione viene soddisfatta se il valore dell'attributo del prodotto è uguale al valore dell'attributo dell'operando. Ad esempio, se l'operando è impostato su Brand e l'attributo è impostato su Contoso, la condizione viene soddisfatta se il valore dell'attributo Brand del catalogo prodotti è uguale a Contoso.

Nelle campagne Shopping le condizioni del prodotto possono essere impostate a livello di campagna e gruppo di annunci. Nella tabella seguente vengono descritte le regole business Condizione prodotto (operando) e Valore prodotto (attributo) per i record dell'ambito del prodotto della campagna e della partizione del prodotto del gruppo di annunci .

Condizione del prodotto (operando)	Descrizione del valore del prodotto (attributo)	Regole dell'ambito del prodotto della campagna	Regole di partizione del prodotto del gruppo di annunci
Tutti	Deve essere Null.	Non applicabile.	Per le partizioni di prodotto di un gruppo di annunci, il nodo radice deve avere l'operando impostato su "All" e l'attributo impostato su Null o vuoto.
Marchio	Produttore, marchio o editore del prodotto. Un massimo di 1.000 caratteri.	L'operando Brand può essere specificato una sola volta per filtro dell'ambito del prodotto della campagna.	L'operando Brand può essere usato in più rami, ma può essere specificato una sola volta per ramo.
CategoriaL1-5 Sono disponibili cinque valori degli operandi di categoria, ad esempio CategoryL1, CategoryL2, CategoryL3, CategoryL4 e CategoryL5.	Categoria di prodotti definita dall'archivio Microsoft Merchant Center. Per i valori di categoria e la tassonomia validi, vedere Tassonomia categoria Bing . CategoryL0 è la categoria di livello più alto e CategoryL4 è il livello più basso o la categoria più granulare. Un massimo di 100 caratteri.	Ogni operando CategoryL può essere usato una volta per filtro dell'ambito del prodotto della campagna. Se si specifica una condizione di prodotto con l'operando impostato su una categoria di prodotti da 1 a 5, devono essere specificati in ordine crescente. Ad esempio, è possibile impostare l'operando su "CategoryL2" con l'attributo "Pet Supplies", se una condizione precedente del prodotto ha l'operando "CategoryL1" con attributo "Animals & Pet Supplies".	Ognuno degli operandi CategoryL può essere usato in più rami, ma può essere specificato solo una volta per ramo. Ad esempio, un ramo può contenere CategoryL1 e CategoryL2, ma potrebbe non contenere un altro nodo con l'operando CategoryL2. Se si imposta l'operando su una categoria di prodotti da 1 a 5, è necessario specificarlo in ordine crescente. Ad esempio, l'operando può essere impostato su "CategoryL2" con l'attributo "Pet Supplies", se una partizione di prodotto di livello superiore ha l'operando "CategoryL1" con attributo "Animals & Pet Supplies". Non è necessario specificare l'operando della categoria di prodotti di livello precedente nella partizione padre immediata. Ad esempio, è possibile specificare una condizione CategoryL2 per una partizione del prodotto se l'elemento padre dell'elemento padre specifica una condizione CategoryL1.
Canale	Canale Local Inventory Ads (LIA). I valori possibili includono "Local Stores" e "Online". Se la campagna non ha scelto annunci di inventario locale, tutte le offerte sono solo online per impostazione predefinita (Channel=Online) e a canale singolo (ChannelExclusivity=Single-channel). Per altre informazioni, vedere la pagina della Guida annunci di inventario locale .	L'operando del canale può essere specificato una sola volta per filtro dell'ambito del prodotto della campagna.	L'operando del canale può essere usato in più rami, ma può essere specificato una sola volta per ramo.
ChannelExclusivity	L'esclusività del canale Local Inventory Ads (LIA). I valori possibili includono "Single-channel" e "Multi-channel". Se la campagna non ha scelto annunci di inventario locale, tutte le offerte sono solo online per impostazione predefinita (Channel=Online) e a canale singolo (ChannelExclusivity=Single-channel). Per altre informazioni, vedere la pagina della Guida annunci di inventario locale .	L'operando ChannelExclusivity può essere specificato una sola volta per filtro dell'ambito del prodotto della campagna.	L'operando ChannelExclusivity può essere usato in più rami, ma può essere specificato una sola volta per ramo.
Condizione	Condizione del prodotto. Se l'operando è impostato su Condition, i valori di attributo supportati che è possibile specificare sono New, Used e Ricondizionati.	L'operando Condition può essere specificato una sola volta per filtro dell'ambito del prodotto della campagna.	L'operando Condition può essere usato in più rami, ma può essere specificato una sola volta per ramo.
CustomLabel0-4 Sono disponibili cinque valori degli operandi etichetta personalizzati, ad esempio CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 e CustomLabel4.	Etichetta personalizzata definita dal commerciante. Le etichette personalizzate, ad esempio CustomLabel0 e CustomLabel4, non vengono convalidate in base a alcuna gerarchia. Un massimo di 100 caratteri. Questo operando non è applicabile ai prodotti sponsorizzati.	Ogni operando CustomLabel può essere usato una volta per filtro dell'ambito del prodotto della campagna.	Ognuno degli operandi CustomLabel può essere usato in più rami, ma può essere specificato una sola volta per ramo. Ad esempio, un ramo può contenere CustomLabel0 e CustomLabel1, ma potrebbe non contenere un altro nodo con l'operando CustomLabel1 .
GTIN	Numero dell'elemento di scambio globale definito dal commerciante. Il campo GTIN ha un limite di 50 caratteri, con ogni valore GTIN con un massimo di 14 cifre. Questo operando è applicabile solo con Sponsored Products.	L'operando GTIN può essere specificato una sola volta per filtro dell'ambito del prodotto della campagna.	L'operando GTIN può essere usato in più rami, ma può essere specificato una sola volta per ramo.
Id	Identificatore del prodotto definito dal commerciante. Un massimo di 1.000 caratteri.	L'operando Id può essere specificato una sola volta per filtro dell'ambito del prodotto della campagna.	L'operando Id può essere usato in più rami, ma può essere specificato una sola volta per ramo.
MPN	Numero dell'elemento di scambio globale definito dal commerciante. Un massimo di 70 caratteri. Questo operando è applicabile solo con Sponsored Products.	L'operando MPN può essere specificato una sola volta per filtro dell'ambito del prodotto della campagna.	L'operando MPN può essere usato in più rami, ma può essere specificato una sola volta per ramo.
ProductType1-5 Sono disponibili cinque valori degli operandi del tipo di prodotto, ad esempio ProductType1, ProductType2, ProductType3, ProductType4 e ProductType5.	Tipo di prodotto o categoria definito dal commerciante. ProductType1 è il tipo di prodotto di livello più alto e ProductType5 è il livello più basso o il tipo di prodotto più granulare. Un massimo di 100 caratteri. Questo operando non è applicabile ai prodotti sponsorizzati.	Ogni operando del tipo di prodotto può essere usato una volta per filtro dell'ambito del prodotto della campagna. Se si specifica una condizione del prodotto con operando impostato su un tipo di prodotto compreso tra 1 e 5, devono essere specificati in ordine crescente. Ad esempio, è possibile impostare l'operando su "ProductType2" con l'attributo "Pet Supplies", se una condizione precedente del prodotto ha l'operando "ProductType1" con l'attributo "Animals & Pet Supplies".	Ognuno degli operandi ProductType può essere usato in più rami, ma può essere specificato una sola volta per ramo. Ad esempio, un ramo può contenere ProductType1 e ProductType2, ma potrebbe non contenere un altro nodo con l'operando ProductType2 . Se si imposta l'operando su un tipo di prodotto compreso tra 1 e 5, è necessario specificarlo in ordine crescente. Ad esempio, l'operando può essere impostato su "ProductType2" con attributo "Pet Supplies", se una partizione di prodotto di livello superiore ha l'operando "ProductType1" con attributo "Animals & Pet Supplies". Non è necessario specificare l'operando del tipo di prodotto di livello precedente nella partizione padre immediata. Ad esempio, è possibile specificare una condizione ProductType2 per una partizione del prodotto se l'elemento padre dell'elemento padre specifica una condizione ProductType1.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura. Non è possibile aggiornare i campi condizione o valore. Per aggiornare le condizioni, è necessario eliminare la partizione del prodotto e aggiungerne una nuova.
Elimina: Sola lettura

Valore prodotto 1

Valore dell'attributo della condizione.

Il valore di un attributo deve corrispondere esattamente al valore specificato nel file di catalogo Microsoft Merchant Center del cliente.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura. Non è possibile aggiornare i campi condizione o valore. Per aggiornare le condizioni, è necessario eliminare la partizione del prodotto e aggiungerne una nuova.
Elimina: Sola lettura

Stato

Stato della partizione del prodotto.

I valori possibili sono Attivo o Eliminato.

Aggiungere: Opzionale. L'unico stato possibile è Attivo. Se si imposta lo stato su Eliminato , verrà ignorato e il record restituito avrà lo stato impostato su Attivo.
Aggiornamento: Opzionale
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.

Sottotipo

Tipo di partizione del prodotto.

I valori possibili sono Suddivisione e Unità.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
Elimina: Sola lettura

Modello di rilevamento

I modelli di rilevamento possono essere usati insieme all'URL specificato nel campo "Collegamento" per l'offerta di prodotto inviata tramite l'API Contenuto. Combinando l'URL del feed con il modello di rilevamento, l'URL della pagina di destinazione viene assemblato in cui un utente viene indirizzato dopo aver fatto clic sull'annuncio. Quando usi il campo Modello di rilevamento per aggiornare i parametri URL invece di aggiornarli nell'URL del feed, l'URL del feed non deve passare attraverso la revisione editoriale e gli annunci continueranno a essere pubblicati senza interruzioni. Ad esempio, se l'URL dell'offerta di prodotto nel feed di catalogo è , è https://contoso.com/possibile specificare il modello di rilevamento seguente: {lpurl}?matchtype={matchtype}&device={device}.

Le regole di convalida seguenti si applicano ai modelli di rilevamento. Per altre informazioni sui modelli e i parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?

• I modelli di rilevamento definiti per le entità di livello inferiore, ad esempio gli annunci, sostituiscono quelli impostati per entità di livello superiore, ad esempio la campagna. Per altre informazioni, vedere Limiti delle entità.

• La lunghezza del modello di rilevamento è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.

• Il modello di rilevamento deve essere un URL ben formato che inizia con uno dei seguenti: http://, https://, {lpurl} o {unescapedlpurl}.

• Microsoft Advertising non convalida l'esistenza di parametri personalizzati. Se si usano parametri personalizzati nel modello di rilevamento e non esistono, l'URL della pagina di destinazione includerà i segnaposto chiave e valore dei parametri personalizzati senza sostituzione. Ad esempio, se il modello di rilevamento è https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}e non vengono definiti {_season} o {_promocode} a livello di campagna, gruppo di annunci, criterio, parola chiave o annuncio, l'URL della pagina di destinazione sarà lo stesso.

Aggiungere: Opzionale
Aggiornamento: 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.
Elimina: Sola lettura