Recommendations可測試Places Service test-validate-loc-svc

全球有許多客戶和組織都會定義POI,因此一定要模擬及測試Places服務與應用程式的互動方式。 此資訊可協助您瞭解如何測試及驗證Places服務專案與退出,這些專案會根據定義的POI和使用者的目前位置正確觸發。

由於環境變數可能是位置訊號和準確度的一個因素,我們建議您先使用開發人員工具和模擬位置專案在本機工作,以建立基準結果。 目標是驗證所有位置事件是否正常運作。 在正確驗證位置事件後,即可測試解決方案整合(例如Analytics、Target和Campaign)。 為了協助您的測試活動,您應該使用回傳設定SlackWebhook,並在個別開發環境中載入GPX檔案。

IMPORTANT
此計畫假設已在Places服務UI中建立POI,且已安裝並正確設定最新版本的Places擴充功能。 執行主動式區域監視時,也會假設已實作區域監視解決方案。 如需詳細資訊,請參閱Places擴充功能、適用於iOS的CoreLocation檔案Android位置檔案
步驟
說明
預期結果
1
確認已輸入適當的資訊清單金鑰,以便Android授予追蹤位置的存取權。
已確認
1a
確認iOS中已設定位置更新。 同時請確定您已在iOS中設定適當的資料夾索引鍵,以要求追蹤位置的使用者許可權。
已確認
2
確認已為iOS設定監視模式。 持續模式可提供更高的精確度和持續性,但也會大幅減少電池壽命。
重大變更或持續性
3
如果使用多個POI資料庫,請確認已在Places擴充功能中選取適當的資料庫以進行Experience Platform Launch。
已確認
4
確認最新版本的Mobile Core和Places擴充功能已透過Gradle或CocoaPods隨應用程式捆綁銷售。
已確認 — 如需最新更新的詳細資訊,請參閱發行說明。
5
確認測試的設定環境正確無誤。 Launch環境ID應和您的Launch開發環境相符。
已確認
6
針對您要測試的每個POI建立GPX檔案。 GPX檔案可用於本機開發環境中,以模擬位置專案。 如需建立及使用GPX檔案的相關資訊,請參閱下列內容: iOS模擬器的
GPX檔案[已關閉]
https://mapstogpx.com/mobiledev.php
行動應用程式中的位置測試
GPX檔案會在應用程式專案中建立和載入。
7
您無需執行任何其他操作,應該能夠從Android Studio或Xcode啟動應用程式,並檢視適當的警報以請求追蹤位置的存取權。 按一下​ 永遠允許 ​許可權。

建議您使用連線到電腦的真實裝置,而不使用裝置模擬器。
位置請求提示應顯示在透過IDE載入的應用程式上
8
一旦接受位置許可權。 Places SDK將擷取裝置的目前位置,而區域監視程式碼應開始從目前位置監視20個最近的POI
請參閱表格下方的記錄範例。
9
在Xcode或Android Studio中的不同位置之間切換時,應該會產生特定POI的登入事件。 進入POI時應有以下記錄。
請參閱表格下方的記錄範例。
10
在區域監視器找到附近的POI後,您應該透過傳送位置Ping來測試。 在Launch中,建立可根據「地理圍欄」專案使用Places擴充功能觸發的新規則。 然後使用行動核心建立新動作以傳送回傳。 建立SlackWebhook應用程式可協助您檢視位置專案與退出點。 如需建立SlackWebhook應用程式的詳細資訊,請參閱使用傳入Webhook傳送訊息。
10安培
在Launch中,請確定您已為Places擴充功能新增資料元素,包括:
目前的POI名稱
目前的POI緯度
目前的POI經度
上次輸入的名稱
上次輸入的經度
上次輸入的經度
上次結束的名稱
上次結束的經度
上次結束的經度
時間戳記
10b
以「事件=地點→輸入POI」建立新規則
10c
建立動作=行動核心→回傳
10天
使用您Slack應用程式的Webhook URL,例如https://hooks.slack.com/services/TKN5FKS68/BNFP7SVD…
10e
貼文內文類似於: {text: User is in POI - {%%Last Entered POI Name%%} in {%%Last Entered POI City%%} additional information: Radius:{%%Last Entered POI Radius%%} Timestamp: {%%timestamp%%}}
請確定您使用的是您在此建立的特定資料元素。
10f
請務必在Launch中發佈所有新的資料元素和規則變更。 (您應在Launch介面的右上角選取有效的開發程式庫。)
11
在開發人員IDE中的GPX位置之間切換,再次啟動並測試您的應用程式。
現在,當您在開發環境中選取不同位置時,應該會看到Slack通知,顯示每個POI的專案。
快速摘要點
​所有測試都可以在本機執行,不必前往特定的POI位置。 驗證測試有助於確保您的應用程式已正確設定,並且已收到位置的正確許可權。

此驗證也可讓您確信定義的POI可搭配您的地區監視實作正常運作。 在此步驟後,我們將開始在Campaign中測試傳訊,以檢視是否根據POI登入與退出顯示正確的訊息。
正在使用Places服務測試Adobe Campaign Standard應用程式內傳訊。
12
在主要Campaign控制面板上,設定新的應用程式內訊息(型別=廣播)
12安培
在觸發器中,選取​ Places事件型別 — 專案作為觸發器
12b
選取​ Places自訂中繼資料 ​作為額外的篩選器 — 使用POI型別=上次輸入的POI。
我們使用​ 上次輸入的 ​做為POI型別,因為大多數情況下,上次輸入的 ​將會與​ 目前的POI ​相同。

目前的POI ​ ​只應在有重疊POI地理圍欄的執行個體中使用。 在此情況下,這些POI需要排名,然後​ ​目前的POI ​ ​將顯示使用者目前可能位於的2或3個地理圍欄中的排名最前的POI。
12c
選取自訂中繼資料索引鍵,協助您縮小將接收訊息的POI範圍。
12天
針對頻率和持續時間,請僅保留一或兩天,這樣如果您不喜歡該條件,則可以在較短的時間內讓觸發程式過期。
12世紀
若為「一直/一次」或「直到點進」,請選取「一直」,以便您可以跨多個位置進行測試。
當您模擬符合適當中繼資料條件的位置變更時,「一律顯示」應用程式內訊息。
12f
對於顯示,選取「本機通知」以外的選項。 這可讓您在前景中使用應用程式進行測試時更輕鬆地檢視。)
12g
準備/確認並部署應用程式內訊息。
13
在您的開發環境中,為確保下載新的行銷活動規則,請結束並再次啟動應用程式。
別忘了,必須再次完整啟動應用程式,才會將新的Campaign規則檔案下載至裝置。
14
在您的開發應用程式中,使用先前建立的GPX檔案來切換位置。
您應該會根據先前設定的條件,看到應用程式內訊息。
15
在下一個測試中,我們基本上會複製與之前相同的步驟,但這次我們會測試本機通知。
預期的結果是每次符合相符條件時都會顯示本機通知。
16
設定新的應用程式內訊息(型別=廣播)。
16安培
在觸發器中,選取​ Places事件型別 - Entry作為觸發器
16b
選取Places自訂中繼資料作為額外的篩選器 — 使用​ POI型別 = 上次輸入的POI
16c
選取自訂中繼資料索引鍵,協助您縮小將接收訊息的POI範圍。
16天
針對頻率和持續時間,請僅保留一或兩天,如此一來,若您不喜歡此條件,則可縮短觸發器的到期時間。
16世紀
對於一直/一次或直到點進,一直
16f
對於顯示型別,請選取​ 本機通知
16g
準備/確認並部署應用程式內訊息。
17
在開發人員環境中,連線您的裝置並按組建上的​ 播放。 建立位置後,請讓應用程式進入背景,並繼續在Xcode或Android Studio中切換位置。 您仍然應該會看到指出位置變更的主控台讀取,而且您也應該會看到根據觸發器中設定的條件而顯示的本機通知。 (可能有1-2秒的延遲。)
預期的結果是每次符合相符條件時都會顯示本機通知。
摘要點
在這個階段,我們應該會在本機環境中看到POI專案。 我們也應該會看到根據POI運作的Campaign傳訊。 如果發生失敗,則檢查Slack通知是否未發出。 如果沒有Slack訊息,請檢查應用程式主控台,因為可能未記錄新的位置專案。 如果結果成功,則我們可以相當確定應用程式是否正確執行,以及Places Service和Campaign訊息服務是否也正確運作。
站上測試
在位置上測試時應該不會發生太多變更。 讓Slack回傳保持作用中狀態,有助於瞭解裝置是否取得位置的進入和退出。
18
從停用wifi和行動資料開始,在POI區域啟用一次的裝置,以進行測試。
如果失敗,請記下是否在Slack中取得地域範圍專案與通知。 Slack通知的時間戳記為何?
19
僅啟用行動資料並關閉Wifi來進行測試。
20
在行動資料和Wifi同時開啟的情況下進行測試。
摘要點
現場測試應非常符合開發測試。 請記住,在決定使用者位置時,可能會有一些環境因素發揮效用,例如POI地理圍欄的逗留時間、可使用的儲存格訊號,以及附近WiFi存取點的強度。

記錄範例

步驟8 : ​位置更新期間必須有iOS和Android記錄

iOS

[AdobeExperienceSDK DEBUG <Places>]: Requesting 20 nearby POIs for device location (<lat>, <longitude>)
[AdobeExperienceSDK DEBUG <Places>]: Response from Places Query Service contained <n> nearby POIs

Android

PlacesExtension - Dispatching nearby places event with n POIs

步驟9 : ​事件期間必須有iOS和Android記錄

iOS

[AdobeExperienceSDK TRACE <Places>]: Dispatching Places region entry event for place ID <poiId>

Android

PlacesExtension -  Dispatching Places Region Event for <poi name> with eventType entry
recommendation-more-help
475fad96-f29f-4dca-a109-68bf0557e825