Gravità del problema e diagnostica di Merchant Center

Supponiamo che tu voglia ottenere informazioni sui prodotti attualmente disponibili nel tuo account. In particolare, ti interessa sapere se alcuni dei tuoi prodotti presentano problemi che devono essere risolti. Sai come ottenere queste informazioni da Merchant Center, ma preferiresti configurare un sistema di avvisi automatici utilizzando l'API Content. In questa guida, esamineremo in che modo le informazioni sulla gravità del problema nell'API Content corrispondono alla prioritizzazione dei problemi visualizzata nei report di diagnostica in Merchant Center.

Esempio con l'API Content

Per ottenere i problemi che interessano i tuoi prodotti, puoi eseguire accountstatuses.get per il tuo account. Ecco un esempio ridotto della risorsa che ricevi:

{
 "kind": "content#accountStatus",
 "accountId": "...",
 "accountLevelIssues": [
    {
     "id": "editorial_and_professional_standards_destination_url_down_policy",
     "title": "Account suspended due to policy violation: landing page not working",
     "country": "US",
     "severity": "critical",
     "documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
    },
    {
     "id": "missing_ad_words_link",
     "title": "No Google Ads account linked",
     "severity": "error",
     "documentation": "https://support.google.com/merchants/answer/6159060"
    }
   ],
   "products": [
      {
       "channel": "online",
       "destination": "Shopping",
       "country": "US",
       "statistics": {
        "active": "0",
        "pending": "0",
        "disapproved": "5",
        "expiring": "0"
       },
       "itemLevelIssues": [
        {
         "code": "image_link_broken",
         "servability": "disapproved",
         "resolution": "merchant_action",
         "attributeName": "image link",
         "description": "Invalid image [image link]",
         "detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
         "documentation": "https://support.google.com/merchants/answer/6098289",
         "numItems": "2"
        },
        {
         "code": "landing_page_error",
         "servability": "disapproved",
         "resolution": "merchant_action",
         "attributeName": "link",
         "description": "Unavailable desktop landing page",
         "detail": "Update your website or landing page URL to enable access from desktop devices",
         "documentation": "https://support.google.com/merchants/answer/6098155",
         "numItems": "5"
        }
      ]
     },
  ...
}

In accountLevelIssues[].severity viene visualizzata la gravità degli errori dell'account Merchant Center. Gli errori Critical comportano la sospensione dell'account, che impedisce la pubblicazione dei tuoi prodotti.

Nella sezione itemLevelIssues, puoi visualizzare gli errori relativi ai prodotti che possono comportare la disapprovazione dei prodotti. Tieni presente che itemLevelIssues[].numItems indica che 2 elementi nel tuo account sono interessati da un link immagine non funzionante e 5 elementi presentano un errore della pagina di destinazione.

In itemLevelIssues[].servability, puoi vedere se l'errore causa la disapprovazione dei prodotti interessati. Tieni presente che sia il link all'immagine non funzionante sia l'errore della pagina di destinazione causano la mancata approvazione dei prodotti.

Per trovare tutti i prodotti interessati, chiama Productstatuses.list per ottenere un elenco completo dei problemi per prodotto. Restituisce voci come le seguenti:

 {
  "kind": "content#productstatusesListResponse",
  ...
  "resources": [
   {
     "kind": "content#productStatus",
     "productId": "online:en:US:online-en-US-GGL614",
     ...
     "itemLevelIssues": [
       {
         "code": "mobile_landing_page_crawling_not_allowed",
         "servability": "disapproved",
         "resolution": "merchant_action",
         "attributeName": "link",
         "destination": "Shopping",
         "description": "Mobile page not crawlable due to robots.txt",
         "detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
         "documentation": "https://support.google.com/merchants/answer/6098296"
       },
       {
         "code": "pending_initial_policy_review",
         "servability": "disapproved",
         "resolution": "pending_processing",
         "destination": "Shopping",
         "description": "Pending initial review",
         "documentation": "https://support.google.com/merchants/answer/2948694"
       },
       {
         "code": "ambiguous_gtin",
         "servability": "unaffected",
         "resolution": "merchant_action",
         "attributeName": "gtin",
         "destination": "Shopping",
         "description": "Ambiguous value [gtin]",
         "detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
         "documentation": "https://support.google.com/merchants/answer/7000891"
       }
     ],
     ...
   },
   ...
   ]
 }

Ora hai informazioni sui problemi relativi a tutti i prodotti del tuo account, ma non è chiaro quanto sia importante risolverli.

Nel nostro esempio productstatuses, puoi utilizzare itemLevelIssues[].servability per scoprire se un errore ti impedisce di pubblicare il prodotto in Acquista su Google, negli annunci Shopping o nelle piattaforme Google.

Se itemLevelIssues[].servability è unaffected come l'errore ambiguous_gtin, l'errore non impedirà la pubblicazione del prodotto.

Tuttavia, se itemLevelIssues[].servability è disapproved come l'errore mobile_landing_page_crawling_not_allowed, si tratta di un errore molto più grave, in quanto non puoi pubblicare il prodotto finché l'errore non viene corretto.

Nel nostro esempio accountstatuses, nella sezione accountLevelIssues[].severity, la sezione Diagnostica in Merchant Center definisce la priorità dei problemi e il significato preciso delle diverse priorità.

Per prima cosa, dai un'occhiata al report:

Report diagnostico di Merchant Center

In che modo tutte le informazioni che ricevi dall'API Content for Shopping sono correlate a quelle visualizzate nella sezione Diagnostica? Quali voci sono problemi da risolvere al più presto e quali sarebbe bello affrontare, ma non sono essenziali da risolvere? Quali problemi impediranno la pubblicazione dei tuoi prodotti negli annunci se non vengono risolti?

Come mostrato in questi esempi, la sezione Diagnostica fornisce informazioni sulla gravità dei problemi relativi all'account e ai prodotti presenti nell'account, mentre l'API Content (tramite il servizio Accountstatuses) fornisce informazioni sulla gravità solo per i problemi accountLevel.

Ogni fonte suddivide i problemi in tre categorie in base alla gravità del problema. Comprendere come valutare la gravità dei problemi restituiti dai servizi correlati allo stato può aiutarti a individuare rapidamente i problemi più importanti da risolvere e quelli che possono essere ignorati in sicurezza.

Priorità dei problemi

Nella sezione Diagnostica, la prioritizzazione dei problemi descrive la gravità del problema come uno dei tre livelli: errori, avvisi e notifiche. Nelle tabelle dei report come quella sopra, questi livelli sono rappresentati da immagini che vengono visualizzate nella prima colonna: Errore per gli errori, Avviso per gli avvisi e Notifica per le notifiche.

  • Gli errori hanno causato la sospensione dell'account o la disapprovazione di un articolo. Devono essere risolti il prima possibile per garantire che gli articoli siano nuovamente idonei a comparire nei risultati.

  • Gli avvisi potrebbero influire negativamente sul rendimento dei tuoi annunci e probabilmente portare alla sospensione di articoli o dell'account in futuro, a meno che il problema non venga risolto.

  • Le notifiche sono ottimizzazioni suggerite per aumentare la qualità dei dati. La risoluzione di questi problemi è consigliata, ma non obbligatoria.

Tuttavia, non è necessario visitare Merchant Center per scoprire a cosa si riferiscono gli errori. Nell'API Content, il campo accountLevelIssues[].severity negli oggetti risorsa accountstatuses fornisce le stesse informazioni sulla gravità del problema. Questi campi possono contenere uno dei tre valori: critical, error e suggestion.

Questi valori hanno una corrispondenza one-to-one con la definizione delle priorità dei problemi nella scheda Diagnostica:

Gravità del problema di qualità dei dati (API) Priorità dei problemi
critical Errore (Errore)
error Avviso (Avviso)
suggestion Notifica (Notifica)

Quindi, nel nostro esempio accountstatuses, il problema missing_ad_words_link ti informa che devi collegare un account Google Ads per pubblicare annunci, ma non influirà sull'approvazione del prodotto nel database Merchant Center. D'altra parte, l'editorial_and_professional_standards_destination_url_down_policy è un errore più grave che comporta la sospensione dell'account. Se partecipi ad Acquista su Google o Surfaces across Google oppure se avevi un account Google Ads collegato, un errore critical impedisce immediatamente la pubblicazione dei tuoi prodotti nei programmi Acquista su Google, Surfaces across Google e annunci Shopping.

Con queste informazioni, ora puoi scrivere un software di avviso che porterà immediatamente alla tua attenzione i problemi importanti, raccogliendo quelli meno gravi per la risoluzione finale, senza dover visitare Merchant Center per distinguere gli uni dagli altri.