文件Experience Platform行動應用程式教學課程

收集身分資料

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 初學者
  • 中繼
  • 開發人員

瞭解如何在行動應用程式中收集身分資料。

Adobe Experience Platform Identity Service可跨裝置和系統橋接身分，讓您即時提供具影響力的個人數位體驗，協助您更清楚瞭解客戶及其行為。 身分欄位和名稱空間是將不同資料來源連線在一起，以建立360度即時客戶個人檔案的膠水。

在檔案中進一步瞭解身分識別擴充功能和身分識別服務。

先決條件

  • 成功建立並執行應用程式，且已安裝並設定SDK。

學習目標

在本課程中，您將會：

  • 設定自訂身分名稱空間。
  • 更新身分。
  • 驗證身分圖表。
  • 取得ECID和其他身分。

設定自訂身分名稱空間

身分識別名稱空間是身分識別服務的元件，做為身分識別相關內容的指標。 例如，他們將name@email.com的值做為電子郵件地址，或將443522做為數值CRM ID。

NOTE
行動SDK會在安裝應用程式時，在其專屬的名稱空間中產生唯一身分識別，命名為Experience CloudID (ECID)。 此ECID會儲存在行動裝置的永久性記憶體中，並隨著每次點選而傳送。 ECID會在使用者解除安裝應用程式，或將Mobile SDK全域隱私權狀態設為選擇退出時移除。 在範例Luma應用程式中，您應該移除並重新安裝應用程式，以建立具有自己唯一ECID的新設定檔。

若要建立新的身分名稱空間：

  1. 在資料收集介面中，從左側欄導覽選取​ 身分。

  2. 選取​ 建立身分識別命名空間。

  3. 提供Luma CRM ID的​ 顯示名稱 ​和lumaCRMId的​ 身分識別符號 ​值。

  4. 選取​ 跨裝置識別碼。

  5. 選取「建立」。

    建立身分名稱空間

更新身分

您想要在使用者登入應用程式時更新標準身分（電子郵件）和自訂身分(Luma CRM ID)。

  1. 導覽至Xcode專案導覽器中的​ Luma > Luma > Utils > MobileSDK，並尋找func updateIdentities(emailAddress: String, crmId: String)函式實作。 將下列程式碼新增至函式。

    code language-swift 
    // Set up identity map, add identities to map and update identities
let identityMap: IdentityMap = IdentityMap()

let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)
identityMap.add(item:emailIdentity, withNamespace: "Email")
identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")

Identity.updateIdentities(with: identityMap)

    此程式碼：

    1. 建立空的IdentityMap物件。

      code language-swift 
      let identityMap: IdentityMap = IdentityMap()

    2. 設定電子郵件與CRM ID的IdentityItem物件。

      code language-swift 
      let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)

    3. 將這IdentityItem個物件新增至IdentityMap物件。

      code language-swift 
      identityMap.add(item:emailIdentity, withNamespace: "Email")
identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")

    4. 將IdentityItem物件當作Identity.updateIdentities API呼叫的一部分傳送至Edge Network。

      code language-swift 
      Identity.updateIdentities(with: identityMap)

  2. 導覽至Xcode專案導覽器中的​ Luma > Luma > Views > General > 登入工作表，並尋找在選取​ 登入 ​按鈕時要執行的程式碼。 新增下列程式碼：

    code language-swift 
    // Update identities
MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
NOTE
您可以在單一updateIdentities呼叫中傳送多個身分。 您也可以修改先前傳送的身分。

移除身分

您可以使用Identity.removeIdentity API從儲存的使用者端身分對應移除身分識別。 身分擴充功能會停止將識別碼傳送至Edge Network。 使用此API不會從伺服器端身分識別圖形中移除識別碼。 請參閱檢視身分圖，以取得身分圖的詳細資訊。

  1. 導覽至Xcode專案導覽器中的​ Luma > Luma > Utils > MobileSDK，並將下列程式碼新增至func removeIdentities(emailAddress: String, crmId: String)函式：

    code language-swift 
    // Remove identities and reset email and CRM Id to their defaults
Identity.removeIdentity(item: IdentityItem(id: emailAddress), withNamespace: "Email")
Identity.removeIdentity(item: IdentityItem(id: crmId), withNamespace: "lumaCRMId")
currentEmailId = "testUser@gmail.com"
currentCRMId = "112ca06ed53d3db37e4cea49cc45b71e"

  2. 導覽至Xcode專案導覽器中的​ Luma > Luma > Views > General > 登入工作表，並尋找在選取​ 登出 ​按鈕時要執行的程式碼。 新增下列程式碼：

    code language-swift 
    // Remove identities
MobileSDK.shared.removeIdentities(emailAddress: currentEmailId, crmId: currentCRMId)

使用保證進行驗證

  1. 檢閱設定指示區段，將您的模擬器或裝置連線到Assurance。

  2. 在Luma應用程式中

    1. 選取「首頁」標籤，並將「保證」圖示移至左側。

    2. 選取 從右上角 {width="15"}圖示。

      {width="300"}

    3. 提供電子郵件地址和CRM ID，或

    4. 選擇 {width="15"}以隨機產生​ 電子郵件 ​和​ CRM ID。

    5. 選取​ 登入。

      {width="300"}

  3. 檢視​ com.adobe.griffon.mobile ​廠商之​ Edge身分更新身分 ​事件的保證網頁介面。

  4. 選取事件並檢閱​ ACPExtensionEventData ​物件中的資料。 您應該會看到已更新的身分識別。
    驗證身分更新

使用身分圖表進行驗證

完成Experience Platform課程中的步驟後，即可在Platforms身分圖表檢視器中確認身分擷取：

  1. 在資料收集UI中選取​ 身分。

  2. 從頂端列選取​ 身分圖表。

  3. 輸入Luma CRM ID作為​ 身分識別名稱空間，並輸入您的CRM ID （例如24e620e255734d8489820e74f357b5c8）作為​ 身分識別值。

  4. 您會看到列出的​ 身分。

    驗證身分圖表

INFO
應用程式中沒有可重設ECID的程式碼，這表示您只能透過解除安裝應用程式並重新安裝，來重設ECID （並有效建立具有新ECID的新設定檔）。 若要實作識別碼的重設，請參閱Identity.resetIdentities與MobileCore.resetIdentities API呼叫。 請注意，使用推播通知識別碼（請參閱傳送推播通知）時，該識別碼會成為裝置上的另一個「粘性」設定檔識別碼。
SUCCESS
您現在已設定應用程式，以更新Edge Network中的身分識別和（設定時） Adobe Experience Platform。
感謝您花時間學習Adobe Experience Platform Mobile SDK。 如果您有疑問、想分享一般意見或有關於未來內容的建議，請在這篇Experience League社群討論貼文上分享

下一步： 收集設定檔資料

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b