Guida all'implementazione delle transazioni avanzate

Panoramica

Gli estratti conto delle transazioni sono spesso difficili da comprendere per gli utenti, in quanto utilizzano abbreviazioni come "ACMEHCORP" anziché i nomi dei commercianti come "Acme Houseware", il che può comportare un aumento delle chiamate all'assistenza clienti e contestazioni costose. Enriched Transactions semplifica queste transazioni e le rende intuitive fornendo il nome completo e la categoria dell'attività del commerciante, una foto della vetrina, l'indirizzo e la posizione su una mappa, i dati di contatto completi e altro ancora. In questo modo, aumentano la soddisfazione e la trasparenza degli utenti, oltre a ridurre le chiamate all'assistenza clienti, aumentare l'NPS e incrementare il tempo trascorso nell'app.

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

Abilita API

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

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

Sezioni della guida all'implementazione

Di seguito sono riportate le implementazioni e le personalizzazioni trattate in questo articolo:

• check_circle_filled L'icona del segno di spunta è un passaggio fondamentale dell'implementazione.
• 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 Place Details da un database di commercianti esistente o tramite una richiesta Place Search:

Ottieni gli ID luogo di Google Maps Platform

Potresti avere un database di commercianti con informazioni di base come il nome e l'indirizzo dell'attività. 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 ciascun commerciante 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 varia, quindi devi verificare se i risultati restituiti corrispondono effettivamente al commerciante.

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

```html
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.

ID luogo del negozio

Per memorizzare le informazioni di Google Maps Platform sul commerciante per richieste future, puoi memorizzare questo ID luogo a tempo indeterminato nel tuo database come attributo del record del commerciante. Dovresti eseguire la richiesta Find Place una sola volta per commerciante. Puoi anche cercare l'ID luogo ogni volta che un utente richiede i dettagli della transazione.

Per assicurarti di avere sempre le informazioni più accurate, aggiorna gli ID luogo ogni 12 mesi utilizzando una richiesta Place Details con il parametro place_id.

Se i dettagli del luogo visualizzati non corrispondono al commerciante presso cui è stata effettuata la transazione, ti consigliamo di consentire agli utenti di fornire un feedback sulla qualità della corrispondenza del commerciante.

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

Per richiedere i dettagli dei luoghi, devi avere l'ID luogo di ciascuna delle tue sedi. Consulta Recupero degli ID luogo per recuperare l'ID luogo della tua sede.

La seguente richiesta Place Details restituisce l'indirizzo, le coordinate, il sito web, il numero di telefono, la valutazione e gli orari in un output json per l'ID luogo di Google Taipei 101:

```html
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
```

Determinare la sede del commerciante

L'API Maps Static accetta un indirizzo o delle coordinate per posizionare un indicatore. Se il tuo record del commerciante ha già un indirizzo, puoi passare alla sezione successiva, ma ti consigliamo di utilizzare le coordinate anziché gli indirizzi per una maggiore 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, memorizzare le coordinate nel tuo 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 Taipei:

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

Aggiungi un indicatore per la sede del commerciante a una mappa

Poiché gli utenti vedranno la mappa per confermare le transazioni anziché per sfogliare o navigare, devi creare una mappa con interattività limitata.

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

La seguente chiamata mostra una mappa stradale, con dimensioni di 640 x 480 px, centrata su un indicatore presso l'ufficio di Google Taipei al livello di zoom predefinito. Specifica inoltre un indicatore rosso della posizione di consegna e uno stile di mappa basato su cloud:

```html
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
```

Questa chiamata è suddivisa nelle seguenti sezioni:

Questo risultato diventa l'immagine mostrata di seguito:

Puoi anche utilizzare un indirizzo come posizione dell'indicatore:

```html
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 altre opzioni dei parametri, consulta la documentazione dell'API Maps Static.

Aggiungi una mappa alla tua app mobile

Se utilizzi Maps SDK for Android o Maps SDK for iOS, puoi posizionare un indicatore utilizzando le coordinate delle informazioni in Place Details.

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

• Per le app per Android, consulta il tutorial sull'aggiunta di una mappa con un indicatore e attiva la modalità Lite per fornire 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.