プレディクティブ・エンゲージメント・トラッキングのスニペット

機能の廃止:Genesys は、対応するすべてのチャット ウィジェット バージョンを通じて顧客に提供されている ACD Web Chat v2 のサポートを終了します。これは、以前に発表された ACD Web Chat v1 の廃止に続くものです。その結果、Predictive Engagement では、これらの従来の Web チャット バージョンのサポートも終了します。詳細については、「廃止予定」を参照してください。 ACD Web チャットの削除 (バージョン 2) 。 既存のすべてのお客様には、Web メッセージングと Messenger への移行をお勧めします。

前提条件

注意： この記事は、ウェブチャット をご利用のお客様のみに適用されます。 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 の追跡 Web ビーコンを無効にします。これにより、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 のダッシュと引用符を印刷可能な同等品に置き換える

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

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

  • If you use the traditional snippet, call ac('init') to initialize the Journey JavaScript SDK. For more information, see init.
  • If you use the SPA snippet, use ac('load') to load the autotrackUrlChange module and initialize the Journey JavaScript SDK. For more information, see load and autotrackURLChange.

After you initialize the Journey JavaScript SDK, Predictive Engagement tracks pageview events when visitors arrive on your webpages. For more information, see Tracking methods.

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

ウェブトラッキング

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

カスタムモジュール

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

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

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

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

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