Visualizzatore importazione

Il visualizzatore dell'importazione (accessibile in Importazione > Cronologia nel Centro azioni) fornisce visibilità quasi in tempo reale su stato, integrità della convalida e cronologia di elaborazione dei feed dei punti d'interesse locali.

Utilizza lo strumento di visualizzazione dell'importazione per monitorare i caricamenti giornalieri dei feed, monitorare l'integrità dell'importazione, controllare le statistiche sugli errori di convalida a livello di articolo e verificare l'arrivo dei file dei feed.

Panoramica

La pagina principale di Visualizzatore ingestioni mostra un log cronologico inverso di ogni feed ricevuto da Google.

Fasi del ciclo di vita dell'importazione

Ogni invio del feed passa attraverso le seguenti fasi di elaborazione sequenziale:

  1. Acquisizione file:Google riceve il file del feed tramite SFTP.
  2. Convalida file: il sistema verifica l'integrità, la decompressione e il formato generale dello schema del file.
  3. Estrazione e convalida delle entità:la pipeline analizza i singoli record locali (poi_id, indirizzo, coordinate, localizzazioni) e verifica la sintassi, la completezza e la conformità alle norme.
  4. Riconciliazione e corrispondenza:le entità valide vengono trasmesse al motore di corrispondenza di Google per essere collegate agli ID luogo Google canonici per la pubblicazione.
  5. Generazione report:le metriche di riepilogo e la diagnostica dei problemi raggruppati vengono pubblicate nel visualizzatore dell'importazione.

Per visualizzare la cronologia dell'importazione dei feed:

  1. Accedi all'Actions Center.
  2. Apri la pagina Importazione > Cronologia.
  3. Filtra, ordina e visualizza la tabella di importazione utilizzando i controlli delle colonne.

Colonne dell'elenco di importazione

La tabella di riepilogo principale fornisce le seguenti colonne per ogni esecuzione dell'importazione:

Colonna Tipo di dati Descrizione
ID String Identificatore univoco dell'esecuzione dell'importazione.
Ora di inserimento (UTC) Timestamp Data e ora (in UTC) in cui Google ha iniziato l'elaborazione dell'importazione del feed.
Tipo di importazione Enum Tipo di acquisizione dei dati (ad es. Feed).
Nome String Nome del tipo di importazione del feed. Il valore sarà google.local_vss.
Stato State Stato di elaborazione complessivo dell'importazione (ad es. Fine, Non riuscita). Consulta le definizioni dello stato.
Comportamento di importazione Enum Tutti i feed dei POI locali vengono elaborati in modalità Batch.
Errori Integer Conteggio totale dei problemi di convalida a livello di errore di blocco rilevati.
Avvisi Integer Numero totale di problemi a livello di avviso non bloccanti rilevati.
Elementi Integer Numero totale di proprietà locali elaborate in questa importazione.

Definizioni degli stati

La colonna Stato indica lo stato operativo attuale di un invio di feed:

  • Fine (STATUS_COMPLETE): il feed è stato inserito, convalidato ed elaborato correttamente senza errori irreversibili.
  • Non riuscito (STATUS_FAILED): l'importazione ha rilevato errori irreversibili di schema, danneggiamento dei file o della pipeline e non è stato possibile completarla.
  • In elaborazione (STATUS_PROCESSING): Google sta convalidando, corrispondendo e memorizzando attivamente i dati del feed.
  • Ignorato (NOT_STARTED): il caricamento del feed è stato ignorato (ad esempio, se il timestamp di generazione è precedente a un feed elaborato in precedenza).

Visualizzazione dei dettagli dell'importazione

Fai clic su una riga qualsiasi della tabella Visualizzatore importazione per aprire la visualizzazione Dettagli importazione. Questa visualizzazione fornisce schede diagnostiche complete e pannelli espandibili per il debug dei problemi.

Pannelli dei dettagli

La pagina dei dettagli di importazione è suddivisa in quattro sezioni espandibili:

1. Informazioni di base

Mostra i metadati principali relativi all'esecuzione:

  • Ora di importazione (UTC): timestamp in cui Google ha iniziato l'importazione.
  • Tipo di importazione: Feed.
  • Nome: google.local_vss
  • Comportamento di importazione: Batch
  • Stato:badge di stato con codice colore (Done, Failed, Processing, Skipped).

2. Convalide

Elenca tutti i risultati di convalida riscontrati durante l'importazione:

  • Errori del file (riquadro): se l'intero file del feed non è stato caricato (ad esempio, a causa di un archivio illeggibile o di una sintassi JSON non valida), viene visualizzato un riquadro di avviso prominente che mostra il messaggio relativo alla causa principale.
  • Problemi relativi all'entità (tabella a fisarmonica): problemi di convalida a livello di articolo raggruppati per gravità e codice di errore.
    • Codice problema: identificatore di errore specifico (ad esempio INVALID_ATTRIBUTE_VALUE, MISSING_RECOMMENDED_FIELD o SAFE_SEARCH_POLICY_VIOLATION_TEXT).
    • Informazioni sul problema:descrizione diagnostica che spiega la causa principale e i campi interessati.
    • Record:il conteggio totale delle entità proprietà interessate da questo problema.
    • Fai clic su una riga di problemi per espandere gli ID entità di esempio (poi_id) con link diretti per esaminare le proprietà in Visualizzatore inventario.

3. Elementi

Fornisce prospetti del delta dell'inventario a livello di articolo per l'esecuzione dell'importazione:

  • Totale:il numero totale di proprietà locali elaborate.
  • Aggiunti:conteggio delle schede di attività commerciali appena scoperte aggiunte al tuo catalogo.
  • Modificate:conteggio delle proprietà esistenti i cui attributi (ad es. nome, indirizzo, coordinate o immagini) sono stati aggiornati.
  • Rimosse:conteggio delle proprietà eliminate o omesse rispetto alla baseline del feed precedente.

4. File

Mostra il nome del file del feed caricato:

  • Nome file:nome del file feed (ad esempio, local_feed.json.gz).

Risoluzione dei problemi relativi agli errori di importazione

Quando risolvi i problemi relativi ai feed nel visualizzatore importazione, utilizza le seguenti linee guida:

Sintomo Probable Cause Azione consigliata
Status is Failed with File Error Archivio ZIP/GZIP corrotto, sintassi JSON non valida o codifica file non supportata. Verifica che il feed sia confezionato correttamente utilizzando le linee guida per il confezionamento dei feed.
Conteggio Errors elevato in Convalide I campi dello schema obbligatori (ad esempio poi_id, location.address strutturato o coordinate WGS84) non sono presenti nei record. Esamina la sezione Convalide espansa per identificare i poi_id problematici, correggere le pipeline del feed dei PDI e importare nuovamente il feed.
Zero Items processed Il file del feed è vuoto o l'analisi dell'array JSON a livello principale non è riuscita. Verifica che la struttura del wrapper del feed sia conforme alle VssPoi specifiche del messaggio. Consulta le linee guida per il packaging dei feed.