La versione v1beta dell'API Merchant è stata ritirata e disattivata il 28 febbraio 2026. Per i passaggi per eseguire la transizione all'ultima versione stabile, consulta Eseguire la migrazione dalla v1beta alla v1.

Valuta i tuoi prodotti

Puoi utilizzare l'API Merchant Reports per visualizzare i dati sul rendimento, filtrare i prodotti in base ad attributi specifici e migliorare i prezzi.

Misurare il rendimento

Puoi recuperare le metriche sul rendimento del tuo account con product_performance_view dell'API Merchant Reports.

Requisiti

Per recuperare questo report, devi disporre del ruolo Rendimento e approfondimenti.

Per assegnare il ruolo Rendimento e approfondimenti a un utente esistente, crea una richiesta di patch e assegna il diritto di accesso PERFORMANCE_REPORTING all'utente. La seguente richiesta mostra come creare una richiesta di patch per assegnare il diritto di accesso PERFORMANCE_REPORTING:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Sostituisci quanto segue:

{ACCOUNT_ID}: l'identificatore univoco dell'account Merchant Center.
{EMAIL_ID}: l'indirizzo email dell'utente a cui vuoi assegnare il ruolo.

Esempio di query

La seguente query recupera impressions, clicks e click_through_rate per tutti i prodotti nel tuo account durante un periodo specifico di 30 giorni. Per effettuare la richiesta, trasmetti la seguente istruzione del linguaggio di query di Merchant Center al accounts.reports.search metodo:

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Per ulteriori informazioni sui report sul rendimento, consulta la guida ai report sul rendimento.

Filtra i prodotti

Puoi utilizzare product_view dell'API Merchant Reports per visualizzare una visualizzazione filtrata dei dati di prodotto, inclusi gli stati dei prodotti. Ad esempio, puoi eseguire una query su product_view per elencare i prodotti che presentano problemi o per ottenere un elenco dei nuovi prodotti e verificarne la pubblicazione.

Devi includere il campo id nella clausola SELECT della query. Il id ha lo stesso valore dell'ID REST del prodotto.

Puoi filtrare in base a tutti i campi disponibili, ad eccezione dei seguenti:

status_per_reporting_context
item_issues.

Puoi ordinare la risposta in base a tutti i campi disponibili, ad eccezione dei seguenti:

gtin
status_per_reporting_context
item_issues

Puoi controllare il campo aggregated_reporting_context_status per comprendere l'idoneità complessiva di un prodotto. Questo campo aggrega gli stati in tutti i contesti di reporting di un prodotto.

Ecco un esempio che restituisce i prodotti con lo stato aggregato ELIGIBLE_LIMITED, il che significa che sono idonei all'erogazione in almeno uno, ma non in tutti, i contesti di reporting di destinazione. Puoi richiedere lo stato dettagliato del prodotto per contesto di reporting e i problemi relativi al prodotto per ulteriori indagini. Per effettuare la richiesta, trasmetti la seguente istruzione del linguaggio di query di Merchant Center al accounts.reports.search metodo:

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status,
  status_per_reporting_context,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'

Ecco una risposta di esempio alla query precedente:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
        "statusPerReportingContext": [
          {
            "reportingContext": "SHOPPING_ADS",
            "disapprovedCountries": [
              "US"
            ]
          },
          {
            "reportingContext": "FREE_LISTINGS",
            "approvedCountries": [
              "US"
            ]
          }
        ]
        "itemIssues": [
          {
            "type": {
              "code": "invalid_string_value",
              "canonicalAttribute": "n:product_code"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                },
                {
                  "reportingContext": "FREE_LISTINGS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DISAPPROVED"
            },
            "resolution": "MERCHANT_ACTION"
          },
          {
            "type": {
              "code": "apparel_missing_brand",
              "canonicalAttribute": "n:brand"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DEMOTED"
            },
            "resolution": "MERCHANT_ACTION"
          }
        ]
      }
    }
  ]
}

Puoi utilizzare un filtro su reporting_context nella clausola WHERE per visualizzare i dettagli del prodotto per un contesto di reporting specifico. Quando filtri per reporting_context, aggregated_reporting_context_status viene calcolato in base solo al contesto di reporting selezionato, mentre status_per_reporting_context e item_issues restituiscono solo i dettagli per quel contesto.

Per ulteriori informazioni sui campi disponibili per la query, consulta la sezione Campi nella tabella.product_view

Migliorare i prezzi

Puoi utilizzare la visualizzazione Approfondimenti sul prezzo per visualizzare i prezzi di vendita suggeriti per i tuoi prodotti e le previsioni sul rendimento che puoi aspettarti se aggiorni i prezzi dei tuoi prodotti. Il report Approfondimenti sul prezzo può aiutarti a stabilire il prezzo dei tuoi prodotti in modo più efficace.

Per ulteriori informazioni, consulta la sezione Migliorare i prezzi dei prodotti con il report Approfondimenti sul prezzo.

Esegui una query su price_insights_product_view per visualizzare i prezzi di vendita suggeriti per i tuoi prodotti.

Ecco un esempio che puoi utilizzare per visualizzare i prezzi di vendita suggeriti per i tuoi prodotti. Per effettuare la richiesta, trasmetti la seguente istruzione del linguaggio di query di Merchant Center al accounts.reports.search metodo:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversion_change_fraction
FROM price_insights_product_view