概要

統合アイデンティティは、個人の属性を異なるデータソースからリンクし、一元化されたアイデンティティ表現を作成することを含みます。さまざまなデータ要素を組み合わせて接続を確立し、ユーザーの包括的なビューを作成します。これらのユーザーを単一のユーザープロファイルに解決することで、マーケターはさまざまなオンラインおよびオフラインのリソースから収集されたデータに基づいてユーザーを正確にセグメント化し、パーソナライズし、重複を避けることができます。
Identity Resolution 機能を使用すると、MoEngageでは、さまざまな識別子属性（ID、EmailID、携帯番号など）を使用して、同じユーザーの複数のプロファイルを統合することができます。これらの属性を識別子として利用して、MoEngageで単一の統合顧客プロファイルを構築することができます。これにより、各ユーザーの真実の唯一の情報源を維持し、アプリケーション上での行動をシームレスに追跡し、それに応じてビジネス戦略を設定することができます。

ユースケース

アイデンティティ解決は、次のシナリオで重要な役割を果たします。

• ユーザーがブランドのウェブサイトの公開リストページを閲覧し、メールID（MoEngageの Email ID 属性として追跡）と電話番号（MoEngageの Mobile Number (standard) ユーザー属性として追跡）を提供します。ブランドのオフラインストアで商品を購入する際、同じユーザーが電話番号を使用して購入を完了します。このブランドは、ウェブサイト上の閲覧活動を、電話番号を使用して店舗で購入したユーザーにリンクすることを目指しています。
• あるブランドは、メールログイン、モバイルOTP、Facebookなどのソーシャルメディアログインなど、複数のユーザー登録方法を提供しています。しかし、これらの方法は同じ個人に対して異なるユーザープロファイルを生成します。このブランドは、ユーザーがさらに活動を行う際に追加情報を収集する際に、これらの複数のプロファイルを単一の統一されたプロファイルに統合することを目指しています。

複数の識別子を構成する

アイデンティティ解決を使用する最初のステップは、識別子として適切なユーザー属性をアクティブにすることです。ワークスペースレベルで最大5つの識別子を設定できます。標準ユーザー属性 ID はデフォルトの識別子として設定されています。追加の識別子として、メールアドレスや携帯番号などの他のユーザー属性を設定することもできます。少なくとも1つの識別子が常にアクティブである必要があります。

例えば、メールアドレスと携帯番号を識別子として選択した場合、MoEngageはすべてのユーザーのメールアドレスと携帯番号を確認します。複数のユーザーが同じ携帯電話番号を共有しているが、異なるメールIDを持っている場合、システムは識別子の値の1つが正常に一致するため、それらのユーザーを1つのプロファイルに統合します。

ユーザープロファイルを比較する際に、値が矛盾している場合、システムはデフォルトの動作（変更可能）として、マージプロセス中に最新の最終閲覧タイムスタンプを持つユーザープロファイルの値を優先して考慮します。この優先プロファイルは 保持プロファイル と呼ばれ、優先度が低くなったプロファイルは 統合プロファイル と呼ばれます。マージされたプロファイルは、イベントとユーザー属性が保持されたプロファイルに転送された後に削除されます。

MoEngageダッシュボードで複数の識別子を設定するための手順を実行します（ID解決を表示およびアクセスできるのは管理者のみです）：

1. MoEngageダッシュボードの左側のナビゲーションメニューで、 設定 > データ > アイデンティティ解決 に移動します。
2. アイデンティティ解決 ページで、 +識別子を追加 をクリックします。アイデンティティ解決のために最大5つの識別子を追加できます。
   
   1. デフォルトでは、 ID がアイデンティティ解決を使用してユーザープロファイルをマージするための識別子としてリストされています。 アクティブ タグは、現在のワークスペースでユーザーをマージするために使用されている識別子を表します。
   2. 追加されたすべての識別子はこのページにリストされています。省略記号アイコン ( ) をクリックして、次の操作を行います:
      1. アイデンティティ解決を一時停止 : このオプションを使用すると、その識別子に基づくユーザーのマージを一時停止できます。
         
      2. 例外を表示/編集 : このオプションを使用すると、その識別子の例外を表示または編集できます。 例外の表示/編集 ダイアログボックスで、リストから例外を選択し、 保存 をクリックします。
         
3. マージ設定 オプションを選択すると、 ステップ2：マージルールの確認 に進みます。
4. 識別子を追加 ページで、次の手順を実行できます。

ステップ1: 識別子を選択

1. ユーザー属性 の横にあるチェックボックスを選択して、アイデンティティ解決の識別子として選択してください。
2. 各属性の説明 を表示できます。
3. 例外: MoEngage は、識別子ユーザー属性で検出された例外的な値を持つユーザー属性を取り込みません。識別子はユーザーを一意に識別するために使用されるため、 null や 空白 のようにこの独自性を達成しない値はシステムから除外されます。これらの値はデフォルトで例外として設定されており、編集や削除はできません。文字列形式である限り、追加の例外を追加することができます。
4. これらの識別子が取得されるさまざまな データソース を表示できます。識別子が複数のデータソースから収集される場合、その識別子をアイデンティティ解決に選択することは有利です。このアプローチは、さまざまなチャネルでのアイデンティティマッチングプロセスの信頼性を向上させます。
5. トラッキングされたデータタイプ は、MoEngageでこれまでにその属性のデータがトラッキングされたさまざまなデータタイプを示します。
   

   info	情報 String型のユーザー属性は、識別子としてアクティブ化することがサポートされています。 識別子として選択された他のデータタイプのユーザー属性は、既存のデータおよび新規データに対してStringに変換されます。

6. 次へ 次へ をクリックします。

ステップ2: マージルールの確認

1. プロファイル保持ルール: このルールは、どのユーザープロファイルを保持するべきかを決定します。プロファイル保持ルールを追加するには、次の手順を実行します：
   1. ルール 1 リストで、ユーザー属性を選択します。選択されたユーザー属性のデータポイントを含むユーザープロファイルが保持プロファイルと見なされます。ルール 1 が正常に検証されると、ルール 1 に基づいて保持プロファイルが選択されます。結合されるべき両方のユーザーが選択されたユーザー属性のデータポイントを持っている場合にルール 1 が同点を解消できない場合、ルール 2 が使用されます。ルール 1 は任意のルールであり、デフォルトでは空です。
   2. ルール 2 リストで、ユーザーの行動を選択します。選択されたユーザーの行動に基づいて、その行動を含むユーザープロファイルが保持プロファイルと見なされます。デフォルトでは、 最新の 最終閲覧 が自動的に入力され、保持されるユーザープロファイルを選択するために使用されます。ルール 2 は、ルール 1 が失敗した場合にのみ実行されます。
      例えば、同じユーザーのためにオンラインで受信されたプロファイル 1 とオフラインで受信されたプロファイル 2 の2つの顧客プロファイルがあるとします。
      シナリオ 1: 選択された属性にデータがあるプロファイルが保持プロファイルと見なされます。
      • プロファイル 1 には、ID、名前、メール、携帯番号などの属性があります。これらの属性はすべてデータを含んでいます。
      • プロファイル 2 には、ID、名前、メール、携帯番号などの属性があります。メールを除くすべての属性がデータを含んでいます。
        オンラインで受信された属性（プロファイル 1）の方がオフライン（プロファイル 2）よりも正確であり、プロファイル 1 を保持プロファイルと見なしたい場合、 ルール 1 リストで メール を選択します。結合中に、システムは メール 属性のデータを含むプロファイルを選択します。ここでは、プロファイル 1 が メール のデータを持っているので、保持プロファイルと見なされます。
      シナリオ 2: 両方のプロファイルが選択された属性にデータを持っている場合、ルール 1 が失敗し、ルール 2 が検証されます。

1. • • • • プロファイル1には、ID、名前、メールID、携帯番号、初回確認日などの属性があります。これらのすべての属性はデータを含んでいます。
         • プロファイル2には、ID、名前、メールID、携帯番号、および初回訪問が含まれています。これらの属性にはすべてデータが含まれています。
           ルール1 リストで メール を選択した場合、プロファイル1とプロファイル2の両方にIDのデータが含まれているため、ルール1は失敗します。したがって、 ルール2 が検証されます。
           ルール2 リストで 最新の 最終訪問 を選択すると、最新の最終訪問を含むプロファイルが保持されるプロファイルと見なされます。
           
2. 属性ルール : このルールを使用すると、カスタムユーザー属性のデータをマージできます。最大で5つのルールを追加できます。デフォルトでは、MoEngageは自動的にLTV（派生ユーザー属性）を入力し、システムはマージされる2つのユーザープロファイルのLTV値を合計します。最終的に解決されたユーザープロファイルには、保持されたユーザーとマージされたユーザーの両方からのLTV値の合計が含まれます。
   独自のカスタムユーザー属性ルールを追加するには、次の手順を実行します：
   1. ルールを追加 をクリックします。
   2. ユーザー属性 と マージルール を選択します。
      例えば、同じユーザーの2つの顧客プロファイルがあり、プロファイル1はオンラインで受信され、プロファイル2はオフラインで受信されたとします。各プロファイルには Loyality_points 属性があり、データが含まれています。これらのプロファイルがマージされるときに両方の Loyality_points の 合計 を取得したい場合、次の手順を実行します：
      1. ユーザー属性 リストで Loyality_points を選択します。
      2. マージルール リストで 値の合計 を選択します。
         したがって、ユーザープロファイルがマージされるたびに、結果として得られる統合プロファイルには、両方のプロファイルからの Loyality_points データの合計を含む Loyality_points 属性が含まれます。
         注 : 下の画像は、デモンストレーションのためにユーザー属性としてLTVを選択した場合を示しています。
         
3. マージの確認 セクションでは、設定したプロファイル保持および属性ルールに基づいてユーザーがどのようにマージされるかを示します。マージシナリオを確認した後、 すべてのマージシナリオを確認しました チェックボックスを選択してください。
   
4. 次へ をクリックします。

ステップ 3: アイデンティティ解決を有効化

このステップでは、アイデンティティ解決をアクティベートする前後に考慮すべき指示を提供します。

アイデンティティ解決を有効化する前に考慮すべき不可逆的な変更。変更には以下が含まれます：

• マージされたユーザーは、マージ解除できません。
• アクティベーション後48時間、Identity resolutionページで以下の操作はできません：
  • 新しい識別子を追加
  • 既存の識別子の一時停止、再有効化、例外の追加
  • マージ設定の変更

アイデンティティ解決を有効化した後:

• ワークスペース内の既存ユーザーは48時間以内にマージされます
• 新しいユーザーは、プロファイル保持ルールに基づいて既存のユーザーと統合されます
• ワークスペース内の同じ識別子値を持つ最大50人の既存ユーザーが正常にマージされ、残りはマージされません。これは、新しく受信されたユーザーには適用されず、設定されたマージルールに基づいて既存のユーザーと正常にマージされます。

「 アイデンティティ解決を有効にすることで、ユーザーの統合の影響を理解しています 」チェックボックスを選択し、「 有効化 」をクリックしてアイデンティティ解決を有効にします。

データインジェスチョンサポート

以下は、複数の識別子を使用してMoEngageにデータを取り込む方法です。

• データAPI
• SDK
• ファイルインポート

データAPI:

MoEngageでは、データの取り込みにIDを使用してユーザーを作成または更新します。Identity Resolutionが有効になっているMoEngageのワークスペースでは、Data APIs（Track User、Create Event、Bulk Import）を使用して、設定された特定の識別子（モバイル番号やメールIDなど）を使用してユーザーを作成または更新できます。

あなたはできる：

• IDがなくても他の識別子がある場合、サーバー間データAPIを通じてユーザーを作成します。
• ID以外の識別子（例えば、メールIDや電話番号）が判明している場合、ユーザーを作成するか、ユーザーのイベントを追跡します。

リクエストボディ

以下は、次のペイロードで構成される一括インポートAPIのサンプルcURLリクエストです。

• ユーザーペイロード：MoEngageでユーザーが作成、更新、またはマージされる際に、属性パラメーターには少なくとも1つの識別子が含まれている必要があります。
• イベントペイロード: ワークスペースで設定された識別子は、次の例に示すように、 user_identifiers パラメーター内で言及されなければなりません。ここでは、 moe_mobile がワークスペース内の識別子の1つです:
  
  JSON

  "user_identifiers":{
      "moe_mobile":"{{Mobile_Number}}"
  }

バルクインポートAPIのサンプルcURLリクエスト：

次の一括インポートAPIは、ユーザーとイベントのペイロードで構成されています。

curl --location 'https://api-xx.moengage.com/v1/transition?app_id=O7NIHY0AT1K1FL8DR1J1' \

      --header 'Content-Type: application/json' \

      --header 'Authorization: Basic {{Authorization_Key}}' \

      --data '{

        "type": "transition",

        "elements": [


        {

          "type": "customer",

          "attributes": {

            "moe_mobile": "{{Mobile_Number}}",

            "first_name": "John"

          }

        },


        {

          "type": "event",

          "user_identifiers": {

            "moe_mobile": "{{Mobile_Number}}"

          },

          "actions": [

          {

            "action": "AddToCart",

            "attributes": {

              "product": "MacBook Air",

              "Brand": "Apple"

            }

          }

          ]

        }

        ]

      }'

SDK

アイデンティティ解決の変更が利用可能なサポートされているSDK:

• Android ( 13.6.00 )
• iOS ( 9.23.0 )
• WebSDK ( 2.52.2 )
• GTM
• AMP
• ReactNative
• Flutter

identifyUser() 関数は、アイデンティティ解決と互換性のある新しいSDKバージョンで導入されています。この関数は SetUniqueID 関数の直接的な代替であり、複数の識別子属性でユーザーを追跡することができます。 IdentifyUser 関数を実装する前に、これらの識別子をMoEngageで設定してください。

以下は、メールとIDが特定のワークスペースで識別子として設定されているSDKサンプルコードの例です。

サンプルコード

MoEAnalyticsHelper.identifyUser(context, "android-native-uid")
MoEAnalyticsHelper.identifyUser(
    context,
    mapOf(
        "email" to "android@moengage.com",
        "id" to "android"
    )
)

MoEngageSDKAnalytics.sharedInstance.identifyUser(identity: "ios-native-uid")
MoEngageSDKAnalytics.sharedInstance.identifyUser(identities: [
    "email": "ios@moengage.com",
    "id": "ios"
])

Moengage.identifyUser({
  uid: 'uid1',
  u_em: 'email1@someEmail.com'
})

ReactMoE.identifyUser("react-native-uid");
ReactMoE.identifyUser({
    "id": "react-native",
    "email": "react-native@moengage.com"
})

final MoEngageFlutter _moengagePlugin = MoEngageFlutter(WORKSPACE_ID);
_moengagePlugin.identifyUser("flutter-uid");
_moengagePlugin.identifyUser({
    "email": "flutter@moengage.com",
    "id": "flutter"
})

ファイルインポート

ワークスペースに設定されている複数の識別子を以下のセクションで確認できます。

セグメントでのユーザーインポート

• 特定のワークスペースに複数の識別子を設定している場合、新しいユーザーインポートを作成する際のステップ2で 識別子のマッピング セクションにそれらを表示できます。このワークスペースで複数の識別子が設定されていない場合は、 識別子のマッピング セクションに ID のみが表示されます。
  
  

  info	情報 アップロードされたCSVには、MoEngageで設定された識別子のいずれかと一致するデータを持つ列が少なくとも1つ必要です。 ワークスペースで識別子を有効化した後、既存の定期的なインポートを編集して、識別子を正しいCSV列にマッピングしてください。

• MoEngageワークスペースで複数の識別子機能が有効になっている場合、匿名IDとして識別子ユーザー属性が選択されると、インポートされたユーザーが同じ識別子値を持つ既存のユーザーとマージされる可能性があります。例えば、識別子としてメールIDを設定し、識別子をマッピングする際にメールIDを匿名IDとして選択した場合、インポートされたユーザーが同じメールIDを持つ他のユーザーとマージされる可能性があります。
  

データ内のデータインポート

• 新しいユーザーデータのインポートを作成する際、特定のワークスペースに複数の識別子を設定している場合、新しいユーザーインポートを作成する際に 識別子のマッピング セクションでそれらを確認できます。このワークスペースで複数の識別子が設定されていない場合、 マップ識別子 セクションの下に ID のみが表示されます。
• 特定のワークスペースに対して複数の識別子を設定している場合、新しいイベントデータインポートを作成する際に、 ステップ 2: インポートの構成とアクション の 識別子のマッピング セクションでそれらを確認できます。このワークスペースで複数の識別子が設定されていない場合、 識別子のマッピング セクションでは ID と イベント時間 のみが表示されます。
  
  

  info	情報 アップロードされたCSVには、MoEngageで設定された識別子のいずれかに一致するデータを含む少なくとも1つの列が必要です。

• 新しい補助データインポートを作成する際に
  ステップ2: インポートの構成とアクション で、 ユーザープロファイル属性の更新 (オプション) トグルをオンにすると、そのワークスペースの複数の識別子を 識別子のマッピング セクションで表示できます。このワークスペースで複数の識別子が構成されていない場合は、 識別子のマッピング セクションに ID のみが表示されます。
  

ユーザーの統合の影響

以下は、ユーザーマージがさまざまなキャンペーンおよびチャネルに与える影響です。

データについて

• ユーザー属性情報: 統合されると、保持されたユーザーのすべてのユーザー属性情報が保持されます。マージされたユーザーの属性が保持されたユーザーに存在しない場合、それらの属性は保持されたユーザープロファイルに転送されます。

• デバイス情報: マージされると、すべてのデバイスが保持されたユーザーにマージされ、デバイス情報は失われません。
• イベント情報: 統合されたユーザーのすべてのイベントは保持されたユーザーに転送されるため、ユーザー統合中にイベントが失われることはありません。解決されたユーザーは、マージされたすべてのユーザーのイベントを持つことになります。
• その他のデータの呼び出し: ユーザーはマージ後にマージを解除することはできません。ワークスペースの識別子を設定する際は注意してください。

オンセグメント

• アクティブ セグメント: ユーザーがマージされると、ユーザーが単一のプロファイルにマージされるため、アクティブセグメント内のユーザーの総数が減少する可能性があります。
• カスタムセグメント: カスタムセグメントが更新されるたびに、ユーザー数が変わる可能性があります。

キャンペーン中

• ユーザーの統合は、全体的な到達可能性の数に影響を与える可能性があります。統合されると、統合されたユーザーの連絡先情報が失われるため、キャンペーンの全体的な到達可能性が低下する可能性があります。これは全体的なキャンペーンの統計にも影響します。
• データAPI（TrackUser、CreateEvent、BulkImport API）のみが、複数の識別子を持つユーザーの追跡をサポートしています。MoEngageの他のAPIは、現在もIDを必要とする場合があります。

到達可能性の影響

ShopifyでマルチIDを有効にする