Per impostare le località, devi seguire questi passaggi:
Scopri le località
Le sedi pubblicate e verificate sono una funzionalità canonica nei risultati della Ricerca Google e di Maps. Queste sedi hanno un proprietario esistente e verificato. Per cambiare la proprietà da un Account Google a un altro, è necessaria una richiesta di proprietà. Le località non rivendicate create da Local Guides o dalla community di utenti sono considerate non verificate. Le piattaforme creano e verificano nuove sedi.
Ricerca località
Per configurare le tue sedi con le API Profilo dell'attività, devi creare una piattaforma che consenta ai commercianti di gestire la loro attività su Google. Sulla tua piattaforma puoi consentire agli utenti di cercare schede corrispondenti a nome, indirizzo e dati telefonici dell'attività.
L'API GoogleLocations ti consente di verificare in anticipo se una sede è stata rivendicata in precedenza da un altro commerciante in Profilo dell'attività. Se la sede non è stata rivendicata, puoi richiederne immediatamente la proprietà. In caso contrario, devi creare e verificare una nuova località.
Per ulteriori informazioni, consulta la guida Cercare schede corrispondenti.
Risultati di ricerca della località
Quando cerchi schede di una sede, devi completare i seguenti passaggi per rivendicare una nuova sede:
- Raccogli dal commerciante dati sulla sede quali nome dell'attività, indirizzo e categoria.
- Chiama l'endpoint
googleLocations.search
e fornisci i dati sulla posizione all'interno del corpo della richiesta della chiamata. In alternativa, puoi cercare una stringa di query, simile a quella che un utente inserisce nella Ricerca o su Maps. Ad esempio, "Starbucks 5th ave NYC" è una stringa di query. L'API restituisce un elenco di potenziali corrispondenze di località e informazioni su ogni località, ad esempio
locationName
e l'indirizzo di ciascuna.Quando ricevi l'elenco restituito dall'API, hai due opzioni:
- Se non vengono trovate corrispondenze, crea una nuova località e verificala.
Se esistono una o più corrispondenze, chiedi al proprietario dell'attività di selezionare quella più simile.
Se
requestAdminRightsUrl
esiste, il proprietario proposto deve accedere al proprio Account Google e fare clic sul link per avviare la procedura di richiesta della proprietà.Se
requestAdminRightsUrl
non è presente, crea una nuova località e verificala.
Richieste di proprietà
La fiducia del commerciante, la comunicazione esplicita e gli Account Google sono fondamentali per la procedura di rivendicazione della proprietà. Le rivendicazioni di proprietà potrebbero essere parzialmente automatizzate, con alcuni passaggi che richiedono al proprietario dell'attività proposto di uscire dalla piattaforma, accedere al proprio Account Google e fare clic su pulsanti o link in Profilo dell'attività.
Per trasferire un'attività correttamente sono necessari fino a sette giorni. Una volta completato il trasferimento, il commerciante deve accedere e completare manualmente la procedura di rivendicazione della proprietà.
I proprietari di attività esistenti potrebbero rifiutare la richiesta e i proprietari proposti potrebbero non intervenire in merito all'email di notifica inviata da Google. Se la rivendicazione della proprietà viene rifiutata, il proprietario dell'attività proposto può avviare manualmente un ricorso.
Per ridurre al minimo l'abbandono, ti consigliamo di implementare una procedura per monitorare le richieste di proprietà. Ti consigliamo di eseguire un follow-up automatico o manuale con il proprietario proposto 7-10 giorni dopo l'avvio della rivendicazione.
Panoramica della procedura di proprietà della sede
Il seguente diagramma mostra la procedura di proprietà della sede:
![Diagramma Swimlane del processo di proprietà della posizione.](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/locations1.png?authuser=8&hl=it)
Duplicati
Se aggiungi una sede già verificata in Profilo dell'attività, questa non viene visualizzata su Google Maps ed è contrassegnata come "sede duplicata" nel tuo account. È consentita una sola sede verificata. Le sedi duplicate non sono verificate e la loro pubblicazione viene annullata. Non è necessario rimuovere manualmente i duplicati.
In genere, le recensioni vengono migrate alla sede appena verificata. Per ulteriori informazioni, consulta la sezione Spostare le recensioni tra le schede.
Crea sedi
In Google Maps, i luoghi sono rappresentati da ID luogo, mentre gli account e le località Profilo dell'attività sono rappresentati da ID account e ID località.
Località e luoghi
Quando crei una nuova posizione, questa viene associata a un luogo in Google Maps. Questo vale anche per le attività al domicilio del cliente, anche se l'indirizzo non è visibile pubblicamente.
Quando crei le sedi, ti consigliamo di attenerti alle seguenti best practice:
- Se sei il proprietario di un'attività che guida il processo, i widget Places e le API di geocodifica di Google Maps JavaScript offrono l'esperienza migliore e più familiare per consentirti di inserire un segnaposto su una mappa per individuare con precisione l'attività.
- I nuovi sviluppi e le regioni in forte crescita potrebbero richiedere le coordinate di latitudine e longitudine. In genere, Google Maps stabilisce gli ID luogo, gli indirizzi e i dati di latitudine-longitudine.
Le località e i luoghi hanno un rapporto many-to-many. Possono esserci più località associate a un singolo ID luogo. Ad esempio, i reparti all'interno di un centro commerciale o di un ospedale sono situati in più sedi. Al contrario, possono esistere più ID luogo associati a una singola località. Per maggiori informazioni, consulta le Linee guida per la rappresentazione delle aziende su Google. Le linee guida si applicano a tutti gli utenti.
ID luoghi su Maps
Gli ID luogo su Maps non sono univoci e potrebbero cambiare nel tempo. Per informazioni su come memorizzare nella cache, archiviare e gestire in modo sicuro gli ID luogo di Maps, più ID luogo e come applicarli, consulta la guida ID luogo.
Per scoprire come creare e aggiornare le planimetrie, consulta la guida Utilizzare le mappe di interni per visualizzare le planimetrie.
Credenziali OAuth
Se possibile, utilizza le credenziali OAuth del proprietario dell'attività per creare la sede. In questo modo, l'Account Google del proprietario viene impostato come proprietario principale per gestire gli inviti e cambiare la proprietà, ma senza utilizzare il nome del proprietario.
Oggetti API e stato elenco
L'oggetto API
Location
incapsula tutte le informazioni associate a una località. L'oggetto
Metadata
fornisce dettagli sulla posizione, ad esempio l'URL di Maps.
Per una descrizione dettagliata dello stato di ogni scheda, consulta Comprendere lo stato delle schede.
Categorie e attributi
Quando crei o aggiorni sedi, ti consigliamo di eseguire query e scegliere da un elenco aggiornato di categorie e attributi. L'elenco delle categorie e degli attributi disponibili è soggetto a modifiche in qualsiasi momento.
Utilizza i metodi dell'API
categories.list
e
attributes.list
per ottenere da Google un aggiornamento accurato dell'elenco di date. Le opzioni disponibili sono localizzate e variano in base alle lingue e alle regioni. L'API utilizza i
codici lingua BCP 47 e
codici paese alpha-2 ISO 3166-1 per descrivere lingue e
regioni.
Indirizzi postali
Gli indirizzi devono rispettare i requisiti dell'indirizzo postale regionali e linguistici di Profilo dell'attività. Questi requisiti sono spesso più elevati rispetto a quelli delle attività non verificate provenienti dalla community presenti in Google Maps. Le Local Guide e gli utenti di Maps e della Ricerca possono inserire indirizzi e dettagli delle attività per le località non rivendicate. Queste informazioni sono spesso colloquiali e in formati non standard.
Questo progetto open source potrebbe aiutare la tua piattaforma a soddisfare questi requisiti.
Commercianti, team operativi e terze parti possono contribuire a garantire l'accuratezza.
Quando chiami
accounts.locations.create
con il parametro validateOnly=true
impostato, ti consigliamo di verificare che i
campi obbligatori siano presenti e che gli indirizzi postali siano formattati correttamente.
Geocoding
La geocodifica converte gli indirizzi in coordinate geografiche che puoi utilizzare per posizionare indicatori su una mappa o per posizionare la mappa.
Le coordinate di latitudine e longitudine vengono utilizzate per stabilire le posizioni fisiche in Maps con la geocodifica, nelle API Places e vengono utilizzate anche con dati di terze parti.
I commercianti, i team operativi e le terze parti possono contribuire a garantire che gli indirizzi siano collegati accuratamente a un luogo, il che rappresenta una coppia di coordinate latitudine-longitudine.
Aggiornamenti posizione
Le modifiche alle sedi provengono principalmente dai proprietari e dai gestori delle sedi, ma possono anche provenire dall'ampia community di internet, da Local Guides e da Google. In che modo Google raccoglie e mostra le informazioni sull'attività descrive come vengono gestiti gli aggiornamenti e come vengono visualizzati in Maps e nei risultati di ricerca.
Le modifiche sono generalmente accettate, ma non sono garantite. Le pagine di assistenza Cosa succede alle modifiche e Gestire gli aggiornamenti Google descrivono in modo più dettagliato la procedura di revisione e pubblicazione.
Il metodo
locations.getGoogleUpdated
restituisce i dettagli delle modifiche alla posizione di Google. Per saperne di più su come accettare o rifiutare questi aggiornamenti, consulta la guida Gestire gli aggiornamenti Google.
Verifica sedi
La procedura di verifica della posizione pubblica una posizione su Google Maps e nella Ricerca. Le attività non verificate non sono visibili pubblicamente. La procedura conferma positivamente l'identità del proprietario della sede e collega in modo efficace un Account Google a quella sede. Al proprietario potrebbe essere richiesto di inserire un codice PIN per verificare la posizione.
Verifica basata sulla piattaforma
Le piattaforme partner possono verificare le sedi senza che gli utenti debbano uscire dalla piattaforma. La piattaforma esegue query sui metodi di verifica disponibili, ad esempio email, SMS, chiamate vocali e cartolina postale oppure automaticamente e, se necessario, chiede al proprietario dell'attività di scegliere il metodo preferito. I servizi Google consegnano il codice di verifica tramite PIN al proprietario dell'attività. Se la verifica automatica è disponibile, il proprietario dell'attività non deve eseguire alcuna procedura per verificarla correttamente.
Il seguente diagramma mostra la procedura di verifica basata sulla piattaforma:
![Diagramma Swimlane della procedura di panoramica della verifica basata sulla piattaforma.](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/locations2.png?authuser=8&hl=it)
Best practice
In alcuni casi, la verifica può richiedere diversi giorni. Devi eseguire un sondaggio per ottenere lo stato della verifica. Se viene restituito un elenco vuoto di metodi di verifica, utilizza nuovi tentativi.
Le modifiche a nomi, indirizzi e categorie dell'attività possono attivare una nuova verifica. Esegui questi tipi di modifiche prima di iniziare la procedura di verifica.
Segui queste best practice per massimizzare i tassi di conversione dei commercianti:
- Misura la frequenza con cui viene presentato ogni metodo di verifica.
- Misura i tassi di abbandono nelle finestre di dialogo e nei passaggi.
- Se la sede non risulta verificata, ricontatta il commerciante.
Catene e brand
Le catene e i brand operano con requisiti diversi per raggiungere gli obiettivi di franchising, franchising e partner. Le catene sono gestite da un team di partnership e assistenza dedicato.
Per ulteriori informazioni sulla registrazione, sulla creazione e sulla verifica delle sedi delle catene, consulta la guida Richiedere la verifica collettiva per più di 10 sedi.
Una volta verificate, le sedi delle catene pubblicate possono essere gestite con le API Profilo dell'attività nello stesso modo in cui vengono gestite altre sedi, con alcune eccezioni. Ad esempio, gli amministratori di sito vengono trattati in modo diverso e possono aggiungersi alle sedi in franchising. Per ulteriori informazioni, consulta la pagina Proprietari e gestori delle schede.
Link
Per rendere la tua sede rintracciabile, puoi collegarla a Google Ads, post e recensioni.
Collega una sede a Google Ads
Per informazioni su come sincronizzare il tuo account Profilo dell'attività con Google Ads, consulta la guida sull'integrazione di Google Ads e il post sull'utilizzo delle API Profilo dell'attività per gestire le estensioni di località sul blog per gli sviluppatori di Google Ads.
Per informazioni generali e per saperne di più sull'API di AdWords, visita il sito per gli sviluppatori dell'API di AdWords o il forum dell'API di AdWords.
La località dell'API Profilo dell'attività storeCode
deve corrispondere al valore del feed di inventario locale dei prodotti di Google Ads.
Genera link a luoghi, post e recensioni
Utilizza il formato seguente per creare un link diretto:
https://business.google.com/{edit|posts|reviews}/l/u{location_id}
L'API Business Profile restituisce gli ID località e account non offuscati. L'interfaccia web di Profilo dell'attività utilizza una combinazione di ID offuscati e non offuscati.
Si applicano limitazioni relative all'accesso e all'accesso degli utenti. Ad esempio, l'utente dell'Account Google deve disporre dei diritti di proprietario o gestore per modificare una sede.
Metriche delle prestazioni
L'API fornisce diverse metriche relative alle prestazioni per le località.
Per ogni località sono disponibili le seguenti metrics da analizzare:
- Il numero di volte in cui la risorsa è stata visualizzata nella Ricerca Google su computer.
- Il numero di volte in cui la risorsa è stata visualizzata nella Ricerca Google sui dispositivi mobili.
- Il numero di volte in cui la risorsa è stata visualizzata su Google Maps su computer.
- Il numero di volte in cui la risorsa è stata visualizzata su Google Maps su un dispositivo mobile.
- Il numero di clic sul sito web.
- Quante volte è stato fatto clic sul numero di telefono.
- Quante volte sono state richieste le indicazioni stradali.
- Quante volte è stato fatto clic sul pulsante di invito all'azione.
Per scoprire di più sugli insight sulla posizione, consulta Recuperare gli insight sulla posizione.