Supponiamo che tu voglia ottenere informazioni sui prodotti attualmente disponibili nel tuo account. In particolare, ti interessa sapere se i tuoi prodotti presentano problemi che richiedono una soluzione. Sai come ottenere queste informazioni da Merchant Center, ma preferisci configurare un sistema di avviso automatico utilizzando l'API Content. In questa guida spiegheremo in che modo le informazioni sulla gravità del problema nell'API Content vengono associate alla priorità del problema indicata nei report Diagnostica di Merchant Center.
Esempio con l'API Content
Per visualizzare i problemi che interessano i tuoi prodotti, puoi eseguire
accountstatuses.get
per il tuo account. Ecco un esempio ridotto della risorsa 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, viene visualizzata la gravità degli errori dell'account Merchant Center. Gli errori Critical causeranno la sospensione dell'account, impedendoti di pubblicare i tuoi prodotti.
In itemLevelIssues, puoi vedere gli errori dei prodotti che possono comportare la loro disapprovazione. Tieni presente che itemLevelIssues[].numItems ti informa che 2 elementi nel tuo account sono interessati da un link immagine non funzionante e 5 elementi presentano un errore nella 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 la seguente:
{
"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 nel 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 su
Acquista su Google, annunci Shopping o piattaforme Google.
Se itemLevelIssues[].servability è unaffected come nell'ambiguous_gtin, l'errore non impedirà la pubblicazione del prodotto.
Tuttavia, se itemLevelIssues[].servability è disapproved come nell'errore mobile_landing_page_crawling_not_allowed, si tratta di un errore molto più grave, poiché non puoi pubblicare il prodotto finché l'errore non viene corretto.
Nel nostro esempio accountstatuses, in 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:
In che modo tutte le informazioni che ricevi dall'API Content for Shopping sono correlate a ciò che vedi nella sezione Diagnostica? Quali voci sono problemi che devi risolvere il prima possibile e quali sarebbe opportuno 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à
in merito ai problemi relativi all'account e ai prodotti in quell'account, mentre l'API Content
(tramite il servizio Accountstatuses) fornisce informazioni sulla gravità
soltanto per i problemi di accountLevel.
Ogni fonte suddivide i problemi in tre categorie in base alla gravità. Comprendere come valutare la gravità dei problemi riportati dai servizi relativi allo stato può aiutarti a individuare rapidamente quali problemi sono i più importanti da risolvere e quali possono essere ignorati in tutta sicurezza.
Priorità dei problemi
Nella sezione Diagnostica, la priorità del problema 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 compaiono 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. 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 quali sono gli errori.
Nell'API Content, il campo accountLevelIssues[].severity negli oggetti della 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) | Assegnazione della priorità ai problemi |
|---|---|
critical |
Errore () |
error |
Avviso () |
suggestion |
Notifica () |
Pertanto, 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.
D'altra parte, editorial_and_professional_standards_destination_url_down_policy è un errore più grave che comporta la sospensione del tuo account. Se partecipi a Acquista su Google, a Surfaces across Google o 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.
Grazie a queste informazioni, ora puoi scrivere un software di avviso che attirerà immediatamente la tua attenzione sui problemi importanti, raccogliendo al contempo i problemi meno gravi per la loro eventuale correzione, senza dover visitare Merchant Center per distinguere i problemi.