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

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

前提条件

Genesys Cloud CXで以下の権限を設定します。
- Journey > Settings > Edit, or View

注意： この記事は、ウェブチャットをご利用のお客様のみに適用されます。 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と地域がすでに含まれています。

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

広告ブロッカー

広告ブロッカーは、ページの読み込み時間を短縮し、疑わしい追跡を最小限に抑えるプラグインまたはブラウザ拡張機能です。すぐに使用できる設定でテストされた広告ブロッカーの大部分は、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 サイト

展開の概要

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

注意： 高度なチャットルーティングの詳細については、Genesys Predictive Engagement with advanced chat routing をご覧ください。

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

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

Genesys Predictive Engagementがウェブサイト上のアクティビティを追跡する方法をカスタマイズするには、タグマネージャによるイベントトラッキングについてをご覧ください。
Genesys Predictive Engagementのトラッキングスニペットを関数でカスタマイズするには、 Journey JavaScript SDK を参照してください。

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

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

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

展開手順

注意： Genesys Predictive Engagement トラッキングスニペットをデプロイする場所の上に、ウィジェットトランスポートトランスポートをデプロイします。

スニペットをコピーした後、以下のいずれかを行ってください。

トラッキングスニペットを手動で配置するには、コピーしたスニペットをウェブサイトに貼り付けてください。
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 を初期化します。詳細については、初期化。
SPAスニペットを使用する場合は、ac('load')ロードする自動トラックURL変更モジュールを作成して、Journey JavaScript SDK を初期化します。詳細については、負荷そして自動トラックURL変更。

Journey JavaScript SDKを初期化すると、予測エンゲージメントはpageview訪問者がウェブページにアクセスしたときに発生するイベント。詳細については、追跡方法。

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

ウェブトラッキング

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

カスタムモジュール

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

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

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

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

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