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

Hedef

Bu belgede, yüksek kaliteli adresler elde etmek amacıyla e-ticaret ödemelerinde Otomatik Yer Tamamlama, Adres Doğrulama API'si1 ve Haritalar'ı bir araya getirme yöntemleri açıklanmaktadır.

Ön koşullar

Google, aşağıdaki konularda bilgi sahibi olmanızı önerir:

  • Otomatik Yer Tamamlama JavaScript geliştirici dokümanları.
    • Yer otomatik tamamlamanın işleyiş şeklini ve uygulama seçeneklerini teknik açıdan anlayın.
  • Otomatik Yer Tamamlama için ödeme özelliğini uygulama kılavuzu.
    • E-ticaret ödeme akışında yer otomatik tamamlama özelliğinin uygulanmasıyla ilgili en iyi uygulamalara dair örnekler.
  • Doğrulama mantığınızı oluşturma bölümüne odaklanarak Address Validation API ürün dokümanlarını inceleyin.
    • Address Validation API'nin teknik açıdan işleyiş şeklini anlayın ve adres kalitesini belirleyen sinyalleri inceleyin.

Adres doğrulaması nedir?

Address Validation API, adres kabul eden bir hizmettir. Adres bileşenlerini tanımlar ve doğrular. Ayrıca, posta adresi için standart bir adres oluşturur ve bu adres için bilinen en iyi enlem/boylam koordinatlarını bulur. İsteğe bağlı olarak, ABD ve Porto Riko'daki adresler için Kodlama Doğruluğu Destek Sistemi'ni (CASS™) etkinleştirebilirsiniz.

Ödeme sırasında neden adres doğrulaması yapmanız gerekir?

Sipariş sürecinde doğru adresleri toplayın:
Bu, başarılı teslimatları teşvik etmek, zamanında sipariş tamamlamayı artırmak ve maliyetli adres düzeltme ücretlerini azaltmak için önemli bir adımdır.

Müşterileri adresi hızlı ve doğru bir şekilde girmeye yönlendirin:
Yer Otomatik Tamamlama, adres girişini hızlandırır ve giriş hatalarını azaltarak müşterilerin ödeme aşamasında kolayca ilerlemesine olanak tanır. Adres Doğrulama, genel adres kalitesiyle ilgili geri bildirim verir, standartlaştırma ve yazım hataları gibi düzeltmeler yapar ve konut veya ticari gösterge sağlamak gibi meta verileri iyileştirir (belirli bölgelerde kullanılabilir).

Uygulamaya Genel Bakış

Bu bölümde, e-ticaret ödemelerinde önerilen adres girişi iş akışı açıklanmaktadır. Bu süreç üç adımdan oluşur:

  1. Adresi ilk kez yakalamak için yer otomatik tamamlama özelliğini kullanın.
  2. Girilmiş adresi doğrulamak için Address Validation API'yi kullanın.
  3. Müşterilere teslimat konusunda güven vermek için girilen adresin konumunu haritada gösterin.

Ardından, her bir adımı ayrı ayrı inceleyeceğiz.

1. adım: Adres girişi akışı - Yer Otomatik Tamamlama hizmetini kullanma

Adres giriş formunun ilk satırında JavaScript API'yi kullanarak yer otomatik tamamlama özelliğini uygulayın.

Yer Otomatik Tamamlama, müşteri adres bilgilerini girerken öneriler sunar. JavaScript API kullanılarak uygulandığında, kullanıcılar yazmaya başladığında adres girişi formu alanının altında, her tuş vuruşuyla güncellenen Otomatik Tamamlama hizmetinden alınan sonuçları gösteren bir açılır menü görünür. Kullanıcı, adresi bulmak için yeterli bilgiyi girdikten sonra açılır menüden adresi seçer. Bu işlem, form alanlarını adres verileriyle otomatik olarak doldurur.

Yer Otomatik Tamamlama özelliğiyle kullanıcıya iki form giriş stili sunabilirsiniz: Tüm adres alanlarının bulunduğu bir ekran veya tek bir giriş alanı içeren bir ekran. Bu tek giriş alanı, kullanıcıdan adres bileşenlerini tek tek girmek yerine yazarken aramaya başlamasını ister. Otomatik tamamlama, adresi doldurduktan sonra iş akışı, form alanlarını adres verileriyle genişletir. Böylece müşteri, inceleme yapabilir ve düzenlemeler yapabilir (ör. daire veya birim numarası ekleyebilir).

Aşağıda, tek bir giriş alanı kullanılarak bu akış 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, adresin geçerli ve eksiksiz olduğunu onaylamak için ödeme sırasında Address Validation API'yi çağırmanızı önerir. Kullanıcı adres formunda İleri veya Devam düğmesini tıkladığında Address Validation API'ye çağrı tetiklenir. Bu düğme genellikle ödeme sayfasına yönlendirir.

Google, her işlem için Address Validation API'yi çağırmanızı önerir.

Aşağıdaki akış şemasında, ödeme sırasında Address Validation API'nin uçtan uca entegrasyonunun bir örneği gösterilmektedir:

resim

Bu dokümanda, adres kabulü senaryoları daha sonra ele alınmaktadır.

3. adım: Görsel onay sağlayın

Adres girildikten sonra, teslimat konumunu harita üzerinde göstererek kullanıcıya görsel onay verin. Bu, müşteriye adresin doğru olduğu konusunda ek güvence verir ve teslimat veya teslim alma hatalarını azaltır.

Harita, ödeme işlemi sırasında gösterilebilir veya işlem onay e-postasıyla gönderilebilir. Bu kullanım alanlarının her ikisi de aşağıdaki API'lerle gerçekleştirilebilir.

Maps JavaScript API, kullanıcı konumunu görüntülemek için etkileşimli bir harita sağlar. Maps Static API, web sayfasına veya daha sonraki bir aşamada e-postaya resim yerleştirmenize olanak tanır.

Ayrıntılı inceleme: Adres kabulü senaryoları

Adres Doğrulama API yanıtları üç ana senaryoya ayrılabilir:

  • Düzeltme: Adresin kalitesi düşük. Daha fazla bilgi isteyebilirsiniz.
  • Onayla: Adres yüksek kalitelidir ancak giriş adresinden farklıdır. Onay isteyebilirsiniz.
  • Kabul et: Adres yüksek kalitelidir. Sağlanan adresi kabul edebilirsiniz.

Bu kavram, Address Validation API dokümanlarındaki Doğrulama mantığınızı oluşturun bölümünde ele alınmıştır. Bu bölümde her senaryoyu ele alacağız.

Düzelt

resim

Bu bölümde, adres girişinin nasıl düzeltileceği gösterilmektedir. Address Validation API'nin düşük kaliteli bir adresi belirtmek için döndürdüğü belirli sinyaller hakkında bilgi edinmek için Doğrulama mantığınızı oluşturma dokümanlarında Adres düzeltme bölümüne bakın.

Address Validation API'den gelen yanıt geçersiz bir adres gösteriyorsa müşteriyi, girdiği verileri kontrol etmesi için adres giriş formuna yönlendirin. Adres düzeltildikten sonra, yapılan düzeltmelerin geçerli olduğundan emin olmak için hizmetiniz AddressValidation API'ye yeniden gönderilmelidir.

Ayrıca, addressComponents düzeyinde döndürülen sinyalleri kullanarak belirli adres satırı hatalarını vurgulayabilirsiniz. Bunun bir örneğini sağdaki ekran görüntüsünde görebilirsiniz.

Onayla

resim

Bu bölümde, bir adresi nasıl onaylayacağınız gösterilmektedir. Address Validation API'nin, bir adresin onaylanması gerektiğini belirtmek için döndürdüğü belirli sinyaller hakkında bilgi edinmek için Doğrulama mantığınızı oluşturma dokümanlarında Adres onaylama bölümüne bakın.

Sisteminiz genellikle kullanıcıdan bir adresi onaylamasını ister. Örneğin, bir müşteri şehir adını yanlış yazarsa bu hata Adres Doğrulama API'si tarafından düzeltilir. Bu düzeltmeyi müşteriyle onaylamanız gerekir. Bunun nedeni, API tarafından yapılan değişikliklerin, başlangıçta girilenleri temelden değiştirebilmesidir.

Müşteriye bilgileri göstermek için geçiş modu kullanın. Bu mod, devam etmek için üç seçenek sunar:

  1. API tarafından döndürülen adresi onaylayın. Ödeme işlemi, düzeltilen adres kullanılarak devam eder.
  2. Adres Doğrulama API'sinden gelen düzeltmeyi yok sayarak adresi ilk girildiği şekilde seçin. Ödeme süreci normal şekilde devam edebilir ve sipariş, süreciniz izin veriyorsa gönderimden önce aşağı akış incelemesi için işaretlenebilir.
  3. Müşteri, modal pencereyi iptal eder veya geri çıkar. Bu durumda müşteri, ödeme işleminin adres girişi aşamasına geri döner. Burada adresi sıfırdan yeniden girerek işlemi baştan başlatabilir.

Bunun bir örneğini sağdaki ekran görüntüsünde görebilirsiniz.

Kabul et

Bu bölümde, bir adresi nasıl kabul edeceğiniz gösterilmektedir. Adres Doğrulama API'sinin, bir adresin kaliteli olduğunu ve kabul edilmesi gerektiğini belirtmek için döndürdüğü belirli sinyaller hakkında bilgi edinmek için Doğrulama mantığınızı oluşturma dokümanlarında Adres kabul etme bölümüne bakın.

Bu senaryoda ödeme süreci, müşteriye adres kalitesiyle ilgili herhangi bir istem göstermeden bir sonraki aşamaya (muhtemelen ödeme tahsilatı) geçmelidir. API, müşteri tarafından girilen adresin iyi kalitede ve teslim edilebilir olduğunu onayladı.

Aşağıdakiler gibi küçük düzeltmeler ve eklemeler içerebileceğinden, sipariş için Address Validation API'den döndürülen adres verilerini kullanmanızı öneririz:

  • Büyük harf kullanımı
  • Biçimlendirme düzeltmeleri, örneğin:
    • Cadde için St
    • Adres bileşenlerinin doğru sıralanması
  • ABD'de ZIP+4.

Uygulamada Dikkat Edilmesi Gereken Hususlar

Adres kabulü mantığınızı oluştururken, uygulamanızın geçersiz bir adres girdikleri için müşterilerin ödeme yapmasını engellemediğinden emin olun. API, girişin geçersiz olduğunu tekrar tekrar belirtirse mantığı, sonsuz döngü olasılığını önleyecek şekilde oluşturun.

Google, müşterilere adreslerini girmeleri için en fazla iki şans vermenizi ve ikinci denemede, doğrulanmamış olsa bile girişlerini kabul etmenizi önerir. İkinci denemede, doğrulamadan bağımsız olarak kullanıcıların devam etmesine izin verilir.

İkinci denemeyi kabul etmek için önerilen iki yöntem:

  • Devam etmeyi zorla: Müşteriye, adresin doğrulanmadığını açıklayan bir modal pencere gösterin ancak müşterinin yazdığı adresle devam etme seçeneğini sunun.
  • Sessiz Kabul: Adres tam olarak doğrulanmamış olsa bile ikinci denemeyi onay adımı olmadan otomatik olarak kabul eder.

Mümkünse sisteminizi, doğrulanmayan adresleri işaretleyecek şekilde tasarlayın. Böylece müşteri hizmetleri temsilcisi, sipariş gönderilmeden önce bu adresleri inceleyebilir. Bu ek önlem, hataları yakalamanızı sağlar.

Yeni yapı inşası, bu kontrolün neden önerildiğinin iyi bir örneğidir. Yeni bir binanın inşaatının tamamlanması ile bu binanın adresinin posta adresi veritabanlarına girilmesi arasında bir gecikme olabilir. Müşteriler, doğrulanmamış olsa bile girdikleri adresle ödeme sayfasına geçmeyi zorunlu kılma seçeneğine sahip olmalıdır.

Bir ödeme oturumu tamamlandıktan sonra, isteğe bağlı olarak provideValidationFeedback yöntemini kullanarak Google'a belirli bir adres doğrulama denemesiyle ilgili geri bildirim gönderebilirsiniz.

Sonuç

Bu dokümanda, Google Haritalar'da otomatik tamamlama, adres doğrulama ve görsel onay özelliklerinin uygulandığı bir ödeme akışına genel bakış sunulmuştur. Önerilen adres girişi akışlarını uygulayarak uygulamanızı tasarlamak için başlangıç noktası olarak bu dokümanı kullanın.

Sonraki Adımlar

Güvenilir adreslerle ödeme, teslimat ve işlemleri iyileştirin teknik belgesini indirin ve Adres Doğrulama ile ödeme, teslimat ve işlemleri iyileştirin webinar'ını izleyin.

Önerilen diğer kaynaklar:

Katkıda bulunanlar

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

  1. United States Postal Service'in Münhasır Olmayan Lisans Sahibi. Aşağıdaki ticari markalar United States Postal Service®'e aittir ve izinle kullanılmaktadır: CASS™, USPS®, DPV®. ↩