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 la mappatura delle informazioni sulla gravità dei problemi nell'API Content con la priorità 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. Di seguito è riportato 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 puoi vedere la gravità degli errori dell'account Merchant Center. Gli errori Critical causano la sospensione dell'account, che impedisce la pubblicazione dei prodotti.

In itemLevelIssues puoi vedere gli errori del prodotto che possono comportare la mancata approvazione del prodotto. Tieni presente che itemLevelIssues[].numItems ti informa che 2 articoli nel tuo account sono interessati da un link all'immagine non funzionante e 5 articoli presentano un errore della pagina di destinazione.

In itemLevelIssues[].servability puoi vedere se l'errore causa la mancata approvazione 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 ogni prodotto. Vengono restituiti 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 di tutti i prodotti nel tuo account, ma non è chiaro quanto sia importante risolverli.

Nel nostro esempio productstatuses, puoi utilizzare itemLevelIssues[].servability per scoprire se un errore disattiva la possibilità di pubblicare il prodotto in Acquista su Google, negli annunci Shopping o nelle schede su 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 perché non puoi pubblicare il prodotto finché 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à.

Innanzitutto, dai un'occhiata al report:

Report di diagnostica di Merchant Center

In che modo tutte le informazioni che ricevi dall'API Content for Shopping sono correlate a quelle che vedi nella sezione Diagnostica? Quali voci sono problemi che devi risolvere al più presto e quali sarebbe bello risolvere, ma non sono essenziali? 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 per l'account e i prodotti in quell'account, mentre l'API Content (tramite il servizio Accountstatuses) fornisce informazioni sulla gravità solo per i problemi accountLevel.

Ogni origine suddivide i problemi in tre categorie in base alla gravità. Comprendere come valutare la gravità dei problemi restituiti dai servizi relativi 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 priorità 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 appaiono 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 mancata approvazione 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.

Non è necessario visitare Merchant Center per scoprire quali errori sono quali. Nell'API Content, il campo accountLevelIssues[].severity negli oggetti risorsa accountstatuses fornisce le stesse informazioni sulla gravità dei problemi. Questi campi possono contenere uno dei tre valori: critical, error e suggestion.

Questi valori hanno una corrispondenza uno a uno con la 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 gli annunci, ma non influirà sull'approvazione del prodotto nel database di Merchant Center. D'altra parte, editorial_and_professional_standards_destination_url_down_policy è un errore più grave che comporta la sospensione dell'account. Se partecipi ad Acquista su Google, alle schede su Google o se avevi un account Google Ads collegato, un errore critical impedisce immediatamente la pubblicazione dei tuoi prodotti nei programmi Acquista su Google, schede su Google e annunci Shopping.

Con queste informazioni, ora puoi scrivere un software di avviso che ti segnalerà immediatamente i problemi importanti, raccogliendo al contempo i problemi meno gravi per un'eventuale correzione, senza dover visitare Merchant Center per distinguere i problemi.