Zenginleştirilmiş İşlemler uygulama kılavuzu

Genel bakış

"Sağlam Ev Ürünleri" gibi satıcı adları yerine "ACMEHCORP" gibi kısaltmalar kullanılması, işlem özetlerini genellikle kullanıcıların anlamasını zorlaştırır. Bu durum, müşteri desteği aramalarının artmasına ve pahalı itirazlara neden olabilir. Zenginleştirilmiş İşlemler, bu işlemleri basitleştirir ve satıcının tam adı ile işletme kategorisini, vitrinin fotoğrafını, haritada adresi ile konumunu, tam iletişim bilgilerini ve daha fazlasını sağlayarak işlemleri kolaylaştırır. Bu, kullanıcı memnuniyeti ve şeffaflığının artmasına yardımcı olur. Ayrıca müşteri desteği çağrılarının azaltılmasına, NPS'nin artırılmasına ve uygulama içinde daha fazla zaman geçirilebilmesine yardımcı olur.

Bu konuda sağladığımız uygulama kılavuzu ve özelleştirme ipuçları olan Zenginleştirilmiş İşlemler, mükemmel işlem geçmişi kullanıcı deneyimleri oluşturmak için Google Haritalar Platformu API'lerinin ideal kombinasyonu olarak bunu öneriyoruz. Bu uygulama kılavuzu, bir konumu belirli bir satıcıyla nasıl eşleştireceğinizi ve ayrıntılı bilgilerini gösterir.

API'ler etkinleştiriliyor

Zenginleştirilmiş İşlemleri uygulamak için Google Cloud Console'da aşağıdaki API'leri etkinleştirmeniz gerekir. Aşağıdaki köprüler, seçtiğiniz projede her bir API'yi etkinleştirmek için sizi Google Cloud Console'a yönlendirir:

• Yerler API'si.
• Geocoding API.
• Haritalar Statik API, Android için Haritalar SDK'sı veya iOS için Haritalar SDK'sı.

Kurulum hakkında daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama bölümüne bakın.

Uygulama kılavuzu bölümleri

Aşağıda, bu konuda ele alacağımız uygulama ve özelleştirme işlemleri belirtilmiştir.

• check_circle_filled Onay işareti simgesi, temel uygulama adımlarından biridir.
• stars Yıldız simgesi isteğe bağlı olsa da çözümü iyileştirmek için önerilen bir özelleştirme seçeneğidir.

check_circle_filled	Satıcıları Google Haritalar Platformu ile eşleştirme	İşlem geçmişindeki bir satıcıyı Google Haritalar Platformu'ndaki bir yerle ilişkilendirme.
check_circle_filled	Satıcı ayrıntılarını gösterme	Kullanıcıların işlemi hızla tanıyabilmesi için satıcı hakkında faydalı bilgiler gösteren, veri açısından zengin işlemler gösterin.
check_circle_filled	Satıcının bulunduğu konumun haritasını ekleme	Satıcının bulunduğu konumun haritasını ekleyin.

Bu örnekte şu kullanımlar kullanılmıştır: Places API

Aşağıdaki şemada, mevcut satıcı veritabanındaki Yer Ayrıntılarını kullanarak veya Yer Arama isteği aracılığıyla uygulamanızın satıcı işlemleriyle nasıl eşleştiği gösterilmektedir:

Google Haritalar Platformu yer kimliklerini alma

İşletme adı ve adresi gibi temel bilgileri içeren bir satıcı veritabanınız olabilir. İletişim bilgileri ve kullanıcıların katkıda bulunduğu bilgiler dahil olmak üzere Google Haritalar Platformu'nun söz konusu yer hakkında sahip olduğu bilgileri almak için veritabanınızdaki her bir satıcıya karşılık gelen Google Haritalar Platformu yer kimliğine ihtiyacınız vardır.

Bir işletmenin yer kimliğini almak için Places API'deki /findplacefromtext uç noktasına istek gönderin ve isteği ücretsiz bir Yer Bulma - Yalnızca kimlik çağrısı olarak faturalandırmak için yalnızca place_id alanını isteyin. Satıcının birden fazla konumu varsa satıcı adını şehir veya sokak adıyla birlikte kullanın. Aramanın döndürdüğü verilerin kalitesi değişiklik gösterir. Bu nedenle, döndürülen sonuçların gerçekten istenen satıcıyla eşleşip eşleşmediğini doğrulamanız gerekir.

Aşağıda, satıcı adını ve şehri kullanarak Google Taipei ofisi için yer kimliği istemeyle ilgili bir örnek verilmiştir:

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

API isteğindeki giriş parametresini URL olarak kodladığınızdan emin olun.

Yer kimliklerini depolama

Google Haritalar Platformu'ndan gelecekteki istekler için satıcıyla ilgili bilgileri depolamak amacıyla bu yer kimliğini satıcı kaydının bir özelliği olarak veritabanınızda süresiz olarak saklayabilirsiniz. Yer Bulma isteğini satıcı başına yalnızca bir kez yapmanız gerekir. Bir kullanıcı işlem ayrıntılarını her istediğinde yer kimliğini de arayabilirsiniz.

Her zaman en doğru bilgilere sahip olduğunuzdan emin olmak için place_id parametresiyle bir Yer Ayrıntıları isteği kullanarak 12 ayda bir Yer Kimliklerini yenileyin.

Gösterdiğiniz Yer Ayrıntılarının, işlemi yaptığı satıcıyla eşleşmemesi durumunda, kullanıcılara satıcı eşleşmesinin kalitesi hakkında geri bildirim verme izni vermenizi öneririz.

Bu örnekte şu kullanımlar kullanılmıştır: Places API

Ayrıca kullanılabilir: Android için Yerler SDK'sı | iOS için Yerler SDK'sı | Yer Kitaplığı, Maps JavaScript API

Konumlarınızdan birini ziyaret eden kullanıcıların bilmesi gereken Yer Ayrıntılarını paylaşabilirsiniz. İletişim bilgileri, çalışma saatleri, kullanıcı puanları ve kullanıcı fotoğrafları gibi zengin Yer Ayrıntıları sayesinde uygulamanız kullanıcılara yaptıkları işlemleri hatırlatabilir. Yer Ayrıntılarını almak için Yerler API'sine çağrı yaptıktan sonra yanıtı bir bilgi penceresinde, web kenar çubuğunda veya istediğiniz başka bir şekilde filtreleyebilir ve oluşturabilirsiniz.

Yer Ayrıntılarını istemek için konumlarınızın her birinin yer kimliğine ihtiyacınız vardır. Konumunuzun yer kimliğini almak için Yer kimlikleri alma konusuna bakın.

Aşağıdaki Yer Ayrıntıları isteği, Google Taipei 101 yer kimliği için json çıkışında adres, koordinatları, web sitesini, telefon numarasını, derecelendirmeyi ve saatleri döndürür:

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

Bu örnekte kullanım alanları: Geocoding API | Maps Static API

Diğer ürünler: Android | iOS

Satıcının konumunu belirleme

Maps Static API, işaretçi yerleştirmek için adres veya koordinatları kabul eder. Satıcı kaydınızda zaten bir adres varsa sonraki bölüme atlayabilirsiniz. Ancak harita doğruluğu için adreslerin üzerinde koordinatları kullanmanızı öneririz.

Satıcı veritabanınızda açık adresler bulunuyor ancak coğrafi koordinatlar bulunmuyorsa ve halihazırda Yer Ayrıntıları isteğinde bulunmuyorsanız açık adreslerinizi sunucu tarafındaki enlem/boylam koordinatlarına dönüştürmek, koordinatları veritabanınızda saklamak ve koordinatları en az 30 günde bir yenilemek için Coğrafi Kodlama API'sini kullanabilirsiniz.

Google Taipei ofis yeri kimliğinin enlem ve boylamını almak için Geocoding API'nin kullanılmasına dair bir örneği aşağıda bulabilirsiniz:

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

Haritaya satıcı konumu için işaretçi ekleme

Kullanıcılarınız haritayı göz atmak veya gezinmek yerine işlemleri onaylamak için göreceğinden, etkileşimi sınırlı bir harita oluşturmak istiyorsunuz.

Masaüstü ve mobil web için satıcının enlem/boylam veya adresinde tek bir işaretçiye sahip Haritalar Statik API URL'si oluşturun. Maps Static API'yi bir web hizmeti çağrısı kullanarak kullanabilirsiniz. Bu çağrı, belirttiğiniz parametrelere göre bir haritanın resim sürümünü oluşturur. Mobil için bir sonraki Mobil uygulamanıza harita ekleme bölümüne geçin.

Aşağıdaki çağrıda, Google Taipei ofisindeki bir işaretçinin merkezinde, varsayılan yakınlaştırma düzeyinde 640x480 piksel boyutunda bir yol haritası gösterilmektedir. Ayrıca kırmızı bir teslimat konumu işaretçisi ve Bulut tabanlı bir harita stili de belirtir:

    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

Bu, aşağıdaki bölümlere ayrılır:

API URL'si	https://maps.googleapis.com/maps/api/staticmap?
Resim boyutu	boyut=640x480
Satıcı konum işaretçileri (URL kodlaması kullanılır.)	işaretçiler=renk:kırmızı%7C25.033976%2C121.5645389
Bulut tabanlı harita stili	map_id=b224095f76859890
API Anahtarı	key=YOUR_API_KEY
Dijital imza (İsteğinizi dijital olarak imzalama hakkında bilgi edinin.)	imza=BASE64_SIGNATURE
Çözüm kanalı parametresi (Parametre belgelerine bakın.)	solution_channel=GMP_guides_enrichedtransactions_v1_a

Bu, aşağıda gösterildiği gibi resim haline gelir:

İşaretçi konumu olarak da bir adresi kullanabilirsiniz:

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

Ek parametre seçenekleri için Haritalar Statik API belgelerine bakın.

Mobil uygulamanıza harita ekleme

Android için Haritalar SDK'sını veya iOS için Haritalar SDK'sını kullanıyorsanız Yer Ayrıntıları'ndaki bilgilerden alınan koordinatları kullanarak bir işaretçi yerleştirebilirsiniz.

Kullanıcılarınız haritayı göz atmak veya gezinmek yerine işlemleri onaylamak için göreceğinden, etkileşimi sınırlı bir harita seçin:

• Android uygulamaları için İşaretçi içeren harita ekleme eğiticisine bakın ve sınırlı etkileşim sağlamak için basit modu etkinleştirin.
• iOS uygulamaları için İşaretçi eğiticisiyle harita ekleme ve GMSUiSettings işaretiyle kontrolleri ve hareketleri devre dışı bırakma konularına bakın.