Przewodnik po implementacji rozszerzonych transakcji

Omówienie

Oświadczenia o transakcji są często trudne do zrozumienia dla użytkowników, ponieważ zawierają skróty takie jak „ACMEHCORP” zamiast nazw sprzedawców, np. „Acme Houseware”. Może to prowadzić do zwiększenia liczby połączeń z obsługą klienta i drogich sporów. Usługa wzbogaconych transakcji upraszcza te transakcje i czyni je bardziej intuicyjnymi, ponieważ udostępnia pełną nazwę sprzedawcy i jego kategorię, zdjęcie sklepu, adres i lokalizację na mapie, pełne dane kontaktowe i inne informacje. Pomoże to zwiększyć zadowolenie użytkowników i przejrzystość, a także może zmniejszyć liczbę połączeń z zespołem pomocy, zwiększyć NPS i wydłużyć czas spędzany w aplikacji.

Transakcje wzbogacone – w tym artykule znajdziesz przewodnik implementacji i wskazówki dotyczące dostosowywania, które stanowią optymalne połączenie interfejsów API Google Maps Platform, umożliwiające tworzenie atrakcyjnych interakcji z użytkownikiem na podstawie historii transakcji. Z tego przewodnika dowiesz się, jak dopasować lokalizację do konkretnego sprzedawcy i wyświetlić szczegółowe informacje o nim.

Włącz interfejsy API

Aby wdrożyć transakcje wzbogacone, musisz włączyć te interfejsy API w konsoli Google Cloud. Te hiperlinki przekierowują Cię do konsoli Google Cloud, gdzie możesz włączyć poszczególne interfejsy API w wybranym projekcie:

• Places API.
• Geocoding API.
• Maps Static API, Maps SDK na Androida lub Maps SDK na iOS.

Sekcje przewodnika po implementacji

Oto implementacje i dostosowywanie, które omawiamy w tym artykule:

• check_circle_filledIkona wyboru to kluczowy krok implementacji.
• starsIkona gwiazdy jest opcjonalną, ale zalecaną funkcją dostosowywania, która pozwala ulepszać rozwiązanie.

Ten diagram pokazuje, jak aplikacja dopasowuje transakcje sprzedawcy, aby zwrócić wynik za pomocą Szczegółów miejsca z dotychczasowej bazy danych sprzedawców lub za pomocą żądania wyszukiwania miejsca:

Pobieranie identyfikatorów miejsc w Google Maps Platform

Możesz mieć bazę danych sprzedawców z podstawowymi informacjami, takimi jak nazwa firmy i adres. Aby uzyskać informacje o danym miejscu dostępne w Google Maps Platform, w tym informacje kontaktowe i dodane przez użytkowników, musisz mieć identyfikator miejsca w Google Maps Platform odpowiadający każdemu sprzedawcy w Twojej bazie danych.

Aby uzyskać identyfikator miejsca dla firmy, wyślij żądanie do punktu końcowego /findplacefromtext w interfejsie Places API, podając tylko pole place_id, aby naliczyć żądanie jako bezpłatne wywołanie FindPlace – tylko identyfikator. Jeśli sprzedawca ma kilka lokalizacji, użyj nazwy sprzedawcy w połączeniu z nazwą miasta lub ulicy. Jakość danych zwracanych przez wywołanie jest różna, dlatego musisz sprawdzić, czy zwrócone wyniki rzeczywiście pasują do sprzedawcy.

Oto przykład żądania identyfikatora miejsca dla biura Google w Tajpej, w którym używamy nazwy sprzedawcy i miasta:

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

Pamiętaj, aby zakodować URL parametru wejściowego w żądaniu interfejsu API.

przechowywać identyfikatory miejsc,

Aby przechowywać informacje o sprzedawcu z Platformy Map Google na potrzeby przyszłych żądań, możesz zapisać ten identyfikator miejsca na stałe w swojej bazie danych jako atrybut rekordu sprzedawcy. Wystarczy, że prześlesz żądanie „Znajdź miejsce” tylko raz na sprzedawcę. Możesz też wyszukać identyfikator miejsca za każdym razem, gdy użytkownik zażąda szczegółów transakcji.

Aby mieć zawsze najdokładniejsze informacje, odświeżaj identyfikatory miejsc co 12 miesięcy, wysyłając żądanie szczegółów miejsca z parametrem place_id.

Jeśli wyświetlane przez Ciebie informacje o miejscu nie pasują do sprzedawcy, w którego użytkownik dokonał transakcji, zalecamy umożliwienie użytkownikom przesyłania opinii na temat jakości dopasowania sprzedawcy.

Możesz udostępnić informacje o miejscu, które użytkownicy powinni znać po odwiedzeniu Twojej lokalizacji. Dzięki szczegółowym informacjom o miejscu, takim jak dane kontaktowe, godziny otwarcia, oceny użytkowników i ich zdjęcia, Twoja aplikacja może przypominać użytkownikom o zakończonej transakcji. Po wywołaniu interfejsu Places API w celu uzyskania szczegółów miejsca możesz odfiltrować i wyrenderować odpowiedź w oknie informacyjnym, na pasku bocznym lub w dowolny inny sposób, o ile nie narusza to naszych Warunków korzystania z usługi.

Aby poprosić o szczegóły miejsca, musisz podać identyfikator każdego z Twoich miejsc. Aby pobrać identyfikator miejsca, zapoznaj się z artykułem Pobieranie identyfikatorów miejsc.

Na podstawie identyfikatora miejsca „Google Taipei 101” następująca prośba o szczegóły miejsca zwraca adres, współrzędne, stronę internetową, numer telefonu, ocenę i godziny otwarcia w formacie json:

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

Określanie lokalizacji sprzedawcy

Interfejs Maps Static API akceptuje adres lub współrzędne do umieszczenia znacznika. Jeśli w rekordzie sprzedawcy jest już podany adres, możesz przejść do następnej sekcji. Zalecamy jednak używanie współrzędnych zamiast adresów, aby zwiększyć dokładność mapy.

Jeśli baza danych sprzedawcy zawiera adresy ulicy, ale nie zawiera współrzędnych geograficznych, a nie wysyłasz żądania dotyczące szczegółów miejsca, możesz użyć interfejsu Geokodowanie API, aby przekształcić adresy ulicy w współrzędne geograficzne po stronie serwera, zapisać je w bazie danych i odświeżać co najmniej raz na 30 dni.

Oto przykład użycia interfejsu Geocoding API do uzyskania szerokości i długości geograficznej identyfikatora miejsca biura Google w Tajpei:

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

Dodawanie znacznika lokalizacji sprzedawcy do mapy

Użytkownicy będą korzystać z mapy, aby potwierdzać transakcje, a nie przeglądać mapy ani nią się poruszać, dlatego warto utworzyć mapę o ograniczonej interaktywności.

W przypadku komputerów i urządzeń mobilnych utwórz adres URL interfejsu Maps Static API z pojedynczym znacznikiem na współrzędnych geograficznych lub adresie sprzedawcy. Interfejs Maps Static API możesz używać, wywołując usługę internetową, która na podstawie podanych przez Ciebie parametrów utworzy wersję mapy w postaci obrazu. W przypadku urządzeń mobilnych przejdź do następnej sekcji Dodawanie mapy w aplikacji mobilnej.

Poniższe wywołanie pokazuje mapę drogową o wymiarach 640 x 480 pikseli wyśrodkowaną na znaczniku w biurze Google w Tajwanie przy domyślnym poziomie powiększenia. Określa ona też czerwony znacznik lokalizacji dostawy i styl mapy w Google 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
```

Rozmowa jest podzielona na te sekcje:

Wynik będzie wyglądał jak na obrazku poniżej:

Jako lokalizację znacznika możesz też użyć adresu:

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

Więcej opcji parametrów znajdziesz w dokumentacji interfejsu Maps Static API.

Dodawanie mapy w aplikacji mobilnej

Jeśli używasz pakietu Maps SDK na Androida lub Maps SDK na iOS, możesz umieścić znacznik za pomocą współrzędnych z informacji w szczegółach miejsca.

Użytkownicy będą korzystać z mapy do potwierdzania transakcji, a nie do przeglądania ani nawigacji, dlatego wybierz mapę z ograniczoną interaktywność:

• W przypadku aplikacji na Androida zapoznaj się z samouczkiem dotyczącym dodawania mapy z oznaczeniem i włącz tryb uproszczony, aby zapewnić ograniczoną interaktywność.
• W przypadku aplikacji na iOS zapoznaj się z samouczkiem dodawania mapy z oznacznikami oraz wyłącz kontrolki i gesty za pomocą flagi GMSUiSettings.