DokumentationExperience PlatformTutorial für Mobile Apps

Verarbeiten von WebViews

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

Erstellt für:

  • Einsteiger
  • Fortgeschrittener
  • Entwickler

Erfahren Sie, wie Sie die Datenerfassung mit WebViews in einer Mobile App handhaben.

Voraussetzungen

  • App mit installierten und konfigurierten SDKs erfolgreich erstellt und ausgeführt.

Lernziele

In dieser Lektion erfahren Sie Folgendes:

  • Erfahren Sie, warum Sie WebViews in Ihrer App besonders berücksichtigen müssen.
  • Den Code verstehen, der zum Verhindern von Tracking-Problemen erforderlich ist.

Mögliche Tracking-Probleme

Separate ECIDs (Experience Cloud Identity) werden generiert, wenn Sie Daten aus dem nativen Teil Ihrer App und aus einer WebView innerhalb der App senden. Diese separaten ECIDs führen zu getrennten Treffern und überhöhten Besuchs- und Besucherdaten. Weitere Informationen zur ECID finden Sie in der ECID-Übersicht.

Um die getrennten Treffer und überhöhten Daten zu beheben, müssen Sie die ECID des Benutzers aus dem nativen Teil Ihrer App an eine WebView übergeben, die Sie möglicherweise in Ihrer App verwenden möchten.

Die in der WebView verwendete AEP Edge Identity-Erweiterung erfasst die aktuelle ECID und fügt sie zur URL hinzu, anstatt eine Anfrage für eine neue ID an Adobe zu senden. Die Implementierung verwendet dann diese ECID, um die URL anzufordern.

Implementierung

So implementieren Sie die Web-Ansicht:

iOS

Navigieren Sie zu Luma > Luma > Views > Info > TermsOfServiceSheet und suchen Sie die func loadUrl() in der final class SwiftUIWebViewModel: ObservableObject. Fügen Sie den folgenden Aufruf hinzu, um die Web-Ansicht zu verarbeiten:

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)")
}

Die AEPEdgeIdentity.Identity.getUrlVariables-API richtet die Variablen für die URL so ein, dass sie alle relevanten Informationen wie ECID und mehr enthalten. Im Beispiel verwenden Sie eine lokale Datei, aber für Remote-Seiten gelten dieselben Konzepte.

Weitere Informationen zur Identity.getUrlVariables-API finden Sie im API-Referenzhandbuch für Erweiterungen von Edge Network.

Android

Navigieren Sie zu Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > views > WebViewModel und suchen Sie im fun loadUrl() nach der class WebViewModel: ViewModel(). Fügen Sie den folgenden Aufruf hinzu, um die Web-Ansicht zu verarbeiten:

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")
}

Die Identity.getUrlVariables-API richtet die Variablen für die URL so ein, dass sie alle relevanten Informationen wie ECID und mehr enthalten. Im Beispiel verwenden Sie eine lokale Datei, aber für Remote-Seiten gelten dieselben Konzepte.

Weitere Informationen zur Identity.getUrlVariables-API finden Sie im API-Referenzhandbuch für Erweiterungen von Edge Network.

In der App validieren

So führen Sie den Code aus:

  1. Lesen Sie den Abschnitt Setup-Anweisungen, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.
  2. Navigieren Sie zu Einstellungen in der App.
  3. Tippen Sie auf die Schaltfläche View… , um die Terms of Use anzuzeigen.
iOS
{width="300"} {width="300"}
Android
{width="300"} {width="300"}

Mit Assurance validieren

  1. Suchen Sie in der Assurance-Benutzeroberfläche nach dem Ereignis Edge Identity Response URL Variables vom Anbieter com.adobe.griffon.mobile.

  2. Wählen Sie das Ereignis aus und überprüfen Sie das urlVariable im ACPExtensionEventData-Objekt, um zu bestätigen, dass die folgenden Parameter in der URL vorhanden sind: adobe_mc, mcmid und mcorgid.

    WebView-Validierung {modal="regular"}

    Nachfolgend finden Sie ein Beispiel für ein urvariables:

    • Original (mit Escape-Zeichen)

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

    • geschmückt

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

Leider ist das Debugging der Websitzung eingeschränkt. Beispielsweise können Sie die Adobe Experience Platform Debugger in Ihrem Browser nicht verwenden, um mit dem Debugging der Webansichtssitzung fortzufahren.

NOTE
Die Zuordnung von Besuchern über diese URL-Parameter wird in Platform Web SDK (Version 2.11.0 oder höher) und bei Verwendung von VisitorAPI.js unterstützt.
SUCCESS
Sie haben jetzt Ihre App so eingerichtet, dass Inhalte basierend auf einer URL in einer Webansicht mit derselben ECID angezeigt werden, die bereits von Adobe Experience Platform Mobile SDK ausgegeben wurde.
Vielen Dank, dass Sie sich Zeit genommen haben, um mehr über Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, allgemeines Feedback geben möchten oder Vorschläge für zukünftige Inhalte haben, teilen Sie diese auf diesem Experience League Community-Diskussionsbeitrag

Weiter: Identität

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b