收集身分資料

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

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.resetIdentitiesMobileCore.resetIdentities API呼叫。 請注意,使用推播通知識別碼(請參閱傳送推播通知)時,該識別碼會成為裝置上的另一個「粘性」設定檔識別碼。
SUCCESS
您現在已設定應用程式,以更新Edge Network中的身分識別和(設定時) Adobe Experience Platform。
感謝您花時間學習Adobe Experience Platform Mobile SDK。 如果您有疑問、想分享一般意見或有關於未來內容的建議,請在這篇Experience League社群討論貼文上分享

下一步: 收集設定檔資料

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