E-ticaret Ödemesi için Adres Doğrulama

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 belgelerini inceleyin.
    • 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, veya e-ticaret ödemesinden yararlanın.
  • 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.
ziyaret edin.

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 standart haline getirme 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ölgeler olarak da adlandırılır.

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:

  1. Başlangıçta adresi yakalamak için Otomatik Yer Tamamlama özelliğini kullanın.
  2. Girilen adresi onaylamak için Address Validation API'yi kullanın.
  3. Teslimat için, girilen adresin konumunu harita üzerinde görüntüleyin güvene dayanıyor.

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ıyı yazarken aramaya başlamasını ister. tek tek girmek daha iyidir. Otomatik tamamlamada adresi doldurursa iş akışı, form alanlarını ve düzenleme yapmasına olanak tanıyarak, örneğin Apartman 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:

resim

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):

resim

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

resim

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 gelen yanıt geçersiz bir adres belirtiyorsa 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

resim

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 tarafından düzeltilir 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:

  1. API'nin döndürdüğü adresi onaylayın ve ödeme işlemini tamamlayın. kullanarak devam eder.
  2. 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.
  3. 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 yeni bir adres oluşturacaksını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ılmaksızın ödeme bilgileri alınması. 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 ile kullanılabilir.
ziyaret edin.

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 validate. İ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 adresi doğrulanmış olsa bile girdiğiniz adresle birlikte ödeme sayfasına yönlendirilir.

Ödeme oturumu tamamlandıktan sonra isteğe bağlı olarak provideValidationFeedback yöntemini kullanabilirsiniz.

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:

Katkıda bulunanlar

Henrik Valve | Çözüm Mühendisi
Thomas Anglaret | Çözüm Mühendisi
Sarthak Ganguly | Çözüm mühendisi


  1. 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®.