ドキュメント Experience Platform モバイルアプリチュートリアル

Web ビューの処理

Last update: Thu Sep 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

初心者
中級
開発者

モバイルアプリで WebView を使用してデータ収集を処理する方法を説明します。

前提条件

SDK がインストールおよび設定された状態で、アプリケーションが正常に構築および実行されました。

学習目標

このレッスンでは、次の操作を行います。

アプリの web ビューに関して特別に考慮する必要がある理由を理解します。
トラッキングの問題を防ぐために必要なコードを理解します。

潜在的なトラッキングの問題

個別（Experience Cloud ID）の ECID は、アプリのネイティブ部分と、アプリ内の WebView からデータを送信する際に生成されます。これらの別々の ECID により、ヒットが切断され、訪問および訪問者データが水増しされます。 ECID について詳しくは、ECID の概要を参照してください。

切断されたヒットと水増しされたデータを解決するには、アプリのネイティブ部分から、アプリで使用する可能性のある WebView にユーザーの ECID を渡す必要があります。

WebView 内で使用されるAEP Edge ID 拡張機能は、現在の ECID を収集し、新しい ID のリクエストをAdobeに送信する代わりに URL に追加します。次に、実装はこの ECID を使用して URL をリクエストします。

実装

Web 表示を実装するには：

iOS

Luma/Luma/Views/Info/TermsOfServiceSheet に移動し、func loadUrl() クラス内の final class SwiftUIWebViewModel: ObservableObject 関数を探します。 Web ビューを処理する次の呼び出しを追加します。

code language-swift

code language-swift
`// Handle web view AEPEdgeIdentity.Identity.getUrlVariables {(urlVariables, error) in if let error = error { print("Error with Webview", error) return; } if let urlVariables: String = urlVariables { urlString.append("?" + urlVariables) guard let url = URL(string: urlString) else { return } DispatchQueue.main.async { self.webView.load(URLRequest(url: url)) } } Logger.aepMobileSDK.info("Successfully retrieved urlVariables for WebView, final URL: \(urlString)") }`

// Handle web view
AEPEdgeIdentity.Identity.getUrlVariables {(urlVariables, error) in
    if let error = error {
        print("Error with Webview", error)
        return;
    }

    if let urlVariables: String = urlVariables {
        urlString.append("?" + urlVariables)
        guard let url = URL(string: urlString) else {
            return
        }
        DispatchQueue.main.async {
            self.webView.load(URLRequest(url: url))
        }
    }
    Logger.aepMobileSDK.info("Successfully retrieved urlVariables for WebView, final URL: \(urlString)")
}

AEPEdgeIdentity.Identity.getUrlVariables API は、ECID などのすべての関連情報を含むように URL の変数を設定します。この例では、ローカルファイルを使用していますが、同じ概念がリモートページにも適用されます。

Identity.getUrlVariables API について詳しくは、Edge Network拡張機能 API リファレンスガイドを参照してください。

Android

Android /app/kotlin+java/com.adobe.luma.tutorial.android/views/WebViewModel に移動し、fun loadUrl() で class WebViewModel: ViewModel() 関数を探します。 Web ビューを処理する次の呼び出しを追加します。

code language-kotlin

code language-kotlin
`// Handle web view Identity.getUrlVariables { urlVariables = it val baseUrl = getHtmlFileUrl("tou.html") val finalUrl = if (urlVariables.isNotEmpty()) { "$baseUrl?$urlVariables" } else { baseUrl } Handler(Looper.getMainLooper()).post { webView.loadUrl(finalUrl) } MobileSDK.shared.logInfo("TermsOfServiceSheet - loadUrl: Successfully loaded WebView with URL: $finalUrl") }`

// Handle web view
Identity.getUrlVariables {
    urlVariables = it
    val baseUrl = getHtmlFileUrl("tou.html")

    val finalUrl = if (urlVariables.isNotEmpty()) {
        "$baseUrl?$urlVariables"
    } else {
        baseUrl
    }

    Handler(Looper.getMainLooper()).post {
        webView.loadUrl(finalUrl)
    }
    MobileSDK.shared.logInfo("TermsOfServiceSheet - loadUrl: Successfully loaded WebView with URL: $finalUrl")
}

Identity.getUrlVariables API は、ECID などのすべての関連情報を含むように URL の変数を設定します。この例では、ローカルファイルを使用していますが、同じ概念がリモートページにも適用されます。

Identity.getUrlVariables API について詳しくは、Edge Network拡張機能 API リファレンスガイドを参照してください。

アプリでの検証

コードを実行するには：

設定手順の節を参照して、シミュレーターまたはデバイスをAssuranceに接続します。
アプリの設定に移動します
「View…」ボタンをタップして Terms of Use を表示します。

iOS

{width="300"}

{width="300"}

Android

{width="300"}

{width="300"}

Assurance での検証

Assurance UI で、{com.adobe.griffon.mobile ベンダーの {0 Edge ID 応答 URL 変数 イベントを探します。

イベントを選択し、ACPExtensionEventData オブジェクトの urlvariable フィールドを確認し、URL に adobe_mc、mcmid および mcorgid のパラメーターが存在することを確認します。

webview 検証 {modal="regular"}

urvariables フィールドの例を以下に示します。

オリジナル（エスケープ文字付き）

code language-html
`adobe_mc=TS%3D1636526122%7CMCMID%3D79076670946787530005526183384271520749%7CMCORGID%3D7ABB3E6A5A7491460A495D61%40AdobeOrg`

美しい

code language-html
`adobe_mc=TS=1636526122\|MCMID=79076670946787530005526183384271520749\|MCORGID=7ABB3E6A5A7491460A495D61@AdobeOrg`

残念ながら、web セッションのデバッグには制限があります。例えば、ブラウザーでAdobe Experience Platform Debuggerを使用して webview セッションのデバッグを続行することはできません。

NOTE

これらの URL パラメーターを使用した訪問者のステッチは、Platform Web SDK（バージョン 2.11.0 以降）および VisitorAPI.js の使用時にサポートされます。

SUCCESS

これで、Adobe Experience Platform Mobile SDKで既に発行されている ECID と同じ ECID を使用して、Web ビュー内の URL に基づいたコンテンツを表示するように、アプリを設定しました。

Adobe Experience Platform Mobile SDKの学習にご協力いただき、ありがとうございます。ご不明な点がある場合や、一般的なフィードバックをお寄せになる場合、または今後のコンテンツに関するご提案がある場合は、この Experience League Community Discussion の投稿でお知らせください

次のトピック：ID

recommendation-more-help

9fed61f5-c338-47ad-8005-0b89a5f4af8b