Show Menu
トピック×

Adobeプラグイン:getPercentPageViewed

このプラグインは、Adobe Analyticsからより多くの価値を引き出すために、アドビコンサルティングから提供されています。 アドビカスタマーケアは、インストールやトラブルシューティングを含む、このプラグインのサポートを提供しません。 このプラグインに関するヘルプが必要な場合は、貴社のアカウントマネージャーにお問い合わせください。 担当コンサルタントとのミーティングを手配できます。
The getPercentPageViewed plug-in measures a visitor's scroll activity to see how much of a page they view before moving on to another page. ページの高さが小さい場合や、スクロール動作を測定したくない場合は、このプラグインは不要です。

カスタムコードエディターの起動を使用したプラグインのインストール

プラグイン拡張機能を使用しない場合は、カスタムコードエディターを使用できます。
  1. Log in to launch.adobe.com using your AdobeID credentials.
  2. 目的のプロパティをクリックします。
  3. タブに移動し Extensions 、Adobe Analytics拡張機能の下 Configure にあるボタンをクリックします。
  4. アコーディオ Configure tracking using custom code ンを展開し、ボタンを表示 Open Editor します。
  5. カスタムコードエディターを開き、下に示すプラグインコードを編集ウィンドウに貼り付けます。
  6. 変更を保存し、Analytics拡張機能に公開します。

AppMeasurementを使用したプラグインのインストール

次のコードを、Analyticsトラッキングオブジェクトのインスタンス化(を使用)後に、AppMeasurementファイルの任意の場所にコピーして貼り付 s_gi けます。 導入時にコードのコメントとバージョン番号を保持すると、アドビは潜在的な問題のトラブルシューティングに役立ちます。
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getPercentPageViewed v4.0 w/handlePPVevents helper function (Requires p_fo plug-in) */
s.getPercentPageViewed=function(pid,ch){var s=this,a=s.c_r("s_ppv");a=-1<a.indexOf(",")?a.split(","):[];a[0]=s.unescape(a[0]); pid=pid?pid:s.pageName?s.pageName:document.location.href;s.ppvChange="undefined"===typeof ch||!0==ch?!0:!1;if("undefined"=== typeof s.linkType||"o"!==s.linkType)s.ppvID&&s.ppvID===pid||(s.ppvID=pid,s.c_w("s_ppv",""),s.handlePPVevents()), s.p_fo("s_gppvLoad") &&window.addEventListener&&(window.addEventListener("load",s.handlePPVevents,!1),window.addEventListener("click",s.handlePPVevents, !1),window.addEventListener("scroll",s.handlePPVevents,!1)),s._ppvPreviousPage=a[0]?a[0]:"",s._ppvHighestPercentViewed=a[1]?a[1]:"",s._ppvInitialPercentViewed=a[2]?a[2]:"",s._ppvHighestPixelsSeen=a[3]?a[3]:"",s._ppvFoldsSeen=a[4]?a[4]:"",s._ppvFoldsAvailable=a[5]?a[5]:""};

/* Adobe Consulting Plugin: handlePPVevents helper function (for getPercentPageViewed v4.0 Plugin) */
s.handlePPVevents=function(){if("undefined"!==typeof s_c_il){for(var c=0,g=s_c_il.length;c<g;c++)if(s_c_il[c]&& (s_c_il[c].getPercentPageViewed||s_c_il[c].getPreviousPageActivity)){var s=s_c_il[c];break}if(s&&s.ppvID){var f=Math.max (Math.max(document.body.scrollHeight,document.documentElement.scrollHeight),Math.max(document.body.offsetHeight, document.documentElement.offsetHeight),Math.max(document.body.clientHeight,document.documentElement.clientHeight)),h= window.innerHeight||document.documentElement.clientHeight||document.body.clientHeight;c=(window.pageYOffset|| window.document.documentElement.scrollTop||window.document.body.scrollTop)+h;g=Math.min(Math.round(c/f*100),100);var k=Math.floor(c/h);h=Math.floor(f/h);var d="";if(!s.c_r("s_tp")||s.unescape(s.c_r("s_ppv").split(",")[0])!==s.ppvID||s.p_fo(s.ppvID) ||1==s.ppvChange&&s.c_r("s_tp")&&f!=s.c_r("s_tp")){(s.unescape(s.c_r("s_ppv").split(",")[0])!==s.ppvID||s.p_fo(s.ppvID+"1"))&&s.c_w("s_ips",c);if(s.c_r("s_tp")&&s.unescape(s.c_r("s_ppv").split(",")[0])===s.ppvID){s.c_r("s_tp");d=s.c_r("s_ppv");var e=-1< d.indexOf(",")?d.split(","):[];d=e[0]?e[0]:"";e=e[3]?e[3]:"";var l=s.c_r("s_ips");d=d+","+Math.round(e/f*100)+","+Math.round(l/ f*100)+","+e+","+k}s.c_w("s_tp",f)}else d=s.c_r("s_ppv");var b=d&&-1<d.indexOf(",")?d.split(",",6):[];f=0<b.length?b[0]: escape(s.ppvID);e=1<b.length?parseInt(b[1]):g;l=2<b.length?parseInt(b[2]):g;var m=3<b.length?parseInt(b[3]):c,n=4<b.length? parseInt(b[4]):k;b=5<b.length?parseInt(b[5]):h;0<g&&(d=f+","+(g>e?g:e)+","+l+","+(c>m?c:m)+","+(k>n?k:n)+","+(h>b?h:b)); s.c_w("s_ppv",d)}}};

/* Adobe Consulting Plugin: p_fo (pageFirstOnly) v2.0 */
s.p_fo=function(on){var s=this;s.__fo||(s.__fo={});if(s.__fo[on])return!1;s.__fo[on]={};return!0};
/******************************************** END CODE TO DEPLOY ********************************************/

プラグインの使用

このメソ getPercentPageViewed ッドでは、次の引数を使用します。
  • pid (オプション、文字列): ページベースの識別子で、プラグインの測定値によって提供される割合と相関させることができます。 デフォルトで変数が使 pageName 用されます。
  • ch (オプション、ブール値): 初期読み込み false 後にペ 0 ージのサイズに対して行われた変更を考慮しない場合は、これを(または)に設定します。 省略した場合、この引数のデフォルト値はで true す。 ほとんどの場合、この引数は省略することをお勧めします。
このメソッドを呼び出すと、何も返されません。代わりに、次の変数を設定します。
  • s._ppvPreviousPage :表示された前のページの名前。 現在のページの最終的なスクロール値は、新しいページが読み込まれるまで使用できません。
  • s._ppvHighestPercentViewed :訪問者が閲覧した前のページの最高閲覧率(ページの高さ)。訪問者が前のページを下にスクロールした最も遠いポイント。
  • s._ppvInitialPercentViewed :前のページが最初に読み込まれたときに表示された、前のページの割合です。
  • s._ppvHighestPixelsSeen :前のページで、訪問者が下にスクロールしたときに表示された合計ピクセル数の最高値(高さが基準)。
  • s._ppvFoldsSeen :訪問者が前のページを下にスクロールしたときに最も多く到達した「ページの折り目」の数。 この変数には、「ページの先頭」の折りたたみが含まれます。
  • s._ppvFoldsAvailable :前のページで下にスクロールできる「ページの折り目」の合計数。
これらの変数の1つ以上をeVarに割り当てて、レポート内のディメンションデータを表示します。
このプラグインは、上記の値を含む、と呼ばれるファーストパ s_ppv ーティcookieを作成します。 ブラウザーセッションの終了時に有効期限が切れます。

呼び出しの例

例1

次のコード…
if(s.pageName) s.getPercentPageViewed();
if(s._ppvPreviousPage)
{
  s.prop1 = s._ppvPreviousPage;
  s.prop2 = "highestPercentViewed=" + s._ppvHighestPercentViewed + " | initialPercentViewed=" + s._ppvInitialPercentViewed + " + | foldsSeen=" + s._ppvFoldsSeen + " | foldsAvailable=" + s._ppvFoldsAvailable;
}

  • s.pageNameが設定されているかどうかを判定し、設定されている場合は、コードがgetPercentPageViewed関数を実行するかどうかを判定します
  • getPercentPageViewed関数を実行すると、上記の「戻り値」の節で説明した変数が作成されます
  • 「Returns」変数が正常に設定された場合:
    • コードは、s.prop1をs._ppvPreviousPageの値(s.pageNameの前の値、または前のページ)に設定します。
    • また、s.prop2には、訪問者が到達した折り目の数および利用可能な折り目の数と共に、前のページの最も高い閲覧率および最初の閲覧率と同じ値が設定されます
注意 : 最初の読み込み時にページ全体が表示される場合、「最高閲覧率」ディメンションと「初期閲覧率」ディメンションの両方が100になり、「閲覧された折り目」と「利用可能な折り目」の両方が1になります。 ページが最初に読み込まれたときにページ全体が表示されず、訪問者が最後にページを下にスクロールしてから次のページに移動した場合、「最高閲覧率」ディメンションと「初期閲覧率」ディメンションの両方が同じ値になります。

例2

ページ名全体ではなくロールアップされた「ページタイプ」を取り込むため、s.prop5 が別途設定されているとします。
次のコードは、s.prop5が設定されているかどうかを判別し、設定されている場合は、その値を「前のページ」として保存して、最も高い閲覧率ディメンションと最初の閲覧率ディメンションを関連付けます。 値は引き続きs._ppvPreviousPage変数に保存されますが、前のページ名の代わりに前のページタイプとして扱うことができます。
if(s.prop5) s.getPercentPageViewed(s.prop5);
if(s._ppvPreviousPage)
{
  s.prop1 = s._ppvPreviousPage;
  s.prop2 = "highestPercentViewed = " + s._ppvHighestPercentViewed + " | initialPercentViewed=" + s._ppvInitialPercentViewed;
}

バージョン履歴

v4.0(2019年10月8日)

  • 追加されたソ s._ppvFoldsSeen リューシ s._ppvFoldsAvailable ョン

v3.01(2018年8月13日)

  • 1つのページに複数のAppMeasurementオブジェクトが含まれるページの問題を修正しました。

v3.0(2018年4月14日)

  • ポイントリリース(再コンパイル、コードサイズが小さい)
  • プラグインで、戻り値の代わりにAdobe Analytics変数に割り当てる変数を作成できるようになりました