透過行動SDK擷取資料
本快速入門手冊說明如何使用Adobe Experience Platform Mobile SDK和Edge Network將行動應用程式追蹤資料直接擷取到Adobe Experience Platform。 然後將這些資料用於Customer Journey Analytics。
若要完成此操作,您必須:
-
在 Adobe Experience Platform 中設定結構和資料集,定義您要收集的資料的模型 (結構),以及實際收集資料的位置 (資料集)。
-
設定資料流以設定 Adobe Experience Platform Edge Network,將收集的資料路由至您在 Adobe Experience Platform 中設定的資料集。
-
使用標籤可針對行動應用程式中的資料輕鬆設定規則和資料元素。 然後,確定資料已傳送至 Adobe Experience Platform Edge Network 上設定的資料流。
-
部署和驗證。 擁有一個讓您可反覆進行標籤開發作業的環境,一旦所有內容均經過驗證,就可以在您的生產環境中實時發佈。
-
在 Customer Journey Analytics 中設定連線。 此連線應 (至少) 包含您的 Adobe Experience Platform 資料集。
-
在 Customer Journey Analytics 中設定資料檢視,定義您要在 Analysis Workspace 中使用的量度和維度。
-
在 Customer Journey Analytics 中設定專案,建立您的報告和視覺效果。
設定結構和資料集
若要將資料擷取至 Adobe Experience Platform,您必須先定義要收集的資料。 所有擷取至 Adobe Experience Platform 的資料都必須符合標準的非正常結構,才能由下游能力和功能識別並處理。 Experience Data Model (XDM)是標準架構,提供結構形式的結構。
定義結構後,您可以使用一個或多個資料集來儲存及管理資料收集。 資料集是資料集合(通常是表格)的儲存和管理結構,其中包含結構(欄)和欄位(列)。
擷取至 Adobe Experience Platform 的所有資料都必須符合預先定義的結構描述,才能以資料集形式持續保存。
設定結構
您想要使用行動應用程式從設定檔追蹤一些最基本的資料,例如場景名稱、識別。
您首先需要定義用來模型化此資料的結構描述。
若要設定您的結構:
-
在 Adobe Experience Platform UI 的左側邊欄中,選取「資料管理」中的「結構」。
-
選取「建立結構」。
. -
在建立架構精靈的選取類別步驟中:
-
選取「體驗活動」。
note info INFO 體驗事件結構描述可用來建立設定檔_行為_ (例如場景名稱、推播按鈕至新增至購物車) 模型。 個體設定檔結構描述可用來建立設定檔_屬性_ (例如姓名、電子郵件、性別) 模型。 -
選取「下一步」。
-
-
在「建立結構描述」精靈的「命名和審查步驟」中:
-
輸入您結構描述的 結構描述顯示名稱 與 (選用) 說明。
-
選取「完成」。
-
-
在範例結構描述的結構標籤中:
-
在「欄位群組」中選取「+ 新增」。
欄位群組是可重複使用的物件和屬性集合,可讓您輕鬆擴充結構。
-
在新增欄位群組對話方塊中,從清單中選取 AEP Mobile SDK ExperienceEvent 欄位群組。
您可以選取預覽按鈕,以查看屬於此欄位群組之欄位的預覽,例如
application > name。
選取 「返回」 來關閉預覽。
-
選取「新增欄位群組」。
-
-
在「結構」面板中,選取結構名稱旁的 +。
-
在欄位屬性面板中,輸入
identification作為欄位名稱,識別作為顯示名稱,選取 物件 作為型別,並選取 ExperienceEvent Core v2.1 作為欄位群組。note NOTE 如果該欄位群組不適用,請尋找另一個包含身分識別欄位的欄位群組。 或建立一個新欄位群組,並新增身分識別欄位 (如 ecid、crmId以及您需要的其他欄位) 至該欄位群組並選取該欄位群組。
識別物件新增識別功能至您的結構描述。 針對您的情況,您想使用Experience Cloud ID和電子郵件地址,以行動應用程式識別設定檔。 還有許多其他屬性可用於追蹤您個人的身分識別 (例如客戶 ID、忠誠度 ID)。
選取 「套用」 將此物件加入您的結構描述。
-
在剛剛新增的身分識別物件中選取 ecid 欄位,然後在右側面板的「身分識別命名空間」清單中,選取 「身分識別」 和 「主要身分識別」 和 ECID。
您將 Experience Cloud Identity 指定為 Adobe Experience Platform 身分識別服務可用於組合 (拼接) 具有相同 ECID 的設定檔的行為的主要身分。
選取「套用」。 您會看到指紋圖示出現在 ecid 屬性中。
-
在剛剛新增的身分識別物件中選取 「電子郵件」 欄位,然後在「欄位屬性」面板的「身分識別命名空間」清單中選取 「身分識別」 和「電子郵件」。
您將電子郵件地址指定為 Adobe Experience Platform 身分識別服務可用於結合 (拼接) 設定檔行為的另一個身分。
選取「套用」。 您會看到指紋圖示出現在電子郵件屬性中。
選取「儲存」。
-
選取顯示結構名稱之結構的根元素,然後選取 「輪廓」 切換。
系統會提示您啟用輪廓的結構。 啟用後,根據此結構將資料攝取至資料集時,該資料就會合併至即時客戶設定檔中。
如需詳細資訊,請參閱啟用結構以用於即時客戶輪廓。
note important IMPORTANT 儲存啟用輪廓的結構後,便無法再為輪廓停用該結構。
-
選取「儲存」,即可儲存您的結構。
您已建立最低架構,為您可從行動應用程式擷取的資料建立模型。 該結構可讓您使用 Experience Cloud Identity 和電子郵件地址來識別設定檔。 為設定檔啟用結構描述後,即可確保從行動應用程式擷取的資料會新增至即時客戶設定檔。
在行為資料旁邊,您還可以從行動應用程式擷取設定檔屬性資料(例如訂閱電子報的設定檔詳細資料)。
若要擷取設定檔資料,您可以:
-
根據 XDM 個體設定檔架構類別建立結構。
-
將「輪廓核心 v2」欄位群組新增至結構描述。
-
根據「設定檔核心 v2」欄位群組新增識別物件。
-
將 Experience Cloud ID 定義為主要識別碼,並將電子郵件定義為識別碼。
-
啟用該設定檔結構描述
請參閱在 UI 中建立和編輯結構,了解有關向結構添加和刪除欄位群組和個別欄位的詳細資訊。
設定資料集
您已使用您的結構定義資料模型。 您現在必須定義結構,才能使用資料集儲存及管理該資料。
若要設定您的資料集:
-
在 Adobe Experience Platform UI 的左側邊欄中,選取「資料管理」中的「資料集」。
-
選取「建立資料集」。
-
選取「從結構建立資料集」。
-
選取您先前建立的結構並選取「下一個」。
-
為資料集命名,並 (可選) 提供說明。
-
選取「完成」。
-
選取 「設定檔」 切換。
系統會提示您為輪廓啟用資料集。 資料集一經啟用,即可透過攝取的資料豐富即時客戶輪廓。
note important IMPORTANT 只有當資料集所遵循的結構同樣啟用設定檔時,您才能啟用設定檔的資料集。
請參閱資料集 UI 指南,了解如何檢視、預覽、建立、刪除資料集的詳細資訊。 以及為即時客戶輪廓啟用資料集的方法。
設定資料流
資料流代表實作 Adobe Experience Platform Web 和 Mobile SDK 時的伺服器端設定。 使用 Adobe Experience Platform SDK 收集資料時,資料會傳送至 Adobe Experience Platform Edge Network。 此資料流決定資料要轉送到哪些服務。
在設定中,您想要將從行動應用程式收集到的資料傳送到Adobe Experience Platform中的資料集。
若要設定您的資料流:
-
在 Adobe Experience Platform UI 中,從左側邊欄的「資料收集」中選取「資料流」。
-
選取「新資料流」。
-
命名並描述您的資料流。 從「事件結構描述」清單中選取您的結構描述。
-
選取「儲存」。
-
選取「新增服務」。
-
在「新增服務畫面」中:
-
從「服務」清單中選取「Adobe Experience Platform」。
-
確保已選取「啟用」。
-
從「事件資料集」清單中選取您的資料集。
-
保留其他設定並選取 「儲存」 以儲存資料流。
-
您的資料流現在已設定為將從行動應用程式收集的資料轉送到Adobe Experience Platform中的資料集。
請參閱資料流概觀,了解如何設定資料流以及如何處理敏感資料的詳細資訊。
使用標籤
若要在您的網站上實作程式碼以實際收集資料,請使用Adobe Experience Platform中的標籤功能。 此標記管理解決方案可讓您部署程式碼以及其他標記需求。 標籤透過Adobe Experience Platform Mobile Adobe Experience Platform擴充功能,提供與SDK的緊密整合。
建立標籤
-
在 Adobe Experience Platform UI 的左側邊欄中,選取「資料收集」中的「標籤」。
-
選取「新屬性」。
為標籤命名,選取行動裝置。 選取 「儲存」 以繼續。
設定您的標籤
建立標籤後,您必須使用正確的擴充功能加以設定,並根據您要如何追蹤網站及將資料傳送至 Adobe Experience Platform 來設定資料元素和規則。
若要設定,請從標籤屬性清單中選取您新建立的標籤。
擴充功能
將Adobe Platform Edge Network擴充功能新增至您的標籤,以確保您可將資料傳送至Adobe Experience Platform (透過資料流)。
若要建立和設定Adobe Experience Platform Mobile SDK擴充功能:
-
選取左側邊欄中的「擴充功能」。 您會看到行動核心和設定檔擴充功能已經可用。
-
在頂端列中選取 「目錄」。
-
搜尋或捲動至 Adobe Experience Platform Edge Network 擴充功能,然後在右窗格中選取「安裝」以進行安裝。
-
為您的生產環境和 (可選) 中繼環境以及開發環境選取您的沙箱和先前建立的資料流。
-
在網域設定下輸入您的Edge Network網域。 通常使用
<organizationName>.data.adobedc.net。 -
選取「儲存」。
如需詳細資訊,請參閱設定Adobe Experience Platform Edge Network擴充功能。
您也想從目錄中設定下列其他擴充功能:
- 身分。
- AEP Assurance。
- 同意。
如需擴充功能及其設定的詳細資訊,請參閱Experience Platform行動應用程式教學課程中的設定標籤屬性。
資料元素
資料元素是資料字典 (或資料地圖) 的建置組塊。 使用資料元素,在行銷和廣告技術之間收集、組織和傳遞資料。 您可以在標籤中設定可從行動應用程式資料或事件讀取的資料元素,並可將資料傳送至Adobe Experience Platform。
例如,您想要從行動應用程式收集電信業者名稱。
若要定義電信業者名稱資料元素,請執行下列步驟:
-
選取左側邊欄中的「資料元素」。
-
選取「新增資料元素」。
-
在「新增資料元素」對話框中:
-
為您的資料元素命名,例如
Carrier Name。 -
從擴充功能清單中選取行動核心。
-
從資料元素型別清單中選取電信業者名稱。
-
選取「儲存」。
-
您可以建立所需數量的資料元素,並在規則中使用這些元素。
規則
Adobe Experience Platform 中的標籤會遵循規則型系統。 它們會尋找使用者互動與相關資料。 當符合列於您規則中的準則時,規則會觸發您識別的擴充功能、指令碼或用戶端代碼。 您可以使用規則,透過Adobe Experience Platform Edge Network擴充功能將資料(例如XDM物件)傳送至Adobe Experience Platform。
例如,您想要在使用行動應用程式時(在前景)或未使用行動應用程式時(推送回背景)傳送事件資料。
定義規則:
-
選取左側邊欄中的「規則」。
-
選取「建立新規則」。
-
在「建立規則」對話框:
-
為規則命名,例如
Application Status。 -
在「事件」下選取「+ 新增」。
-
在「事件設定」對話框:
-
從擴充功能清單中選取行動核心。
-
從事件型別清單中選取前景。
-
選取「保留變更」。
-
-
按一下行動核心 — 前景旁的
。-
從擴充功能清單中選取行動核心。
-
從事件型別清單中選取背景。
-
選取「保留變更」。
-
-
按一下ACTIONS底下的
新增。 在動作設定 對話框:-
從擴充功能清單中選取Adobe Experience Platform Edge Network。
-
從動作型別清單中選取轉寄事件至Edge Network。
-
選取「保留變更」。
-
-
您的規則應如下所示:
-
選取「儲存」。
-
以上只是定義規則的範例,此規則會將包含應用程式狀態的XDM資料傳送至Adobe Edge Network和Adobe Experience Platform。
您可以在標籤中以各種方式使用規則來操控變數 (使用您的資料元素)。
如需詳細資訊,請參閱規則。
建置並發佈您的標籤
定義資料元素和規則後,您需要建置並發佈標籤。 建立程式庫組建時,必須將其指派至一個環境。 隨後建置的擴充功能、規則和資料元素會經過編譯,並放入指派的環境中。 每個環境都會提供唯一的嵌入程式碼,可讓您將指派的建置整合至您的網站。
若要建置並發佈您的標籤:
-
從左側邊欄中選取「發佈流程」。
-
選取「選擇工作程式庫」,然後選取「新增程式庫…」。
-
在「建立程式庫」對話框:
-
為程式庫命名。
-
從 「環境」 清單中選取「開發 (開發)」。
-
選取「+ 新增所有變更的資源」。
-
選取「儲存並建置至開發」。
您的標記已儲存並已針對您的開發環境建立。 綠色圓點表示在開發環境中成功建置標籤。
-
-
您可以選取 「…」 來重建程式庫或將程式庫移至中繼環境或生產環境。
Adobe Experience Platform標籤支援從簡單到複雜的發佈工作流程,應該能因應您的Adobe Experience Platform Edge Network部署。
如需詳細資訊,請參閱發佈概觀。
擷取您的標籤程式碼
最後,您必須在要追蹤的行動應用程式中使用標籤。
若要取得說明如何設定行動應用程式以及在應用程式中使用標籤的程式碼指示:
-
選取左側邊欄中的「環境」。
-
從環境清單中,選取正確的安裝
按鈕。在行動安裝指示對話方塊中,選取適當的平台(iOS,Android)。 然後使用您想要用來設定和初始化行動應用程式的每個相關程式碼片段旁的復本
按鈕:
-
選取「關閉」。
您原本可以根據部署Adobe Experience Platform Mobile SDK的程式中,選取其他環境(測試、生產),而不是開發環境的程式碼。
如需詳細資訊,請參閱環境。
部署和驗證。
您現在可以在行動應用程式中部署程式碼。 部署後,您的行動應用程式就會開始將資料收集到Adobe Experience Platform中。
驗證您的實作、視需要更正實作,並在更正後,使用「標籤」的發佈工作流程功能,將其部署至中繼和生產環境。
如需更多詳細資訊,請參閱在行動應用程式教學課程中實作Adobe Experience Cloud 。
設定連線
若要在 Customer Journey Analytics 中使用 Adobe Experience Platform 資料,您可以建立連線,其中包含設定結構、資料集和工作流程所產生的資料。
連線可讓您將資料集從 Adobe Experience Platform 整合到工作區。 若要針對這些資料集製作報表,必須先為Adobe Experience Platform和Workspace中的資料集建立連線。
若要建立連線,請執行以下操作:
-
在Customer Journey Analytics UI中,選取頂端功能表中的連線 (選擇性的從資料管理)。
-
選取「建立新連線」。
-
在「無標題連線」畫面中:
在「連線設定」中為連線命名並提供說明。
從「資料設定」的「沙箱」清單中選取正確沙箱,並從「每日事件平均數」清單中選取每日事件數。
選取「新增資料集」。
在新增資料集的選取資料集步驟:
-
選取您先前建立的資料集和/或您要納入連線中的其他相關資料集(例如來自Adobe Journey Optimizer的推送追蹤體驗事件資料和推送設定檔資料)
-
選取「下一步」。
在新增資料集的資料集設定步驟:
-
對於每個資料集:
-
在 Adobe Experience Platform 中,從資料集結構描述中所定義的可用身分識別中選取人員 ID。
-
從「資料來源類型」清單中選取正確的資料來源。 如果您指定「其他」,請為您的資料來源新增說明。
-
根據您的偏好設定,設定 匯入所有新資料 和資料集回填現有資料。
-
-
選取「新增資料集」。
選取「儲存」。
-
如需如何建立和管理連線,以及如何選取和合併資料集的詳細資訊,請參閱連線概觀。
設定資料釋圖
資料檢視是特定於 Customer Journey Analytics 的容器,可讓您決定如何詮釋來自連線的資料。 它指定 Analysis Workspace 中可用的所有維度和量度,以及這些維度和量度從哪些欄取得資料。 資料檢視是為了在 Analysis Workspace 中報告資料而定義的。
若要建立資料釋圖,請執行以下操作:
-
在Customer Journey Analytics UI中,選取頂端功能表中的資料檢視 (可選擇從 資料管理 進行)。
-
選取「建立新的資料檢視」。
-
在設定步驟:
從「連線」清單中選取您的連線。
為連線命名,並 (可選) 提供說明。
選取「儲存並繼續」。
-
在元件步驟:
將您要納入的任何結構欄位和/或標準元件新增至量度或維度元件框。
選取「儲存並繼續」。
-
在設定步驟:
保留設定原樣並選取「儲存並完成」。
請參閱資料檢視總覽,以取得如何建立和編輯資料檢視、資料檢視中有哪些元件可供使用,以及如何使用區段和工作階段設定的詳細資訊。
設定專案
Analysis Workspace 是彈性的瀏覽器工具,可讓您根據資料快速建立分析及分享洞察。 您可以使用工作區專案合併資料元件、表格和視覺效果,進行分析並與貴組織的任何人分享。
若要建立專案,請執行以下操作:
-
在Customer Journey Analytics UI中,選取頂端功能表中的專案。
-
在左側導覽中選取「專案」。
-
選取「建立專案」。
選取「空白專案」。
-
從清單中選取您的資料釋圖。
。
-
若要建立您的第一個報表,請開始將維度和量度拖放至面板中的自由表格。 例如,將
Events拖曳為量度,將Push Title拖曳為維度(依Event Type劃分),以取得您行動應用程式的推播通知概觀以及發生狀況。
如需如何使用元件、視覺效果和面板建立專案和建立分析的詳細資訊,請參閱 Analysis Workspace 概觀。