Guida all'implementazione delle transazioni avanzate

Panoramica

Gli estratti conto delle transazioni sono spesso difficili da comprendere per gli utenti, in quanto utilizzano abbreviature come "ACMEHCORP" anziché nomi di commercianti come "Acme Houseware", il che può comportare un aumento delle chiamate all'assistenza clienti e controversie costose. Le transazioni arricchite semplificano queste transazioni e le rendono intuitive fornendo il nome completo e la categoria dell'attività di un commerciante, una foto della vetrina, l'indirizzo e la posizione su una mappa, i dati di contatto completi e altro ancora. In questo modo, contribuisci ad aumentare la soddisfazione e la trasparenza degli utenti, nonché a ridurre le chiamate all'assistenza clienti, aumentare il NPS e incrementare il tempo trascorso in-app.

Le transazioni arricchite, la guida all'implementazione e i suggerimenti di personalizzazione che forniamo in questo argomento, sono la combinazione ottimale di API di Google Maps Platform per creare esperienze utente straordinarie con la cronologia delle transazioni. Questa guida all'implementazione ti mostrerà come associare una località a un commerciante specifico e mostrare le relative informazioni dettagliate.

Abilitazione delle API in corso…

Per implementare le transazioni arricchite, devi attivare le seguenti API nella Console Google Cloud. I seguenti link ipertestuali ti indirizzano alla console Google Cloud per attivare ogni API per il progetto selezionato:

• API Places.
• API Geocoding.
• API Maps Static, SDK Maps per Android o SDK Maps per iOS.

Sezioni della guida all'implementazione

Di seguito sono riportate le implementazioni e le personalizzazioni che tratteremo in questo argomento.

• check_circle_filled L'icona del segno di spunta è un passaggio di implementazione fondamentale.
• stars L'icona a forma di stella è una personalizzazione facoltativa, ma consigliata, per migliorare la soluzione.

Il seguente diagramma mostra in che modo la tua applicazione associa le transazioni dei commercianti per restituire un risultato utilizzando i dettagli dei luoghi da un database esistente di commercianti o tramite una richiesta di ricerca dei luoghi:

Ottenere gli ID luogo di Google Maps Platform

Potresti avere un database di commercianti con informazioni di base come il nome dell'attività e il suo indirizzo. Per ottenere le informazioni di Google Maps Platform su quel luogo, inclusi i dati di contatto e le informazioni fornite dagli utenti, devi avere l'ID luogo di Google Maps Platform corrispondente a ciascuno dei commercianti nel tuo database.

Per ottenere l'ID luogo di un'attività, invia una richiesta all'endpoint /findplacefromtext nell' API Places e richiedi solo il campo place_id per fatturare la richiesta come chiamata Find Place - ID only senza costi. Se il commerciante ha più sedi, utilizza il nome del commerciante insieme al nome della città o della via. La qualità dei dati restituiti dalla chiamata varierà, quindi devi verificare se i risultati restituiti corrispondono effettivamente al commerciante desiderato.

Ecco un esempio di richiesta dell'ID posizione per l'ufficio di Google a Taipei utilizzando il nome e la città del commerciante:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Assicurati di codificare l'URL del parametro di input nella richiesta API.

Archiviazione degli ID luogo

Per memorizzare le informazioni del commerciante provenienti dalla piattaforma Google Maps per richieste future, puoi memorizzare questo ID luogo indefinitamente nel tuo database come attributo del record del commerciante. Dovresti eseguire la richiesta Find Place solo una volta per commerciante. Puoi anche cercare l'ID luogo ogni volta che un utente richiede i dettagli della transazione.

Per assicurarti di disporre sempre delle informazioni più accurate, aggiorna gli ID luogo ogni 12 mesi utilizzando una richiesta Dettagli luogo con il parametro place_id.

Se i dettagli del luogo che mostri non corrispondono al commerciante presso il quale è stata eseguita la transazione, ti consigliamo di consentire agli utenti di fornire un feedback sulla qualità della corrispondenza del commerciante.

Puoi condividere i dettagli dei luoghi che gli utenti devono conoscere dopo aver visitato una delle tue sedi. Con dettagli completi dei luoghi, come dati di contatto, orari di apertura, valutazioni e foto degli utenti, la tua app può ricordare agli utenti la loro transazione completata. Dopo aver effettuato una chiamata all'API Places per ottenere i dettagli dei luoghi, puoi filtrare e visualizzare la risposta in una finestra informativa, in una barra laterale web o in qualsiasi altro modo, nei limiti dei nostri Termini di servizio.

Per richiedere i dettagli dei luoghi, devi disporre dell'ID luogo di ciascuna delle tue sedi. Consulta la sezione Ottenere gli ID luogo per recuperare l'ID luogo della tua sede.

La seguente richiesta di dettagli dei luoghi restituisce l'indirizzo, le coordinate, il sito web, il numero di telefono, la valutazione e l'orario in un output json per l'ID luogo Taipei 101 di Google:

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Determinazione della posizione del commerciante

L'API Maps Static accetta un indirizzo o coordinate per inserire un indicatore. Se il record del commerciante ha già un indirizzo, puoi andare alla sezione successiva, ma ti consigliamo di utilizzare le coordinate anziché gli indirizzi per la precisione della mappa.

Se il tuo database dei commercianti contiene indirizzi, ma non coordinate geografiche e non stai già richiedendo i dettagli dei luoghi, puoi utilizzare l'API Geocoding per convertire gli indirizzi in coordinate di latitudine/longitudine sul lato server, archiviare le coordinate nel database e aggiornarle almeno una volta ogni 30 giorni.

Ecco un esempio di utilizzo dell'API Geocoding per ottenere la latitudine e la longitudine dell'ID luogo dell'ufficio di Google a Taipei:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Aggiunta di un indicatore per la sede del commerciante a una mappa

Poiché gli utenti vedranno la mappa per confermare le transazioni anziché navigare o esplorare, ti consigliamo di creare una mappa con interattività limitata.

Per il web desktop e mobile, crea un URL dell'API Maps Static con un singolo indicatore nella latitudine/longitudine o nell'indirizzo del commerciante. Puoi utilizzare l'API Maps Static tramite una chiamata di servizio web, che creerà una versione immagine di una mappa in base ai parametri specificati. Per i dispositivi mobili, vai alla sezione successiva sull'aggiunta di una mappa nell'applicazione mobile.

La chiamata seguente mostra una roadmap, con dimensioni di 640 x 480 pixel, centrata su un indicatore nell'ufficio di Google a Taipei con il livello di zoom predefinito. Specifica inoltre un indicatore della posizione di consegna rosso e uno stile di mappa basato su Cloud:

    https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

che si suddividono nelle seguenti sezioni:

L'immagine diventa come mostrato di seguito:

Puoi anche utilizzare un indirizzo come posizione dell'indicatore:

https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

Per ulteriori opzioni di parametro, consulta la documentazione dell'API Maps Static.

Aggiunta di una mappa nell'applicazione mobile

Se utilizzi Maps SDK for Android o Maps SDK for iOS, puoi inserire un indicatore utilizzando le coordinate delle informazioni in Dettagli dei luoghi.

Poiché gli utenti vedranno la mappa per confermare le transazioni anziché navigare o esplorare, scegli una mappa con interattività limitata:

• Per le applicazioni Android, consulta il tutorial sull'aggiunta di una mappa con un indicatore e attiva la modalità Lite per offrire un'interattività limitata.
• Per le applicazioni per iOS, consulta il tutorial sull'aggiunta di una mappa con un indicatore e disattiva i controlli e i gesti con il flag GMSUiSettings.