Valuta i tuoi prodotti

Puoi utilizzare l'API Merchant Reports per visualizzare il rendimento dati, filtra i prodotti per attributi specifici e migliora i prezzi.

Misurare le prestazioni

Puoi utilizzare l'API Merchant Reports ProductPerformanceView per recuperare il rendimento metriche per il tuo account.

Requisiti

Devi avere la metrica Performance and Insights per recuperare questo report.

Per assegnare a un account il ruolo Prestazioni e insight, applica la patch User risorsa per l'account con PERFORMANCE_REPORTING di accesso.

accounts.v1beta.accounts.users.patch sostituisce l'intera risorsa User. Per evitare di perdere informazioni, chiama il numero accounts.v1beta.accounts.users.get per ottenere la risorsa User completa, quindi compila tutti i campi nel Richiesta accounts.v1beta.accounts.users.patch.

Esempio di query

La seguente query recupera gli elementi impressions, clicks e clickThroughRate per tutti i prodotti nel tuo account durante uno specifico periodo di 30 giorni punto. Per effettuare la richiesta, passa la seguente query di Merchant Center linguistica alla accounts.reports.search: :

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

Puoi anche segmentare le metriche in la query per ottenere report sul rendimento più dettagliati.

Filtra i prodotti

Puoi utilizzare l'API Merchant Reports ProductView per mostrare una visualizzazione filtrata dei dati di prodotto, inclusi gli stati dei prodotti. Per Ad esempio, puoi eseguire una query su ProductView 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 del parametro REST del prodotto ID.

Puoi filtrare in base a tutte le disponibili campi, 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, trasmetti le seguenti informazioni sul commerciante dell'istruzione Center Query Language a il accounts.reports.search: :

SELECT
  id,
  offerId,
  feedLabel,
  title,
  aggregatedReportingContextStatus
  itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = '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"
          }
        ]
      }
    }
  ]
}

Consulta le ProductView di riferimento 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 il tuo prodotti e le previsioni sul rendimento che puoi aspettarti se aggiorni dei tuoi prodotti prezzi. Il report Approfondimenti sul prezzo può aiutarti a stabilire il prezzo prodotti in modo più efficace.

Consulta Migliorare i prezzi dei prodotti con gli approfondimenti sul prezzo report per ulteriori informazioni.

Termine di ricerca 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. A effettuare la richiesta, passare la seguente query di Merchant Center linguistica alla accounts.reports.search: :

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

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"
      }
    }
  ]
}