Di seguito sono riportati alcuni problemi comuni relativi ai dati che possono verificarsi durante l'elaborazione dei feed delle recensioni di Merchant. Forniamo descrizioni di ogni problema relativo ai dati e i passaggi da seguire per risolverlo. Quando viene rilevato un problema relativo ai dati nel tuo feed, l'assistenza dell'aggregatore di valutazioni del negozio ti invia una notifica del problema.
La maggior parte dei problemi relativi ai dati può essere risolta inviando nuovi file di feed all'endpoint. Ti consigliamo di creare un file separato contenente tutte le correzioni per i problemi in sospeso, anziché consolidarle con il feed giornaliero di nuovi commercianti e recensioni. Inoltre, prendi nota dei nomi dei file che contengono correzioni. I nomi dei file sono necessari nel caso in cui una correzione non risolva un problema relativo ai dati e tu debba contattare il team di assistenza per ricevere aiuto.
Di seguito sono riportati i passaggi tipici per risolvere un problema relativo ai dati.
- Fornisci un file di feed giornaliero al tuo endpoint: 2017-11-10.xml. Questo file contiene una classificazione non valida.
- Fornisci un secondo file del feed giornaliero all'endpoint, che non presenta problemi di dati: 2017-11-11.xml.
- Dopo che il team di assistenza ti ha comunicato un problema, fornisci un nuovo file feed, 2017-11-11_fix.xml,
che contiene una valutazione valida per la recensione non valida precedentemente inviata. Questo record valido ha
un
last_update_timestamp
aggiornato per indicare che questa recensione ha una valutazione valida per risolvere il problema dei dati.
Mentre leggi questa guida, tieni presente quanto segue:
- I file dei feed vengono scaricati in recuperi periodici. Se viene rilevato un problema con i dati in un recupero, i nuovi dati di quel recupero o dei recuperi successivi non verranno pubblicati finché tutti i problemi con i dati non saranno stati risolti.
- Finché nel feed sono presenti problemi di dati in sospeso, i feed continueranno a essere recuperati ed elaborati per nuovi problemi di dati.
- Una volta risolti tutti i problemi relativi ai dati, verranno pubblicati tutti i dati scaricati dall'endpoint.
- Esiste una causa principale per ogni problema relativo ai dati, che si tratti di dati non validi nel database o di un bug nel modo in cui sono stati generati. Prima di fornire un feed di correzione per i problemi di dati in sospeso, assicurati che la causa principale del problema sia stata risolta. La risoluzione della causa principale impedisce il verificarsi di nuovi problemi dello stesso tipo. Dopo aver risolto la causa principale, puoi lavorare alla pubblicazione dei file di feed corretti.
- I file di correzione (ovvero i file che terminano con "_fix.xml") non devono includere record che non hanno lo scopo di risolvere problemi di dati in sospeso.
- Se le correzioni non risolvono automaticamente i problemi relativi ai dati, contatta il team di assistenza rispondendo alla comunicazione che ti ha informato del problema.
- Poiché queste correzioni dei problemi relativi ai dati spesso comportano la pubblicazione di entità commerciante e recensione nei tuoi feed, è utile esaminare la documentazione dello schema XML prima di leggere ogni problema relativo ai dati.
- Per semplicità, la documentazione riportata di seguito presuppone che tu stia risolvendo un singolo problema relativo ai dati di un particolare tipo. In pratica, possono verificarsi più problemi relativi ai dati contemporaneamente. Quando fornisci correzioni, puoi consolidare le correzioni per più problemi in un unico file di feed. Allo stesso modo, quando contatti il team di assistenza, consolida le comunicazioni relative a diversi problemi di dati.