設定保證

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

初學者
中繼
開發人員

瞭解如何在行動應用程式中設定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還需要下列附加專案，才能啟動您應用程式的保證工作階段。

導覽至Xcode專案導覽器中的 Luma > Luma > SceneDelegate。

將下列程式碼新增至 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) }`

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

在這裡可以找到更多資訊。

定義套件組合識別碼

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

在Xcode中開啟專案。
在專案導覽器中選取 Luma。
選取 Luma 目標。
選取「簽署與功能」標籤。

定義 組合識別碼。

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

Xcode簽署功能 {modal="regular"}

設定基礎URL

前往Xcode中的專案。
在專案導覽器中選取 Luma。
選取 Luma 目標。
選取資訊索引標籤。
若要新增基底URL，請向下捲動至 URL型別 並選取 + 按鈕。

將 識別碼 設定為您選擇的組合識別碼，並設定您選擇的 URL配置。

保證url

note important

IMPORTANT

請確定您使用_唯一_組合識別碼並取代com.adobe.luma.tutorial.swiftui組合識別碼，因為每個組合識別碼必須是唯一的。一般而言，您會使用反向DNS格式作為套件組合ID字串，例如com.organization.brand.uniqueidentifier。您可以使用您在定義組合識別碼中使用的相同組合識別碼。
同樣地，使用唯一的URL配置，並以您唯一的URL配置取代已經提供的lumatutorialswiftui。

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

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

連線到工作階段

在Xcode中：

使用，在模擬器中或在Xcode的實體裝置上建置或重建並執行應用程式。

note tip
TIP
您可選擇是否要「清除」組建，尤其是在看到非預期結果時。若要這麼做，請從Xcode 產品功能表選取清除組建資料夾……。

在 允許[Luma應用程式]使用您的位置 對話方塊中，選取 使用應用程式時允許。

{width="300"}
在 「Luma應用程式」想要傳送通知 對話方塊中，選取允許。

{width="300"}
選取 繼續…… 以允許應用程式追蹤您的活動。

{width="300"}
在 允許[Luma應用程式]追蹤其他公司應用程式和網站 對話方塊中，選取允許。

{width="300"}

在您的瀏覽器中：

前往資料收集UI。
從左側邊欄選取保證。
選取 建立工作階段。
選取開始。
提供 工作階段名稱，例如Luma Mobile App Session和 基底URL，這是您在Xcode中輸入的URL配置，後面接著://，例如： lumatutorialswiftui://
選取 下一步。
在 建立新工作階段 模型對話方塊中：

如果您使用實體裝置：
- 選取 掃描QR碼。若要開啟應用程式，請使用實體裝置上的相機掃描二維碼並點選連結。
如果您使用模擬器：
1. 選取 複製連結。
2. 使用複製深層連結，並使用深層連結在模擬器中使用Safari開啟應用程式。
應用程式載入時，畫面會顯示強制回應對話方塊，要求您輸入步驟7顯示的PIN。

{width="300"}

輸入PIN並選取連線。
如果連線成功，您會看到：
- 「保證」圖示會浮動在應用程式上方。
  
  {width="300"}
- Experience Cloud更新從Assurance UI傳入，顯示：
  1. 來自應用程式的體驗事件。
  2. 所選事件的詳細資料。
  3. 裝置和時間表。

如果您遇到任何挑戰，請檢閱技術和一般檔案。

驗證擴充功能

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

選取設定。
選取 延伸版本 的。
選取「儲存」。
選取 擴充功能版本，以檢視最新可用擴充功能的概觀，以及您應用程式版本中使用的擴充功能。
若要更新您的擴充功能版本（例如，傳訊與 最佳化），請從 封裝相依性 （例如，AEPMessaging）選取封裝（擴充功能），然後從內容功能表選取 更新封裝。 Xcode將更新套件相依性。