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 le prestazioni

Puoi utilizzare l'API Merchant Reports product_performance_view per recuperare le metriche sul rendimento per il tuo account.

Requisiti

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

Per assegnare a un account il ruolo Rendimento e approfondimenti, esegui la patch della risorsa User per l'account con il diritto di accesso PERFORMANCE_REPORTING.

accounts.v1beta.accounts.users.patch sostituisce l'intera risorsa User. Per evitare di perdere informazioni, chiama accounts.v1beta.accounts.users.get per recuperare la risorsa User completa, quindi fornisci tutti i campi nella richiesta accounts.v1beta.accounts.users.patch.

Esempio di query

La seguente query recupera impressions, clicks e click_through_rate per tutti i prodotti nel tuo account durante un determinato periodo di 30 giorni. Per effettuare la richiesta, passa la seguente dichiarazione Merchant Center Query Language al metodo accounts.reports.search:

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

Per saperne di più sui report sul rendimento, consulta la guida Report sul rendimento.

Filtra i prodotti

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

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

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

• gtin
• item_issues

Ecco un esempio che restituisce i prodotti con lo stato NOT_ELIGIBLE_OR_DISAPPROVED. Per effettuare la richiesta, passa la seguente dichiarazione Merchant Center Query Language al metodo accounts.reports.search:

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status
  item_issues
FROM ProductView
WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'

Ecco un esempio di risposta alla query precedente:

{
  "results": [
    {
      "productView": {
        "id": "online~en~US~id0"
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
        "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"
          }
        ]
      }
    }
  ]
}

Per ulteriori informazioni su campi e comportamenti specifici, consulta la documentazione di riferimento di 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 Migliorare i prezzi dei prodotti con il report Approfondimenti sul prezzo.

Esegui query su price_insights_product_view per visualizzare i prezzi scontati suggeriti per i tuoi prodotti.

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

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

Ecco un esempio di risposta alla query precedente:

{
   "results": [
    {
      "priceInsightsProductView": {
        "id": "online~en~US~12345",
        "title": "UGG Women's s Classic Mini",
        "brand": "UGG",
        "price" {
          "amountMicros": "124990000",
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "135680000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.12609300017356873",
        "predictedClicksChangeFraction": "0.508745014667511",
        "predictedConversionsChangeFraction": "2.3431060314178467"
      }
    },
    {
      "priceInsightsProductView": {
        "id": "online~en~US~12346",
        "title": "Nike React Infinity Run Flyknit 2",
        "brand": "Nike",
        "price" {
          "amountMicros": "119990000"
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "125440000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.1799899935722351",
        "predictedClicksChangeFraction": "0.6203680038452148",
        "predictedConversionsChangeFraction": "1.234868049621582"
      }
    },
    {
      "priceInsightsProductView": {
        "id": "online~en~US~12347",
        "title": "  New Balance 327 White Trainers",
        "brand": "New Balance",
        "price" {
          "amountMicros": "84990000"
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "82000000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.11538799852132797",
        "predictedClicksChangeFraction": "0.5869849920272827",
        "predictedConversionsChangeFraction": "1.3622850179672241"
      }
    }
  ]
}