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

Hedef

Bu dokümanda, yüksek kaliteli adresleri yakalamak amacıyla e-ticaret ödemelerinde Yer Otomatik Tamamlama, Adres Doğrulama API'si1 ve Haritalar'ı birleştirme yöntemleri açıklanmaktadır.

Ön koşullar

Google, aşağıdakiler konusunda bilgi sahibi olmanızı önerir:

  • Yer Otomatik Tamamlama JavaScript geliştirici dokümanları.
    • Otomatik Yer Tamamlama özelliğinin nasıl çalıştığını ve uygulama seçeneklerini teknik bir açıdan öğrenin.
  • Otomatik Yer Tamamlama için ödeme uygulaması rehberi.
    • E-ticaret ödemelerinde Otomatik Yer Tamamlama'nın uygulanmasıyla ilgili en iyi uygulamalara örnekler.
  • Doğrulama mantığınızı oluşturma odaklı Address Validation API ürün belgeleri.
    • Address Validation API'nin işleyiş şeklini teknik bir açıdan öğrenin 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 göndermek için adresi standartlaştırır ve 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 (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ı teşvik etmek, zamanında sipariş karşılama oranını 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 girmesini sağlayın:
Otomatik Yerleştirme özelliği, adres girişini hızlandırır ve giriş hatalarını azaltır, böylece müşterilerin ödeme aşamasında kolayca hareket edebilmesini sağlar. Adres Doğrulama, genel adres kalitesi hakkında geri bildirim verir, standartlaştırma ve yazım hataları gibi düzeltmeler yapar, 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 işlemleri için önerilen adres girişi iş akışı özetlenmektedir. Süreç üç adımdan oluşur:

  1. Başlangıçta adresi kaydetmek için Otomatik Yer 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örüntüleyin.

Bir sonraki adımda, her bir adımı tek tek ele alacağız.

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

JavaScript API'sini kullanarak adres giriş formunun ilk satırına Yer Otomatik Tamamlama'yı uygulayın.

Yer Otomatik Tamamlama özelliği, adres bilgilerini giren müşterilere öneriler sunar. JavaScript API kullanılarak uygulandığında, kullanıcılar yazmaya başladığında adres giriş formu alanının altında bir açılır liste görüntülenir. Bu açılır menü, Otomatik Tamamlama hizmetinden gelen ve her tuş vuruşunda güncellenen sonuçları gösterir. Kullanıcı, adresi bulmak için yeterli bilgi girdikten sonra açılır listeden adresi seçer. Bu işlem, form alanlarını adres verileriyle otomatik olarak doldurur.

Otomatik Yer Tamamlama ile kullanıcıya iki form girişi stili sağlayabilirsiniz: tüm adres alanlarını içeren bir ekran veya tek bir giriş alanı olan bir ekran. Bu tek giriş alanı, adres bileşenlerini tek tek girmek yerine kullanıcıdan, yazarken arama yapmaya başlamasını sağlar. Otomatik tamamlama adresi adresi doldurduğunda iş akışı, adres verilerini içeren form alanlarını genişletir. Böylece müşteri, bilgileri gözden geçirip düzenlemeler yapabilir (örneğin, bir apartman veya birim numarası ekleyebilir).

Tek bir giriş alanı kullanıldığında, bu akışın nasıl görünebileceğine dair bir örnek aşağıda 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, ödeme sırasında Address Validation API'nin uçtan uca entegrasyonu örneği gösterilmektedir:

resim

Bu belgede, kabul senaryoları daha sonra ele alınmaktadır.

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

Adres girişinden sonra, teslimat konumunu harita üzerinde görüntüleyerek kullanıcıya teslimat konumu için görsel onay sağlayın. Bu, müşteriye adresin doğru olduğuna dair ek güvence sağlar ve teslimat veya teslim alma hatalarını azaltı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, resimlerin web sayfası içine veya daha sonraki bir aşamada e-postayla yerleştirilmesine olanak tanır.

Ayrıntılı İnceleme: Kabul senaryoları

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

  • Düzelt: Adres düşük kaliteli. Daha fazla bilgi isteminde bulunmanız gerekir.
  • Onayla: Adres yüksek kalitede ancak giriş adresinde değişiklik içeriyor. Onay isteyebilirsiniz.
  • Kabul et: Adres yüksek kalitededir. 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 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ıtta geçersiz bir adres belirtiliyorsa girilen verileri kontrol etmek için müşteriyi 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.

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

Onayla

resim

Bu bölümde, adreslerin 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 belgelerindeki Bir adresi onaylama bölümüne bakın.

Sisteminiz çoğu zaman kullanıcıdan bir adresi onaylamasını ister. Örneğin, bir müşteri şehir adını yanlış yazar. Bu durum, Address Validation API tarafından düzeltilir. Bu düzeltmeyi müşteriye bildirmeniz gerekir. Bunun nedeni, API tarafından yapılan değişikliklerin başlangıçta girilen içeriği temelden değiştirebilmesidir.

Bilgileri müşteriye göstermek için bir geçiş reklamı penceresi kullanarak devam etmek için üç seçenek belirleyin:

  1. API tarafından döndürülen adresi onayladığınızda, düzeltilmiş adres kullanılarak ödeme süreci devam eder.
  2. Adresi orijinal olarak girildiği şekilde seçin ve Address Validation API'deki düzeltmeyi göz ardı edin. Ödeme süreci normal şekilde devam edebilir ve süreciniz izin veriyorsa gönderim öncesinde sipariş aşağı akış incelemesi için işaretlenebilir.
  3. Müşteri mesajı iptal eder veya mesajı geri çeker ve ödeme işleminin adres girişi aşamasına geri döner. Burada adresi en baştan girerek işlemi baştan başlatabilir.

Sağ taraftaki 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 için döndürdüğü belirli sinyaller hakkında bilgi edinmek için Doğrulama mantığınızı oluşturma dokümanındaki Adres kabul etme bölümüne bakın.

Bu senaryoda ödeme süreci, adres kalitesiyle ilgili olarak müşteriye herhangi bir istemde bulunulmadan bir sonraki aşamaya, yani muhtemelen ödemenin alınmasına geçmelidir. API, müşteri tarafından girilen adresin iyi kalitede ve teslimat yapılabilir olduğunu onayladı.

Aşağıdakiler gibi küçük düzeltmeler ve eklemeler içerebileceğinden siparişe karşı 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 - Cadde
    • 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 geçersiz adres girilmesi nedeniyle müşterilerin ödeme yapmasını engellemediğinden emin olun. API, girişinin geçersiz olduğunu tekrar tekrar gösterdiğinde mantığı, sonsuz döngü olasılığını önleyecek şekilde yapılandırın.

Google, müşterilere adreslerini girmeleri için en fazla iki deneme hakkı tanımanızı ve ikinci denemede, geçersiz olsa bile girişlerini kabul etmenizi önerir. İkinci denemede amaç, doğrulamadan bağımsız olarak devam etmelerine izin vermektir.

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

  • Zorla devam et: Müşteriye, adresin doğrulanmadığını açıklayan bir modal gösterin ancak yazılan adresle devam etme seçeneğine izin verin.
  • Sessiz Kabul: Adres tamamen doğrulanmamış olsa bile, onay adımı olmadan ikinci denemeyi 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 bina inşası bu kontrolün neden önerildiğine dair iyi bir örnek teşkil eder. Yeni bina inşaatının bittiği tarih ile posta adresi veritabanlarına bu binanın adresinin girildiği zaman arasında bir boşluk olabilir. Müşteriler, doğrulama olmasa bile, yazılan adresleriyle ödeme sayfasından zorla devam etme seçeneğine sahip olmalıdır.

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

Sonuç

Bu belgede, Google Haritalar'da Otomatik Tamamlama, Adres Doğrulama ve görsel onayı uygulayan ödeme adımlarına genel bir bakış sunulmaktadır. Bu belgeyi, önerilen adres girişi akışlarını izleyerek 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ğrulama ile ödeme, teslimat ve işlemleri iyileştirme web seminerini görüntüleyin.

Önerilen daha fazla bilgi:

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®'e aittir ve izinle kullanılmaktadır: CASSTM, USPS®, DPV®. ↩