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

Hedef

Bu belgede, yüksek kaliteli adresler elde etmek amacıyla e-ticaret ödeme işleminde Yer Otomatik Tamamlama, Adres Doğrulama API'si1 ve Haritalar'ı birleştirme yöntemleri açıklanmaktadır.

Ön koşullar

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

  • Otomatik Yer Tamamlama JavaScript geliştirici dokümanları.
    • Yer otomatik tamamlama özelliğinin teknik açıdan nasıl çalıştığını ve uygulama seçeneklerini öğrenin.
  • Otomatik Yer Tamamlama için ödeme uygulama rehberi.
    • E-ticaret ödemesinde Yer Otomatik Tamamlama'nın uygulanmasıyla ilgili en iyi uygulamalara dair örnekler.
  • Address Validation API ürün dokümanları, Doğrulama mantığınızı oluşturma konusuna odaklanarak.
    • Adres Doğrulama API'sinin nasıl çalıştığını teknik 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 posta adresini standartlaştırır 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 Coding Accuracy Support System (CASS™)'i etkinleştirebilirsiniz.

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

Sipariş sürecinde doğru adresleri toplayın:
Bu, başarılı teslimatları teşvik etmek, zamanında yerine getirme oranını 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ı azaltır. Böylece müşteriler ödeme sürecinde kolayca ilerleyebilir. Adres Doğrulama, genel adres kalitesi hakkında geri bildirim verir, standartlaştırma ve yazım hataları gibi düzeltmeler yapar ve meta verileri geliştirir (ör. konut veya ticari gösterge sağlar) (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ışı açıklanmaktadır. Bu süreç üç adımdan oluşur:

  1. Adresi ilk olarak yakalamak için Yer Otomatik Tamamlama'yı 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 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 Place Autocomplete'i uygulayın.

Yer Otomatik Tamamlama, müşteri 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 bilgiyi girdikten sonra açılır listeden 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şi 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ının adres bileşenlerini tek tek girmesi 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, örneğin bir daire veya birim numarası ekleyerek adresi inceleyip düzenleyebilir.

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 yapılan çağrıyı 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ı, ödeme sırasında Address Validation API'nin uçtan uca entegrasyonuna dair bir örnek göstermektedir:

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, 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 veya 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'ler kullanılarak gerçekleştirilebilir.

Maps JavaScript API, kullanıcı konumunu göstermek için 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ı inceleme: Adres kabulü senaryoları

Address Validation API yanıtları üç ana senaryo halinde sınıflandırılabilir:

  • Düzeltin: Adresin kalitesi düşük. Daha fazla bilgi istemelisiniz.
  • Onayla: Adres yüksek kaliteli ancak giriş adresinden farklı. Onay istenebilir.
  • 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ınmaktadır. Bu bölümde her senaryoyu ayrı ayrı inceleyeceğiz.

Düzelt

resim

Bu bölümde, adres girişinin nasıl düzeltileceği gösterilmektedir. Adres Doğrulama API'sinin 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ındaki Adresi düzeltme bölümüne bakın.

Adres Doğrulama API'sinden gelen yanıt geçersiz bir adresi 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 Adres Doğrulama API'sine yeniden göndermelidir.

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, adresin 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ış yazıyor ve bu yanlış, Adres Doğrulama API'si tarafından düzeltiliyor. 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 bir 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üzeltilmiş adres kullanılarak devam eder.
  2. Adres Doğrulama API'sinden gelen düzeltmeyi yoksayarak adresi ilk girildiği şekliyle seçin. Ödeme işlemi normal şekilde devam edebilir ve sipariş, süreciniz izin veriyorsa gönderilmeden önce daha ayrıntılı bir inceleme için işaretlenebilir.
  3. Müşteri, ödeme sürecinin adres girişi aşamasına geri dönerek modalı iptal eder veya modalda geri gider. Burada adresi baştan girebilir ve süreci yeniden 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. 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ındaki Adresi kabul etme bölümüne bakın.

Bu senaryoda, ödeme süreci 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üşterinin girdiği adresin kaliteli ve teslim edilebilir olduğunu onaylamıştır.

Adres Doğrulama API'sinden döndürülen adres verilerini siparişle karşılaştırmanı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ıralanması
  • 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, girişin 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 iki şans vermenizi ve ikinci denemede, doğrulanmamış olsa bile girişlerini kabul etmenizi önerir. İkinci denemede, doğrulama işleminden bağımsız olarak devam etmelerine izin verilir.

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

  • Devam etmeye zorla: Müşteriye, adresin doğrulanmadığını açıklayan bir modal gösterin ancak yazılan adresle devam etme seçeneğini etkinleştirin.
  • Sessiz Kabul: Adres tam olarak doğrulanmasa bile ikinci deneme, onay adımı olmadan otomatik olarak kabul edilir.

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 bina inşaatı, bu kontrolün neden önerildiğini iyi bir şekilde gösterir. Yeni bir binanın inşaatı tamamlandığında bu binanın adresinin posta adresi veritabanlarına girilmesi arasında bir süre geçebilir. Müşteriler, yazılan adres doğrulanmasa bile ödeme sayfasına zorunlu olarak devam etme seçeneğine sahip olmalıdır.

Bir ödeme oturumu tamamlandıktan sonra, belirli bir adres doğrulama girişimiyle ilgili Google'a geri bildirim göndermek için isteğe bağlı olarak provideValidationFeedback<0x0x0A> yöntemini kullanın.

Sonuç

Bu belgede, Google Harita'da otomatik tamamlama, adres doğrulama ve görsel onay özelliklerinin uygulandığı bir ödeme akışına genel bakış sunulmuştur. Uygulamanızı tasarlarken başlangıç noktası olarak bu dokümandan yararlanın ve önerilen adres girişi akışlarını izleyin.

Sonraki Adımlar

Güvenilir adreslerle ödeme, teslimat ve operasyon süreçlerini iyileştirme başlıklı teknik incelemeyi indirin ve Adres Doğrulama ile ödeme, teslimat ve operasyon süreçlerini iyileştirme başlıklı web seminerini izleyin.

Daha fazla bilgi için önerilen 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 sahibi. Aşağıdaki ticari markalar, United States Postal Service®'e aittir ve izinle kullanılmaktadır: CASS™, USPS®, DPV®. ↩