設定保證

瞭解如何在行動應用程式中設定Adobe Experience Platform保證。

Assurance (正式名稱為Project Griffon)可協助您檢查、證明、模擬及驗證如何在行動應用程式中收集資料或提供體驗。

Assurance 可協助您檢查 Adobe Experience Platform Mobile SDK 產生的原始 SDK 事件。SDK 收集的所有事件都可供檢查。SDK 事件會載入清單檢視,並依時間排序。每個事件都有一個可提供更多詳細資料的詳細檢視。此外,也提供瀏覽SDK設定、資料元素、共用狀態和SDK擴充功能版本的其他檢視。 進一步瞭解 保證 產品檔案內。

先決條件

  • 已成功安裝並設定SDK以設定應用程式。

學習目標

在本課程中,您將會:

  • 確認您的組織擁有存取權(如果您沒有存取權,請提出要求)。
  • 設定您的基底URL。
  • 新增必要的iOS特定程式碼。
  • 連線到工作階段。

確認存取

確認您的組織有權存取Assurance。 您身為使用者,應已新增至Adobe Experience Platform的設定檔。 另請參閱 使用者存取權 在保證指南中取得詳細資訊。

實作

除了一般 SDK安裝,您已完成先前的課程,iOS還需要下列新增專案,才能啟動應用程式的保證工作階段。

  1. 瀏覽至 Luma > Luma > SceneDelegate 在您的Xcode專案導覽器中。

  2. 將下列程式碼新增至 func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>:

    code language-swift
    // Called when the app in background is opened with a deep link.
    if let deepLinkURL = URLContexts.first?.url {
        // Start the Assurance session
        Assurance.startSession(url: deepLinkURL)
    }
    

    當應用程式於背景並使用深層連結開啟時,此程式碼就會啟動保證工作階段。

可以找到更多資訊 此處.

定義套件組合識別碼

您必須提供應用程式的唯一套件組合識別碼。

  1. 在Xcode中開啟專案。

  2. 選取 Luma 在「專案」導覽器中。

  3. 選取 Luma 目標。

  4. 選取 簽署與功能 標籤。

  5. 定義 組合識別碼.

    note important
    IMPORTANT
    確定您使用 獨特 組合識別碼並取代 com.adobe.luma.tutorial.swiftui 組合識別碼,因為每個組合識別碼必須是唯一的。 通常,套件組合ID字串會使用反向DNS格式,例如 com.organization.brand.uniqueidentifier. 例如,本教學課程的完成版本使用 com.adobe.luma.tutorial.swiftui.

    Xcode簽署功能 {zoomable="yes"}

設定基礎URL

  1. 前往Xcode中的專案。

  2. 選取 Luma 在「專案」導覽器中。

  3. 選取 Luma 目標。

  4. 選取 資訊 標籤。

  5. 若要新增基本URL,請向下捲動至 URL型別 並選取 + 按鈕。

  6. 設定 識別碼 至您選擇的組合識別碼,並設定 URL配置 ,依您的選擇而定。

    保證url

    note important
    IMPORTANT
    確定您使用 獨特 組合識別碼並取代 com.adobe.luma.tutorial.swiftui 組合識別碼,因為每個組合識別碼必須是唯一的。 通常,套件組合ID字串會使用反向DNS格式,例如 com.organization.brand.uniqueidentifier. 您可以使用先前使用的相同套件組合識別碼 定義套件組合識別碼.
    同樣地,使用唯一的URL配置,並取代已經提供的 lumatutorialswiftui 使用您唯一的URL配置。

若要進一步瞭解iOS中的URL配置,請檢閱 Apple的檔案.

Assurance的運作方式是透過瀏覽器或QR碼開啟URL。 該URL以基礎URL開頭,此URL會開啟應用程式並包含其他引數。 這些唯一引數用於連線工作階段。

連線到工作階段

在Xcode中:

  1. 在模擬器中或從Xcode在實體裝置上建置或重建及執行應用程式,使用 播放 .

    note tip
    TIP
    您可選擇是否要「清除」組建,尤其是在看到非預期結果時。 要執行此操作,請選取 清除建置資料夾…… 從Xcode 產品 功能表。
  2. 允許「Luma應用程式」使用您的位置 對話方塊,選取 使用應用程式時允許.

    img-md
    w-300
  3. 「Luma應用程式」想要傳送通知給您 對話方塊,選取 允許.

    img-md
    w-300
  4. 選取 繼續…… 允許應用程式追蹤您的活動。

    img-md
    w-300
  5. 允許「Luma應用程式」追蹤您在其他公司的應用程式和網站上的活動 對話方塊,選取 允許.

    img-md
    w-300

在您的瀏覽器中:

  1. 前往資料收集UI。

  2. 選取 保證 從左側邊欄。

  3. 選取 建立工作階段.

  4. 選取「開始」。

  5. 提供 工作階段名稱 例如 Luma Mobile App Session基礎URL,即您在Xcode中輸入的URL配置,後面接著 :// 例如: lumatutorialswiftui://

  6. 選取​ 「下一步」
    保證建立工作階段

  7. 建立新工作階段 模型對話方塊:

    如果您使用實體裝置:

    • 選取 掃描QR碼. 若要開啟應用程式,請使用實體裝置上的相機掃描二維碼並點選連結。

      保證qa程式碼

    如果您使用模擬器:

    1. 選取 複製連結.

    2. 複製深層連結,使用 複製 並使用深層連結,在模擬器中以Safari開啟應用程式。

      保證副本連結

  8. 應用程式載入時,畫面會顯示強制回應對話方塊,要求您輸入步驟7顯示的PIN。

    img-md
    w-300

    輸入PIN並選取 連線.

  9. 如果連線成功,您會看到:

    • 「保證」圖示會浮動在應用程式上方。

      img-md
      w-300
    • Experience Cloud更新從Assurance UI傳入,顯示:

      1. 來自應用程式的體驗事件。

      2. 所選事件的詳細資料。

      3. 裝置和時間表。

        保證事件

如果您遇到任何挑戰,請檢閱 技術 and general documentation.

驗證擴充功能

若要確認您的應用程式是否使用最新的擴充功能:

  1. 選取 設定.

  2. 選取 新增 123 擴充功能版本.

  3. 選取「儲存」。

    設定擴充功能版本

  4. 選取 123 擴充功能版本 以檢視最新可用擴充功能的概觀,以及應用程式版本中使用的擴充功能。

    擴充功能版本

  5. 若要更新擴充功能版本(例如 傳訊最佳化)從中選擇套件(擴充功能) 套件相依性 (例如, AEPMessaging)並從快顯選單中選取 更新封裝. Xcode將更新套件相依性。

NOTE
在Xcode中更新擴充功能(套件)後,請關閉並刪除目前的工作階段,並重複的所有步驟,從 連線到工作階段驗證擴充功能 確保Assurance在新的Assurance工作階段中正確報告正確的延伸模組。
SUCCESS
您現在已設定應用程式,以便在教學課程的其餘部分使用Assurance 。
感謝您花時間學習Adobe Experience Platform Mobile SDK。 如果您有疑問、想要分享一般意見或有關於未來內容的建議,請在此分享這些內容 Experience League社群討論貼文

下一步: 實作同意

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