REST Resource: accounts.reports

Risorsa: ReportRow

Riga del risultato restituita dalla query di ricerca.

Nella risposta viene compilato solo il messaggio corrispondente alla tabella sottoposta a query. Nel messaggio compilato, vengono compilati solo i campi richiesti esplicitamente nella query.

Rappresentazione JSON
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
Campi
productPerformanceView

object (ProductPerformanceView)

Campi disponibili per le query nella tabella productPerformanceView.

nonProductPerformanceView

object (NonProductPerformanceView)

Campi disponibili per le query nella tabella nonProductPerformanceView.

productView

object (ProductView)

Campi disponibili per le query nella tabella productView.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Campi disponibili per le query nella tabella priceCompetitivenessProductView.

priceInsightsProductView

object (PriceInsightsProductView)

Campi disponibili per le query nella tabella priceInsightsProductView.

bestSellersProductClusterView

object (BestSellersProductClusterView)

Campi disponibili per le query nella tabella bestSellersProductClusterView.

bestSellersBrandView

object (BestSellersBrandView)

Campi disponibili per le query nella tabella bestSellersBrandView.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Campi disponibili per le query nella tabella competitiveVisibilityCompetitorView.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Campi disponibili per le query nella tabella competitiveVisibilityTopMerchantView.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

Campi disponibili per le query nella tabella competitiveVisibilityBenchmarkView.

ProductPerformanceView

Campi disponibili per le query nella tabella productPerformanceView.

Dati sul rendimento dei prodotti per il tuo account, tra cui le metriche sul rendimento (ad es. clicks) e le dimensioni in base alle quali le metriche sul rendimento sono segmentate (ad es. offerId). I valori delle dimensioni dei prodotti, come offerId, riflettono lo stato di un prodotto al momento dell'impressione.

I campi dei segmenti non possono essere selezionati nelle query senza selezionare almeno un campo metrica.

I valori vengono impostati solo per i campi richiesti esplicitamente nella query di ricerca della richiesta.

Rappresentazione JSON
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
Campi
date

object (Date)

Data nel fuso orario del commerciante a cui si applicano le metriche. Segmento.

La condizione su date è obbligatoria nella clausola WHERE.

week

object (Date)

Primo giorno della settimana (lunedì) della data delle metriche nel fuso orario del commerciante. Segmento.

conversionValue

object (Price)

Valore delle conversioni attribuite al prodotto, registrato nella data di conversione. Metrica.

Disponibile solo per la sorgente di traffico FREE.

marketingMethod

enum (MarketingMethodEnum)

Metodo di marketing a cui si applicano le metriche. Segmento.

customerCountryCode

string

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 speciale "ZZ".

offerId

string

L'ID del prodotto fornito dal commerciante. Segmento.

title

string

Titolo del prodotto. Segmento.

brand

string

Marca del prodotto. Segmento.

categoryL1

string

Categoria di prodotto (1° livello) nella tassonomia dei prodotti di Google. Segmento.

categoryL2

string

Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google. Segmento.

categoryL3

string

Categoria di prodotto (3° livello) nella tassonomia dei prodotti di Google. Segmento.

categoryL4

string

Categoria di prodotto (4° livello) nella tassonomia dei prodotti di Google. Segmento.

categoryL5

string

Categoria di prodotto (5° livello) nella tassonomia dei prodotti di Google. Segmento.

productTypeL1

string

Tipo di prodotto (1° livello) nella tassonomia dei prodotti del commerciante. Segmento.

productTypeL2

string

Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante. Segmento.

productTypeL3

string

Tipo di prodotto (3° livello) nella tassonomia dei prodotti del commerciante. Segmento.

productTypeL4

string

Tipo di prodotto (4° livello) nella tassonomia dei prodotti del commerciante. Segmento.

productTypeL5

string

Tipo di prodotto (5° livello) nella tassonomia dei prodotti del commerciante. Segmento.

customLabel0

string

Etichetta personalizzata 0 per il raggruppamento personalizzato dei prodotti. Segmento.

customLabel1

string

Etichetta personalizzata 1 per il raggruppamento personalizzato dei prodotti. Segmento.

customLabel2

string

Etichetta personalizzata 2 per il raggruppamento personalizzato dei prodotti. Segmento.

customLabel3

string

Etichetta personalizzata 3 per il raggruppamento personalizzato dei prodotti. Segmento.

customLabel4

string

Etichetta personalizzata 4 per il raggruppamento personalizzato dei prodotti. Segmento.

clicks

string (int64 format)

Numero di clic. Metrica.

impressions

string (int64 format)

Numero di volte in cui i prodotti del commerciante vengono mostrati. Metrica.

clickThroughRate

number

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

number

Numero di conversioni attribuite al prodotto, registrate nella data di conversione. A seconda del modello di attribuzione, una conversione può essere distribuita su più clic, a ciascuno dei quali viene assegnato un proprio merito. Questa metrica è la somma di tutti questi crediti. Metrica.

Disponibile solo per la sorgente di traffico FREE.

conversionRate

number

Numero di conversioni diviso per il numero di clic, registrato nella data dell'impressione. Metrica.

Disponibile solo per la sorgente di traffico FREE.

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 le query nella tabella nonProductPerformanceView.

Dati sul rendimento delle immagini e dei link del negozio online che rimandano alle tue pagine non inerenti al prodotto. Sono incluse le metriche sul rendimento (ad es. clicks) e le dimensioni in base alle quali le metriche sul rendimento sono segmentate (ad es. date).

I campi dei segmenti non possono essere selezionati nelle query senza selezionare almeno un campo metrica.

I valori vengono impostati solo per i campi richiesti esplicitamente nella query di ricerca della richiesta.

Rappresentazione JSON
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Campi
date

object (Date)

Data nel fuso orario del commerciante a cui si applicano le metriche. Segmento.

La condizione su date è obbligatoria nella clausola WHERE.

week

object (Date)

Primo giorno della settimana (lunedì) della data delle metriche nel fuso orario del commerciante. Segmento.

clicks

string (int64 format)

Numero di clic sulle immagini e sui link del negozio online che rimandano alle tue pagine non relative ai prodotti. Metrica.

impressions

string (int64 format)

Numero di volte in cui sono state mostrate immagini e link al negozio online che rimandano alle tue pagine non inerenti al prodotto. Metrica.

clickThroughRate

number

Percentuale di clic: il numero di clic (clicks) diviso per il numero di impressioni (impressions) di immagini e link al negozio online che rimandano alle tue pagine non inerenti al prodotto. Metrica.

ProductView

Campi disponibili per le query nella tabella productView.

Prodotti nell'inventario corrente. I prodotti in questa tabella sono gli stessi dell'API secondaria Products, ma non tutti gli attributi del prodotto dell'API secondaria Products sono disponibili per le query in questa tabella. A differenza della sottoAPI Products, questa tabella consente di filtrare l'elenco restituito dei prodotti in base agli attributi del prodotto. Per recuperare un singolo prodotto tramite id o elencare tutti i prodotti, devi utilizzare la sottoAPI Products.

I valori vengono impostati solo per i campi richiesti esplicitamente nella query di ricerca della richiesta.

Rappresentazione JSON
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
Campi
price

object (Price)

Prezzo prodotto Non presente se le informazioni sul prezzo del prodotto non sono disponibili.

gtin[]

string

Elenco dei codici GTIN (Global Trade Item Number) del prodotto.

creationTime

string (Timestamp format)

La data e l'ora in cui il commerciante ha creato il prodotto in secondi timestamp.

expirationDate

object (Date)

Data di scadenza del prodotto, specificata al momento dell'inserimento.

itemIssues[]

object (ItemIssue)

Elenco dei problemi relativi agli articoli del prodotto.

Questo campo non può essere utilizzato per ordinare i risultati.

Per filtrare i risultati possono essere utilizzati solo alcuni attributi di questo campo (ad esempio itemIssues.severity.aggregated_severity).

clickPotential

enum (ClickPotential)

Rendimento potenziale stimato rispetto ai prodotti con il rendimento migliore del commerciante.

id

string

ID REST del prodotto, sotto forma di channel~languageCode~feedLabel~offerId. I metodi dell'API Merchant che operano sui prodotti lo utilizzano come parametro name.

Obbligatorio nella clausola SELECT.

channel

enum (ChannelEnum)

Canale del prodotto. Può essere ONLINE o LOCAL.

languageCode

string

Codice lingua del prodotto in formato BCP 47.

feedLabel

string

L'etichetta del feed del prodotto.

offerId

string

L'ID del prodotto fornito dal commerciante.

title

string

Titolo del prodotto.

brand

string

Marca del prodotto.

categoryL1

string

Categoria di prodotto (1° livello) nella tassonomia dei prodotti di Google.

categoryL2

string

Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google.

categoryL3

string

Categoria di prodotto (3° livello) nella tassonomia dei prodotti di Google.

categoryL4

string

Categoria di prodotto (4° livello) nella tassonomia dei prodotti di Google.

categoryL5

string

Categoria di prodotto (5° livello) nella tassonomia dei prodotti di Google.

productTypeL1

string

Tipo di prodotto (1° livello) nella tassonomia dei prodotti del commerciante.

productTypeL2

string

Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante.

productTypeL3

string

Tipo di prodotto (3° livello) nella tassonomia dei prodotti del commerciante.

productTypeL4

string

Tipo di prodotto (4° livello) nella tassonomia dei prodotti del commerciante.

productTypeL5

string

Tipo di prodotto (5° livello) nella tassonomia dei prodotti del commerciante.

condition

string

Condizione del prodotto.

availability

string

Disponibilità del prodotto.

shippingLabel

string

Etichetta di spedizione normalizzata specificata nell'origine dati.

itemGroupId

string

ID gruppo di articoli fornito dal commerciante per raggruppare le varianti.

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

Stato aggregato.

clickPotentialRank

string (int64 format)

Il ranking del prodotto in base al suo potenziale in termini di clic. Un prodotto con clickPotentialRank 1 ha il potenziale di clic più elevato tra i prodotti del commerciante che soddisfano le condizioni della query di ricerca.

AggregatedReportingContextStatus

Stato del prodotto aggregato per tutti i contesti di generazione di report.

Ecco un esempio di come viene calcolato lo stato aggregato:

Schede gratuite Annunci Shopping Stato
Approvato Approvato ELIGIBLE
Approvato In attesa ELIGIBLE
Approvato 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 dei report.
PENDING Lo stato del prodotto è in attesa in tutti i contesti dei report.
ELIGIBLE_LIMITED Il prodotto è idoneo per alcuni (ma non tutti) contesti di generazione di report.
ELIGIBLE Il prodotto è idoneo per tutti i contesti di generazione di report.

ItemIssue

Problema relativo all'articolo associato al prodotto.

Rappresentazione JSON
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
Campi
type

object (ItemIssueType)

Tipo di problema dell'articolo.

severity

object (ItemIssueSeverity)

Gravità del problema dell'articolo.

resolution

enum (ItemIssueResolution)

Risoluzione del problema relativo all'articolo.

ItemIssueType

Tipo di problema.

Rappresentazione JSON
{
  "code": string,
  "canonicalAttribute": string
}
Campi
code

string

Codice di errore del problema, equivalente a code di Problemi relativi ai prodotti.

canonicalAttribute

string

Nome dell'attributo canonico per i problemi specifici dell'attributo.

ItemIssueSeverity

In che modo il problema influisce sulla pubblicazione del prodotto.

Rappresentazione JSON
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
Campi
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

Gravità del problema per contesto dei report.

aggregatedSeverity

enum (AggregatedIssueSeverity)

Gravità aggregata del problema per tutti i contesti dei report interessati.

Questo campo può essere utilizzato per filtrare i risultati.

IssueSeverityPerReportingContext

Gravità del problema per contesto dei report.

Rappresentazione JSON
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
Campi
disapprovedCountries[]

string

Elenco dei paesi non approvati nel contesto dei report, rappresentato in formato ISO 3166.

demotedCountries[]

string

Elenco dei paesi retrocessi nel contesto dei report, rappresentato in formato ISO 3166.

reportingContext

enum (ReportingContextEnum)

Contesto dei report a cui si applica il problema.

AggregatedIssueSeverity

Gravità del problema aggregata per tutti i contesti di generazione di report.

Enum
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Non specificato.
DISAPPROVED Il problema non approva il prodotto in almeno un contesto di generazione di report.
DEMOTED Il problema riduce il prodotto a un livello inferiore in tutti i contesti di generazione di report interessati.
PENDING La risoluzione del problema è PENDING_PROCESSING.

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, la scansione delle immagini) o tramite una revisione di Google. Al momento non è richiesta alcuna azione da parte del commerciante. La risoluzione potrebbe portare a un altro problema (ad esempio, se la scansione non va a buon fine).

ClickPotential

Il potenziale in termini di clic di un prodotto offre una stima del suo rendimento potenziale rispetto ai prodotti con il rendimento migliore del commerciante. Il potenziale in termini di clic di un prodotto aiuta i commercianti a dare la priorità ai prodotti da correggere e a capire il rendimento dei prodotti rispetto al loro potenziale.

Enum
CLICK_POTENTIAL_UNSPECIFIED Impatto sconosciuto dei clic previsti.
LOW Potenziale per ricevere un numero ridotto di clic rispetto ai prodotti con il rendimento migliore del commerciante.
MEDIUM Potenziale per ricevere un numero moderato di clic rispetto ai prodotti con il rendimento migliore del commerciante.
HIGH Possibilità di ricevere un numero di clic simile a quello dei prodotti con il rendimento migliore del commerciante.

PriceCompetitivenessProductView

Campi disponibili per le query nella tabella priceCompetitivenessProductView.

Report Competitività del prezzo.

I valori vengono impostati solo per i campi richiesti esplicitamente nella query di ricerca della richiesta.

Rappresentazione JSON
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
Campi
price

object (Price)

Prezzo corrente del prodotto.

benchmarkPrice

object (Price)

Ultimo benchmark del prezzo disponibile per il catalogo del prodotto nel paese di riferimento.

reportCountryCode

string

Paese del benchmark prezzo. Rappresentato nel formato ISO 3166.

Obbligatorio nella clausola SELECT.

id

string

ID REST del prodotto, sotto forma di channel~languageCode~feedLabel~offerId. Può essere utilizzato per unire i dati con la tabella productView.

Obbligatorio nella clausola SELECT.

offerId

string

L'ID del prodotto fornito dal commerciante.

title

string

Titolo del prodotto.

brand

string

Marca del prodotto.

categoryL1

string

Categoria di prodotto (1° livello) nella tassonomia dei prodotti di Google.

categoryL2

string

Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google.

categoryL3

string

Categoria di prodotto (3° livello) nella tassonomia dei prodotti di Google.

categoryL4

string

Categoria di prodotto (4° livello) nella tassonomia dei prodotti di Google.

categoryL5

string

Categoria di prodotto (5° livello) nella tassonomia dei prodotti di Google.

productTypeL1

string

Tipo di prodotto (1° livello) nella tassonomia dei prodotti del commerciante.

productTypeL2

string

Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante.

productTypeL3

string

Tipo di prodotto (3° livello) nella tassonomia dei prodotti del commerciante.

productTypeL4

string

Tipo di prodotto (4° livello) nella tassonomia dei prodotti del commerciante.

productTypeL5

string

Tipo di prodotto (5° livello) nella tassonomia dei prodotti del commerciante.

PriceInsightsProductView

Campi disponibili per le query nella tabella priceInsightsProductView.

Report Approfondimenti sul prezzo.

I valori vengono impostati solo per i campi richiesti esplicitamente nella query di ricerca della richiesta.

Rappresentazione JSON
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
Campi
price

object (Price)

Prezzo corrente del prodotto.

suggestedPrice

object (Price)

Prezzo suggerito più recente per il prodotto.

effectiveness

enum (Effectiveness)

L'efficacia prevista dell'applicazione del suggerimento di prezzo, raggruppata in bucket.

id

string

ID REST del prodotto, sotto forma di channel~languageCode~feedLabel~offerId. Può essere utilizzato per unire i dati con la tabella productView.

Obbligatorio nella clausola SELECT.

offerId

string

L'ID del prodotto fornito dal commerciante.

title

string

Titolo del prodotto.

brand

string

Marca del prodotto.

categoryL1

string

Categoria di prodotto (1° livello) nella tassonomia dei prodotti di Google.

categoryL2

string

Categoria di prodotto (2° livello) nella tassonomia dei prodotti di Google.

categoryL3

string

Categoria di prodotto (3° livello) nella tassonomia dei prodotti di Google.

categoryL4

string

Categoria di prodotto (4° livello) nella tassonomia dei prodotti di Google.

categoryL5

string

Categoria di prodotto (5° livello) nella tassonomia dei prodotti di Google.

productTypeL1

string

Tipo di prodotto (1° livello) nella tassonomia dei prodotti del commerciante.

productTypeL2

string

Tipo di prodotto (2° livello) nella tassonomia dei prodotti del commerciante.

productTypeL3

string

Tipo di prodotto (3° livello) nella tassonomia dei prodotti del commerciante.

productTypeL4

string

Tipo di prodotto (4° livello) nella tassonomia dei prodotti del commerciante.

productTypeL5

string

Tipo di prodotto (5° livello) nella tassonomia dei prodotti del commerciante.

predictedImpressionsChangeFraction

number

Variazione prevista delle impressioni sotto forma di frazione dopo l'introduzione del prezzo suggerito rispetto al prezzo corrente attivo. Ad esempio, 0,05 corrisponde a un aumento previsto delle impressioni del 5%.

predictedClicksChangeFraction

number

Variazione prevista dei clic sotto forma di frazione dopo l'introduzione del prezzo suggerito rispetto al prezzo attivo corrente. Ad esempio, 0,05 corrisponde a un aumento previsto del 5% dei clic.

predictedConversionsChangeFraction

number

Variazione prevista delle conversioni sotto forma di frazione dopo l'introduzione del prezzo suggerito rispetto al prezzo corrente attivo. Ad esempio, 0,05 corrisponde a un aumento previsto del 5% delle conversioni.

Efficacia

Bucket dell'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 di prezzi con efficacia 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.

BestSellersProductClusterView

Campi disponibili per le query nella tabella bestSellersProductClusterView.

Report Più venduti con i principali cluster di prodotti. Un cluster di prodotti è un raggruppamento di offerte e varianti diverse che rappresentano lo stesso prodotto, ad esempio Google Pixel 7.

I valori vengono impostati solo per i campi richiesti esplicitamente nella query di ricerca della richiesta.

Rappresentazione JSON
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Campi
reportDate

object (Date)

Data del report. Il valore di questo campo può essere solo uno dei seguenti:

  • Il primo giorno della settimana (lunedì) per i report settimanali,
  • Il primo giorno del mese per i report mensili.

Obbligatorio nella clausola SELECT. Se nella query non è specificata una condizione WHERE per reportDate, viene restituito l'ultimo report settimanale o mensile disponibile.

variantGtins[]

string

GTIN di varianti di esempio del cluster di prodotti.

reportGranularity

enum (ReportGranularityEnum)

Granularità del report. Il ranking può essere effettuato nell'arco di una settimana o di un mese.

Obbligatorio nella clausola SELECT. La condizione su reportGranularity è obbligatoria nella clausola WHERE.

reportCountryCode

string

Paese in cui viene calcolato il ranking. Rappresentato nel formato ISO 3166.

Obbligatorio nella clausola SELECT. La condizione su reportCountryCode è obbligatoria nella clausola WHERE.

reportCategoryId

string (int64 format)

L'ID categoria prodotto Google per cui calcolare il ranking, rappresentato nella tassonomia dei prodotti di Google.

Obbligatorio nella clausola SELECT. Se nella query non è specificata una condizione WHERE su reportCategoryId, vengono restituiti i ranking per tutte le categorie di primo livello.

title

string

Titolo del cluster di prodotti.

brand

string

Brand del cluster di prodotti.

categoryL1

string

Categoria di prodotto (1° livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.

categoryL2

string

Categoria di prodotto (2° livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.

categoryL3

string

Categoria di prodotto (3° livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.

categoryL4

string

Categoria di prodotto (4° livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.

categoryL5

string

Categoria di prodotto (5° livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.

inventoryStatus

enum (InventoryStatus)

Indica se il cluster di prodotti è IN_STOCK nell'origine dati di prodotto in almeno uno dei paesi, OUT_OF_STOCK nell'origine dati di prodotto in tutti i paesi o NOT_IN_INVENTORY in nessun paese.

Il campo non tiene in considerazione il filtro relativo al paese del report Più venduti.

brandInventoryStatus

enum (InventoryStatus)

Indica se almeno un prodotto del brand è attualmente IN_STOCK nell'origine dati di prodotto in almeno uno dei paesi, se tutti i prodotti sono OUT_OF_STOCK nell'origine dati di prodotto in tutti i paesi o NOT_IN_INVENTORY.

Il campo non tiene in considerazione il filtro relativo al paese del report Più venduti.

rank

string (int64 format)

Popolarità del cluster di prodotti su Google Ads e sulle piattaforme organiche, nella categoria e nel paese selezionati, in base al numero stimato di unità vendute.

previousRank

string (int64 format)

Ranking di popolarità nella settimana o nel mese precedente.

relativeDemand

enum (RelativeDemandEnum)

Domanda stimata in relazione al cluster di prodotti con il ranking popolarità più alto nella stessa categoria e nello stesso paese.

previousRelativeDemand

enum (RelativeDemandEnum)

Domanda stimata rispetto al cluster di prodotti con il ranking di popolarità più alto nella stessa categoria e nello stesso paese nella settimana o nel mese precedente.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Variazione della domanda stimata. Se è aumentato, diminuito o è rimasto invariato.

ReportGranularityEnum

Specifica i valori di granularità dei report.

Enum
REPORT_GRANULARITY_ENUM_UNSPECIFIED Non specificato.
WEEKLY Il report viene calcolato in un periodo di una settimana.
MONTHLY Il report viene calcolato in un periodo di un mese.

InventoryStatus

Stato del cluster o del brand di prodotti nel tuo inventario.

Enum
INVENTORY_STATUS_UNSPECIFIED Non specificato.
IN_STOCK Hai un prodotto disponibile per questo cluster di prodotti o brand.
OUT_OF_STOCK Hai un prodotto per questo cluster di prodotti o brand nell'inventario, ma al momento non è disponibile.
NOT_IN_INVENTORY Non hai un prodotto per questo cluster di prodotti o brand nell'inventario.

RelativeDemandEnum

Valori della domanda relativa.

Enum
RELATIVE_DEMAND_ENUM_UNSPECIFIED Non specificato.
VERY_LOW La domanda è pari allo 0-5% della domanda del cluster o del brand di prodotti con il ranking più alto.
LOW La domanda è pari al 6-10% della domanda del cluster o del brand di prodotti con il ranking più alto.
MEDIUM La domanda è pari all'11-20% della domanda del cluster o del brand di prodotti con il ranking più alto.
HIGH La domanda è pari al 21-50% della domanda del cluster o del brand di prodotti con il ranking più alto.
VERY_HIGH La domanda è pari al 51-100% della domanda del cluster di prodotti o del brand con il ranking più alto.

RelativeDemandChangeTypeEnum

Valori del tipo di variazione della domanda relativa.

Enum
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED Non specificato.
SINKER La domanda relativa è inferiore al periodo di tempo precedente.
FLAT La domanda relativa è uguale al periodo di tempo precedente.
RISER La domanda relativa è superiore al periodo di tempo precedente.

BestSellersBrandView

Campi disponibili per le query nella tabella bestSellersBrandView.

Report Più venduti con i principali brand.

I valori vengono impostati solo per i campi richiesti esplicitamente nella query di ricerca della richiesta.

Rappresentazione JSON
{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Campi
reportDate

object (Date)

Data del report. Il valore di questo campo può essere solo uno dei seguenti:

  • Il primo giorno della settimana (lunedì) per i report settimanali,
  • Il primo giorno del mese per i report mensili.

Obbligatorio nella clausola SELECT. Se nella query non è specificata una condizione WHERE per reportDate, viene restituito l'ultimo report settimanale o mensile disponibile.

reportGranularity

enum (ReportGranularityEnum)

Granularità del report. Il ranking può essere effettuato nell'arco di una settimana o di un mese.

Obbligatorio nella clausola SELECT. La condizione su reportGranularity è obbligatoria nella clausola WHERE.

reportCountryCode

string

Paese in cui viene calcolato il ranking. Rappresentato nel formato ISO 3166.

Obbligatorio nella clausola SELECT. La condizione su reportCountryCode è obbligatoria nella clausola WHERE.

reportCategoryId

string (int64 format)

L'ID categoria prodotto Google per cui calcolare il ranking, rappresentato nella tassonomia dei prodotti di Google.

Obbligatorio nella clausola SELECT. Se nella query non è specificata una condizione WHERE su reportCategoryId, vengono restituiti i ranking per tutte le categorie di primo livello.

brand

string

Nome del brand.

rank

string (int64 format)

Popolarità del brand su annunci e piattaforme organiche, nella categoria e nel paese selezionati, in base al numero stimato di unità vendute.

previousRank

string (int64 format)

Ranking di popolarità nella settimana o nel mese precedente.

relativeDemand

enum (RelativeDemandEnum)

Domanda stimata rispetto al brand con il ranking popolarità più alto nella stessa categoria e nello stesso paese.

previousRelativeDemand

enum (RelativeDemandEnum)

Domanda stimata rispetto al brand con il ranking popolarità più alto nella stessa categoria e nello stesso paese nella settimana o nel mese precedente.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Variazione della domanda stimata. Se è aumentato, diminuito o è rimasto invariato.

CompetitiveVisibilityCompetitorView

Campi disponibili per le query nella tabella competitiveVisibilityCompetitorView.

Report Scenario competitivo con attività con visibilità simile.

I valori vengono impostati solo per i campi richiesti esplicitamente nella query di ricerca della richiesta.

Rappresentazione JSON
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
Campi
date

object (Date)

Data di questa riga.

Nella clausola WHERE è necessaria una condizione su date.

domain

string

Il dominio del tuo concorrente o il tuo dominio, se "isYourDomain" è true.

Obbligatorio nella clausola SELECT. Non può essere filtrato nella clausola "WHERE".

isYourDomain

boolean

True se questa riga contiene dati per il tuo dominio.

Non può essere filtrato nella clausola "WHERE".

reportCountryCode

string

Paese in cui sono state pubblicate le impressioni.

Obbligatorio nella clausola SELECT. Nella clausola WHERE è necessaria una condizione su reportCountryCode.

reportCategoryId

string (int64 format)

L'ID categoria di prodotto Google per cui calcolare il report, rappresentato nella tassonomia dei prodotti di Google.

Obbligatorio nella clausola SELECT. Nella clausola WHERE è necessaria una condizione su reportCategoryId.

trafficSource

enum (TrafficSourceEnum)

Sorgente di traffico delle impressioni.

Obbligatorio nella clausola SELECT.

rank

string (int64 format)

Posizione del dominio nel ranking delle attività simili per le chiavi selezionate (date, reportCategoryId, reportCountryCode, trafficSource) in base alle impressioni. 1 è il valore più alto.

Non può essere filtrato nella clausola "WHERE".

adsOrganicRatio

number

Il rapporto annunci / ricerca organica mostra quanto spesso il dominio riceve impressioni dagli annunci Shopping rispetto al traffico organico. Il numero viene arrotondato e raggruppato.

Non può essere filtrato nella clausola "WHERE".

pageOverlapRate

number

Il tasso di sovrapposizione della pagina indica la frequenza con cui le offerte dei rivenditori concorrenti vengono visualizzate insieme alle tue offerte sulla stessa pagina.

Non può essere filtrato nella clausola "WHERE".

higherPositionRate

number

Il tasso di posizionamento superiore indica la frequenza con cui l'offerta di un concorrente ha ottenuto un posizionamento più elevato nella pagina rispetto alla tua offerta.

Non può essere filtrato nella clausola "WHERE".

relativeVisibility

number

La visibilità relativa indica la frequenza con cui le offerte della concorrenza vengono mostrate rispetto alle tue offerte. In altre parole, si tratta del numero di impressioni visualizzate per un rivenditore concorrente diviso per il numero delle tue impressioni visualizzate in un determinato intervallo di tempo per una categoria di prodotto e un paese selezionati.

Non può essere filtrato nella clausola "WHERE".

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.

CompetitiveVisibilityTopMerchantView

Campi disponibili per le query nella tabella competitiveVisibilityTopMerchantView.

Report sullo scenario competitivo con le attività con la massima visibilità.

I valori vengono impostati solo per i campi richiesti esplicitamente nella query di ricerca della richiesta.

Rappresentazione JSON
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
Campi
date

object (Date)

Data di questa riga.

Non può essere selezionato nella clausola SELECT. Nella clausola WHERE è necessaria una condizione su date.

domain

string

Il dominio del tuo concorrente o il tuo dominio, se "isYourDomain" è true.

Obbligatorio nella clausola SELECT. Non può essere filtrato nella clausola "WHERE".

isYourDomain

boolean

True se questa riga contiene dati per il tuo dominio.

Non può essere filtrato nella clausola "WHERE".

reportCountryCode

string

Paese in cui sono state pubblicate le impressioni.

Obbligatorio nella clausola SELECT. Nella clausola WHERE è necessaria una condizione su reportCountryCode.

reportCategoryId

string (int64 format)

L'ID categoria di prodotto Google per cui calcolare il report, rappresentato nella tassonomia dei prodotti di Google.

Obbligatorio nella clausola SELECT. Nella clausola WHERE è necessaria una condizione su reportCategoryId.

trafficSource

enum (TrafficSourceEnum)

Sorgente di traffico delle impressioni.

Obbligatorio nella clausola SELECT.

rank

string (int64 format)

Posizione del dominio nel ranking dei migliori commercianti per le chiavi selezionate (date, reportCategoryId, reportCountryCode, trafficSource) in base alle impressioni. 1 è il valore più alto.

Non può essere filtrato nella clausola "WHERE".

adsOrganicRatio

number

Il rapporto annunci / ricerca organica mostra quanto spesso il dominio riceve impressioni dagli annunci Shopping rispetto al traffico organico. Il numero viene arrotondato e raggruppato.

Non può essere filtrato nella clausola "WHERE".

pageOverlapRate

number

Il tasso di sovrapposizione della pagina indica la frequenza con cui le offerte dei rivenditori concorrenti vengono visualizzate insieme alle tue offerte sulla stessa pagina.

Non può essere filtrato nella clausola "WHERE".

higherPositionRate

number

Il tasso di posizionamento superiore indica la frequenza con cui l'offerta di un concorrente ha ottenuto un posizionamento più elevato nella pagina rispetto alla tua offerta.

Non può essere filtrato nella clausola "WHERE".

CompetitiveVisibilityBenchmarkView

Campi disponibili per le query nella tabella competitiveVisibilityBenchmarkView.

Report Scenario competitivo con il benchmark di categoria.

I valori vengono impostati solo per i campi richiesti esplicitamente nella query di ricerca della richiesta.

Rappresentazione JSON
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Campi
date

object (Date)

Data di questa riga.

Obbligatorio nella clausola SELECT. Nella clausola WHERE è necessaria una condizione su date.

reportCountryCode

string

Paese in cui sono state pubblicate le impressioni.

Obbligatorio nella clausola SELECT. Nella clausola WHERE è necessaria una condizione su reportCountryCode.

reportCategoryId

string (int64 format)

L'ID categoria di prodotto Google per cui calcolare il report, rappresentato nella tassonomia dei prodotti di Google.

Obbligatorio nella clausola SELECT. Nella clausola WHERE è necessaria una condizione su reportCategoryId.

trafficSource

enum (TrafficSourceEnum)

Sorgente di traffico delle impressioni.

Obbligatorio nella clausola SELECT.

yourDomainVisibilityTrend

number

Variazione della visibilità in base alle impressioni per il tuo dominio rispetto all'inizio dell'intervallo di tempo selezionato (o al primo giorno con impressioni diverse da zero).

Non può essere filtrato nella clausola "WHERE".

categoryBenchmarkVisibilityTrend

number

Variazione della visibilità in base alle impressioni rispetto all'inizio dell'intervallo di tempo selezionato (o primo giorno con impressioni diverse da zero) per un insieme combinato di commercianti con la visibilità più alta che si avvicina al mercato.

Non può essere filtrato nella clausola "WHERE".

Metodi

Recupera un report definito da una query di ricerca.