Zenginleştirilmiş İşlemler uygulama kılavuzu

Genel Bakış

web iOS API

Google Haritalar Platformu; web (JS, TS), Android ve iOS için ve yerler, yol tarifleri ve Google'dan hakkında bilgi edinmek için web hizmetleri API'leri görebilirsiniz. Bu kılavuzdaki örnekler bir platform için yazılmıştır ancak belge bağlantıları diğer platformlarda uygulanmak üzere sağlanmıştır.

İşlem ekstrelerini anlamak zordur. satıcı adları yerine “Sağlam Ev Eşyaları” gibi kısaltmalar kullanılmış. Bu da müşteri desteği çağrılarının artmasına ve yüksek ihtilaflara yol açabilir. Zenginleştirilmiş İşlemler, bu işlemleri basitleştirir ve Satıcının tam adını ve işletme kategorisini, Vitrin, haritadaki adresi ve konumu, tam iletişim bilgileri ve daha fazlası. Bu kullanıcı memnuniyetini ve şeffaflığı artırmaya yardımcı olur, müşteri desteği aramaları, NPS'yi artırın ve uygulamada daha fazla zaman geçirin.

Zenginleştirilmiş İşlemler: Google Analytics Yardım Merkezi'nde sağladığımız uygulama kılavuzu ve özelleştirme en iyi kombinasyonu bulmak için önerimiz Mükemmel işlem geçmişi kullanıcısı oluşturmak için Google Haritalar Platformu API'leri paylaşmaya istekli olmalıdır. Bu uygulama kılavuzu, bir konumu nasıl eşleştireceğinizi gösterir belirli bir satıcıyla bağlantı kurabilir ve ayrıntılı bilgilerini gösterebilir.

Zenginleştirilmiş işlem örnek ekranları
Zenginleştirilmiş işlemler örnek ekranları (büyütmek için tıklayın)

API'ler etkinleştiriliyor

Zenginleştirilmiş işlemleri uygulamak için aşağıdaki API'leri etkinleştirmeniz gerekir: Google Cloud Console. Aşağıdaki köprüler sizi Google Cloud Console'a yönlendirir API'yi etkinleştirmek için:

ziyaret edin. Kurulum hakkında daha fazla bilgi için bkz. Başlarken Google Haritalar Platformu'nu kullanmaya başladı.

Uygulama kılavuzu bölümleri

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

  • . Onay işareti simgesi, temel uygulama adımıdır.
  • . Yıldız simgesi isteğe bağlıdır ancak önerilen özelleştirmedir geliştirmenin ne kadar önemli olduğunu konuştuk.
Satıcıları Google Haritalar Platformu ile eşleştirme İşlem geçmişindeki bir satıcıyı bir yerle ilişkilendirme Google Haritalar Platformu.
Satıcı ayrıntılarını gösterme Google Ads ile ilgili faydalı bilgiler gösteren, veri açısından zengin işlemleri Böylece, kullanıcılar işlemi hızlı bir şekilde tanıyabilir.
Satıcının bulunduğu konumun haritasını ekleme Satıcının bulunduğu konumun haritasını ekleyin.

Satıcıları Google Haritalar Platformu ile eşleştirme

Bu örnekte şunlar kullanılmaktadır: Places API

Aşağıdaki şemada, uygulamanızın satıcı işlemleriyle nasıl eşleştiği gösterilir kullanarak bir sonuç döndürmeyi unutmayın. veya Yer Arama isteği üzerinden:

Satıcı eşleştirme akış matrisi
Satıcı eşleştirme akış matrisi (büyütmek için tıklayın)

Google Haritalar Platformu yer kimliklerini alma

İşletme veya satıcı gibi temel bilgileri içeren bir satıcı veritabanınız olabilir. adını ve adresini yazın. Google Haritalar Platformu'nun hakkında sunduğu bilgileri almak için bilgileri ve kullanıcıların sağladığı bilgiler dahil olmak üzere, her bir konuma karşılık gelen Google Haritalar Platformu yer kimliğini satıcılar olduğundan emin olun.

Bir işletmenin yer kimliğini almak için /findplacefromtext uç noktası: Places API'yi gönderebilir ve yalnızca place_id alanını isteği ücretsiz olarak faturalandırın Yer Bulma - yalnızca Kimlik çağrısına bir tıklama URL'si eklemeniz gerekir. Satıcının birden fazla konumu varsa satıcı adını şurada kullanın: yanında şehir ya da sokak adıyla birlikte gösterilir. Web sayfası tarafından döndürülen verilerin kalitesi arama değişiklik gösterebilir, bu yüzden sonuçların döndürülüp döndürülmediğini doğrulamanız gerekir uygun satıcıyla eşleşmesini sağlar.

Aşağıda, Taipei ofisi için yer kimliğini Satıcının adı ve şehri:

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

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

Yer kimliklerini depolama

İleride kullanılmak üzere Google Haritalar Platformu'nda satıcıyla ilgili bilgileri depolamak için bu yer kimliğini saklayabilirsiniz. süresiz olarak ekleyebilirsiniz. Siz Yer Bulma isteğini her satıcı için yalnızca bir kez yapmalıdır. Şunları yapabilirsiniz: bir kullanıcı işlem ayrıntılarını her istediğinde yer kimliğini de arar.

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

Gösterdiğiniz Yer Ayrıntılarının satıcıyla eşleşmemesi durumunda satın alma işlemi gerçekleştirdiyseniz, kullanıcıların geri bildirimde bulunmalarına satıcı eşleşmesinin kalitesi hakkında.

Satıcı bilgileri gösteriliyor

Bu örnekte şunlar kullanılmaktadır: Places API Sunulan diğer kaynaklar: Android için Yerler SDK'sı | iOS için Yerler SDK'sı | Yerler Kitaplığı, Maps JavaScript API

Mağazanızdan birini ziyaret eden kullanıcıların bilmesi gereken Yer Ayrıntılarını yerler. İletişim bilgileri, çalışma saatleri ve ve kullanıcı fotoğraflarına bakarak, uygulamanız kullanıcılara belirtir. Yer Ayrıntılarını almak için Yerler API'si, yanıtı bir bilgi penceresinde, bir web kenar çubuğunda filtreleyebilir ve istediğiniz gibi kullanabilirsiniz.

Örnek satıcı ayrıntıları ekranı
Örnek satıcı ayrıntıları ekranı (büyütmek için tıklayın)

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

Aşağıdaki Yer Ayrıntısı isteği; adres, koordinatları, web sitesini Google Taipei 101 için json çıkışında telefon numarası, puan ve saat bilgileri yer kimliği:

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 bulunduğu konumun haritasını ekleme

Bu örnekte şunlar kullanılmaktadır: Coğrafi Kodlama API'si | Maps Static API Sunulan diğer kaynaklar: Android | iOS

Satıcının konumunu belirleme

Maps Static API, kullanabilirsiniz. Satıcı kaydınızda zaten bir adres varsa ileri atlayabilirsiniz bir sonraki bölüme geçelim, ancak haritalama için adreslerin üzerinde daha yüksek olması gerekir.

Satıcı veritabanınızda açık adresler bulunuyorsa ancak coğrafi koordinatlar yoksa ve halihazırda Yer Ayrıntıları isteğinde bulunmuyorsanız, sokak adreslerini Google Ads'e dönüştürmek için Geocoding API'yi kullanabilirsiniz enlem/boylam koordinatlarını alırken koordinatlarınızı ve koordinatları en az 30 günde bir yenilemelidir.

Verilerinizi almak için Geocoding API'nin Google Taipei ofis yer kimliğinin enlem ve boylamı:

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 işlem gerçekleştirmek yerine işlemleri onaylamak için göreceklerinden, sınırlı etkileşim olanağı sunan bir harita oluşturmak istiyorsanız.

Masaüstü ve mobil web için tek bir işaretçili Haritalar Statik API URL'si oluşturun. Satıcının enlem/boylam veya adresinde gösterilir. URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için Haritalar Statik API'yi kullanmak için bir web hizmeti çağrısı belirttiğiniz parametrelere göre bir haritanın resim sürümü Mobil için şuna atlayın: sonraki Mobil uygulamanız bölümüne harita ekleme.

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

    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.) signature=BASE64_SIGNATURE
Çözüm kanalı parametresi (bkz. parametre belgeleri) solution_channel=GMP_guides_enrichedtransactions_v1_a

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

Google Taipei Office'in statik harita görüntüsü

İş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 dokümanlarını.

Mobil uygulamanıza harita ekleme

Android için Haritalar SDK'sını kullanıyorsanız veya iOS için Google Haritalar SDK'sı kullanıyorsanız aşağıdakileri kullanarak bir işaretçi yerleştirebilirsiniz: koordinatlarını Yer Ayrıntıları'ndaki bilgilerden çıkarır.

Kullanıcılarınız haritayı göz atmak veya işlem gerçekleştirmek yerine işlemleri onaylamak için göreceklerinden, gezinme, sınırlı etkileşim içeren bir harita seçin: