使用地標
瞭解如何在應用程式中使用Places地理位置服務。
Adobe Experience Platform Data Collection Places Service是一項地理位置服務，可讓具備位置感知功能的行動應用程式瞭解位置內容。 此服務使用豐富且簡單易用的SDK介面，並隨附彈性的興趣點資料庫(POI)。
先決條件
- 所有套件相依性都在Xcode專案中。
- AppDelegate中註冊的擴充功能。
- 已將MobileCore設定為使用您的開發appId。
- 匯入的SDK。
- 已順利建置並執行應用程式，包含上述變更。
學習目標
在本課程中，您將學習
- 瞭解如何在Places服務中定義地標。
- 使用Places擴充功能更新您的標籤屬性。
- 更新您的結構描述以擷取地理位置事件。
- 驗證Assurance中的設定。
- 更新您的應用程式以註冊Places擴充功能。
- 從應用程式中的Places服務實作地理位置追蹤。
設定
若要讓Places服務在您的應用程式和Mobile SDK中運作，您必須進行一些設定。
定義地標
您可以在Places服務中定義一些地標。
- 在資料收集UI中，選取 地點.
- 選取
- 從內容功能表中，選取 管理程式庫.
- 在 管理程式庫 對話方塊，選取 新增.
- 在 建立資料庫 對話方塊輸入 名稱，例如
Luma. - 選取 確認.
- 若要關閉 管理程式庫 對話方塊，選取 關閉.
- 返回 POI管理，選取 匯入POI.
- 選取 開始 在 匯入地標 對話方塊。
- 選取 Luma 從程式庫清單中，
- 選取 「下一步」。
- 下載 Luma POIs ZIP檔案 並將它擷取到您電腦上的某個位置。
- 在 匯入地標 對話方塊，拖放擷取的
luma_pois.csv檔案開啟到 選擇CSV檔案 — 拖放您的檔案. 您應該會看到 驗證成功 - 已成功驗證CSV檔案. - 選取 開始匯入. 您應該會看到 成功 - 已成功新增6個POI.
- 選取「完成」。
- 在 POI管理，您應該會看到清單中已新增六家新的Luma商店。 您可以切換
安裝Places擴充功能
-
瀏覽至 標籤 並尋找您的行動標籤屬性並開啟屬性。
-
選取 擴充功能.
-
選取 目錄.
-
搜尋 地點 副檔名。
-
安裝擴充功能。
-
在 安裝擴充功能 對話方塊：
-
選取 Luma 從 選取程式庫 清單。
-
確認您已挑選工作程式庫，例如 初始建置.
-
選取 儲存至程式庫並建置 從 儲存至程式庫.
-
-
已重建您的程式庫。
驗證您的結構描述
驗證您的結構描述是否如中定義 建立結構描述，整合了必要的欄位群組和類別，以便收集POI和地理位置資料。
- 導覽至資料收集介面並選取「 」 方案 從左側邊欄。
- 選取 瀏覽 從頂端列。
- 選取要開啟的結構描述。
- 在架構編輯器中，選取 消費者體驗事件.
- 您會看到 placeContext 物件，具有物件和欄位，可擷取POI互動和地理位置資料。
更新您的標籤屬性
Tags的Places擴充功能提供監視地理位置事件的功能，可讓您根據這些事件觸發動作。 您可以使用此功能，將您必須在應用程式中實施的API編碼減至最少。
資料元素
您先建立數個資料元素。
-
前往資料收集UI中的標籤屬性。
-
選取 資料元素 從左側邊欄。
-
選取 「新增資料元素」。
-
在 建立資料元素 畫面，輸入名稱，例如
Name - Entered. -
選取 地點 從 副檔名 清單。
-
選取 名稱 從 資料元素型別 清單。
-
選取 目前POI 底下 TARGET.
-
選取 儲存至程式庫.
-
使用下表中的資訊重複步驟4至8，以建立其他資料元素。
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 名稱 擴充功能 資料元素型別 TARGET Name - Exited地點 名稱 上次退出的POI Category - Current地點 類別 目前POI Category - Exited地點 類別 上次退出的POI City - Current地點 城市 目前POI City - Exited地點 城市 上次退出的POI 您應該有以下資料元素清單。
規則
接下來，您將定義處理這些資料元素的規則。
-
在您的標籤屬性中，選取 規則 從左側邊欄。
-
選取 新增規則.
-
在 建立規則 畫面，輸入規則的名稱，例如
POI - Entry. -
選取
-
選取 地點 從 副檔名 清單並選取 輸入POI 從 事件型別 清單。
-
選取 「保留變更」。
-
-
選取
-
選取 行動核心 從 副檔名 清單，選取 附加資料 從 動作型別 清單。 此動作會附加裝載資料。
-
在 JSON裝載，貼上下列裝載：
code language-json { "xdm": { "eventType": "location.entry", "placeContext": { "geo": { "city": "{%%City - Current%%}" }, "POIinteraction": { "poiDetail": { "name": "{%%Name - Current%%}", "category": "{%%Category - Current%%}" }, "poiEntries": { "value": 1 } } } } }您也可以插入
{%% ... %%}JSON中的資料元素預留位置值，方法是選取
-
選取 「保留變更」。
-
-
選取
- 選取 Adobe Experience Platform Edge Network 從 副檔名 清單並選取 將事件轉送至Edge Network. 此動作可確保將事件和其他裝載資料轉送到Platform Edge Network。
- 選取 「保留變更」。
-
若要儲存規則，請選取「 」 儲存至程式庫.
讓我們建立另一個規則
-
在 建立規則 畫面，輸入規則的名稱，例如
POI - Exit. -
選取
- 選取 地點 從 副檔名 清單並選取 退出POI 從 事件型別 清單。
- 選取 「保留變更」。
-
選取
-
選取 行動核心 從 副檔名 清單，選取 附加資料 從 動作型別 清單。
-
在 JSON裝載，貼上下列裝載：
code language-json { "xdm": { "eventType": "location.exit", "placeContext": { "geo": { "city": "{%%City - Exited%%}" }, "POIinteraction": { "poiExits": { "value": 1 }, "poiDetail": { "name": "{%%Name - Exited%%}", "category": "{%%Category - Exited%%}" } } } } } -
選取 「保留變更」。
-
-
選取
- 選取 Adobe Experience Platform Edge Network 從 副檔名 清單並選取 將事件轉送至Edge Network.
- 選取 「保留變更」。
-
若要儲存規則，請選取「 」 儲存至程式庫.
若要確保標籤中的所有變更皆已發佈
- 選取 初始建置 作為要建置的程式庫。
- 選取 建置.
驗證Assurance中的設定
若要驗證Assurance中的設定：
- 前往Assurance UI。
- 如果左側邊欄中尚未提供，請選取 設定 在左側邊欄中並選取
- 選取「儲存」。
- 選取 地圖和模擬 在左側邊欄中。
- 將地圖移至其中一個POI的位置。
- 選取
- 選取您的POI。
- 從快顯視窗中選取
- 選取 活動 從左側邊欄中，應該會看到您模擬的事件。
在您的應用程式中實作地標
如先前課程所述，安裝行動標籤擴充功能僅會提供設定。 接下來，您必須安裝並註冊Places SDK。 如果這些步驟不清楚，請查閱 安裝SDK 區段。
-
在Xcode中，確認 AEP地點 會新增至套件相依性中的套件清單中。 另請參閱 Swift封裝管理程式.
-
瀏覽至 Luma > Luma > AppDelegate 在「Xcode專案」導覽器中。
-
確定
AEPPlaces是匯入清單的一部分。code language-swift import AEPPlaces -
確定
Places.self是您註冊的擴充功能陣列的一部分。code language-swift let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ] -
瀏覽至 Luma > Luma > Utils > MobileSDK 在Xcode專案導覽器中，並找到
func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async函式。 新增下列程式碼：code language-swift // Process geolocation event Places.processRegionEvent(regionEvent, forRegion: region)這個
Places.processRegionEventAPI會將地理位置資訊通訊至Places服務。 -
瀏覽至 Luma > Luma > Views > Location > GeofenceSheet 在Xcode的專案導覽器中。
- 針對「輸入」按鈕，輸入下列代碼
code language-swift // Simulate geofence entry event Task { await MobileSDK.shared.processRegionEvent(regionEvent: .entry, forRegion: region) }- 針對「結束」按鈕，輸入下列程式碼
code language-swift // Simulate geofence exit event Task { await MobileSDK.shared.processRegionEvent(regionEvent: .exit, forRegion: region) }
使用您的應用程式進行驗證
-
在裝置上或在模擬器中開啟您的應用程式。
-
前往 位置 標籤。
-
四處移動（拖曳）地圖，確保藍色中間圓圈位於其中一個POI的上方，例如倫敦。
-
點選
-
點選POI的標籤，這會開啟 附近的POI 工作表。
-
按下 登入點 或 退出 按鈕來模擬應用程式中的地理柵欄登入和地理柵欄退出事件。
-
您應該會在Assurance UI中看到事件。
後續步驟
您現在應該有所有的工具，以便開始將更多功能新增至應用程式中的地理位置功能。 當您為設定應用程式後，將事件轉送至「邊緣網路」 Experience Platform，您應該會看到針對應用程式中所用設定檔顯示的體驗事件。
在本教學課程的Journey Optimizer一節中，您會看到體驗事件可用來觸發歷程(請參閱 推播通知 和 應用程式內傳訊 使用Journey Optimizer)。 例如，當應用程式使用者進入實體商店的地理柵欄時，傳送推播通知給該使用者並進行某些產品促銷的常見範例。
您見過應用程式的功能實作，大多是由Places服務以及您在標籤屬性中定義的資料元素和規則所驅動。 因此，請儘可能減少應用程式中的程式碼。 或者，您可以使用直接在應用程式中實作相同的功能 Edge.sendEvent API (請參閱 活動 瞭解更多資訊)，其XDM裝載包含已填入的 placeContext 物件。