Valuta i tuoi prodotti

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

Misurare le prestazioni

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

Requisiti

Per recuperare questo report, devi avere il ruolo su prestazioni e approfondimenti.

Per concedere a un account il ruolo Prestazioni e approfondimenti, utilizza il metodo accounts.update dell'API Content for Shopping per impostare il campo reportsManager su true.

accounts.update sostituisce l'intera risorsa Account. Utilizza accounts.get per ottenere la risorsa Account completa, poi compila tutti i campi nella richiesta accounts.update per non perdere informazioni.

Esempio di query

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

SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Puoi inoltre segmentare le metriche nella query per generare report sul rendimento più granulari.

Filtra i prodotti

Puoi utilizzare l'API Merchant Reports ProductView per mostrare una visualizzazione filtrata dei dati di prodotto, inclusi gli stati dei prodotti. Ad esempio, puoi eseguire una query su ProductView per elencare i prodotti che presentano problemi o per ricevere un elenco dei 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 itemIssues. Puoi ordinare la risposta in base a tutti i campi disponibili, ad eccezione di quanto segue:

• gtin
• itemIssues

Ecco un esempio che restituisce i tuoi prodotti con lo stato NOT_ELIGIBLE_OR_DISAPPROVED. Per effettuare la richiesta, passa la seguente istruzione Linguaggio di query di Merchant Center al metodo accounts.reports.search:

SELECT
  id,
  offerId,
  feedLabel,
  title,
  aggregatedReportingContextStatus
  itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'

Ecco una risposta di esempio 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"
          }
        ]
      }
    }
  ]
}

Consulta la documentazione di ProductView per ulteriori informazioni su campi e comportamenti specifici.

Migliora i prezzi

Puoi utilizzare la visualizzazione Approfondimenti sul prezzo per vedere i prezzi scontati suggeriti per i tuoi prodotti e le previsioni relative al 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 saperne di più, consulta Migliorare i prezzi dei prodotti con il report Approfondimenti sul prezzo.

Query PriceInsightsProductView per visualizzare i prezzi scontati suggeriti per i tuoi prodotti.

Ecco un esempio che puoi utilizzare per visualizzare i prezzi scontati consigliati per i tuoi prodotti. Per effettuare la richiesta, passa la seguente istruzione Lingua di query di Merchant Center al metodo accounts.reports.search:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predictedImpressionsChangeFraction,
  predictedClicksChangeFraction,
  predictedConversionChangeFraction
FROM PriceInsightsProductView

Ecco una risposta di esempio 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"
      }
    }
  ]
}