設定Assurance

除了一般SDK安裝之外，iOS還需要下列額外程式碼，才能為您的應用程式啟動Assurance工作階段。

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

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

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

除了一般SDK安裝之外，Android還需要下列額外程式碼，才能為您的應用程式啟動Assurance工作階段。

1. 在Android Studio中，以​ Android ​檢視導覽至​ 應用程式 > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication。

2. 將下列程式碼新增至 fun handleDeeplink(deeplink: String?):

   code language-kotlin
   // Called when the app in background is opened with a deep link. if (deeplink.isNullOrEmpty()) { Log.w("Luma", "Deeplink is null or empty") return } Log.i("Luma", "Handling deeplink: $deeplink") Assurance.startSession(deeplink)

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

1. 在Xcode中開啟專案。
2. 在專案導覽器中選取​ Luma。
3. 選取​ Luma ​目標。
4. 選取「簽署與功能」標籤。
5. 定義​ 組合識別碼。

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

{modal="regular"}

1. 在Android Studio中開啟專案。
2. 在導覽器中選取​ build.gradle.kts （模組:app）。
3. 確定您使用​ 唯一 ​組合識別碼，並在com.adobe.luma.tutorial.android中取代namespace的android值
4. 確定您使用相同的​ 唯一 ​組合識別碼，並在com.adobe.luma.tutorial.android中為applicationId中的defaultConfig取代android

一般而言，您會使用反向DNS格式作為套件組合ID字串，例如com.organization.brand.uniqueidentifier。 例如，此教學課程的完成版本使用com.adobe.luma.tutorial.android。

{modal="regular"}

1. 前往Xcode中的專案。

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

3. 選取​ Luma ​目標。

4. 選取​ 資訊 ​索引標籤。

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

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

   {modal="regular"}

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

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

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

1. 移至Android Studio中專案的​ Android ​檢視。

2. 在導覽器中選取​ 應用程式 > 資訊清單 > AndroidManifest.xml。

3. 確定​ 資訊清單 > 應用程式 > 活動 XML專案看起來像這樣：

   code language-xml

   <activity android:name=".MainActivity" android:exported="true" android:theme="@style/Theme.LumaAndroid"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter android:label="@string/app_name"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="lumatutorialandroid" android:host="default" /> </intent-filter> </activity>

請確定您指定了android:scheme (例如。 lumatutorialandroid)和android:host （例如default）以定義基底URL。

若要深入瞭解Android中的深層連結，請參閱建立應用程式內容的深層連結。

Assurance的運作方式是透過瀏覽器或QR碼開啟URL。 該URL以基礎URL開頭，開啟App並包含其他引數。 這些唯一引數用於連線工作階段。 在範例應用程式中，深層連結為lumatutorialandroid://default。

在Xcode中：

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

   您可選擇是否要​ 清除 ​您的組建，尤其是當您看到非預期的結果時。 從Xcode Product ​功能表選取​ 清除組建資料夾……。

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

   {width="300"}

3. 在​ 「Luma應用程式」想要傳送通知 ​對話方塊中，選取​ 允許。

   {width="300"}

4. 選取​ 繼續…… ​以允許應用程式追蹤您的活動。

   {width="300"}

5. 在​ 允許[Luma應用程式]追蹤其他公司應用程式和網站 ​對話方塊中，選取​ 允許。

   {width="300"}

6. 選取​ 繼續。

在您的瀏覽器中：

1. 前往資料收集UI。

2. 從左側邊欄選取​ Assurance。

3. 選取​ 建立新工作階段，然後選取​ 深層連結連線。

4. 選取​ 開始。

5. 提供​ 工作階段名稱，例如Luma Mobile App Session和​ 基底URL，這是您在Xcode中輸入的URL配置，後面接著://，例如： lumatutorialswiftui://

6. 選取​ 下一步。
   {modal="regular"}

7. 在​ 建立新工作階段 ​模型對話方塊中：

   如果您使用實體裝置：

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

     {modal="regular"}

   如果您使用模擬器：

   1. 選取​ 複製連結。

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

      {modal="regular"}

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

   {width="300"}

   輸入PIN並選取​ 連線。

9. 如果連線成功，您會看到：

   • 浮動在應用程式上方的Assurance圖示。

     {width="300"}

   • Experience Cloud更新會在Assurance UI中傳入，顯示：

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

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

     3. 裝置和時間表。

        {modal="regular"}

10. 選取​ 繼續 ​以移至主畫面。

在Android Studio中：

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

   您可選擇是否要​ 清除 ​您的組建，尤其是當您看到非預期的結果時。 從Android Studio 建置 ​功能表選取​ 清除專案。

2. 在​ 允許Luma Android傳送通知 ​對話方塊中，選取​ 允許。

   {width="300"}

3. 選取​ 顯示許可權對話方塊。

   {width="300"}

4. 在​ 允許Luma Android存取此裝置的位置？…

   {width="300"}

   • 選取​ 精確。
   • 使用應用程式​ 時選取。

5. 回到簡介應用程式畫面，選取​ 開啟裝置設定。

6. 在​ 位置許可權 ​畫面中，選取​ 允許所有時間。 然後選取​ ← ​以返回介紹應用程式畫面。

   {width="300"}

7. 選取​ 繼續 ​以移至主畫面。

在您的瀏覽器中：

1. 前往資料收集UI。

2. 從左側邊欄選取​ Assurance。

3. 選取​ 建立新工作階段，然後選取​ 深層連結連線。

4. 選取​ 開始。

5. 提供​ 工作階段名稱，例如Luma Mobile App Session和​ 基底URL，這是您在Android Studio的android:schemeAndroidManifest.xmlandroid:host中定義的​ 和，以://分隔。例如： lumatutorialandroid://default

6. 選取​ 下一步。
   {modal="regular"}

7. 在​ 建立新工作階段 ​模型對話方塊中：

   如果您使用實體裝置：

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

     {modal="regular"}

   如果您使用模擬器：

   1. 選取​ 複製連結。
   2. 使用 來複製深層連結，並使用深層連結在模擬器中透過Chrome開啟應用程式。

   {modal="regular"}

   在Chrome中提示​ 繼續使用Luma Android ​時，請選取​ 繼續。

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

   {width="300"}

   輸入PIN並選取​ 連線。

9. 如果連線成功，您會看到：

   • 浮動在應用程式上方的Assurance圖示。

     {width="300"}

   • Experience Cloud更新會在Assurance UI中傳入，顯示：

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

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

     3. 裝置和時間表。

        {modal="regular"}

{modal="regular"}

若要更新您的擴充功能版本（例如，傳訊 ​與​ 最佳化），請從​ 封裝相依性 （例如，AEPMessaging）選取封裝（擴充功能），然後從內容功能表選取​ 更新封裝。 Xcode會更新套件相依性。

{modal="regular"}

如果您看到過時的擴充功能，請參閱Android Studio檔案，瞭解如何更新專案的相依性模組。