Hedef
Bu dokümanda Otomatik Yer Tamamlama, Adres bilgilerini birleştirme yöntemleri açıklanmaktadır Doğrulama API'si1 ve Haritalar'ı kullanan bir e-ticaret ödemesinde Bu özelliği kullanabilirsiniz.
Ön koşullar
Google, aşağıdaki konularda bilgi sahibi olmanızı önerir:
- Otomatik Yer Tamamlama JavaScript geliştiricisi
belgelerine göz atın.
- Otomatik Yer Tamamlama'nın nasıl çalıştığını teknik bir açıdan anlayın ve uygulama seçeneklerinden bahsedeceğiz.
- Yer için ödeme uygulama rehberi
Otomatik tamamlama.
- Otomatik Tamamlama özelliğinin kullanıldığı en iyi uygulama örnekleri, ödeme yapabilirsiniz.
- Address Validation API ürünü
,
Doğrulamanızı oluşturun
mantığına bakın.
- Address Validation API'nin nasıl çalıştığını teknik bir açıdan anlayın olup olmadığını belirlemek ve adres kalitesini belirleyen sinyalleri incelemektir.
Adres doğrulama nedir?
Address Validation API, adres kabul eden bir hizmettir. Adres bileşenlerini tanımlar ve doğrular. Aynı zamanda, ve bu adrese ilişkin en bilinen enlem/boylam koordinatlarını bulur. Dilerseniz ABD ve Porto Riko'daki adresler için Kodlama Doğruluğu Destek Sistemi (CASSTM).Ödeme sırasında neden adres doğrulamasına ihtiyacınız var?
Sipariş işlemi sırasında doğru adresleri toplayın:
Bu, başarılı teslimatların teşvik edilmesi ve zamanında teslimatların yapılması için
ve maliyetli adres düzeltme ücretlerini azaltır.
Müşterileri adresi hızlı ve doğru bir şekilde girmeleri için yönlendirin:
Otomatik Tamamlama, adres girişini hızlandırıp giriş hatalarını azaltarak
Müşterilerin ödeme sırasında kolayca ilerlemesini sağlar. Adres Doğrulama geri bildirim verir
standartlaştırma ve kaliteyi en üst düzeye çıkarma gibi düzeltmelerin
yazım hatalarını düzeltir ve konut ya da e-posta adresi gibi meta verileri geliştirir.
ticari gösterge (belirli
bölgelerinde bulabilirsiniz.
Uygulamaya Genel Bakış
Bu bölümde, e-ticaret için önerilen adres girişi iş akışı açıklanmaktadır. ödeme işlemleri. Süreç üç adımdan oluşur:
- Başlangıçta adresi yakalamak için Otomatik Yer Tamamlama özelliğini kullanın.
- Girilen adresi onaylamak için Address Validation API'yi kullanın.
- Teslimat için, girilen adresin konumunu harita üzerinde görüntüleyin güven kazanmak çok önemli.
Daha sonra, her adımı tek tek inceleyeceğiz.
1. Adım: Adres girişi akışı - Otomatik Yer Tamamlama hizmetini kullanarak
Yer Uygulama Otomatik tamamlama kullanarak JavaScript API'sini kullanabilirsiniz.
Otomatik Yer Tamamlama, müşteriler giriş yaparken öneriler sunar adres ayrıntıları. JavaScript API ile uygulandığında, kullanıcılar yazdığınızda, adres girişi form alanının altında sonuçları gösteren bir açılır menü görünür her tuş vuruşunda güncellenen Otomatik tamamlama hizmetinden yararlanın. Kullanıcı adresi bulmak için yeterli bilgi girdiyse adresi açılır. Bu işlem, form alanlarını otomatik olarak şu adresle doldurur: dışı verilerdir.
Otomatik Yer Tamamlama özelliğiyle kullanıcıya iki form giriş stili sağlayabilirsiniz: Tüm adres alanlarını içeren bir ekran veya tek bir giriş içeren bir ekran girin. Bu tek giriş alanı, kullanıcının yazarken aramaya başlamasını ister. tek tek girmek daha iyidir. Otomatik tamamlamada adresi doldurursa iş akışı, form alanlarını Böylece, müşteri verilerini inceleyip düzenleyebilir, örneğin daire veya daire numarası.
Aşağıda, tek bir giriş alanı kullanıldığında bu akışın nasıl görünebileceğine dair bir örnek verilmiştir:
2. Adım: Adresleri doğrulamak için Address Validation API'yi kullanın
Kullanıcı adresi girdikten sonra Google, Adres Doğrulama API ödeme aşamasında bu adresin geçerli ve eksiksiz olduğunu onaylayın. Bir Kullanıcı, yer alır. Bu düğme genellikle ödeme sayfasına yönlendirir.
Google, her işlem için Address Validation API'nin çağrılmasını önerir.
Aşağıdaki akış şemasında, Ödemede Address Validation API (Adres Doğrulama API'si):
Bu belgede, adres kabul senaryoları daha sonra ele alınacaktır.
3. Adım: Görsel onay sağlayın
Adres girişinden sonra kullanıcıya teslimatın görsel olarak onayını sağlayın konumu harita üzerinde görüntüleyerek belirleyebilirsiniz. Bu, müşteriye ek olarak emin olmanız gerekir. Bu da teslimatın veya teslim almanın azaltılmasını sağlar başarısız olur.
Harita, ödeme işlemi sırasında gösterilebilir veya işlem içinde gönderilebilir. onay e-postası. Bu kullanım alanlarının her ikisi de API'leri takip edin.
Haritalar JavaScript API'si, kullanıcının konumunu görüntülemek için etkileşimli bir harita sağlar. | Haritalar Statik API'si, resmin web sayfasına veya e-postanın daha sonraki bir aşamasında yerleştirilmesine olanak tanır. |
---|---|
![]() |
![]() |
Ayrıntılı İnceleme: Kabul senaryolarını ele alma
Address Validation API yanıtları, üç ana senaryoya ayrılabilir:
- . Düzelt: Adresin kalitesi düşük. Daha fazla bilgi için istemde bulunmalısınız.
- . Onayla: Adres yüksek kalitede ancak farklı olabilir. Bir ekip üyesine onayı.
- . Kabul et: Adres yüksek kalitededir. Şunları yapabilirsiniz: sağlanan adresi kabul edin.
Bu kavram, Doğrulamanızı oluşturma mantık bölümünde bulabilirsiniz. Her senaryoyu bu bölümde bulabilirsiniz.
Düzelt
Bu bölümde, bir adres girişinin nasıl düzeltileceği gösterilmektedir. Belirli konulardaki Address Validation API'nin düşük kaliteyi belirtmek için döndürdüğü sinyaller daha fazla bilgi için adres oluşturma hakkındaki makalemizi incelemenizi öneririz.
Address Validation API'den alınan yanıtta geçersiz bir adres görünüyorsa Müşteriyi, girdiği verileri kontrol etmesi için adres giriş formuna yönlendirin. Adres düzeltildikten sonra hizmetiniz Adrese yeniden göndermelidir Doğrulama API'si ile yapılan düzeltmelerin geçerli olduğundan emin olun.
Ayrıca, sinyalleri kullanarak belirli adres satırı hatalarını da vurgulayabilirsiniz.
addressComponents
düzeyinde döndürüldü. Bunun bir örneğini
sağ taraftaki ekran görüntüsüdür.
Onayla
Bu bölümde, bir adresin nasıl onaylanacağı gösterilmektedir. Belirli konulardaki Adres Doğrulama API'sinin bir adresin doğru şekilde ayarlanması gerektiğini belirtmek için döndürdüğü sinyaller doğrulama işlemini tamamlamak için adres oluşturma hakkındaki makalemizi incelemenizi öneririz.
Sisteminiz çoğu zaman bir kullanıcıdan adresi onaylamasını ister. Örneğin, müşteri şehir adını yanlış yazıyorsa bu durum Adres Doğrulama API'si. Bu düzeltmeyi müşteriyle onaylamalısınız. Çünkü API tarafından yapılan değişiklikler, orijinal yapılandırmada kullanılan girildi.
Bir geçiş reklamı penceresi kullanarak bilgileri müşteriye gösterin. üç seçenek sunulur:
- API'nin döndürdüğü adresi onaylayın ve ödeme işlemini tamamlayın. kullanarak devam eder.
- Orijinal olarak girildiği şekliyle adresi seçin ve Address Validation API. Ödeme işlemi normal şekilde devam edebilir ve gönderimden önce aşağı akış açısından incelenmek üzere işaretlenebilir. izin verir.
- Müşteri, kalıcı aboneliği iptal eder veya iptal eder ya da geri çekerek iletişim kutusunu ödeme işleminin giriş aşamasını (burada yeniden girebilecekleri şekilde) sıfırdan başlayarak işleme koyacağız.
Sağdaki ekran görüntüsünde bunun bir örneğini görebilirsiniz.
Kabul et
Bu bölümde, adreslerin nasıl kabul edileceği gösterilmektedir. Belirli konulardaki Address Validation API'nin bir adresin iyi olduğunu belirtmek için döndürdüğü sinyaller ve kabul edilmelidir. Daha fazla bilgi edinmek için adres oluşturma hakkındaki makalemizi incelemenizi öneririz.
Bu senaryoda ödeme işlemi bir sonraki aşamaya geçmelidir. müşteriden kaliteyle ilgili herhangi bir yönlendirme yapılmadan ödeme bilgileri. API, müşterinin girdiği adresin iyi kaliteli olduğunu onayladı. ve teslimatlardır.
Address Validation API'den döndürülen adres verilerini kullanmanızı öneririz küçük düzeltmeler ve eklemeler içerebileceği için karara aykırıdır. Örneğin:
- Büyük harf kullanımı
- Örneğin biçimlendirme düzeltmeleri
- Sokak'tan St'ye
- Adres bileşenlerinin doğru sıralanması
- ABD'de ZIP+4 biçimindedir.
Uygulamada Dikkat Edilmesi Gereken Hususlar
Adres kabul mantığınızı oluştururken, uygulamanızın Geçersiz bir adres girmeleri nedeniyle müşterilerin ödeme yapmasını engelleyebilirsiniz. Bir araya getirme sonsuz döngü olasılığını önleyecek şekilde bir mantıksal sisteme sürekli olarak girişlerinin geçersiz olduğunu gösterir.
Google, müşterilerinize giriş yapma hakkı tanımaları için en fazla iki adresine gitmesi ve ikinci denemede, ilk denemede esas alınan yardımcı olur. İkinci denemede hedef, ne olursa olsun devam etmelerine izin vermektir. doğrulama.
İkinci denemeyi kabul etmek için önerilen iki yöntem vardır:
- Zorla devam et: Müşteriye, adresin farklı olduğunu açıklayan bir kalıcı iletişim kutusu gösterin ancak girilen adresle devam etme seçeneğine izin vermelidir.
- Sessiz Kabul: emin olun.
Mümkünse sisteminizi doğrulanmayan adresleri işaretleyecek şekilde tasarlayın. Böylece, sitenizin Müşteri hizmetleri temsilcisi, sipariş gönderilmeden önce bunları inceleyebilir. Bu ekstra önlem, hataları yakalamanızı sağlar.
Yeni bina inşaatı bu kontrolün neden yapıldığını önerilir. Yeni bina inşaatının gerçekleşmesi arasında tamamlandığına ve söz konusu binanın adresi posta adresine girildiğinde veri tabanları. Müşterilere, 2020'de ve 2022'den bu yana doğrulama olmasa bile girilen adresle birlikte ödeme sayfasına yönlendirilir.
Ödeme oturumu tamamlandıktan sonra isteğe bağlı olarak
provideValidationFeedback
belirli bir adres doğrulama girişimi hakkında Google'a geri bildirim göndermek için kullanılan bir yöntemdir.
Sonuç
Bu belgede, uygulama ve oyununuzun nasıl uygulandığını anlamak için Otomatik tamamlama, adres doğrulama ve Google haritalarında görsel onay. Tekliflerinizi otomatikleştirmek ve optimize etmek için aşağıdaki adımları izleyerek uygulamanızı tasarlamak için bir başlangıç noktası olarak bu belgeden önerilen adres girişi akışlarını kullanır.
Sonraki Adımlar
Güvenilir adreslerle ödeme, teslimat ve işlemleri iyileştirme Teknik belge ve Adresle ödeme, teslimat ve işlemleri iyileştirme Doğrulama Web semineri.
Önerilen ek okuma:
- Otomatik Yer Tamamlama Belgeleri
- Address Validation API Belgeleri
- Google Haritalar Platformu Raporlaması
Katkıda bulunanlar
Henrik Valve | Çözüm Mühendisi
Thomas Anglaret | Çözüm Mühendisi
Sarthak Ganguly | Çözüm mühendisi
-
ABD Posta Hizmeti'nin Münhasır Olmayan Lisans Sahibi. Şu ticari markalar United States Postal Service®'a aittir ve izinle kullanılmaktadır: CASSTM, USPS®, DPV®. ↩