前提条件

注意: この記事は、ウェブチャット をご利用のお客様のみに適用されます。 Genesys Cloud CXをご利用のお客様には、Webチャットに代わる新しい機能として、Webメッセージング をご利用いただくことをお勧めします。

トラッキングスニペットについて

ウェブチャットを使用したいお客様は、Predictive Engagementトラッキングスニペットを導入する必要があります。 このスニペットは、ウェブサイトに Predictive Engagement トラッキングを導入し、またウェブチャット 機能を使用することができます。
Webメッセージングを使用したいGenesys Cloud CXのお客様は、 Messenger snippet をデプロイする必要があります。 このスニペットは、ウェブサイトに Predictive Engagement トラッキングを導入し、また Web メッセージング 機能を使用することができます。
重要
この記事では、Predictive Engagementトラッキングスニペットのみをデプロイするための手順を説明します。

始める前に

Genesys Predictive Engagementが追跡するデータの種類と、法規制に準拠した方法で訪問者データを追跡する方法についてお読みください。 広告ブロックソフトを使用することの意味を理解する。 最後に、トラッキングスニペットの仕組みと、利用できるトラッキングスニペットの種類について学びます。

スニペットをコピーする

Genesys Predictive Engagementは、コピー&ペーストが可能なトラッキングスニペットを提供します。 Genesys Cloud CXにログインしているため、トラッキングスニペットに組織IDと地域がすでに含まれています。

  1. どのスニペットを使うか を決定します。
  2. Genesys Cloud CXのAdminで、 Global Settings ページを開き、 Tracking Snippet タブをクリックします。
  3. トラッキングスニペットをコピーします。
  4. スニペットを貼り付けます。 スニペットの貼り付け場所については、 スニペットのデプロイ を参照してください。

広告ブロッカー

広告ブロックは、ページの読み込み時間を改善し、疑わしい追跡を最小限に抑えるプラグインまたはブラウザの拡張機能です。 すぐに使える設定でテストした広告ブロッカーの大半は、Genesys Predictive Engagementのトラッキング機能を妨害しません。 ただし、uBlock Originを使用する場合、いくつかの注意点があります。

  • uBlock OriginはGenesys Predictive Engagementのトラッキングウェブビーコンを無効化し、Genesys Predictive Engagementのトラッキング機能を効果的に阻止します。
  • uBlock OriginとuBlock Plus Adblockerは、Adobe Tag Manager、Google Tag Managerなどの一般的なタグマネージャーをブロックします。
重要
タグマネージャーを使用してWebサイトのJavaScriptとトラッキングを管理している場合、広告ブロッカーを検出した訪問者に重要な機能を逃している可能性があることを通知するために、サイトに広告ブロッカー検出機能を追加することを検討してください。 また、Genesys Predictive Engagementのトラッキングスニペットを展開するためにタグマネージャーを使用する代わりに、トラッキングスニペットをウェブサイトの本文またはヘッダーに直接配置することを検討してください。

トラッキングスニペットの種類とレコメンデーション

ウェブサイトスニペット

Webサイトスニペットは、動的なコンテンツをほとんど含まない従来のWebページにトラッキングのサポートを提供します。 従来のWebサイトでは、訪問者が別のURLに移動するたびに新しいHTMLページが読み込まれます。 従来のウェブページにトラッキングサポートを提供するために、ウェブサイトスニペットは、ウェブブラウザが新しいページをロードするたびに、 ac('pageview') を呼び出します。

SPAスニペット

SPAスニペットは、Single Page Application(SPA)のアクティビティを追跡することができます。 SPAは、HTMLページのハードリロードを必要とせず、オンデマンドで動的なコンテンツをロードします。 また、SPAスニペットでは、ウェブサイトスニペットにはない相対リンクのクリックを追跡することができます。 このSPAスニペットは、Angular、React、Vue.jsなどのSPAで動作します。 SPAスニペットで利用可能な追加のトラッキングオプションの詳細については、 autotrackURLChange を参照してください。

おすすめスニペット

こんなサイトがあったら...。このスニペットを使う...
不明スパ
従来のページとSPAのページが混在スパ
従来のページのみWeb サイト

展開の概要

トラッキングスニペットのデプロイメント

  1. スニペットをコピーします。
  2. (オプション)スニペットをカスタマイズします。
  3. スニペットをデプロイします。
  4. スニペットが動作することを確認します。
  5. ウェブトラッキングを設定します。
注意: 高度なチャットルーティングの詳細については、Genesys Predictive Engagement with advanced chat routing をご覧ください。

(オプション) スニペットのアクティビティ追跡方法をカスタマイズします。

スニペットがウェブサイト上のアクティビティを追跡する方法をカスタマイズすることができます。

スニペットをデプロイする

スニペットのデプロイについて

  • Genesys Predictive Engagementトラッキングスニペットを展開する場所の上に、ウィジェット輸送を展開します。
  • Genesys Predictive Engagementトラッキングスニペットをトラッキング対象のWebサイトのメインウィンドウに展開します。
  • ウェブサイトテンプレートページのheadセクションに、閉じタグの前にトラッキングスニペットを貼り付けます。
  • トラッキングスニペットをiframe内に展開しないでください。
  • Genesys Predictive Engagementトラッキングスニペットは、ページの読み込みを遅くすることなく、JavaScriptを非同期で読み込みます。 トラッキングスニペットの動作の詳細については、 トラッキングスニペットについて を参照してください。

展開手順

スニペット をコピーした後、以下のいずれかを行ってください。
  • トラッキングスニペットを手動で配置するには、コピーしたスニペットをウェブサイトに貼り付けてください。
  • Google タグマネージャを使用してトラッキングスニペットを配置するには、 Google タグマネージャを使用してトラッキングスニペットを配置する を参照してください。
  • Adobe Launchを使用してトラッキングスニペットをデプロイするには、 Use Adobe Launch with Genesys Predictive Engagement をご覧ください。
  • 他のタグマネージャーを使用してトラッキングスニペットをデプロイするには、タグマネージャーのベンダーの説明を参照してください。
注意: uBlockなどの広告ブロックソフトは、タグマネージャーをブロックすることが知られており、その場合、タグマネージャーを通じて展開されるトラッキングスニペットもブロックされることになります。 詳しくは、 広告ブロッカー をご覧ください。

スニペットが動作することを確認する

トラッキングスニペットを展開した後、Live Nowを使用して、Genesys Predictive EngagementがWebサイトのアクティビティをトラッキングしていることを確認します。 4~5秒ごとに更新があるはずです。

スニペットのトラブルシューティング

Webページを読み込んだときにトラッキングスニペットが正しく動作しない場合は、以下を確認してください。

  • スニペットは正しいページに表示されていますか?
  • スニペットは、ページヘッダーの正しい位置にありますか?
  • パラメータは正しく定義されていますか?
  • 誤字、脱字、余分な空白はありませんか?
  • 印刷用の文字に置き換えたものはありますか?
  • ドメインは許可されたドメインのリストにあるか?

その他の提案については、 スニペットのデプロイメントについて をご覧ください。

エラーリファレンス

エラーコード   説明
403エラーあなたのドメインは、 許可されたドメイン のリストに入っていますか?
404エラースニペットの中に余分な空白がありませんか?

注意:  URLでは、ホワイトスペースは%20としてエンコードされます。

リクエスト エラースニペットの中に余分な空白がありませんか?

注意:  URLでは、ホワイトスペースは%20としてエンコードされます。

初期化エラースニペットの中に次のようなものはありませんか。
  • タイポス
  • 欠落している文字
  • URL のダッシュと引用符を印刷可能な同等品に置き換える

トラッキングスニペットを呼び出す

トラッキングスニペットをウェブページに設置した後、以下のいずれかの方法でトラッキングスニペットを呼び出してください。

  • 従来のスニペットを使用する場合、 ac('init') を呼び出し、Journey JavaScript SDKを初期化します。 詳しくは、 init をご覧ください。
  • SPAスニペットを使用する場合、 ac('load') を使用して autotrackUrlChange モジュールをロードし、Journey JavaScript SDKを初期化します。 詳しくは、 load and autotrackURLChange をご覧ください。

Journey JavaScript SDKを初期化した後、Predictive Engagementは訪問者がウェブページに到着すると、 pageview イベントを追跡します。 詳しくは、 トラッキングメソッド をご覧ください。

その他のトラッキングオプション

ウェブトラッキング

Webトラッキング 機能を使用して、トラッキングするドメインを指定し、Web関連のトラッキング設定を行います。

カスタムモジュール

Journey JavaScript SDKが提供する機能を強化するために、 モジュール のセットを使用します。

タグマネージャーによるイベントトラッキング

タグマネージャーを使用して、カスタムタグとトリガーを構築し、Predictive Engagementがお客様のウェブサイト上のアクティビティを追跡する方法を定義します。 詳しくは、 タグマネージャによるイベントトラッキングについて をご覧ください。

Cookieによるドメインおよびサブドメインのトラッキング

ドメインとサブドメインを追跡するためにクッキーを使用します。 詳しくは、 Cookies および Advanced tracking with Cookies をご覧ください。