インテグレーション:Olark

Mouseflowは、Olarkのようなチャットソフトウェアにシームレスにインテグレーションすることができます。Olark内のチャットセッションに再生URLを追加するか、Olarkの顧客の詳細をMouseflowセッションに追加するかのどちらかにより行うことができます。

Olarkに再生URLを追加する

Olarkには、カスタムフィールドをチャットセッションに追加できるJavaScript APIがあります。

以下のコードは、再生URLをOlarkのカスタムフィールドとして追加するためのコードです。

<script type="text/javascript">

  var _mfq = _mfq || [];
  _mfq.push(
    olark('api.visitor.updateCustomFields', {
      mouseflowPlaybackUrl: 'https://app.mouseflow.com/websites/' + 
        mouseflow.websiteId + '/recordings/' + mouseflow.getSessionId() + '/play'
    });
  );

</script>

コードにより、以下のようなことを行っています。

1. _mfq変数が使用可能であることを確認します。 これは、Mouseflowオブジェクトと通信するために使用される変数です。
2. _mfq.push（…）を呼び出して、Mouseflowのコンテキストが完全にロードされたときに内部関数が呼び出されるようにします。
3. Olarkに新しいカスタムフィールドを追加するために、Olark（ ‘api.visitor.updateCustomFields’、名前：値）を呼び出します。 名前は “mouseflowPlaybackUrl”で、値は再生のURLです（Mouseflowアカウントにログインしている必要があります）

OlarkからMouseflowへの顧客データの追加

Olarkには、JavaScript APIを通じて顧客の詳細を得る方法もあります。 このデータを使用してMouseflowに送信する方法を説明します。 以下のコード例を参照してください。

<script type="text/javascript">

  _mfq = _mfq || [];
  olark('api.visitor.getDetails', function(details) {
    if (details && details.emailAddress)
      _mfq.push(["setVariable", "olark_email", details.emailAddress]);
  });

</script>

上記のコードでは、Olarkセッションに登録されている電子メールアドレスがあるかどうかを確認し、登録されている場合は、カスタム変数としてMouseflowに追加しています。 ここで完全な “詳細”オブジェクトを見ることができます（右側の列を参照）。

このインテグレーションをさらに強化するために、上記のメールアドレスを使用してMouseflowで直接ユーザーを識別することができます。

以下の方法に従ってください：

<script type="text/javascript">

  _mfq = _mfq || [];
  olark('api.visitor.getDetails', function(details) {
    if (details && details.emailAddress)
      _mfq.push(["identify", details.emailAddress]);
  });

</script>