プレディクティブ・エンゲージメント・トラッキングのスニペット
前提条件
- Genesys Cloud CXで以下の権限を設定します。
- Journey > Settings > Edit, or View
トラッキングスニペットについて
始める前に
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のトラッキングウェブビーコンを無効化し、Genesys Predictive Engagementのトラッキング機能を効果的に阻止します。
- uBlock OriginとuBlock Plus Adblockerは、Adobe Tag Manager、Google Tag Managerなどの一般的なタグマネージャーをブロックします。
トラッキングスニペットの種類とレコメンデーション
ウェブサイトスニペット
Webサイトスニペットは、動的なコンテンツをほとんど含まない従来のWebページにトラッキングのサポートを提供します。 従来のWebサイトでは、訪問者が別のURLに移動するたびに新しいHTMLページが読み込まれます。 従来のウェブページにトラッキングサポートを提供するために、ウェブサイトスニペットは、ウェブブラウザが新しいページをロードするたびに、 ac('pageview') を呼び出します。
SPAスニペット
SPAスニペットは、Single Page Application(SPA)のアクティビティを追跡することができます。 SPAは、HTMLページのハードリロードを必要とせず、オンデマンドで動的なコンテンツをロードします。 また、SPAスニペットでは、ウェブサイトスニペットにはない相対リンクのクリックを追跡することができます。 このSPAスニペットは、Angular、React、Vue.jsなどのSPAで動作します。 SPAスニペットで利用可能な追加のトラッキングオプションの詳細については、 autotrackURLChange を参照してください。
おすすめスニペット
(オプション) スニペットのアクティビティ追跡方法をカスタマイズします。
スニペットがウェブサイト上のアクティビティを追跡する方法をカスタマイズすることができます。
- Genesys Predictive Engagementがウェブサイト上のアクティビティを追跡する方法をカスタマイズするには、 タグマネージャによるイベントトラッキングについて をご覧ください。
- Genesys Predictive Engagementのトラッキングスニペットを関数でカスタマイズするには、 Journey JavaScript SDK を参照してください。
スニペットをデプロイする
スニペットのデプロイについて
- Genesys Predictive Engagementトラッキングスニペットを展開する場所の上に、ウィジェット輸送を展開します。
- Genesys Predictive Engagementトラッキングスニペットをトラッキング対象のWebサイトのメインウィンドウに展開します。
- ウェブサイトテンプレートページのheadセクションに、閉じタグの前にトラッキングスニペットを貼り付けます。
- トラッキングスニペットをiframe内に展開しないでください。
- Genesys Predictive Engagementトラッキングスニペットは、ページの読み込みを遅くすることなく、JavaScriptを非同期で読み込みます。 トラッキングスニペットの動作の詳細については、 トラッキングスニペットについて を参照してください。
展開手順
- トラッキングスニペットを手動で配置するには、コピーしたスニペットをウェブサイトに貼り付けてください。
- Google タグマネージャを使用してトラッキングスニペットを配置するには、 Google タグマネージャを使用してトラッキングスニペットを配置する を参照してください。
- Adobe Launchを使用してトラッキングスニペットをデプロイするには、 Use Adobe Launch with Genesys Predictive Engagement をご覧ください。
- 他のタグマネージャーを使用してトラッキングスニペットをデプロイするには、タグマネージャーのベンダーの説明を参照してください。
スニペットが動作することを確認する
トラッキングスニペットを展開した後、Live Nowを使用して、Genesys Predictive EngagementがWebサイトのアクティビティをトラッキングしていることを確認します。 4~5秒ごとに更新があるはずです。
スニペットのトラブルシューティング
Webページを読み込んだときにトラッキングスニペットが正しく動作しない場合は、以下を確認してください。
- スニペットは正しいページに表示されていますか?
- スニペットは、ページヘッダーの正しい位置にありますか?
- パラメータは正しく定義されていますか?
- 誤字、脱字、余分な空白はありませんか?
- 印刷用の文字に置き換えたものはありますか?
- ドメインは許可されたドメインのリストにあるか?
その他の提案については、 スニペットのデプロイメントについて をご覧ください。
エラーリファレンス
エラーコード | 説明 |
403エラー | あなたのドメインは、 許可されたドメイン のリストに入っていますか? |
404エラー | スニペットの中に余分な空白がありませんか? 注意: URLでは、ホワイトスペースは%20としてエンコードされます。 |
リクエスト エラー | スニペットの中に余分な空白がありませんか? 注意: URLでは、ホワイトスペースは%20としてエンコードされます。 |
初期化エラー | スニペットの中に次のようなものはありませんか。
|
トラッキングスニペットを呼び出す
トラッキングスニペットをウェブページに設置した後、以下のいずれかの方法でトラッキングスニペットを呼び出してください。
- 従来のスニペットを使用する場合、
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 をご覧ください。