Ödeme için adres doğrulama

Hedef

Bu belgede, yüksek kaliteli adresler yakalamak amacıyla e-ticaret ödeme sayfasında Yer Adı Otomatik Tamamlama, Address Validation API1 ve Haritalar'ı birleştirme yöntemleri açıklanmaktadır.

Ön koşullar

Google, aşağıdaki konular hakkında bilgi sahibi olmanızı önerir:

  • Yer Adı Otomatik Tamamlama JavaScript geliştirici belgeleri.
    • Yer Adı Otomatik Tamamlama'nın teknik açıdan işleyiş şeklini ve uygulama seçeneklerini öğrenin.
  • Yer Adı Otomatik Tamamlama için ödeme uygulaması kılavuzu.
    • E-ticaret ödeme sayfasında Yer Adı Otomatik Tamamlama'nın uygulanmasıyla ilgili en iyi uygulamalara örnekler.
  • Address Validation API ürün dokümanları, Doğrulama mantığınızı oluşturma konusuna odaklanarak.
    • Address Validation API'nin teknik açıdan nasıl çalıştığını anlayın ve adres kalitesini belirleyen sinyalleri inceleyin.

Address Validation nedir?

Address Validation API, adres kabul eden bir hizmettir. Adres bileşenlerini tanımlar ve bunları doğrular. Ayrıca, adresi posta gönderimi için standartlaştırır ve adres için en iyi bilinen 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 adres doğrulamaya neden ihtiyacınız var?

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

Müşterilerin adresi hızlı ve doğru bir şekilde girmesine yardımcı olun:
Yer Adı Otomatik Tamamlama, adres girişini hızlandırır ve giriş hatalarını azaltarak müşterilerin ödeme adımına kolayca geçmesini sağlar. Address Validation, genel adres kalitesi hakkında geri bildirim verir, standardizasyon ve yazım hataları gibi düzeltmeler yapar ve konut veya ticari gösterge sağlama gibi meta verileri iyileştirir (belirli bölgelerde kullanılabilir).

Uygulamaya Genel Bakış

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

  1. Adresi ilk olarak yakalamak için Yer Adı Otomatik 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.

Şimdi her adımı ayrı ayrı inceleyelim.

1. adım: Yer Adı Otomatik Tamamlama hizmetini kullanarak adres girişi akışı

Adres giriş formunun ilk satırında JavaScript API'yi kullanarak Place Autocomplete'i uygulayın.

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

Yer Adı Otomatik Tamamlama ile kullanıcıya iki form giriş stili sunabilirsiniz: tüm adres alanlarının bulunduğu bir ekran veya tek bir giriş alanının bulunduğu bir ekran. Bu tek giriş alanı, kullanıcıdan adres bileşenlerini tek tek girmek yerine yazmaya başladığı anda arama yapmasını ister. Otomatik tamamlama, adresi doldurduktan sonra iş akışı, form alanlarını adres verileriyle genişletir. Böylece müşteri, adresi inceleyip düzenleyebilir (ör. apartman dairesi veya birim numarası ekleyebilir).

Tek bir giriş alanı kullanılarak bu akışın nasıl görünebileceğine dair bir örneği aşağıda bulabilirsiniz:

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 önerilir. Kullanıcı, adres formunda İleri veya Devam düğmesini tıkladığında Adres Doğrulama API'sine bir çağrı tetikleyin. 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, ödeme sırasında Address Validation API'nin uçtan uca entegrasyonuna dair bir örnek gösterilmektedir:

resim

Bu dokümanın ilerleyen bölümlerinde adres kabul senaryoları ele alınmaktadır.

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

Adres girildikten sonra, teslimat konumunu haritada göstererek kullanıcıya görsel onay verin. Bu sayede müşteriye adresin doğru olduğu konusunda ek güvence verilir ve teslimat ya da teslim alma hataları azaltılı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österen etkileşimli bir harita sağlar. Maps Static API, web sayfasına veya daha sonra e-postaya resim yerleştirilmesine olanak tanır.

Ayrıntılı İnceleme - Adres kabulü senaryoları

Address Validation API yanıtları üç ana senaryoda kategorize edilebilir:

  • Düzelt: Adres kalitesi düşük. Daha fazla bilgi istemeniz gerekir.
  • Onayla: Adres yüksek kaliteli ancak giriş adresinden farklı. Onay istemi görünebilir.
  • Kabul et: Adres yüksek kalitededir. Sağlanan adresi kabul edebilirsiniz.

Bu kavram, Adres Doğrulama API dokümanlarının Doğrulama mantığınızı oluşturma bölümünde ele alınmaktadır. Bu bölümde her senaryoyu ayrı ayrı inceleyeceğiz.

Düzelt

resim

Bu bölümde, adres girişinin nasıl çözüleceğ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ümanındaki Adres düzeltme bölümüne bakın.

Address Validation API'den gelen yanıt geçersiz bir adres olduğunu 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 Address Validation API'ye yeniden gönderilmelidir.

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

Onayla

resim

Bu bölümde, adreslerin nasıl onaylanacağı gösterilmektedir. Adres Doğrulama API'sinin, 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ındaki Adresi 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ış yazabilir ve bu durumda Adres Doğrulama API'si bu hatayı düzeltir. 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ş reklamı kalıbı kullanın. Bu kalıp, 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. Address Validation API'nin düzeltmesini yok sayarak adresi ilk girildiği şekilde seçin. Ödeme işlemi normal şekilde devam edebilir ve süreciniz izin veriyorsa sipariş, gönderimden önce alt inceleme için işaretlenebilir.
  3. Müşteri, modülü iptal eder veya modülden çıkar. Bu durumda, ödeme sürecinin adres girişi aşamasına geri döner ve adresi sıfırdan tekrar girerek süreci baştan başlatabilir.

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

Kabul et

Bu bölümde, adresin nasıl kabul edileceği gösterilmektedir. Address Validation API'nin 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ındaki Adres kabul etme bölümüne bakın.

Bu senaryoda, ödeme işlemi bir sonraki aşamaya (büyük olasılıkla ödeme alma) geçmeli ve müşteriye adres kalitesiyle ilgili herhangi bir istem gösterilmemelidir. API, müşteri tarafından girilen adresin kaliteli ve teslimata uygun olduğunu onayladı.

Siparişle ilgili olarak Address Validation API'den döndürülen adres verilerini kullanmanızı öneririz. Bu verilerde, aşağıdakiler gibi küçük düzeltmeler ve eklemeler olabilir:

  • Büyük harf kullanımı
  • Biçimlendirme düzeltmeleri (ör.)
    • Street to St
    • Adres bileşenlerinin doğru sıralaması
  • ABD'de ZIP+4.

Uygulamada Dikkat Edilmesi Gereken Hususlar

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

Google, müşterilere adreslerini girmeleri için en fazla iki şans vermenizi ve ikinci denemede, doğrulanmasa bile girişlerini kabul etmenizi önerir. İkinci denemede, doğrulama durumuna bakılmaksızın devam etmelerine izin verilir.

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

  • Devam etmeye zorlama: Müşteriye, adresin doğrulanmadığını açıklayan bir modal gösterin ancak yazılan adresle devam etme seçeneği sunun.
  • Sessiz kabul: Adres tam olarak doğrulanmasa bile ikinci denemeyi onay adımı olmadan otomatik olarak kabul edin.

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 ekstra önlem, hataları yakalamanızı sağlar.

Yeni bina inşaatı, bu kontrolün neden önerildiğini gösteren iyi bir örnektir. Yeni bir binanın inşaatının tamamlanması ile binanın adresinin posta adresi veritabanlarına eklenmesi arasında bir süre geçebilir. Müşteriler, yazılan adres doğrulanmasa bile ödeme sayfasında zorunlu olarak ilerleme seçeneğine sahip olmalıdır.

Ödeme oturumu tamamlandıktan sonra, belirli bir adres doğrulama denemesi hakkında Google'a geri bildirim göndermek için isteğe bağlı olarak provideValidationFeedback yöntemini kullanın.

Sonuç

Bu belgede, Google Haritalar'da Otomatik Tamamlama, Address Validation ve görsel onay uygulayan ödeme adımlarına genel bir bakış sunulmuştur. Önerilen adres girişi akışlarını uygulayarak uygulamanızı tasarlamak için bu dokümanı başlangıç noktası olarak kullanın.

Sonraki Adımlar

Önerilen ek kaynaklar:

Katkıda bulunanlar

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

  1. ABD Posta Servisi'nin münhasır olmayan lisans sahibidir. Aşağıdaki ticari markalar United States Postal Service®'e aittir ve izin alınarak kullanılmaktadır: CASS™, USPS®, DPV®. ↩