Questa pagina è stata tradotta dall'API Cloud Translation.

Method: accounts.reports.search

Richiesta HTTP
Parametri percorso
Corpo della richiesta
- Rappresentazione JSON
Corpo della risposta
- Rappresentazione JSON
Ambiti di autorizzazione
ReportRow
- Rappresentazione JSON
ProductPerformanceView
- Rappresentazione JSON
MarketingMethodEnum
NonProductPerformanceView
- Rappresentazione JSON
ProductView
- Rappresentazione JSON
AggregatedReportingContextStatus
ItemIssue
- Rappresentazione JSON
ItemIssueType
- Rappresentazione JSON
ItemIssueSeverity
- Rappresentazione JSON
IssueSeverityPerReportingContext
- Rappresentazione JSON
AggregatedIssueSeverity
ItemIssueResolution
ClickPotential
PriceCompetitivenessProductView
- Rappresentazione JSON
PriceInsightsProductView
- Rappresentazione JSON
Efficacia
BestSellersProductClusterView
- Rappresentazione JSON
ReportGranularityEnum
InventoryStatus
RelativeDemandEnum
RelativeDemandChangeTypeEnum
BestSellersBrandView
- Rappresentazione JSON
CompetitiveVisibilityCompetitorView
- Rappresentazione JSON
TrafficSourceEnum
CompetitiveVisibilityTopMerchantView
- Rappresentazione JSON
CompetitiveVisibilityBenchmarkView
- Rappresentazione JSON

Consente di recuperare un report definito da una query di ricerca. La risposta potrebbe contenere meno righe di quelle specificate da pageSize. Affidati a nextPageToken per determinare se sono presenti più righe da richiedere.

Richiesta HTTP

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri

Parametri
`parent`	`string` Obbligatoria. ID dell'account che effettua la chiamata. Deve essere un account autonomo o un subaccount AMC. Formato: accounts/{account}

parent

string

Obbligatoria. ID dell'account che effettua la chiamata. Deve essere un account autonomo o un subaccount AMC. Formato: accounts/{account}

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{ "query": string, "pageSize": integer, "pageToken": string }

Campi

Campi
`query`	`string` Obbligatoria. Query che definisce un report da recuperare. Per maggiori dettagli su come creare la tua query, consulta la guida Linguaggio di query. Per l'elenco completo delle tabelle e dei campi disponibili, vedi Campi disponibili.
`pageSize`	`integer` Campo facoltativo. Numero di `ReportRows` da recuperare in una singola pagina. Il valore predefinito è 1000. I valori superiori a 5000 vengono forzati a 5000.
`pageToken`	`string` Campo facoltativo. Token della pagina da recuperare. Se non specificata, viene restituita la prima pagina dei risultati. Per richiedere la pagina dei risultati successiva, deve essere utilizzato il valore ottenuto da `nextPageToken` nella risposta precedente.

query

string

Obbligatoria. Query che definisce un report da recuperare.

Per maggiori dettagli su come creare la tua query, consulta la guida Linguaggio di query. Per l'elenco completo delle tabelle e dei campi disponibili, vedi Campi disponibili.

pageSize

integer

Campo facoltativo. Numero di ReportRows da recuperare in una singola pagina. Il valore predefinito è 1000. I valori superiori a 5000 vengono forzati a 5000.

pageToken

string

Campo facoltativo. Token della pagina da recuperare. Se non specificata, viene restituita la prima pagina dei risultati. Per richiedere la pagina dei risultati successiva, deve essere utilizzato il valore ottenuto da nextPageToken nella risposta precedente.

Corpo della risposta

Messaggio di risposta per il metodo ReportService.Search.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{ "results": [ { object (`ReportRow`) } ], "nextPageToken": string }

Campi

Campi
`results[]`	`object (ReportRow)` Righe corrispondenti alla query di ricerca.
`nextPageToken`	`string` Token che può essere inviato come `pageToken` per recuperare la pagina successiva. Se omesso, non ci sono pagine successive.

results[]

object (ReportRow)

Righe corrispondenti alla query di ricerca.

nextPageToken

string

Token che può essere inviato come pageToken per recuperare la pagina successiva. Se omesso, non ci sono pagine successive.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

ReportRow

Riga del risultato 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.

Rappresentazione JSON

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`) } }

{
  "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 la query nella tabella `productPerformanceView`.
`nonProductPerformanceView`	`object (NonProductPerformanceView)` Campi disponibili per la query nella tabella `nonProductPerformanceView`.
`productView`	`object (ProductView)` Campi disponibili per la query nella tabella `productView`.
`priceCompetitivenessProductView`	`object (PriceCompetitivenessProductView)` Campi disponibili per la query nella tabella `priceCompetitivenessProductView`.
`priceInsightsProductView`	`object (PriceInsightsProductView)` Campi disponibili per la query nella tabella `priceInsightsProductView`.
`bestSellersProductClusterView`	`object (BestSellersProductClusterView)` Campi disponibili per la query nella tabella `bestSellersProductClusterView`.
`bestSellersBrandView`	`object (BestSellersBrandView)` Campi disponibili per la query nella tabella `bestSellersBrandView`.
`competitiveVisibilityCompetitorView`	`object (CompetitiveVisibilityCompetitorView)` Campi disponibili per la query nella tabella `competitiveVisibilityCompetitorView`.
`competitiveVisibilityTopMerchantView`	`object (CompetitiveVisibilityTopMerchantView)` Campi disponibili per la query nella tabella `competitiveVisibilityTopMerchantView`.
`competitiveVisibilityBenchmarkView`	`object (CompetitiveVisibilityBenchmarkView)` Campi disponibili per la query nella tabella `competitiveVisibilityBenchmarkView`.

ProductPerformanceView

Campi disponibili per la query nella tabella productPerformanceView.

Dati sul rendimento dei prodotti relativi al tuo account, incluse metriche sul rendimento (ad es. clicks) e dimensioni in base alle quali vengono segmentate le metriche sul rendimento (ad es. offerId). I valori delle dimensioni del prodotto, ad esempio offerId, riflettono lo stato di un prodotto al momento dell'impressione.

Non è possibile selezionare i campi del segmento nelle query senza selezionare anche almeno un campo della metrica.

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

Rappresentazione JSON

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 }

{
  "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 alla data della 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` Il codice del paese in cui si trova il cliente al momento dell'evento. Rappresentate nel formato ISO 3166. Segmento. Se non è possibile determinare il paese del cliente, viene restituito un codice "ZZ" speciale.
`offerId`	`string` L'ID del prodotto fornito dal commerciante. Segmento.
`title`	`string` Titolo del prodotto. Segmento.
`brand`	`string` Brand 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 (3o livello) nella tassonomia dei prodotti di Google. Segmento.
`categoryL4`	`string` Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google. Segmento.
`categoryL5`	`string` Categoria di prodotto (5o 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 (3o livello) nella tassonomia dei prodotti del commerciante. Segmento.
`productTypeL4`	`string` Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante. Segmento.
`productTypeL5`	`string` Tipo di prodotto (5o 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 vengono mostrati i prodotti del commerciante. 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 sono stati visualizzati (impressioni). Metrica.
`conversions`	`number` Numero di conversioni attribuite al prodotto, registrato alla data di conversione. A seconda del modello di attribuzione, una conversione può essere distribuita tra più clic, ognuno dei quali riceve il proprio merito assegnato. Questa metrica è la somma di tutti i crediti di questo tipo. Metrica. Disponibile solo per la sorgente di traffico `FREE`.
`conversionRate`	`number` Il numero di conversioni diviso per il numero di clic, riportato 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 la query nella tabella nonProductPerformanceView.

Dati sul rendimento di immagini e link del negozio online che rimandano alle tue pagine non relative ai prodotti. Sono incluse le metriche sul rendimento (ad es. clicks) e le dimensioni in base alle quali vengono segmentate le metriche sul rendimento (ad es. date).

Non è possibile selezionare i campi del segmento nelle query senza selezionare anche almeno un campo della 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 su immagini e 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 le immagini e i link dei negozi online che rimandano alle tue pagine non relative ai prodotti. Metrica.
`clickThroughRate`	`number` Percentuale di clic: il numero di clic (`clicks`) diviso per il numero di impressioni (`impressions`) di immagini e link di negozi online che rimandano alle tue pagine non relative ai prodotti. Metrica.

ProductView

Campi disponibili per la 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 dei prodotti dell'API secondaria Products sono disponibili per le query in questa tabella. A differenza dell'API secondaria Products, questa tabella consente di filtrare l'elenco dei prodotti restituito in base agli attributi del prodotto. Per recuperare un singolo prodotto entro il giorno id o elencare tutti i prodotti, deve essere utilizzata l'API secondaria Products.

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

Rappresentazione JSON

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 }

{
  "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 Assente 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)` L'ora in cui il commerciante ha creato il prodotto, espressa in secondi timestamp.
`expirationDate`	`object (Date)` Data di scadenza del prodotto, specificata al momento dell'inserimento.
`itemIssues[]`	`object (ItemIssue)` Elenco dei problemi correlati all'articolo del prodotto. Questo campo non può essere utilizzato per ordinare i risultati. Solo gli attributi selezionati di questo campo (ad es. `itemIssues.severity.aggregated_severity`) possono essere utilizzati per filtrare i risultati.
`clickPotential`	`enum (ClickPotential)` Rendimento stimato potenziale rispetto ai prodotti del commerciante con il rendimento migliore.
`id`	`string` ID REST del prodotto, nel formato `channel~languageCode~feedLabel~offerId`. I metodi dell'API Merchant che operano sui prodotti prendono questo come parametro `name`. Obbligatorio nella clausola `SELECT`.
`channel`	`enum (ChannelEnum)` Canale del prodotto. Può essere `ONLINE` o `LOCAL`.
`languageCode`	`string` Codice lingua del prodotto nel formato BCP 47.
`feedLabel`	`string` Etichetta del feed del prodotto.
`offerId`	`string` L'ID del prodotto fornito dal commerciante.
`title`	`string` Titolo del prodotto.
`brand`	`string` Brand 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 (3o livello) nella tassonomia dei prodotti di Google.
`categoryL4`	`string` Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google.
`categoryL5`	`string` Categoria di prodotto (5o 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 (3o livello) nella tassonomia dei prodotti del commerciante.
`productTypeL4`	`string` Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante.
`productTypeL5`	`string` Tipo di prodotto (5o livello) nella tassonomia dei prodotti del commerciante.
`condition`	`string` Condizione del prodotto.
`availability`	`string` Disponibilità del prodotto.
`shippingLabel`	`string` Etichetta spedizione normalizzata specificata nell'origine dati.
`itemGroupId`	`string` ID gruppo di articoli fornito dal commerciante per raggruppare le varianti.
`thumbnailLink`	`string` Link all'immagine elaborata del prodotto, ospitata sull'infrastruttura di Google.
`aggregatedReportingContextStatus`	`enum (AggregatedReportingContextStatus)` Stato aggregato.
`clickPotentialRank`	`string (int64 format)` 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 delle query di ricerca.

AggregatedReportingContextStatus

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

ItemIssue

Problema relativo all'articolo associato al prodotto.

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

Campi

Campi
`type`	`object (ItemIssueType)` Tipo di problema dell'articolo.
`severity`	`object (ItemIssueSeverity)` Gravità del problema dell'articolo.
`resolution`	`enum (ItemIssueResolution)` Risoluzione del problema dell'articolo.

type

object (ItemIssueType)

Tipo di problema dell'articolo.

severity

object (ItemIssueSeverity)

Gravità del problema dell'articolo.

resolution

enum (ItemIssueResolution)

Risoluzione del problema dell'articolo.

ItemIssueType

Tipo di problema.

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

Campi

Campi
`code`	`string` Codice di errore del problema, equivalente al valore `code` di Problemi correlati al prodotto.
`canonicalAttribute`	`string` Nome dell'attributo canonico per problemi specifici degli attributi.

code

string

Codice di errore del problema, equivalente al valore code di Problemi correlati al prodotto.

canonicalAttribute

string

Nome dell'attributo canonico per problemi specifici degli attributi.

ItemIssueSeverity

Il modo in cui il problema influisce sulla pubblicazione del prodotto.

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

Campi

Campi
`severityPerReportingContext[]`	`object (IssueSeverityPerReportingContext)` Gravità del problema in base al contesto del report.
`aggregatedSeverity`	`enum (AggregatedIssueSeverity)` Gravità aggregata del problema per tutti i contesti di segnalazione interessati. Questo campo può essere utilizzato per filtrare i risultati.

severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

Gravità del problema in base al contesto del report.

aggregatedSeverity

enum (AggregatedIssueSeverity)

Gravità aggregata del problema per tutti i contesti di segnalazione interessati.

Questo campo può essere utilizzato per filtrare i risultati.

IssueSeverityPerReportingContext

Gravità del problema in base al contesto del report.

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

Campi

Campi
`disapprovedCountries[]`	`string` Elenco dei paesi non approvati nel contesto della segnalazione, rappresentati in formato ISO 3166.
`demotedCountries[]`	`string` Elenco dei paesi retrocessi nel contesto della segnalazione, rappresentati in formato ISO 3166.
`reportingContext`	`enum (ReportingContextEnum)` Contesto dei report a cui si applica il problema.

disapprovedCountries[]

string

Elenco dei paesi non approvati nel contesto della segnalazione, rappresentati in formato ISO 3166.

demotedCountries[]

string

Elenco dei paesi retrocessi nel contesto della segnalazione, rappresentati in formato ISO 3166.

reportingContext

enum (ReportingContextEnum)

Contesto dei report a cui si applica il problema.

AggregatedIssueSeverity

Gravità dei problemi aggregata per tutti i contesti dei report.

Enum
`AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED`	Non specificato.
`DISAPPROVED`	Il problema non approva il prodotto in almeno un contesto di segnalazione.
`DEMOTED`	Il problema fa retrocedere il prodotto in tutti i contesti di generazione dei 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 causare un altro problema (ad esempio, se la scansione non riesce).

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 e a comprendere il rendimento dei prodotti rispetto al loro potenziale.

Enum
`CLICK_POTENTIAL_UNSPECIFIED`	Impatto sui clic previsti sconosciuto.
`LOW`	Potrebbe ricevere un numero di clic basso rispetto ai prodotti del commerciante con il rendimento migliore.
`MEDIUM`	Potrebbe ricevere un numero moderato di clic rispetto ai prodotti del commerciante con il rendimento migliore.
`HIGH`	Potrebbe ricevere un numero di clic simile a quello dei prodotti del commerciante con il rendimento migliore.

PriceCompetitivenessProductView

Campi disponibili per la 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

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 }

{
  "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 attuale del prodotto.
`benchmarkPrice`	`object (Price)` Ultimo benchmark prezzi disponibile per il catalogo del prodotto nel paese di benchmark.
`reportCountryCode`	`string` Paese del benchmark prezzi. Rappresentate nel formato ISO 3166. Obbligatorio nella clausola `SELECT`.
`id`	`string` ID REST del prodotto, nel formato `channel~languageCode~feedLabel~offerId`. Può essere utilizzato per unire i dati alla tabella `productView`. Obbligatorio nella clausola `SELECT`.
`offerId`	`string` L'ID del prodotto fornito dal commerciante.
`title`	`string` Titolo del prodotto.
`brand`	`string` Brand 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 (3o livello) nella tassonomia dei prodotti di Google.
`categoryL4`	`string` Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google.
`categoryL5`	`string` Categoria di prodotto (5o 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 (3o livello) nella tassonomia dei prodotti del commerciante.
`productTypeL4`	`string` Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante.
`productTypeL5`	`string` Tipo di prodotto (5o livello) nella tassonomia dei prodotti del commerciante.

PriceInsightsProductView

Campi disponibili per la 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

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 }

{
  "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 attuale del prodotto.
`suggestedPrice`	`object (Price)` Ultimo prezzo suggerito per il prodotto.
`effectiveness`	`enum (Effectiveness)` L'efficacia prevista dell'applicazione del suggerimento relativo al prezzo in bucket.
`id`	`string` ID REST del prodotto, nel formato `channel~languageCode~feedLabel~offerId`. Può essere utilizzato per unire i dati alla tabella `productView`. Obbligatorio nella clausola `SELECT`.
`offerId`	`string` L'ID del prodotto fornito dal commerciante.
`title`	`string` Titolo del prodotto.
`brand`	`string` Brand 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 (3o livello) nella tassonomia dei prodotti di Google.
`categoryL4`	`string` Categoria di prodotto (4o livello) nella tassonomia dei prodotti di Google.
`categoryL5`	`string` Categoria di prodotto (5o 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 (3o livello) nella tassonomia dei prodotti del commerciante.
`productTypeL4`	`string` Tipo di prodotto (4o livello) nella tassonomia dei prodotti del commerciante.
`productTypeL5`	`string` Tipo di prodotto (5o livello) nella tassonomia dei prodotti del commerciante.
`predictedImpressionsChangeFraction`	`number` Variazione prevista delle impressioni come frazione dopo l'introduzione del prezzo suggerito rispetto al prezzo attivo corrente. Ad esempio, 0,05 indica un aumento previsto del 5% delle impressioni.
`predictedClicksChangeFraction`	`number` Variazione prevista dei clic come frazione dopo l'introduzione del prezzo suggerito rispetto al prezzo attivo corrente. Ad esempio, 0,05 indica un aumento previsto del 5% dei clic.
`predictedConversionsChangeFraction`	`number` Variazione prevista nelle conversioni come 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 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 la query nella tabella bestSellersProductClusterView.

Report Più venduti con i migliori cluster di prodotti. Un cluster di prodotti è un raggruppamento di diverse offerte e varianti 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

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`) }

{
  "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 viene specificata una condizione `WHERE` per `reportDate`, viene restituito l'ultimo report settimanale o mensile disponibile.
`variantGtins[]`	`string` GTIN delle varianti di esempio del cluster di prodotti.
`reportGranularity`	`enum (ReportGranularityEnum)` Granularità del report. Il ranking può essere calcolato nell'arco di una settimana o un mese. Obbligatorio nella clausola `SELECT`. La condizione su `reportGranularity` è obbligatoria nella clausola `WHERE`.
`reportCountryCode`	`string` Paese in cui viene calcolato il ranking. Rappresentate nel formato ISO 3166. Obbligatorio nella clausola `SELECT`. La condizione su `reportCountryCode` è obbligatoria nella clausola `WHERE`.
`reportCategoryId`	`string (int64 format)` L'ID della categoria prodotto Google per calcolare il ranking, rappresentato nella tassonomia dei prodotti di Google. Obbligatorio nella clausola `SELECT`. Se nella query non viene specificata una condizione `WHERE` in `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 (3o livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.
`categoryL4`	`string` Categoria di prodotto (4o livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.
`categoryL5`	`string` Categoria di prodotto (5o livello) del cluster di prodotti, rappresentata nella tassonomia dei prodotti di Google.
`inventoryStatus`	`enum (InventoryStatus)` Indica se il cluster dei 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` del tutto. Il campo non tiene in considerazione il filtro relativo al paese del report Più venduti.
`brandInventoryStatus`	`enum (InventoryStatus)` Se almeno un prodotto del brand è attualmente `IN_STOCK` nell'origine dati di prodotto in almeno uno dei paesi, tutti i prodotti saranno `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 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 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.
`relativeDemandChange`	`enum (RelativeDemandChangeTypeEnum)` Variazione della domanda stimata. Indipendentemente dal fatto che si alzò, affondò o rimase in posizione orizzontale.

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 un mese.

InventoryStatus

Stato del cluster di prodotti o del brand 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 disponibile nell'inventario, ma al momento non è disponibile.
`NOT_IN_INVENTORY`	Non disponi di un prodotto per questo cluster o brand di prodotti nell'inventario.

RelativeDemandEnum

Valori della domanda relativa.

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

RelativeDemandChangeTypeEnum

Valori del tipo di modifica 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ù alta rispetto al periodo di tempo precedente.

BestSellersBrandView

Campi disponibili per la query nella tabella bestSellersBrandView.

Report Più venduti con brand famosi.

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

Rappresentazione JSON

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`) }

{
  "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 viene 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 calcolato nell'arco di una settimana o un mese. Obbligatorio nella clausola `SELECT`. La condizione su `reportGranularity` è obbligatoria nella clausola `WHERE`.
`reportCountryCode`	`string` Paese in cui viene calcolato il ranking. Rappresentate nel formato ISO 3166. Obbligatorio nella clausola `SELECT`. La condizione su `reportCountryCode` è obbligatoria nella clausola `WHERE`.
`reportCategoryId`	`string (int64 format)` L'ID della categoria prodotto Google per calcolare il ranking, rappresentato nella tassonomia dei prodotti di Google. Obbligatorio nella clausola `SELECT`. Se nella query non viene specificata una condizione `WHERE` in `reportCategoryId`, vengono restituiti i ranking per tutte le categorie di primo livello.
`brand`	`string` Il nome del brand.
`rank`	`string (int64 format)` Popolarità del brand 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 popolarità nella settimana o nel mese precedente.
`relativeDemand`	`enum (RelativeDemandEnum)` Domanda stimata in relazione al brand con il ranking popolarità più alto nella stessa categoria e nello stesso paese.
`previousRelativeDemand`	`enum (RelativeDemandEnum)` Domanda stimata in relazione 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. Indipendentemente dal fatto che si alzò, affondò o rimase in posizione orizzontale.

CompetitiveVisibilityCompetitorView

Campi disponibili per la query nella tabella competitiveVisibilityCompetitorView.

Report Scenario competitivo con attività con una visibilità simile.

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

Rappresentazione JSON

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 }

{
  "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. È richiesta una condizione su `date` nella clausola `WHERE`.
`domain`	`string` Dominio della concorrenza o del tuo dominio, se "isYourDomain" è vero. Obbligatorio nella clausola `SELECT`. Non può essere filtrato in base alla clausola "WHERE".
`isYourDomain`	`boolean` True se la riga contiene dati relativi al tuo dominio. Non può essere filtrato in base alla clausola "WHERE".
`reportCountryCode`	`string` Paese in cui sono apparse le impressioni. Obbligatorio nella clausola `SELECT`. È richiesta una condizione su `reportCountryCode` nella clausola `WHERE`.
`reportCategoryId`	`string (int64 format)` ID della categoria prodotto Google per il quale calcolare il report, rappresentato nella tassonomia dei prodotti di Google. Obbligatorio nella clausola `SELECT`. È richiesta una condizione su `reportCategoryId` nella clausola `WHERE`.
`trafficSource`	`enum (TrafficSourceEnum)` Sorgente di traffico delle impressioni. Obbligatorio nella clausola `SELECT`.
`rank`	`string (int64 format)` Posizione del dominio nel ranking di attività simili per le chiavi selezionate (`date`, `reportCategoryId`, `reportCountryCode`, `trafficSource`) in base alle impressioni. 1 è il valore più alto. Non può essere filtrato in base alla clausola "WHERE".
`adsOrganicRatio`	`number` Rapporto annunci / ricerca organica mostra la frequenza con cui il dominio riceve impressioni dagli annunci Shopping rispetto al traffico organico. Il numero è arrotondato e diviso in bucket. Non può essere filtrato in base alla clausola "WHERE".
`pageOverlapRate`	`number` Il tasso di sovrapposizione della pagina mostra la frequenza con cui le offerte dei rivenditori concorrenti vengono mostrate insieme alle tue offerte nella stessa pagina. Non può essere filtrato in base alla clausola "WHERE".
`higherPositionRate`	`number` Il tasso di posizione più elevata mostra 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 in base alla clausola "WHERE".
`relativeVisibility`	`number` La visibilità relativa indica la frequenza con cui vengono mostrate le offerte della concorrenza rispetto alle tue. In altre parole, il 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 in base alla 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 pubblicitari.

CompetitiveVisibilityTopMerchantView

Campi disponibili per la query nella tabella competitiveVisibilityTopMerchantView.

Report Scenario competitivo con l'attività con la visibilità più elevata.

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

Rappresentazione JSON

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

{
  "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`. È richiesta una condizione su `date` nella clausola `WHERE`.
`domain`	`string` Dominio della concorrenza o del tuo dominio, se "isYourDomain" è vero. Obbligatorio nella clausola `SELECT`. Non può essere filtrato in base alla clausola "WHERE".
`isYourDomain`	`boolean` True se la riga contiene dati relativi al tuo dominio. Non può essere filtrato in base alla clausola "WHERE".
`reportCountryCode`	`string` Paese in cui sono apparse le impressioni. Obbligatorio nella clausola `SELECT`. È richiesta una condizione su `reportCountryCode` nella clausola `WHERE`.
`reportCategoryId`	`string (int64 format)` ID della categoria prodotto Google per il quale calcolare il report, rappresentato nella tassonomia dei prodotti di Google. Obbligatorio nella clausola `SELECT`. È richiesta una condizione su `reportCategoryId` nella clausola `WHERE`.
`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 in base alla clausola "WHERE".
`adsOrganicRatio`	`number` Rapporto annunci / ricerca organica mostra la frequenza con cui il dominio riceve impressioni dagli annunci Shopping rispetto al traffico organico. Il numero è arrotondato e diviso in bucket. Non può essere filtrato in base alla clausola "WHERE".
`pageOverlapRate`	`number` Il tasso di sovrapposizione della pagina mostra la frequenza con cui le offerte dei rivenditori concorrenti vengono mostrate insieme alle tue offerte nella stessa pagina. Non può essere filtrato in base alla clausola "WHERE".
`higherPositionRate`	`number` Il tasso di posizione più elevata mostra 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 in base alla clausola "WHERE".

CompetitiveVisibilityBenchmarkView

Campi disponibili per la 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

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

{
  "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`. È richiesta una condizione su `date` nella clausola `WHERE`.
`reportCountryCode`	`string` Paese in cui sono apparse le impressioni. Obbligatorio nella clausola `SELECT`. È richiesta una condizione su `reportCountryCode` nella clausola `WHERE`.
`reportCategoryId`	`string (int64 format)` ID della categoria prodotto Google per il quale calcolare il report, rappresentato nella tassonomia dei prodotti di Google. Obbligatorio nella clausola `SELECT`. È richiesta una condizione su `reportCategoryId` nella clausola `WHERE`.
`trafficSource`	`enum (TrafficSourceEnum)` Sorgente di traffico delle impressioni. Obbligatorio nella clausola `SELECT`.
`yourDomainVisibilityTrend`	`number` Modifica della visibilità in base alle impressioni per il dominio rispetto all'inizio dell'intervallo di tempo selezionato (o al primo giorno con impressioni diverse da zero). Non può essere filtrato in base alla 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 in base alla clausola "WHERE".