Smartyを使用した最適化のアドレス検証の統合

アドレス検証は、eコマースプラットフォームの重要なコンポーネントです。正確な顧客データを保証し、出荷エラーを減らし、ユーザーエクスペリエンス全体を改善します。この投稿では、Optimizely（以前のEpiserver）でアドレス検証を統合する方法を説明します 賢い で smartystreets-dotnet SDK。

なぜ賢いのですか？

Smartyは次のように強力なAPIを提供します：

• AutoCompletingアドレス入力

• 国内および国際的な住所の検証

• zip/郵便コードの検証

米国固有と国際の両方のエンドポイントを提供し、グローバルなeコマースの実装に適しています。

OptimizelyでSmartyをセットアップします

1。 資格情報を構成します

まず、Smarty資格情報を保持するように構成モデルを定義します。

public class SmartyConfiguration
{
    public string ApplicationId { get; set; }
    public string ApplicationSecret { get; set; }
}

構成のセットアップを拡張します。

public static class SmartyConfigurationLoader
{
    public static IConfiguration SmartyConfiguration(this IConfiguration configuration) =>
        configuration.GetSection("SmartyConfiguration");
}

2。 CMSのSmarty設定を定義します

国外除外を管理するためのモデルを作成します。

public class SmartySettingsModel
{
    [JsonProperty("autocompleteExcludedCountries")]
    public string AutocompleteExcludedCountries { get; set; }

    [JsonProperty("verificationExcludedCountries")]
    public string VerificationExcludedCountries { get; set; }
}

ViewComponentを使用してUIに設定を表示します。

public class SmartySettingsViewComponent : ViewComponent
{
    private readonly ISmartyService _smartyService;

    public SmartySettingsViewComponent(ISmartyService smartyService)
    {
        _smartyService = smartyService;
    }

    public IViewComponentResult Invoke()
    {
        var viewModel = _smartyService.GetSettings();
        return View("~/Features/Smarty/Components/SmartySettings/Default.cshtml", viewModel);
    }
}

3。 Smartyコントローラーを実装します

コントローラーは、オートコンプリートのフロントエンドリクエストとアドレス検証を処理します。

[Route("smarty/autocomplete")]
public IActionResult Autocomplete(AutocompleteRequestModel model)


[Route("smarty/street")]
public IActionResult Street(...)

どちらのアクションもキャッシュ層を使用して、繰り返しクエリを最適化します。

4。 Smartyサービスを作成します

統合の中心はです SmartyService それはSmarty APIと通信します：

• 米国のオートコンプリート 経由 USAutocompleteProApi

• 国際オートコンプリート 経由 InternationalAutocompleteApi

• 米国の通りの検証 経由 USStreetApi

• 国際住所の検証 経由 InternationalStreetApi

例：方法：

public object Autocomplete(AutocompleteRequestModel request)
{
    // Handles US or international logic
}


public object Street(AddressModel addressModel)
{
    // Determines whether to use US or international client
}

郵便番号検証用のプレースホルダーストリート（「A」または「B」）で試してみるなどのフォールバック戦略は、信頼性を高めます（チェックアウトに完全な住所がない場合）。

クライアント側のJavaScript統合

あなたは電話することができます /smarty/autocomplete または /smarty/street JavaScriptから、アドレスの提案と検証への動きまで。例えば：

fetch(`/smarty/autocomplete?countryCode=USA&line1=123 Main`)
  .then(response => response.json())
  .then(data => {
    // Render autocomplete suggestions
  });

応答スキーマに基づいてUIインタラクションをカスタマイズします。

Smarty統合の利点

• 精度が向上しました 配送先住所

• 失敗した配送の減少

• より良い顧客体験 ライブオートコンプリート付き

• 国際住所のサポート

結論

OptimizelyでSmartyを使用したアドレス検証を統合すると、eコマースプラットフォームのユーザーエクスペリエンスを向上させることができます。 Smartyは、堅牢なAPIと思慮深いエラー処理により、グローバルなアドレスの精度の強力な同盟国になります。

2025年5月21日