Indice
ReportService
(interfaccia)BestSellersBrandView
(messaggio)BestSellersProductClusterView
(messaggio)BestSellersProductClusterView.InventoryStatus
(enum)CompetitiveVisibilityBenchmarkView
(messaggio)CompetitiveVisibilityCompetitorView
(messaggio)CompetitiveVisibilityTopMerchantView
(messaggio)MarketingMethod
(messaggio)MarketingMethod.MarketingMethodEnum
(enum)NonProductPerformanceView
(messaggio)PriceCompetitivenessProductView
(messaggio)PriceInsightsProductView
(messaggio)PriceInsightsProductView.Effectiveness
(enum)ProductPerformanceView
(messaggio)ProductView
(messaggio)ProductView.AggregatedReportingContextStatus
(enum)ProductView.ClickPotential
(enum)ProductView.ItemIssue
(messaggio)ProductView.ItemIssue.ItemIssueResolution
(enum)ProductView.ItemIssue.ItemIssueSeverity
(messaggio)ProductView.ItemIssue.ItemIssueSeverity.AggregatedIssueSeverity
(enum)ProductView.ItemIssue.ItemIssueSeverity.IssueSeverityPerReportingContext
(messaggio)ProductView.ItemIssue.ItemIssueType
(messaggio)RelativeDemand
(messaggio)RelativeDemand.RelativeDemandEnum
(enum)RelativeDemandChangeType
(messaggio)RelativeDemandChangeType.RelativeDemandChangeTypeEnum
(enum)ReportGranularity
(messaggio)ReportGranularity.ReportGranularityEnum
(enum)ReportRow
(messaggio)SearchRequest
(messaggio)SearchResponse
(messaggio)TrafficSource
(messaggio)TrafficSource.TrafficSourceEnum
(enum)
ReportService
Servizio per il recupero di report e approfondimenti sui prodotti, sulle loro prestazioni e sull'ambiente competitivo su Google.
Cerca |
---|
Recupera un report definito da una query di ricerca. La risposta potrebbe contenere meno righe rispetto a quanto specificato da
|
BestSellersBrandView
Campi disponibili per la query nella tabella best_sellers_brand_view
.
Report Più venduti con i brand più popolari.
I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.
Campi | |
---|---|
report_date |
Data del report. Il valore di questo campo può essere solo uno dei seguenti:
Obbligatoria nella clausola |
report_granularity |
Granularità del report. Il ranking può avvenire nell'arco di una settimana o un mese. Obbligatoria nella clausola |
report_country_code |
Paese in cui viene calcolata la classifica. Rappresentato nel formato ISO 3166. Obbligatoria nella clausola |
report_category_id |
ID categoria prodotto Google per il quale calcolare il ranking, rappresentato nella tassonomia dei prodotti di Google. Obbligatoria nella clausola |
brand |
Nome del brand. |
rank |
Popolarità del brand su annunci e piattaforme organiche, nella categoria e nel paese selezionati, in base al numero stimato di unità vendute. |
previous_rank |
Ranking popolarità nella settimana o nel mese precedente. |
relative_demand |
Domanda stimata rispetto al brand con il ranking popolarità più alto nella stessa categoria e nello stesso paese. |
previous_relative_demand |
Domanda stimata rispetto al brand con il ranking popolarità più alto nella stessa categoria e nello stesso paese nella settimana o nel mese precedente. |
relative_demand_change |
Variazione della domanda stimata. Se è salito, affondato o rimasto piatto. |
BestSellersProductClusterView
Campi disponibili per la query nella tabella best_sellers_product_cluster_view
.
Report Più venduti con i cluster di prodotti principali. Un cluster di prodotti è un raggruppamento per diverse offerte e varianti che rappresentano lo stesso prodotto, ad esempio Google Pixel 7.
I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.
Campi | |
---|---|
report_date |
Data del report. Il valore di questo campo può essere solo uno dei seguenti:
Obbligatoria nella clausola |
variant_gtins[] |
GTIN di varianti di esempio del cluster di prodotti. |
report_granularity |
Granularità del report. Il ranking può avvenire nell'arco di una settimana o un mese. Obbligatoria nella clausola |
report_country_code |
Paese in cui viene calcolata la classifica. Rappresentato nel formato ISO 3166. Obbligatoria nella clausola |
report_category_id |
ID categoria prodotto Google per il quale calcolare il ranking, rappresentato nella tassonomia dei prodotti di Google. Obbligatoria nella clausola |
title |
Titolo del cluster di prodotti. |
brand |
Brand del cluster di prodotti. |
category_l1 |
Categoria di prodotto (1° livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google. |
category_l2 |
Categoria di prodotto (2° livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google. |
category_l3 |
Categoria di prodotto (3o livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google. |
category_l4 |
Categoria di prodotto (4o livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google. |
category_l5 |
Categoria di prodotto (5o livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google. |
inventory_status |
Indica se il cluster dei prodotti è Questo campo non tiene in considerazione il filtro relativo al paese del report Più venduti. |
brand_inventory_status |
Se nell'origine dati di prodotto è presente almeno un prodotto del brand Questo campo non tiene in considerazione il filtro relativo al paese del report Più venduti. |
rank |
Popolarità del cluster di prodotti su annunci e piattaforme organiche, nella categoria e nel paese selezionati, in base al numero stimato di unità vendute. |
previous_rank |
Ranking popolarità nella settimana o nel mese precedente. |
relative_demand |
Domanda stimata in relazione al cluster di prodotti con il ranking popolarità più alto nella stessa categoria e nello stesso paese. |
previous_relative_demand |
Domanda stimata in relazione al cluster di prodotti con il ranking popolarità più alto nella stessa categoria e nello stesso paese nella settimana o nel mese precedente. |
relative_demand_change |
Variazione della domanda stimata. Se è salito, affondato o rimasto piatto. |
InventoryStatus
Stato del cluster di prodotti o del brand nel tuo inventario.
Enum | |
---|---|
INVENTORY_STATUS_UNSPECIFIED |
Non specificato. |
IN_STOCK |
Un prodotto per questo cluster o brand di prodotti è disponibile. |
OUT_OF_STOCK |
Hai un prodotto per questo cluster di prodotti o brand nell'inventario, ma al momento non è disponibile. |
NOT_IN_INVENTORY |
Non è presente un prodotto per questo cluster di prodotti o brand nell'inventario. |
CompetitiveVisibilityBenchmarkView
Campi disponibili per la query nella tabella competitive_visibility_benchmark_view
.
Report Scenario competitivo con il benchmark di categoria.
I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.
Campi | |
---|---|
date |
Data di questa riga. Obbligatoria nella clausola |
report_country_code |
Paese in cui sono comparse le impressioni. Obbligatoria nella clausola |
report_category_id |
ID categoria prodotto Google per il quale calcolare il report, rappresentato nella tassonomia dei prodotti di Google. Obbligatoria nella clausola |
traffic_source |
Sorgente di traffico delle impressioni. Obbligatoria nella clausola |
your_domain_visibility_trend |
Variazione della visibilità basata sulle impressioni del dominio rispetto all'inizio dell'intervallo di tempo selezionato (o primo giorno con impressioni diverse da zero). Non può essere filtrato nella clausola "WHERE". |
category_benchmark_visibility_trend |
Variazione della visibilità basata sulle impressioni rispetto all'inizio dell'intervallo di tempo selezionato (o primo giorno con impressioni diverse da zero) per un insieme combinato di commercianti con visibilità più elevata che si avvicina al mercato. Non può essere filtrato nella clausola "WHERE". |
CompetitiveVisibilityCompetitorView
Campi disponibili per la query nella tabella competitive_visibility_competitor_view
.
Report Scenario competitivo con attività con visibilità simile.
I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.
Campi | |
---|---|
date |
Data di questa riga. Una condizione su |
domain |
Dominio del tuo concorrente o del tuo dominio, se "is_your_domain" è true. Obbligatoria nella clausola |
is_your_domain |
True se questa riga contiene dati relativi al tuo dominio. Non può essere filtrato nella clausola "WHERE". |
report_country_code |
Paese in cui sono comparse le impressioni. Obbligatoria nella clausola |
report_category_id |
ID categoria prodotto Google per il quale calcolare il report, rappresentato nella tassonomia dei prodotti di Google. Obbligatoria nella clausola |
traffic_source |
Sorgente di traffico delle impressioni. Obbligatoria nella clausola |
rank |
Posizione del dominio nel ranking di attività simili per le chiavi selezionate ( Non può essere filtrato nella clausola "WHERE". |
ads_organic_ratio |
Il rapporto annunci / ricerca organica indica la frequenza con cui il dominio riceve impressioni dagli annunci Shopping rispetto al traffico organico. Il numero viene arrotondato e specificato in bucket. Non può essere filtrato nella clausola "WHERE". |
page_overlap_rate |
Il tasso di sovrapposizione della pagina mostra la frequenza con cui le offerte dei rivenditori concorrenti vengono mostrate insieme alle tue offerte sulla stessa pagina. Non può essere filtrato nella clausola "WHERE". |
higher_position_rate |
Il tasso di posizionamento superiore indica la frequenza con cui l'offerta di un concorrente è stata posizionata in una posizione più elevata nella pagina rispetto alla tua offerta. Non può essere filtrato nella clausola "WHERE". |
relative_visibility |
La visibilità relativa mostra la frequenza con cui le offerte della concorrenza vengono mostrate rispetto alle tue. In altre parole, si tratta del numero di impressioni visualizzate di un rivenditore concorrente diviso per il numero di impressioni visualizzate durante l'intervallo di tempo selezionato per una categoria di prodotto e un paese selezionati. Non può essere filtrato nella clausola "WHERE". |
CompetitiveVisibilityTopMerchantView
Campi disponibili per la query nella tabella competitive_visibility_top_merchant_view
.
Report Scenario competitivo con l'attività con la visibilità più alta.
I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.
Campi | |
---|---|
date |
Data di questa riga. Non può essere selezionato nella clausola |
domain |
Dominio del tuo concorrente o del tuo dominio, se "is_your_domain" è true. Obbligatoria nella clausola |
is_your_domain |
True se questa riga contiene dati relativi al tuo dominio. Non può essere filtrato nella clausola "WHERE". |
report_country_code |
Paese in cui sono comparse le impressioni. Obbligatoria nella clausola |
report_category_id |
ID categoria prodotto Google per il quale calcolare il report, rappresentato nella tassonomia dei prodotti di Google. Obbligatoria nella clausola |
traffic_source |
Sorgente di traffico delle impressioni. Obbligatoria nella clausola |
rank |
Posizione del dominio nel ranking dei commercianti migliori per le chiavi selezionate ( Non può essere filtrato nella clausola "WHERE". |
ads_organic_ratio |
Il rapporto annunci / ricerca organica indica la frequenza con cui il dominio riceve impressioni dagli annunci Shopping rispetto al traffico organico. Il numero viene arrotondato e specificato in bucket. Non può essere filtrato nella clausola "WHERE". |
page_overlap_rate |
Il tasso di sovrapposizione della pagina mostra la frequenza con cui le offerte dei rivenditori concorrenti vengono mostrate insieme alle tue offerte sulla stessa pagina. Non può essere filtrato nella clausola "WHERE". |
higher_position_rate |
Il tasso di posizionamento superiore indica la frequenza con cui l'offerta di un concorrente è stata posizionata in una posizione più elevata nella pagina rispetto alla tua offerta. Non può essere filtrato nella clausola "WHERE". |
MarketingMethod
Questo tipo non contiene campi.
Metodo di marketing utilizzato per promuovere i tuoi prodotti su Google (organica o annunci).
MarketingMethodEnum
Valori del metodo di marketing.
Enum | |
---|---|
MARKETING_METHOD_ENUM_UNSPECIFIED |
Non specificato. |
ORGANIC |
Marketing organico. |
ADS |
Marketing basato sugli annunci. |
NonProductPerformanceView
Campi disponibili per la query nella tabella non_product_performance_view
.
Dati sul rendimento relativi a immagini e link ai negozi online che rimandano alle tue pagine non relative al prodotto. Sono incluse le metriche sul rendimento (ad es. clicks
) e le dimensioni in base alle quali sono segmentate le metriche sul rendimento (ad es. date
).
I campi dei segmenti non possono essere selezionati nelle query senza selezionare anche almeno un campo della metrica.
I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.
Campi | |
---|---|
date |
Data nel fuso orario del commerciante a cui si applicano le metriche. Segmento. La condizione su |
week |
Primo giorno della settimana (lunedì) della data delle metriche nel fuso orario del commerciante. Segmento. |
clicks |
Numero di clic sulle immagini e sui link dei negozi online che rimandano alle tue pagine non relative al prodotto. Metrica. |
impressions |
Numero di volte in cui sono state mostrate immagini e link ai negozi online che rimandano alle tue pagine non relative al prodotto. Metrica. |
click_through_rate |
Percentuale di clic: il numero di clic ( |
PriceCompetitivenessProductView
Campi disponibili per la query nella tabella price_competitiveness_product_view
.
Report Competitività del prezzo.
I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.
Campi | |
---|---|
price |
Prezzo attuale del prodotto. |
benchmark_price |
Ultimo benchmark prezzi disponibile per il catalogo del prodotto nel paese di riferimento. |
report_country_code |
Paese del benchmark prezzi. Rappresentato nel formato ISO 3166. Obbligatoria nella clausola |
id |
ID REST del prodotto, nel formato Obbligatoria nella clausola |
offer_id |
ID del prodotto fornito dal commerciante. |
title |
Titolo del prodotto. |
brand |
La marca del prodotto. |
category_l1 |
Categoria di prodotto (1o livello) nella tassonomia dei prodotti di Google. |
category_l2 |
Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google. |
category_l3 |
Categoria di prodotto (3o livello) nella tassonomia dei prodotti di Google. |
category_l4 |
Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google. |
category_l5 |
Categoria di prodotto (5o livello) nella tassonomia dei prodotti di Google. |
product_type_l1 |
Tipo di prodotto (1o livello) nella tassonomia dei prodotti del commerciante. |
product_type_l2 |
Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante. |
product_type_l3 |
Tipo di prodotto (3o livello) nella tassonomia dei prodotti del commerciante. |
product_type_l4 |
Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante. |
product_type_l5 |
Tipo di prodotto (5o livello) nella tassonomia dei prodotti del commerciante. |
PriceInsightsProductView
Campi disponibili per la query nella tabella price_insights_product_view
.
Report Approfondimenti sul prezzo.
I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.
Campi | |
---|---|
price |
Prezzo attuale del prodotto. |
suggested_price |
Ultimo prezzo suggerito per il prodotto. |
effectiveness |
L'efficacia prevista dell'applicazione del suggerimento di prezzo, in bucket. |
id |
ID REST del prodotto, nel formato Obbligatoria nella clausola |
offer_id |
ID del prodotto fornito dal commerciante. |
title |
Titolo del prodotto. |
brand |
La marca del prodotto. |
category_l1 |
Categoria di prodotto (1o livello) nella tassonomia dei prodotti di Google. |
category_l2 |
Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google. |
category_l3 |
Categoria di prodotto (3o livello) nella tassonomia dei prodotti di Google. |
category_l4 |
Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google. |
category_l5 |
Categoria di prodotto (5o livello) nella tassonomia dei prodotti di Google. |
product_type_l1 |
Tipo di prodotto (1o livello) nella tassonomia dei prodotti del commerciante. |
product_type_l2 |
Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante. |
product_type_l3 |
Tipo di prodotto (3o livello) nella tassonomia dei prodotti del commerciante. |
product_type_l4 |
Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante. |
product_type_l5 |
Tipo di prodotto (5o livello) nella tassonomia dei prodotti del commerciante. |
predicted_impressions_change_fraction |
Variazione prevista delle impressioni in frazione dopo l'introduzione del prezzo suggerito rispetto al prezzo attivo corrente. Ad esempio, 0,05 è un aumento previsto del 5% delle impressioni. |
predicted_clicks_change_fraction |
Variazione prevista dei clic in frazione dopo l'introduzione del prezzo suggerito rispetto al prezzo attivo corrente. Ad esempio, 0,05 corrisponde a un aumento previsto dei clic del 5%. |
predicted_conversions_change_fraction |
Variazione prevista delle conversioni sotto forma di frazione dopo l'introduzione del prezzo suggerito rispetto al prezzo attivo corrente. Ad esempio, 0,05 indica un aumento previsto delle conversioni del 5%. |
Efficacia
Bucket di efficacia prevista.
L'efficacia indica quali prodotti trarrebbero vantaggio dalle variazioni di prezzo. Questa valutazione tiene conto dell'incremento del rendimento previsto modificando il prezzo scontato e la differenza tra il prezzo attuale e quello suggerito. Si prevede che i suggerimenti relativi ai prezzi con un'efficacia pari a HIGH
generino il maggiore incremento del rendimento.
Enum | |
---|---|
EFFECTIVENESS_UNSPECIFIED |
L'efficacia è sconosciuta. |
LOW |
L'efficacia è bassa. |
MEDIUM |
L'efficacia è media. |
HIGH |
L'efficacia è elevata. |
ProductPerformanceView
Campi disponibili per la query nella tabella product_performance_view
.
Dati sul rendimento dei prodotti per il tuo account, incluse le metriche sul rendimento (ad es. clicks
) e le dimensioni in base alle quali sono segmentate le metriche sul rendimento (ad es. offer_id
). I valori delle dimensioni del prodotto, come offer_id
, riflettono lo stato di un prodotto al momento dell'impressione.
I campi dei segmenti non possono essere selezionati nelle query senza selezionare anche almeno un campo della metrica.
I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.
Campi | |
---|---|
date |
Data nel fuso orario del commerciante a cui si applicano le metriche. Segmento. La condizione su |
week |
Primo giorno della settimana (lunedì) della data delle metriche nel fuso orario del commerciante. Segmento. |
conversion_value |
Valore delle conversioni attribuite al prodotto, registrato nella data di conversione. Metrica. Disponibile solo per la sorgente di traffico |
marketing_method |
Metodo di marketing a cui si applicano le metriche. Segmento. |
customer_country_code |
Codice del paese in cui si trova il cliente al momento dell'evento. Rappresentato nel formato ISO 3166. Segmento. Se non è possibile determinare il paese del cliente, viene restituito un codice "ZZ" speciale. |
offer_id |
ID del prodotto fornito dal commerciante. Segmento. |
title |
Titolo del prodotto. Segmento. |
brand |
La marca del prodotto. Segmento. |
category_l1 |
Categoria di prodotto (1° livello) nella tassonomia dei prodotti di Google. Segmento. |
category_l2 |
Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google. Segmento. |
category_l3 |
Categoria di prodotto (3o livello) nella tassonomia dei prodotti di Google. Segmento. |
category_l4 |
Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google. Segmento. |
category_l5 |
Categoria di prodotto (5o livello) nella tassonomia dei prodotti di Google. Segmento. |
product_type_l1 |
Tipo di prodotto (1o livello) nella tassonomia dei prodotti del commerciante. Segmento. |
product_type_l2 |
Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante. Segmento. |
product_type_l3 |
Tipo di prodotto (3o livello) nella tassonomia dei prodotti del commerciante. Segmento. |
product_type_l4 |
Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante. Segmento. |
product_type_l5 |
Tipo di prodotto (5o livello) nella tassonomia dei prodotti del commerciante. Segmento. |
custom_label0 |
Etichetta personalizzata 0 per il raggruppamento personalizzato dei prodotti. Segmento. |
custom_label1 |
Etichetta personalizzata 1 per il raggruppamento personalizzato dei prodotti. Segmento. |
custom_label2 |
Etichetta personalizzata 2 per il raggruppamento personalizzato dei prodotti. Segmento. |
custom_label3 |
Etichetta personalizzata 3 per il raggruppamento personalizzato dei prodotti. Segmento. |
custom_label4 |
Etichetta personalizzata 4 per il raggruppamento personalizzato dei prodotti. Segmento. |
clicks |
Numero di clic. Metrica. |
impressions |
Numero di volte in cui vengono mostrati i prodotti del commerciante. Metrica. |
click_through_rate |
Percentuale di clic: il numero di clic ricevuti dai prodotti del commerciante (clic) diviso per il numero di volte in cui i prodotti vengono mostrati (impressioni). Metrica. |
conversions |
Numero di conversioni attribuite al prodotto, registrate nella data di conversione. A seconda del modello di attribuzione, una conversione potrebbe essere distribuita tra più clic e a ogni clic viene assegnato il proprio merito. Questa metrica è la somma di tutti questi crediti. Metrica. Disponibile solo per la sorgente di traffico |
conversion_rate |
Numero di conversioni diviso per il numero di clic, registrato alla data dell'impressione. Metrica. Disponibile solo per la sorgente di traffico |
ProductView
Campi disponibili per la query nella tabella product_view
.
Prodotti disponibili nell'inventario corrente. I prodotti in questa tabella sono gli stessi dell'API secondaria Prodotti, ma non tutti gli attributi del prodotto dell'API secondaria Prodotti sono disponibili per le query in questa tabella. A differenza dell'API secondaria Prodotti, questa tabella consente di filtrare l'elenco dei prodotti restituito in base agli attributi del prodotto. Per recuperare un singolo prodotto in base a id
o elencare tutti i prodotti, deve essere utilizzata l'API secondaria Prodotti.
I valori vengono impostati solo per i campi richiesti in modo esplicito nella query di ricerca della richiesta.
Campi | |
---|---|
price |
Prezzo prodotto Assente se le informazioni sul prezzo del prodotto non sono disponibili. |
gtin[] |
Elenco dei GTIN (Global Trade Item Number) del prodotto. |
creation_time |
L'ora in cui il commerciante ha creato il prodotto in secondi del timestamp. |
expiration_date |
Data di scadenza del prodotto, specificata nell'inserimento. |
item_issues[] |
Elenco dei problemi correlati all'articolo per il prodotto. Questo campo non può essere utilizzato per ordinare i risultati. Solo gli attributi selezionati di questo campo (ad esempio, |
click_potential |
Rendimento stimato della spesa rispetto ai prodotti del commerciante con il rendimento migliore. |
id |
ID REST del prodotto, nel formato Obbligatoria nella clausola |
channel |
Il canale del prodotto. Può essere |
language_code |
Codice lingua del prodotto in formato BCP 47. |
feed_label |
Etichetta del feed del prodotto. |
offer_id |
ID del prodotto fornito dal commerciante. |
title |
Titolo del prodotto. |
brand |
La marca del prodotto. |
category_l1 |
Categoria di prodotto (1o livello) nella tassonomia dei prodotti di Google. |
category_l2 |
Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google. |
category_l3 |
Categoria di prodotto (3o livello) nella tassonomia dei prodotti di Google. |
category_l4 |
Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google. |
category_l5 |
Categoria di prodotto (5o livello) nella tassonomia dei prodotti di Google. |
product_type_l1 |
Tipo di prodotto (1o livello) nella tassonomia dei prodotti del commerciante. |
product_type_l2 |
Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante. |
product_type_l3 |
Tipo di prodotto (3o livello) nella tassonomia dei prodotti del commerciante. |
product_type_l4 |
Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante. |
product_type_l5 |
Tipo di prodotto (5o livello) nella tassonomia dei prodotti del commerciante. |
condition |
La condizione del prodotto. |
availability |
La disponibilità del prodotto. |
shipping_label |
Etichetta spedizione normalizzata specificata nell'origine dati. |
item_group_id |
ID gruppo di articoli fornito dal commerciante per raggruppare le varianti. |
thumbnail_link |
Link all'immagine elaborata del prodotto, ospitata sull'infrastruttura di Google. |
aggregated_reporting_context_status |
Stato aggregato. |
click_potential_rank |
Ranking del prodotto in base al suo potenziale in termini di clic. Un prodotto con |
AggregatedReportingContextStatus
Stato del prodotto aggregato per tutti i contesti di report.
Ecco un esempio di come viene calcolato lo stato aggregato:
Schede senza costi | Annunci Shopping | Stato |
---|---|---|
Approved | Approved | ELIGIBLE |
Approved | In attesa | ELIGIBLE |
Approved | Non approvato | ELIGIBLE_LIMITED |
In attesa | In attesa | IN ATTESA |
Non approvato | Non approvato | NOT_ELIGIBLE_OR_DISAPPROVED |
Enum | |
---|---|
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED |
Non specificato. |
NOT_ELIGIBLE_OR_DISAPPROVED |
Il prodotto non è idoneo o non è approvato per tutti i contesti di generazione dei report. |
PENDING |
Lo stato del prodotto è in attesa in tutti i contesti di report. |
ELIGIBLE_LIMITED |
Il prodotto è idoneo per alcuni (ma non tutti) contesti di segnalazione. |
ELIGIBLE |
Il prodotto è idoneo per tutti i contesti di generazione di report. |
ClickPotential
Il potenziale in termini di clic di un prodotto offre una stima del suo rendimento potenziale rispetto ai prodotti del commerciante con il rendimento migliore. Il potenziale in termini di clic di un prodotto aiuta i commercianti a dare la priorità ai prodotti da correggere, nonché a comprendere il rendimento dei prodotti rispetto al loro potenziale.
Enum | |
---|---|
CLICK_POTENTIAL_UNSPECIFIED |
Impatto previsto sui clic previsti sconosciuto. |
LOW |
Possibilità di ricevere un numero ridotto di clic rispetto ai prodotti del commerciante con il rendimento migliore. |
MEDIUM |
Possibilità di ricevere un numero moderato di clic rispetto ai prodotti del commerciante con il rendimento migliore. |
HIGH |
Possibilità di ricevere un numero di clic simile a quello dei prodotti del commerciante con il rendimento migliore. |
ItemIssue
Problema dell'articolo associato al prodotto.
Campi | |
---|---|
type |
Tipo di problema dell'elemento. |
severity |
Gravità del problema dell'articolo. |
resolution |
Risoluzione dei problemi relativi all'articolo. |
ItemIssueResolution
Come risolvere il problema.
Enum | |
---|---|
ITEM_ISSUE_RESOLUTION_UNSPECIFIED |
Non specificato. |
MERCHANT_ACTION |
Il commerciante deve risolvere il problema. |
PENDING_PROCESSING |
Il problema verrà risolto automaticamente (ad esempio, scansione dell'immagine) o tramite una revisione di Google. Al momento non è richiesta alcuna azione da parte del commerciante. La risoluzione potrebbe causare un altro problema (ad esempio, se la scansione non va a buon fine). |
ItemIssueSeverity
In che modo il problema influisce sulla pubblicazione del prodotto.
Campi | |
---|---|
severity_per_reporting_context[] |
Gravità del problema per contesto del report. |
aggregated_severity |
Gravità aggregata del problema per tutti i contesti di report interessati. Questo campo può essere utilizzato per filtrare i risultati. |
AggregatedIssueSeverity
Gravità dei problemi aggregata per tutti i contesti di report.
Enum | |
---|---|
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED |
Non specificato. |
DISAPPROVED |
Il problema disapprova il prodotto in almeno un contesto di report. |
DEMOTED |
Il problema fa retrocedere il prodotto in tutti i contesti di report interessati. |
PENDING |
La risoluzione del problema è PENDING_PROCESSING . |
IssueSeverityPerReportingContext
Gravità del problema per contesto del report.
Campi | |
---|---|
disapproved_countries[] |
Elenco dei paesi non approvati nel contesto dei report, rappresentati in formato ISO 3166. |
demoted_countries[] |
Elenco dei paesi retrocessi nel contesto dei report, rappresentati in formato ISO 3166. |
reporting_context |
Contesto di segnalazione a cui si applica il problema. |
ItemIssueType
Tipo di problema.
Campi | |
---|---|
code |
Codice di errore del problema, equivalente a |
canonical_attribute |
Nome dell'attributo canonico per problemi specifici degli attributi. |
RelativeDemand
Questo tipo non contiene campi.
Domanda relativa di un cluster di prodotti o di un brand nel report Più venduti.
RelativeDemandEnum
Valori della domanda relativa.
Enum | |
---|---|
RELATIVE_DEMAND_ENUM_UNSPECIFIED |
Non specificato. |
VERY_LOW |
La domanda è pari allo 0-5% della domanda del brand o cluster di prodotti con il ranking più alto. |
LOW |
La domanda è pari al 6-10% della domanda del brand o cluster di prodotti con il ranking più alto. |
MEDIUM |
La domanda è pari all'11-20% della domanda del brand o cluster di prodotti con il ranking più alto. |
HIGH |
La domanda è pari al 21-50% della domanda del brand o cluster di prodotti con il ranking più alto. |
VERY_HIGH |
La domanda corrisponde al 51-100% della domanda del brand o cluster di prodotti con il ranking più alto. |
RelativeDemandChangeType
Questo tipo non contiene campi.
Domanda relativa di un cluster di prodotti o di un brand nel report Più venduti rispetto al periodo di tempo precedente.
RelativeDemandChangeTypeEnum
Valori del tipo di variazione della domanda relativa.
Enum | |
---|---|
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED |
Non specificato. |
SINKER |
La domanda relativa è inferiore rispetto al periodo di tempo precedente. |
FLAT |
La domanda relativa è uguale al periodo di tempo precedente. |
RISER |
La domanda relativa è più elevata rispetto al periodo di tempo precedente. |
ReportGranularity
Questo tipo non contiene campi.
Granularità del report Più venduti. I report Più venduti vengono calcolati nell'arco di una settimana e un mese.
ReportGranularityEnum
Valori di granularità dei report.
Enum | |
---|---|
REPORT_GRANULARITY_ENUM_UNSPECIFIED |
Non specificato. |
WEEKLY |
Il report viene calcolato su un periodo di una settimana. |
MONTHLY |
Il report viene calcolato su un periodo di tempo di un mese. |
ReportRow
Riga dei risultati restituita dalla query di ricerca.
Nella risposta viene compilato solo il messaggio corrispondente alla tabella sottoposta a query. All'interno del messaggio compilato, vengono compilati solo i campi richiesti esplicitamente nella query.
Campi | |
---|---|
product_performance_view |
Campi disponibili per la query nella tabella |
non_product_performance_view |
Campi disponibili per la query nella tabella |
product_view |
Campi disponibili per la query nella tabella |
price_competitiveness_product_view |
Campi disponibili per la query nella tabella |
price_insights_product_view |
Campi disponibili per la query nella tabella |
best_sellers_product_cluster_view |
Campi disponibili per la query nella tabella |
best_sellers_brand_view |
Campi disponibili per la query nella tabella |
competitive_visibility_competitor_view |
Campi disponibili per la query nella tabella |
competitive_visibility_top_merchant_view |
Campi disponibili per la query nella tabella |
competitive_visibility_benchmark_view |
Campi disponibili per la query nella tabella |
SearchRequest
Messaggio di richiesta per il metodo ReportService.Search
.
Campi | |
---|---|
parent |
Obbligatoria. ID dell'account che effettua la chiamata. Deve essere un account autonomo o un subaccount dell'AMC. Formato: accounts/{account} |
query |
Obbligatoria. Query che definisce un report da recuperare. Per informazioni dettagliate su come creare la query, consulta la guida Linguaggio di query. Per l'elenco completo delle tabelle e dei campi disponibili, vedi Campi disponibili. |
page_size |
Campo facoltativo. Numero di |
page_token |
Campo facoltativo. Token della pagina da recuperare. Se non specificato, viene restituita la prima pagina dei risultati. Per richiedere la pagina di risultati successiva, deve essere utilizzato il valore ottenuto da |
SearchResponse
Messaggio di risposta per il metodo ReportService.Search
.
Campi | |
---|---|
results[] |
Righe che corrispondono alla query di ricerca. |
next_page_token |
Token che può essere inviato come |
TrafficSource
Questo tipo non contiene campi.
Sorgente di traffico delle impressioni nel report Scenario competitivo.
TrafficSourceEnum
Valori delle sorgenti di traffico.
Enum | |
---|---|
TRAFFIC_SOURCE_ENUM_UNSPECIFIED |
Non specificato. |
ORGANIC |
Traffico organico. |
ADS |
Traffico proveniente dagli annunci. |
ALL |
Traffico organico e dagli annunci pubblicitari. |