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 uygulaması 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 biçim kullanır ve bilinen en iyi enlem/boylam koordinatlarını bulur. Dilerseniz ABD ve Porto Riko'daki adresler için Kodlama Doğruluğu Destek Sistemi'ni (CASSTM) etkinleştirebilirsiniz.

Ödeme sırasında neden adres doğrulamasına ihtiyacınız var?

Sipariş verme sürecinde doğru adresleri toplayın:
Bu; başarılı teslimatlar sağlamak, zamanında sipariş karşılamayı 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 girmeleri için yönlendirin:
Yerleştirme Otomatik Tamamlama, adres girişini hızlandırıp 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. 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. 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ışı - Otomatik Yer Tamamlama hizmetini kullanarak

Adres giriş formunun ilk satırına 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.

Otomatik Yer Tamamlama özelliği ile kullanıcıya iki form giriş stili sağlayabilirsiniz: tüm adres alanlarını içeren bir ekran veya tek bir giriş alanına sahip 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 bir apartman veya daire numarası eklemek gibi bilgileri inceleyip düzenleyebilir.

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 bir çağrı tetikleyin. 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, Address Validation API'nin bir ödeme ile uçtan uca entegrasyonu ö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.

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ı inceleme: Adres kabulü senaryoları

Address Validation API yanıtları üç ana senaryoya ayrılabilir:

  • Düzeltme: Adresin kalitesi düşük. Daha fazla bilgi isteyebilirsiniz.
  • Onayla: Adres yüksek kalitede ancak giriş adresinde değişiklikler var. Onay isteyebilirsiniz.
  • Kabul et: Adres yüksek kalitelidir. Sağlanan adresi kabul edebilirsiniz.

Bu kavram, Address Validation API belgelerinin Doğrulama mantığınızı oluşturma bölümünde ele alınmıştır. Her bir senaryoyu bu bölümde ele alacağız.

Düzelt

resim

Bu bölümde, bir adres girişinin nasıl düzeltileceği gösterilmektedir. Address Validation API'nin düşük kaliteli bir adres göstermek üzere döndürdüğü belirli sinyaller hakkında bilgi için "Build your verification Mandik" belgelerindeki Adresi düzeltme" bölümüne bakın.

Address Validation API'den gelen yanıt geçersiz bir adres gösteriyorsa müşteriyi, girilen 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 adresin nasıl onaylanacağı 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 çoğu zaman bir kullanıcıdan adresi onaylamasını ister. Örneğin, bir müşteri şehir adını yanlış yazar. Bu daha sonra Address Verification API'si tarafından düzeltilir. Bu düzeltmeyi müşteriyle onaylamalısınız. Bunun nedeni, API tarafından yapılan değişikliklerin, başlangıçta girilen bilgileri 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 yoksayarak adresi ilk girildiği şekilde seçin. Ödeme süreci normal şekilde devam edebilir ve işleminiz izin veriyorsa sipariş, 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 işlemi, 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
    • 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 girdikleri için müşterilerin ödeme yapmasını engellemediğinden emin olun. Mantığı, API'nin girişinin geçersiz olduğunu tekrar tekrar belirtmesi durumunda 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ğrulama olmasa bile girişini 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 vardır:

  • 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 deneme, onay adımı olmadan otomatik olarak kabul edilir.

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

Yeni bina inşaatı bu kontrolün neden önerildiğine dair iyi bir örnek sunar. 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 ödeme sayfasında girdikleri adresle devam etme seçeneğine sahip olmalıdır.

Ö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ştirme teknik belgesini indirin ve Adres doğrulaması ile ödeme, teslimat ve işlemleri iyileştirme web seminerini görüntüleyin.

Ö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®. ↩