Zenginleştirilmiş İşlemler uygulama kılavuzu

Genel Bakış

"Acme Ev Eşyaları" gibi satıcı adları yerine "ACMEHCORP" gibi kısaltmalar kullanıldığı için işlem ekstrelerinin kullanıcılar tarafından anlaşılması genellikle zordur. Bu da müşteri desteği aramalarının ve pahalı itirazların artmasına neden olabilir. Zenginleştirilmiş İşlemler, satıcının tam adını ve işletme kategorisini, mağazanın fotoğrafını, haritadaki adresini ve konumunu, tam iletişim bilgilerini ve daha fazlasını sağlayarak bu işlemleri basitleştirir ve sezgisel hale getirir. Bu, kullanıcı memnuniyetini ve şeffaflığı artırmaya yardımcı olur. Ayrıca müşteri desteği aramalarını azaltabilir, NPS'yi artırabilir ve uygulamada daha fazla zaman geçirmeyi sağlayabilir.

Mükemmel işlem geçmişi kullanıcı deneyimleri oluşturmak için Google Haritalar Platformu API'lerinin en uygun kombinasyonu olarak zenginleştirilmiş işlemler (bu konuda sunduğumuz uygulama kılavuzu ve özelleştirme ipuçları) önerilir. Bu uygulama kılavuzunda, bir konumu belirli bir satıcıyla nasıl eşleştireceğiniz ve satıcının ayrıntılı bilgilerini nasıl göstereceğiniz açıklanmaktadır.

API'leri etkinleştir

Zenginleştirilmiş İşlemler'i uygulamak için Google Cloud Console'da aşağıdaki API'leri etkinleştirmeniz gerekir. Aşağıdaki köprü bağlantıları, seçtiğiniz proje için her API'yi etkinleştirmek üzere sizi Google Cloud Console'a yönlendirir:

• Places API.
• Geocoding API.
• Maps Static API, Android için Haritalar SDK'sı veya iOS için Haritalar SDK'sı.

Uygulama kılavuzu bölümleri

Burada ele alınan uygulamalar ve özelleştirmeler aşağıda verilmiştir:

• check_circle_filled Onay işareti simgesi, temel bir uygulama adımıdır.
• stars Yıldız simgesi, çözümü iyileştirmek için isteğe bağlı ancak önerilen bir özelleştirmedir.

Aşağıdaki şemada, uygulamanızın mevcut bir satıcı veritabanındaki yer ayrıntılarını kullanarak veya bir yer arama isteği aracılığıyla sonuç döndürmek için satıcı işlemlerini nasıl eşleştirdiği gösterilmektedir:

Google Haritalar Platformu yer kimliklerini alma

İşletmenin adı ve adresi gibi temel bilgiler içeren bir satıcı veritabanınız olabilir. Google Haritalar Platformu'nun ilgili yerle ilgili sahip olduğu bilgileri (iletişim bilgileri ve kullanıcı tarafından eklenen bilgiler dahil) almak için veritabanınızdaki satıcıların her birine 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 istekte bulunun ve isteği ücretsiz 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österdiğinden, döndürülen sonuçların gerçekten satıcıyla eşleşip eşleşmediğini doğrulamanız gerekir.

Satıcı adı ve şehri kullanılarak Google Taipei ofisinin yer kimliğinin istenmesine ilişkin bir örnek aşağıda verilmiştir:

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

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

Mağaza yer kimlikleri

Gelecekteki istekler için Google Haritalar Platformu'ndaki satıcıyla ilgili bilgileri depolamak istiyorsanız bu yer kimliğini satıcı kaydının bir özelliği olarak veritabanınızda süresiz olarak depolayabilirsiniz. Yer bulma isteğini satıcı başına yalnızca bir kez göndermeniz gerekir. Ayrıca, bir kullanıcı her işlem ayrıntısı istediğinde yer kimliğini arayabilirsiniz.

Her zaman en doğru bilgilere sahip olmak için place_id parametresini içeren bir Yer Ayrıntıları isteği kullanarak 12 ayda bir yer kimliklerini yenileyin.

Gösterdiğiniz yer ayrıntıları, işlemi gerçekleştirdikleri satıcıyla eşleşmezse kullanıcıların satıcı eşleşmesinin kalitesi hakkında geri bildirim vermesine izin vermenizi öneririz.

Kullanıcıların konumlarınızdan birini ziyaret ettikten sonra 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 tamamladıkları işlemleri hatırlatabilir. Yer Ayrıntıları'nı almak için Places API'yi çağırdıktan sonra yanıtı bir bilgi penceresinde, web kenar çubuğunda veya Hizmet Şartlarımız dahilinde istediğiniz şekilde filtreleyip oluşturabilirsiniz.

Yer ayrıntıları isteğinde bulunmak için her konumunuzun yer kimliğine ihtiyacınız vardır. Konumunuzun yer kimliğini almak için Yer kimlikleri alma başlıklı makaleyi inceleyin.

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

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

Satıcının konumunu belirleme

Maps Static API, işaretçi yerleştirmek için bir adres veya koordinat kabul eder. Satıcı kaydınızda zaten bir adres varsa sonraki bölüme geçebilirsiniz ancak haritadaki konumun daha doğru olması için adres yerine koordinatları kullanmanızı öneririz.

Satıcı veritabanınızda sokak adresleri varsa ancak coğrafi koordinatlar yoksa ve yer ayrıntılarını istemiyorsanız, sokak adreslerini sunucu tarafında enlem/boylam koordinatlarına dönüştürmek, koordinatları veritabanınızda depolamak ve koordinatları en az 30 günde bir yenilemek için Coğrafi Kodlama API'yi kullanabilirsiniz.

Google Taipei ofisi yer kimliğinin enlem ve boylamını almak için Geocoding API'nin kullanıldığı örnek:

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

Satıcı konumu için haritaya işaretçi ekleme

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

Masaüstü ve mobil web için satıcının enlem/boylamında veya adresinde tek bir işaretçi içeren bir Maps 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 cihazlar için Mobil uygulamanıza harita ekleme bölümüne geçin.

Aşağıdaki çağrıda, varsayılan yakınlaştırma düzeyinde Google Taipei ofisindeki bir işaretçiye odaklanan 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:

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

Bu görüşme aşağıdaki bölümlere ayrılmıştır:

Bu sonuç, aşağıda gösterilen resim olur:

İşaretçi konumu olarak bir adres de kullanabilirsiniz:

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

Diğer parametre seçenekleri için Maps Static 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 koordinatları kullanarak bir işaretçi yerleştirebilirsiniz.

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

• Android uygulamaları için İşaretçi içeren bir harita ekleme eğitimiyle ilgili makaleyi inceleyin ve sınırlı etkileşim sağlamak üzere basit modu etkinleştirin.
• iOS uygulamaları için İşaretçi içeren bir harita ekleme eğitim videosunu inceleyin ve GMSUiSettings işaretçisiyle kontrolleri ve hareketleri devre dışı bırakın.