モバイルアプリからモバイル web/Web ビューへのIDの共有

訪問者がモバイルアプリからWebViewまたはモバイル web ページに移動すると、アプリとweb コンテキストはそれぞれ独自のIDを維持します。 明示的な引き継ぎがなければ、web体験では訪問者を未知の新しい人物として扱い、レポートをフラグメント化し、パーソナライゼーションを再開します。

モバイルからwebへのID共有では、訪問者のExperience Cloud ID （ECID） ​をモバイルアプリからadobe_mc クエリ文字列パラメーターを介してweb宛先に渡すことにより、これを解決します。 パラメーターには、ECID、Experience Cloud組織ID、およびタイムスタンプが含まれます。 Web宛先が有効なadobe_mc パラメーターで読み込まれると、Web SDKはそれを自動的に読み取り、最初のEdge Network リクエストにハンドオフ IDを適用するため、両方のコンテキストで同じ訪問者が共有されます。

このパターンは、組織が管理するWebViewまたはモバイル web ページをモバイルアプリで開き、アプリのアクティビティとweb アクティビティを同じ訪問者に関連付けたままにする場合に使用します。 目標が異なるドメイン上のweb サイト間のID継続性である場合は、代わりに​ クロスドメイン共有を使用してください。

前提条件

開始する前に、実装が次の要件を満たしていることを確認してください。

モバイルアプリからIDを取得 retrieve-identity

Edge Network用ID拡張機能のgetUrlVariables APIを使用して、訪問者のIDをクエリ文字列として取得します。 その後、WebViewまたはブラウザーを開く前に、その文字列をURLに追加できます。

返される文字列には、次のURL エンコードされたパラメーターが含まれます。

次のコード例は、モバイルアプリでの引き継ぎがどのように表示されるかを示しています。

Identity.getUrlVariables { (urlVariables, error) in
    if let error = error {
        // Handle the error
        return
    }

    guard let urlVariables = urlVariables else { return }

    // Construct the full URL by appending the identity query string
    if let url = URL(string: "https://example.com/webapp?\(urlVariables)") {
        // Open the URL in a WebView or browser
        let request = URLRequest(url: url)
        webView.load(request)
    }
}

Identity.getUrlVariables { urlVariables ->
    if (urlVariables != null) {
        // Construct the full URL by appending the identity query string
        val url = "https://example.com/webapp?$urlVariables"

        // Open the URL in a WebView or browser
        webView.loadUrl(url)
    }
}

Web側でIDを受信する receive-identity

Web宛先に追加のコードは必要ありません。 Web SDKがページに存在し、URLに有効なadobe_mc パラメーターが含まれている場合、SDKはECIDを自動的に抽出し、最初のEdge Network リクエストで訪問者のID マップに適用します。

Web宛先でWeb SDK タグ拡張機能を使用しており、IDを保持しながら訪問者を別のページにリダイレクトする必要がある場合は、IDでリダイレクト ​ アクションを使用して、adobe_mc パラメーターを次のページに転送します。