Condividi tramite


Record gruppo elenco asset - Bulk

Definisce un gruppo di elenchi di asset che può essere caricato e scaricato in un file bulk.

Puoi caricare i record del gruppo di inserzioni del gruppo di asset 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.

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

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

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAssetGroupListingGroup , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.

Per un record gruppo di elenchi di asset , i campi di attributo seguenti sono disponibili nello schema file bulk.

Gruppo di asset

Nome del gruppo di asset a cui appartiene il gruppo di voci del gruppo di asset.

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

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

Campagna

Nome della campagna che contiene il gruppo di asset e il gruppo di inserzioni.

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

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

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

Id

Identificatore generato dal sistema del gruppo di voci del gruppo di asset.

Aggiungere: Opzionale. È necessario lasciare vuoto questo campo o specificare un identificatore negativo. È quindi possibile fare riferimento a un identificatore negativo impostato per il gruppo di voci del gruppo di asset nel campo Id padre dei tipi di record dipendenti, ad esempio annunci, parole chiave o criterio. Questa operazione è consigliata se si aggiungono nuovi gruppi di asset che elencano gruppi e nuovi record dipendenti 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

È escluso

Determina se i prodotti appartengono al gruppo di elenchi devono essere esclusi durante la porzione.

Se impostato su true è un criterio negativo e in caso contrario, se false è un criterio positivo.

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

Parent Id

ID del gruppo di asset che contiene il gruppo di inserzioni.

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

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

ID gruppo elenco padre

È necessario specificare almeno il nodo radice per la struttura ad albero.

Il nodo radice del gruppo di presentazione 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 i prodotti in base a condizioni di prodotto più specifiche, impostare il campo Sottotipo su Suddivisione, l'ID gruppo elenco padre su Null o vuoto e l'ID su un valore negativo. Il valore negativo verrà usato come ID gruppo elenco padre per tutti i nodi figlio.

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

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 di prodotto per ogni gruppo di asset Microsoft Performance Max. 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 Performance Max le condizioni del prodotto possono essere impostate solo a livello di gruppo di asset. Nella tabella seguente vengono descritte le regole business Product Condition (operando) e Product Value (attributo) per gli oggetti AssetGroupListingGroup del gruppo di asset.

Condizione del prodotto (operando) Descrizione del valore del prodotto (attributo) Regole di partizione del prodotto del gruppo di asset
Tutti Deve essere Null. Per le partizioni di prodotto di un gruppo di asset, il nodo radice deve avere l'operando impostato su Tutti e l'attributo impostato su Null o vuoto.
Marchio Produttore, marchio o editore del prodotto.

Un massimo di 1.000 caratteri.
Per le partizioni di prodotto di un gruppo di asset, il nodo radice deve avere l'operando impostato su Tutti e l'attributo impostato su Null o vuoto.
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.
Ognuno degli operandi CategoryL può essere usato in più rami.

Ognuno degli operandi CategoryL può essere usato in più rami, ma può essere specificato una sola 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 l'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 ha specificato 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 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 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 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.
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 .
Id Identificatore del prodotto definito dal commerciante.

Un massimo di 1.000 caratteri.
L'operando Id 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.
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 l'attributo Pet Supplies, se una partizione di prodotto di livello superiore ha l'operando ProductType1 con l'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 del gruppo di voci del gruppo di asset.

I valori possibili sono Attivo, Eliminato.

Aggiungere: Opzionale.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.

Sottotipo

Tipo di gruppo di asset listato.

I valori possibili sono Suddivisione e Unità.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
Elimina: Sola lettura