ID データを収集

モバイルアプリで ID データを収集する方法を説明します。

Adobe Experience Platform ID サービスを使用すると、デバイスやシステム間で ID を結び付け、顧客とその行動をより良く把握でき、効果的な個人のデジタルエクスペリエンスをリアルタイムで提供できます。 ID フィールドと名前空間は、異なるデータソースを結合して、360 度のリアルタイム顧客プロファイルを構築するための接着剤です。

詳しくは、 ID 拡張機能 そして id サービス 」を参照してください。

前提条件

  • SDK が正常に構築され、インストールされ、設定された状態でアプリが実行されました。

学習内容

このレッスンでは、次の操作を実行します。

  • カスタム ID 名前空間を設定します。
  • ID を更新します。
  • ID グラフを検証します。
  • ECID やその他の ID を取得します。

カスタム ID 名前空間の設定

ID 名前空間は、 ID サービス id が関連するコンテキストのインジケーターとして機能する 例えば、 name@email.com 電子メールアドレスとして、または 443522 を数値 CRM ID として設定します。

NOTE
Mobile SDK は、アプリがインストールされると、Experience CloudID(ECID) という名前の一意の ID を独自の名前空間に生成します。 この ECID はモバイルデバイスの永続的なメモリに保存され、ヒットのたびに送信されます。 ECID が削除されるのは、ユーザーがアプリをアンインストールしたとき、またはユーザーが Mobile SDK のグローバルプライバシーステータスをオプトアウトに設定したときです。 サンプルの Luma アプリで、アプリを削除してから再インストールし、独自の一意の ECID を持つ新しいプロファイルを作成する必要があります。

新しい ID 名前空間を作成するには:

  1. データ収集インターフェイスで、「 」を選択します。 ID をクリックします。

  2. ID 名前空間を作成」を選択します。

  3. 次を提供: 表示名 / Luma CRM ID および ID シンボル の値 lumaCRMId.

  4. 選択 クロスデバイス ID.

  5. 作成」を選択します。

    id 名前空間を作成

ID を更新

ユーザーがアプリにログインする際に、標準 ID(電子メール)とカスタム ID(Luma CRM ID) の両方を更新する必要がある場合。

  1. に移動します。 Luma > Luma > Utils > MobileSDK Xcode プロジェクトナビゲーターで、 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. 設定 IdentityItem 電子メール ID と CRM ID 用のオブジェクト。

      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 Edge ネットワークへの API 呼び出し。

      code language-swift
      Identity.updateIdentities(with: identityMap)
      
  2. に移動します。 Luma > Luma > Views > General > LoginSheet をクリックし、 ログイン 」ボタンをクリックします。 次のコードを追加します。

    code language-swift
    // Update identities
    MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    
NOTE
1 回のみで複数の ID を送信できます updateIdentities を呼び出します。 また、以前に送信した ID を変更することもできます。

ID の削除

以下を使用すると、 Identity.removeIdentity 保存されたクライアント側 ID マップから ID を削除する API。 ID 拡張機能が Edge ネットワークへの識別子の送信を停止します。 この API を使用しても、サーバー側の ID グラフから識別子が削除されることはありません。 詳しくは、 ID グラフの表示 id グラフについて詳しくは、を参照してください。

  1. に移動します。 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. に移動します。 Luma > Luma > Views > General > LoginSheet をクリックし、 ログアウト 」ボタンをクリックします。 次のコードを追加します。

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

アシュランスで検証

  1. 以下を確認します。 設定手順 シミュレーターまたはデバイスを Assurance に接続するには、「 」セクションを参照してください。

  2. Luma アプリ内

    1. を選択します。 ホーム タブをクリックし、アシュランスアイコンを左に移動します。

    2. を選択します。+-------------+ | img-md | +=============+ | w-15 | +-------------+ | | +-------------+アイコンを右上に表示します。

      img-md
      w-300
    3. 電子メールアドレスと CRM ID を入力するか、

    4. 選択+-------------+ | img-md | +=============+ | w-15 | +-------------+ | | +-------------+ランダムに生成するには 電子メール および CRM ID.

    5. 選択 ログイン.

      img-md
      w-300
  3. Assurance Web インターフェイスで エッジ ID の更新 ID イベント com.adobe.griffon.mobile ベンダー。

  4. イベントを選択し、 ACPExtensionEventData オブジェクト。 更新した ID が表示されます。
    id の更新を検証

ID グラフで検証

手順を完了したら、 Experience Platformレッスンを使用すると、Platforms の ID グラフビューアで ID の取得を確認できます。

  1. 選択 ID (データ収集 UI)を参照してください。

  2. 選択 ID グラフ 上部のバーから。

  3. 入力 Luma CRM ID として ID 名前空間 と CRM ID(例: ) 24e620e255734d8489820e74f357b5c8) を ID 値.

  4. 次のように表示されます。 ID リストに表示されました。

    id グラフを検証

INFO
ECID をリセットするコードがアプリにないので、ECID をアンインストールして再インストールするだけで、ECID をリセット(新しい ECID で新しいプロファイルを効果的に作成)できます。 識別子のリセットを実装するには、 Identity.resetIdentities および MobileCore.resetIdentities API 呼び出し。 ただし、プッシュ通知識別子を使用する場合は、 プッシュ通知の送信) の代わりに使用され、その識別子がデバイス上の別の「スティッキー」プロファイル識別子になります。
SUCCESS
これで、Edge ネットワーク内の ID を更新するアプリを設定し、(設定時に)Adobe Experience Platformで ID を更新するようになりました。
Adobe Experience Platform Mobile SDK の学習に時間を割いていただき、ありがとうございます。 ご質問がある場合、一般的なフィードバックを共有する場合、または今後のコンテンツに関する提案がある場合は、このドキュメントで共有します Experience Leagueコミュニティディスカッション投稿

次へ: プロファイルデータを収集

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