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

Hedef

Bu belgede, yüksek kaliteli adresler yakalamak amacıyla e-ticaret ödemesinde Yer Otomatik Tamamlama, Adres Doğrulama API'si1 ve Haritalar'ı birleştirme 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ı.
    • Otomatik Yer Tamamlama'nın işleyiş şeklini ve uygulama seçeneklerini teknik bir açıdan anlayın.
  • Otomatik Yer Tamamlama için ödeme uygulaması kılavuzu.
    • E-ticaret ödemelerinde Otomatik Yer Tamamlama uygulamasıyla ilgili en iyi uygulamalara örnekler.
  • Doğrulama mantığınızı oluşturma konusuna odaklanarak Address Validation API ürün belgeleri.
    • Address Validation API'nin işleyiş şeklini teknik bir açıdan anlayın ve adres kalitesini belirleyen sinyalleri inceleyin.

Adres doğrulama nedir?

Address Validation API, adres kabul eden bir hizmettir. Adres bileşenlerini tanımlar ve doğrular. Ayrıca, postalama için adresi standart hâle getirir ve bunun için 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 kalitesi hakkında geri bildirim verir, standartlaştırma ve yazım hataları gibi düzeltmeler yapar ve bir konut ya da ticari gösterge sağlama gibi meta verileri geliştirir (belirli bölgelerde kullanılabilir).

Uygulamaya Genel Bakış

Bu bölümde, e-ticaret ödeme işlemleri için önerilen adres girişi iş akışı özetlenmektedir. 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 harita üzerinde görüntüleyin.

Daha sonra, her adımı tek tek 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.

Otomatik Yer Tamamlama, müşteri adres bilgilerini girerken öneriler sunar. JavaScript API kullanılarak uygulandığında, kullanıcılar yazmaya başladığında adres girişi form alanının altında bir açılır liste görünür. Bu açılır 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.

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ının adres bileşenlerini ayrı ayrı girmek yerine, yazarken aramaya başlamasını sağlar. 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ı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, adresin geçerli ve eksiksiz olduğunu onaylamak için ödeme sırasında Adres Doğrulama API'sini ç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'nin çağrılmasını önerir.

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

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 konumunu haritada göstererek teslimat yerinin görsel onayını sağlayın. Bu sayede müşteriye adresin doğru olduğuna dair ek güvence verilir ve teslimat veya teslim alma hataları azalır.

Harita, ödeme işlemi sırasında gösterilebilir veya işlem onay e-postasında 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ı İ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 giriş adresinde değişiklikler var. Onay isteyebilirsiniz.
  • Kabul et: Adres yüksek kalitelidir. Belirtilen 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 edinmek için "Build your verification logicd" (Doğrulama mantığınızı oluşturun) dokümanlarındaki Adresi düzeltme bölümüne göz atın.

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 yapılan düzeltmelerin geçerli olduğundan emin olmak için Address Validation API'ye yeniden gönderilmesi gerekir.

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 üzere döndürdüğü belirli sinyaller hakkında bilgi için "Build your verification logic" belgelerindeki Adresi onaylama bölümüne göz atı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 Validation API 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 değeri temel olarak değiştirebilmesidir.

Bilgileri müşteriye göstermek için bir geçiş reklamı penceresi kullanın ve devam etmek için üç seçeneği etkinleştirin:

  1. API'nin döndürdüğü adresi onaylayın. Ardından, düzeltilmiş adresi kullanarak ödeme işlemi devam eder.
  2. Address Validation API'den yapılan düzeltmeyi yok sayarak ilk olarak girildiği adresi 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 kalıcı iletişim kutusunu iptal eder veya iptal eder. Ardından ödeme işleminin adres giriş aşamasına geri döner ve süreci yeniden başlatarak adresi en baştan girebilir.

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. Address Validation API'nin bir adresin iyi kalitede olduğunu ve kabul edilmesi gerektiğini belirtmek üzere döndürdüğü belirli sinyaller hakkında bilgi için "Doğrulama mantığınızı oluşturun" dokümanlarındaki Adresi kabul etme bölümüne bakın.

Bu senaryoda, ödeme işlemi bir sonraki aşama olan ödeme yakalamaya geçilmeli ve müşteriye kaliteyle ilgili herhangi bir yönlendirme yapılmamalıdır. API, müşterinin girdiği adresin iyi kalitede ve teslimatta olduğunu onayladı.

Address Validation API'den döndürülen adres verilerini siparişin yerine kullanmanızı öneririz. Çünkü bu veriler, aşağıdakiler gibi küçük düzeltme ve eklemeleri içerebilir:

  • 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 ile kullanılabilir.

Uygulamada Dikkat Edilmesi Gereken Hususlar

Adres kabul mantığınızı oluştururken uygulamanızın, geçersiz adres girmeleri nedeniyle 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ğrulanmamış olsa bile girişini kabul etmenizi önerir. İkinci denemede amaç, doğrulamadan bağımsız olarak devam etmelerine izin vermektir.

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

  • Zorla devam et: Müşteriye, adresin doğrulanmadığını açıklayan bir kalıcı adres gösterin ancak girilen adresle devam etme seçeneğine izin verin.
  • 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 bina inşaatının bitmesi ile bu binanın adresinin posta adresi veri tabanlarına doldurulması arasında bir boşluk olabilir. Müşteriler, doğrulama yapmasalar bile, kullandıkları adresle ödeme sayfasında zorla 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 belgede otomatik tamamlama, adres doğrulama ve Google Haritalar'da görsel onayı uygulayan ödeme akışına dair genel bir bakış sunulmaktadır. Önerilen adres giriş akışlarını izleyerek bu belgeyi, uygulamanızı tasarlamak için başlangıç noktası olarak 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 ek okuma:

Katılımcılar

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 ait olup izinle kullanılmaktadır: CASSTM, USPS®, DPV®.