使用地標

導覽至​ 標籤 ​並尋找您的行動標籤屬性並開啟屬性。

選取​ 延伸模組。

選取​ 目錄。

搜尋​ Places ​延伸模組。

安裝擴充功能。

在​ 安裝擴充功能 ​對話方塊中：

1. 從​ 選取資料庫 ​清單中選取​ Luma。

2. 請確定您已挑選您的工作程式庫，例如​ 初始組建。

3. 從​ 儲存至程式庫 ​中選取​ 儲存至程式庫並建置。

   。

已重建您的程式庫。

前往資料收集UI中的標籤屬性。

從左側邊欄選取​ 資料元素。

選取​ 新增資料元素。

在​ 建立資料元素 ​畫面中，輸入名稱，例如Name - Entered。

從​ 擴充功能 ​清單中選取​ 地標。

從​ 資料元素型別 ​清單中選取​ 名稱。

選取​ TARGET ​底下的​ 目前POI。

選取​ 儲存至資料庫。

使用下表中的資訊重複步驟4至8，以建立其他資料元素。

您應該有以下資料元素清單。

在您的標籤屬性中，從左側邊欄選取​ 規則。

選取​ 新增規則。

在​ 建立規則 ​畫面中，輸入規則的名稱，例如POI - Entry。

選取​ EVENTS ​底下的 。

1. 從​ 擴充功能 ​清單中選取​ 地標，並從​ 事件型別 ​清單中選取​ 輸入POI。

2. 選取​ 保留變更。

   。

選取​ ACTIONS ​底下的 。

1. 從​ 擴充功能 ​清單中選取​ 行動核心，從清單中選取​ 動作型別 ​中的​ 附加資料。 此動作會附加裝載資料。

2. 在​ 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中插入{%% ... %%}資料元素預留位置值。 快顯對話方塊可讓您挑選您建立的任何資料元素。

3. 選取​ 保留變更。

   

選取​ 行動核心 — 附加資料 ​動作旁的 。

1. 從​ 擴充功能 ​清單中選取​ Adobe Experience PlatformEdge Network，然後選取​ 轉寄事件至Edge Network。 此動作可確保事件和其他裝載資料轉送至PlatformEdge Network。
2. 選取​ 保留變更。

若要儲存規則，請選取​ 儲存至資料庫。

在​ 建立規則 ​畫面中，輸入規則的名稱，例如POI - Exit。

選取​ EVENTS ​底下的 。

1. 從​ 擴充功能 ​清單中選取​ 地標，並從​ 事件型別 ​清單中選取​ 結束POI。
2. 選取​ 保留變更。

選取​ ACTIONS ​底下的 。

1. 從​ 擴充功能 ​清單中選取​ 行動核心，從​ 動作型別 ​清單中選取​ 附加資料。

2. 在​ JSON裝載 ​中，貼上下列裝載：

   code language-json
   { "xdm": { "eventType": "location.exit", "placeContext": { "geo": { "city": "{%%City - Exited%%}" }, "POIinteraction": { "poiExits": { "value": 1 }, "poiDetail": { "name": "{%%Name - Exited%%}", "category": "{%%Category - Exited%%}" } } } } }

3. 選取​ 保留變更。

選取​ 行動核心 — 附加資料 ​動作旁的 。

1. 從​ 擴充功能 ​清單中選取​ Adobe Experience PlatformEdge Network，然後選取​ 轉寄事件至Edge Network。
2. 選取​ 保留變更。

若要儲存規則，請選取​ 儲存至資料庫。

在Xcode中，請確定已將AEP Places新增至套件相依性中的套件清單中。 請參閱Swift封裝管理員。

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

請確定AEPPlaces是匯入清單的一部分。

import AEPPlaces

請確定Places.self是您註冊的擴充功能陣列的一部分。

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
]

導覽至Xcode專案導覽器中的​ Luma > Luma > Utils > MobileSDK，並尋找func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async函式。 新增下列程式碼：

// Process geolocation event
Places.processRegionEvent(regionEvent, forRegion: region)

此Places.processRegionEvent API會將地理位置資訊通訊至Places服務。

導覽至Xcode專案導覽器中的​ Luma > Luma > Views > Location > GeofenceSheet。

1. 針對「輸入」按鈕，輸入下列代碼

// Simulate geofence entry event
Task {
    await MobileSDK.shared.processRegionEvent(regionEvent: .entry, forRegion: region)
}

1. 針對「結束」按鈕，輸入下列程式碼

// Simulate geofence exit event
Task {
    await MobileSDK.shared.processRegionEvent(regionEvent: .exit, forRegion: region)
}

在裝置上或在模擬器中開啟您的應用程式。

前往​ 位置 ​標籤。

四處移動（拖曳）地圖，確保藍色中間圓圈位於其中一個POI的上方，例如倫敦。

點選 {width="20"}，直到您看到類別和名稱出現在標籤中帶有pin的紅色位置為止。

點選POI的標籤，開啟​ 附近的POI ​工作表。

{width="300"}

按下​ 登入 ​或​ 退出 ​按鈕，以模擬應用程式中的地理柵欄登入與地理柵欄退出事件。

{width="300"}

您應該會在Assurance UI中看到事件。