Verada Docs

ユーザーID ​

リピーターを識別する能力を向上させるためにユーザーIDを管理する。

はじめに ​

Veradaは、ユーザーのブラウザに一意の匿名識別子を割り当てることでユーザーを識別します。リピーターは、同じブラウザでウェブサイトに戻ってきたときに検出されます。

ユーザーは異なるブラウザを使用したり、モバイルデバイスからノートパソコンに移動したり、定期的に閲覧データをクリアしたりする可能性があります。Veradaは、ユーザーの異なるプラットフォーム間での動きを連携させ、ユーザーのジャーニーを全体的に把握する機能を提供します。これは、1つ以上の既知のIDをVeradaに提供することで実現されます。

既知のIDをVeradaの統合に提供すると、Veradaは同じIDを共有するユーザーを連携させ、統合することができます。これにより、Veradaが取得する行動データから実用的な洞察を得る能力が大幅に向上します。

ユーザー識別 ​

ユーザーIDは、ページトラッキングおよびオーダートラッキング統合を通じて、IDマップオブジェクトを提供することでVeradaと共有されます。

例 ​

以下は、$userとcrm1という2つのIDの詳細を提供するIDマップデータ構造の例です。

  • 各IDオブジェクトには、IDタイプの一意のユーザー識別子を指定する必須のuserIdプロパティがあります。
  • 特殊な$user IDは、ウェブサイトまたはアプリでログインしているユーザーのIDを指定するために使用されます。
  • 使用されるIDタイプの名前は任意であり、環境にとって意味のある任意の英数字名を使用できます。この例では、crm1は、顧客関係管理システムにおけるユーザーのIDをVeradaユーザーIDと関連付けるために使用されます。また、dataオブジェクトを介して追加の属性も関連付けます。
json
{
  "$user": {
    "userId": "23872392383"
  },
  "crm1": {
    "userId": "b70115f2-aea8-456a-ab07-f9152257df4d",
    "data": {
      "key1": "value1",
      "key2": "value2"
    }
  }
}

データ型 ​

IdentityMap ​

typescript
// 各プロバイダーIDと一致するキーを持つオブジェクト
interface IdentityMap {
  [providerId: string]: Identity;
  // Veradaがサポートする、ウェブサイトのログインユーザーIDを表すための
  // オプションの特殊なID。
  $user?: Identity;
}

Identity ​

typescript
interface Identity {
  // 一意のユーザー識別子。
  userId: string;
  // 任意のデータを含むオプションのオブジェクト。
  data: {
    [key: string]: any;
  };
}

ページトラッキングタグによるユーザーの識別 ​

ページトラッキングJavaScriptタグは、IDマップを受け入れるidentitiesプロパティをサポートしています。

json
{
  "version": 3,
  "accountKey": "...",
  "data": {
    "pageType": "..."
  },
  "identities": {
    "$user": {
      "userId": "23872392383"
    },
    "crm1": {
      "userId": "b70115f2-aea8-456a-ab07-f9152257df4d",
      "data": {
        "key1": "value1",
        "key2": "value2"
      }
    }
  }
}

Veradaデータレイヤーによるユーザーの識別 ​

Veradaデータレイヤーは、ページトラッキングタグで事前に定義することなく、IDをVeradaにプッシュするために使用できます。

ウェブサイトでデータレイヤーを定義した後、次のようにIDをプッシュするだけです。

html
<!--
  この例では、Veradaデータレイヤー配列がドキュメント内の
  どこか前の部分で次のように定義されていることを前提としています：
-->
<script>
  var fanplayr_api = [];
</script>

<script>
  fanplayr_api.push({
    _type: 'identities',
    $user: {
      userId: '23872392383'
    },
    crm1: {
      userId: 'b70115f2-aea8-456a-ab07-f9152257df4d',
      data: {
        key1: 'value1',
        key2: 'value2'
      }
    }
  });
</script>

IDプロバイダーの管理 ​

VeradaポータルのID管理エリアでは、IDプロバイダーを定義および管理できます。この情報は、Veradaのストリームサービスが、定義した外部エンドポイントにデータとともにどのユーザーIDをストリームすべきかを理解するために使用されます。

たとえば、VeradaをCRMに接続していて、VeradaがCRMにストリームするデータにユーザーのCRM IDを含めたい場合、CRM用のIDプロバイダーを作成し、上記のいずれかの方法で関連するIDを提供します。VeradaがCRMにデータをストリームする際、それに関連付けられたIDが含まれます。

提供される各IDには、次のプロパティがあります。

  • key - 任意の文字列値である一意の識別子。このキーはIDマップJavaScriptオブジェクトで使用されます。例：「crm1」。
  • name - IDの一意の表示名。これはVeradaポータルでのみ表示されます。例：「Salesforce」。

ログインユーザーID ​

Veradaは、ウェブサイトのログインユーザーのIDを渡すために使用できる特殊な$user IDプロバイダーキーをサポートしています。

例えば、ユーザーがウェブサイトにログインした後、Veradaのデータレイヤー変数を使用して、ログインユーザーのIDをVeradaユーザーに関連付けることができます：

javascript
fanplayr_api.push({
  _type: 'identities',
  $user: {
    userId: '234902834211'
  }
});

INFO

注: ユーザーのログインIDを指定するこの方法は、ページトラッキングタグでcustomerIdプロパティを指定することと同等です。この方法が推奨されますが、後方互換性のためにcustomerIdプロパティは引き続き機能します。

ユーザーIDの結合 ​

Veradaは、重複するIDを持つ個々のユーザーを自動的に結合することを理解することが重要です。

例：

  • 匿名のユーザーが初めてウェブサイトを訪れます。Veradaは、そのブラウザに一意のユーザーキーを関連付けます。例：「User_1234」。
  • ユーザーが同じユーザーキーで戻ってくる限り、Veradaはそのユーザーを識別し続けます。
  • 後で、ユーザーがウェブサイトにログインし、ウェブサイトがVeradaのID管理システムを使用して、ウェブサイトのログインユーザーのIDをVeradaに通知します。
javascript
fanplayr_api.push({
  _type: 'identities',
  $user: {
    userId: '234902834211'
  }
});
  • この時点から、Veradaは独自のユーザーキー「User_1234」をウェブサイトのログインユーザーID「234902834211」と連携させます。
  • その後、ユーザーが別のデバイスでウェブサイトに戻ったり、閲覧データをクリアしたりした場合、Veradaはユーザーに新しいユーザーキーを割り当てます。例：「User_5678」。
  • 最後に、ユーザーが再度ウェブサイトにログインし、Veradaに同じログインユーザーID「234902834211」が提供された場合、Veradaはユーザー「User_1234」と「User_5678」が同一人物であると理解し、それらを結合して単一のプロファイルと履歴を形成します。

Copyright © 2011-present Verada