Adres doğrulama çözümü seçme

Hedef

Adres Doğrulama, çeşitli kullanım alanları için değer sağlar. Test sonuçlarının ham kalitesinin ötesinde, keşfetmenizi önerdiğimiz önemli hususlar vardır. Örneğin: Yer Otomatik Tamamlama ve Haritalar gibi kullanıcı akışında uyumlu ürünlerin bütünsel görünümü, bölgesel kullanılabilirlik ve kurumsal güven ve güvenilirlik.

Address Validation API'yi değerlendirme aşamasına geldiğinizde, testiniz kapsamında kullanmanızı önerdiğimiz bazı yönergeleri burada bulabilirsiniz.

Bu testin hedefleri şunlardır:

1. Address Validation API'nin kullanım alanınız için uygun olduğunu onaylayın.
2. Address Validation API'nin çözüm gereksinimlerinizi nasıl karşıladığını doğrulayın. Örneğin:
   • Kaliteli adresleri belirleme
   • Düşük kaliteli girişleri ele almak için uyarı.
   • Çıkarımlar, değiştirmeler ve yazım düzeltmeleri dahil olmak üzere adres verilerinde düzeltmeler yapma
   • Gönderim için biçimlendirilmiş bir adres sağlama
   • Eksik veya yanlış alt tesis verileri hakkında uyarı (yalnızca ABD).
3. API'yi uygulayarak ölçülebilir bir fayda elde edeceğinizden emin olun.

Testinizi yaptıktan sonra yukarıdaki soruları yanıtlayabilir ve API'nin işletmeniz için uygun olup olmadığını belirleyebilirsiniz.

Verilerinizi hazırlama

Testiniz, mevcut adres verilerinizin bir örneği üzerinde yapılmalıdır. Test için verileri kendiniz seçmeyin. Bunun yerine, faaliyet gösterdiğiniz coğrafi bölgeleri temsil eden rastgele örnekler seçin. Yani hem ABD'de hem de Birleşik Krallık'ta faaliyet gösteriyorsanız ancak işletmenizin% 70'i Birleşik Krallık'ta, %30'u ise ABD'de faaliyet gösteriyorsa örnek bu dağılımı yansıtmalıdır.

Kayıt noktasındaki adresleri kullanın. Örneğin, e-ticaret ödeme adımınızda adres doğrulamayı uygulamayı planlıyorsanız Address Validation API'nin uygulanmasıyla değiştirilebilecek mevcut işlemler yapılmadan önce, müşterilerinizin formda girdiği adresleri kullanın.

Test için yaklaşık 5.000-10.000 kayıtlık bir örneklem boyutu hazırlayın.

API'yi çağırma

Bölüm ön koşulu: Adres doğrulama isteği gönderme hakkında bilgi edinin.

Verileri hazırladıktan sonra her adres kaydını API'ye göre çalıştırmanız gerekir.

API'yi çağırmayla ilgili yönergeler için Address Validation API belgelerine bakın. Ayrıca, adresleri yüksek hacimle işlemek için Address Validation API'yi kullanmayla ilgili en iyi uygulamaları açıklayan bir makalemiz de mevcuttur.

Bu adımın sonucu, her adres kaydı için API'den alınan veri çıkışı olmalıdır. Ardından, API'nin kullanım alanınıza uygunluğunu belirlemek için sonuçları analiz edebilirsiniz. E-tablo, veritabanı veya başka bir araç kullanıp kullanmayacağınıza siz karar verirsiniz.

Sonuçları inceleme

Bölüm ön koşulu: Doğrulama yanıtını nasıl ele alacağınızı, özellikle de Düzelt, Onayla ve Kabul Et kavramlarını anlayın.

Bu bölümde, çözümün uygunluğunu değerlendirmek için analiz edebileceğiniz çıkış senaryolarını ele alacağız.

Bu dokümanda ele alınan önemli API alanlarına genel bakış

Geçerli adresleri inceleme

Sisteminizin geçerli olarak kabul edeceği adres grubunu belirlemek için API'den döndürülen verileri sıralayın. API'den aranacak temel sinyaller şunlardır:

• verdict.validationGranularity, PREMISE veya daha iyi bir değer içeriyor.
• verdict.addressComplete true.
• Tahmine dayalı veya değiştirilmiş bileşen yoktur.

Daha fazla bilgi için adres kabul etme başlıklı makaleyi inceleyin.

Bu alıştırmanın çıktısı, sisteminiz tarafından geçerli olarak kabul edilecek adres verilerinin bir alt kümesi olmalıdır. Bu aşamada şunları belirleyebilirsiniz:

• Kabul oranı kabul edilebilir mi?
• Mevcut bir adres doğrulama iş akışı kullanıyorsanız kabul oranı eşdeğer mi yoksa daha iyi mi?

Örnek: Geçerli adres

Sonuç

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

Geçersiz adresleri inceleme

Bu adım, geçersiz olarak işaretlenmiş adres verilerinin bir kısmını manuel olarak inceleme ve Address Validation API kullanılmadan bu geçersiz adresin alt akış sorunlarına neden olup olmayacağını görme fırsatı sunar.

Sisteminizin geçersiz olarak işaretleyeceği adres grubunu belirlemek için API'den döndürülen verileri sıralayın. API'den aranacak temel sinyaller şunlardır:

• verdict.validationGranularity, risk düzeyinize bağlı olarak OTHER veya ROUTE olarak ayarlanır.
• verdict.addressComplete false.

Daha fazla bilgi için adres düzeltme bölümüne bakın.

Bu alıştırmanın çıktısı, sisteminiz tarafından geçersiz olarak işaretlenecek adres verilerinin bir alt kümesi olmalıdır. Bu noktada, geçersiz yüzde oranının kabul edilip edilemeyeceğini belirleyebilirsiniz.

Adreslerin geçersiz olarak işaretlenmesinin, Address Validation API'nin işlevselliğinin temel bir parçası olduğunu ve geçersiz olarak işaretlenen adreslerin oranının yüksek olmasının API'nin kötü performans gösterdiği anlamına gelmediğini unutmayın. API, adresle ilgili bir sorun olduğu konusunda size bilgi veriyor. Bu, hataları daha sonra soruna yol açmadan önce yakalayarak iş akışınızda verimlilik sağlayabilir.

Örnek: Geçersiz adres

Sonuç

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Eksik veya onaylanmamış bileşenleri inceleme

Bu aşamada eksik veya onaylanmamış bileşenler de incelenebilir. Bu, iadedeki Adres nesnesinin bir parçasıdır. Bu iki alan missingComponentTypes ve unconfirmedComponentTypes'dur.

Bir adresin API tarafından geçersiz olarak işaretlenme nedenini tespit etmek ve yanlış olan alanları veri toplama noktasına geri besleyerek adresin geçerli olmasını sağlayacak doğru bilgileri toplamak için bu alanları kullanın. Bu, API'nin verilerinizin kalitesi hakkında size belirli bilgiler sağlayarak değer sunmasının bir yoludur.

Örnek: Eksik ve onaylanmamış bileşen

Sonuç

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

Eksik ve onaylanmamış bileşenler

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

Düzeltme içeren adresleri inceleme

Address Validation API, giriş verilerinde düzeltmeler yapabilir, geçersiz olabilecek bir adres girişini alıp geçerli adres verileri döndürebilir. Bu, API'nin değer katma yöntemlerinden biridir ve testin bir parçası olarak bu özelliği yakalamak önemlidir.

Aramanız gereken önemli sinyaller şunlardır:

• inferred, replaced veya spellCorrected, addressComponents'ten herhangi birinde true olarak ayarlanmışsa
• verdict.hasInferredComponents veya verdict.hasReplacedComponents, true olarak ayarlandı.

Daha fazla bilgi için adresi onaylama bölümüne bakın.

Bu alıştırmanın çıktısı, API tarafından düzeltme uygulanmış adres verilerinin bir alt kümesi olmalıdır.

API'nin verileriniz üzerinde, aşağı akış iş akışınızdaki sürtünmeyi azaltacak düzeltmeler yapıp yapmadığını belirlemek için bu verilerin bir kısmı manuel olarak incelenebilir.

Örnek: Düzeltme içeren adres

addressComponent numaralı rota

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[Yalnızca ABD] Eksik veya yanlış alt tesis verileriyle adresi inceleme

Adres Doğrulama API'si, ABD adresleri için bir alt tesisin eksik veya yanlış olup olmadığını belirleyebilir.

Aramanız gereken önemli sinyaller şunlardır:

• Adres nesnesinde:
  • unconfirmedComponentTypes, subpremise değerini içeriyor
  • missingComponentTypes, subpremise değerini içeriyor
• UspsData nesnesinde:
  • dpvConfirmation D (alt tesis eksik)
  • dpvConfirmation S (alt tesis onaylanmadı)

Daha fazla bilgi için Amerika Birleşik Devletleri adreslerini işleme bölümüne bakın.

Bu test, verilerinizdeki eksik veya yanlış alt tesislerle (ör. daire numaraları) ilgili bir sorun olup olmadığını gösterir. Bu durum, özellikle yayınlama kullanım alanları için yayın sonrası sorunlara neden olabilir. Address Validation API, bu durumu daha erken tespit ederek iş akışınıza değer katabilir ve düzeltilmiş verileri toplamak için adımlar uygulamanıza olanak tanır.

Örnek: Alt tesis eksik

Eksik bileşen

"missingComponentTypes": [
    "subpremise"
]

USPS veri DPV onayı

"dpvConfirmation": "D"

[Yalnızca ABD] USPS standardizedAddress özelliğini inceleme

Address Validation API, ABD adresleri için USPS standartlaştırılmış adresini de döndürür. Bu, özellikle gönderi etiketlerinize USPS biçimli adreslerin basılması gerekiyorsa önemlidir.

Bu verileri görüntülemek ve iş akışınıza değer katıp katmadığını belirlemek için UspsAddress incelenebilir.

Örnek: USPS standartlaştırılmış adresi

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

Sonuç

Test etmeye başlayın: Doğru adres verilerinden emin olmak, müşteri deneyimini iyileştirmek ve işletme operasyonlarınızı kolaylaştırmak için Address Validation API testinize hemen başlayın. Yukarıda belirtilen test senaryolarını uyguladıktan sonra, Address Validation API'nin iş akışınıza değer katapmayacağını belirlemek için gereken bilgilere sahip olursunuz.

Önerilen daha fazla okuma:

• Address Validation API geliştirici dokümanları
• Adresleri yüksek hacimle işlemek için Address Validation API'yi kullanma
• E-ticaret Ödemesi için Adres Doğrulaması

Katkıda bulunanlar

Henrik Valve | DevX Mühendisi