Supponiamo che tu voglia ricevere informazioni sui prodotti attualmente disponibili nel tuo account. In particolare, ti interessa sapere se uno dei tuoi prodotti presenta problemi che devono essere risolti. Sai come ottenere queste informazioni da Merchant Center, ma preferisci configurare un sistema di avviso automatico utilizzando l'API Content. In questa guida, analizzeremo in che modo le informazioni sulla gravità dei problemi nell'API Content corrispondono all'assegnazione della priorità dei problemi visualizzata nei report Diagnostica in Merchant Center.
Esempio con Content API
Per visualizzare i problemi che interessano i tuoi prodotti, puoi utilizzare
accountstatuses.get
per il tuo account. Ecco una versione ridotta della risorsa che ti viene restituita:
{
"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. Critical errori causeranno la sospensione dell'account, che
impedisce la pubblicazione dei prodotti.
In itemLevelIssues, puoi visualizzare gli errori relativi ai prodotti che possono portare alla disapprovazione
dei prodotti. Tieni presente che itemLevelIssues[].numItems ti informa che due articoli del tuo account sono interessati da un link immagine inaccessibile e cinque articoli presentano un errore nella pagina di destinazione.
In itemLevelIssues[].servability, puoi vedere se l'errore determina la disapprovazione
dei prodotti interessati. Tieni presente che sia il link immagine non funzionante
sia l'errore della pagina di destinazione comportano la disapprovazione dei prodotti.
Per trovare tutti i prodotti interessati, chiama il numero
Productstatuses.list
per ricevere un elenco completo dei problemi in base al singolo prodotto. Restituisce voci simili a quelle riportate di seguito:
{
"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 ti è chiaro quanto sia importante risolverli.
Nel nostro esempio di 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 sulle piattaforme Google.
Se itemLevelIssues[].servability è unaffected come l'errore ambiguous_gtin, l'errore non impedirà la pubblicazione del tuo prodotto.
Tuttavia, se itemLevelIssues[].servability è disapproved come l'errore mobile_landing_page_crawling_not_allowed, si tratta di un errore molto più grave poiché non potrai pubblicare il prodotto finché l'errore non verrà corretto.
Nel nostro esempio di accountstatuses, in accountLevelIssues[].severity, la sezione Diagnostica di Merchant Center definisce la priorità dei problemi e il significato preciso delle diverse priorità.
Innanzitutto, dai un'occhiata al report:
Qual è la correlazione tra tutte le informazioni che ricevi dall'API Content for Shopping e i dati che visualizzi nella sezione Diagnostica? Quali sono i problemi da risolvere il prima possibile e quali sarebbe invece carino da risolvere, ma non essenziali? Quali problemi impediscono la pubblicazione degli annunci per i tuoi prodotti?
Come mostrato in questi esempi, la sezione Diagnostica fornisce informazioni sulla gravità dei problemi dell'account e dei prodotti associati all'account, mentre l'API Content (tramite il servizio Accountstatuses) fornisce informazioni sulla gravità esclusivamente per i problemi di accountLevel.
Ogni origine suddivide i problemi in tre categorie a seconda della loro gravità. Capire come valutare la gravità dei problemi restituiti dai servizi relativi allo stato può aiutare a individuare rapidamente quali sono i problemi più importanti da risolvere e quali possono essere tranquillamente ignorati.
Priorità dei problemi
Nella sezione Diagnostica, l'assegnazione della priorità dei problemi descrive la gravità del problema secondo uno dei tre livelli seguenti: errori, avvisi e notifiche. Nelle tabelle dei report come quella sopra, questi livelli sono rappresentati da immagini visualizzate nella prima colonna: 
per gli errori, 
per gli avvisi e 
per le notifiche.
Gli errori hanno causato la sospensione dell'account o la disapprovazione di un articolo. Questi problemi dovrebbero essere risolti il prima possibile per garantire che gli articoli siano nuovamente idonei a comparire nei risultati.
Se il problema non viene risolto, gli avvisi potrebbero influire negativamente sul rendimento dei tuoi annunci e probabilmente comportare la sospensione di articoli o dell'account in futuro.
Le notifiche sono ottimizzazioni suggerite per migliorare la qualità dei dati. La risoluzione di questi problemi è consigliata, ma non obbligatoria.
Tuttavia, non dobbiamo visitare Merchant Center per scoprire quali sono 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 di tre valori:
critical, error e suggestion.
Questi valori hanno una corrispondenza one-to-one con l'assegnazione della priorità dei problemi nella scheda Diagnostica:
| Gravità dei problemi relativi alla qualità dei dati (API) | Assegnazione delle priorità ai problemi |
|---|---|
critical |
Errore () |
error |
Avviso () |
suggestion |
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
influisce sull'approvazione del prodotto nel database di Merchant Center.
editorial_and_professional_standards_destination_url_down_policy è invece un errore più grave che sospende l'account. Se partecipi ai programmi Acquista su Google, Piattaforme Google o se avevi un account Google Ads collegato, un errore critical interrompe immediatamente la pubblicazione dei tuoi prodotti nei programmi Acquista su Google, Piattaforme Google e Annunci Shopping.
Grazie a queste informazioni, ora puoi scrivere software di avviso che attirerà immediatamente la tua attenzione a problemi importanti raccogliendo al contempo problemi meno gravi da risolvere in caso di problemi, senza dover visitare Merchant Center per capire quali sono.