API Reference
Start typing to search…

ページ閲覧と死活監視のイベント

デフォルトで、query.petametrics.com/__activity.gifに対してページ閲覧ごとに3つのイベントを送ります。

  • [pageview]: Javascriptの読み込みと同時に送ります。</li> <li>[stuck_10s]: Webページに10秒間滞在した後に送ります。
  • `[stuck_3m]: Webページに3分間滞在した後に送ります。

我々からリコメンデーションの取得と表示を開始すると、リコメンドの表示とクリックに対してアクティビティイベントが追加して発生します。この詳細については次の項で説明します。 死活監視に使用するタイマーは設定変更することができます。デフォルトのタイマー（10秒と3分）は、送信するデータの量を管理し、Webサイト上でのユーザの滞在時間とのバランスを考慮して設定しています。ユースケースによっては、滞在時間のタイマーを追加することもできます。

1. 送られる情報についてさらに理解する

Networkパネルから、送られるすべてのイベントにアクセスすることができます。それぞれのイベントをクリックすることで、リクエストヘッダの詳細を確認することができます。

これはページ閲覧のイベントに対するヘッダのサンプルです。

イベントの送信先をapi.petametrics.comからquery.petametrics.comに変更したため、下記のサンプルでは古い送信先が表示されています。あらかじめご了承ください。

Remote Address:54.193.101.92:80
Request URL:http://api.petametrics.com/__activity.gif?ts=1440011328177&jsk=vba4vdhq7eo382ub&jsv=0.4&cu=http%3A%2F%2Fwww.liftigniter.com%2F&uid=c25c93e4-6b80-4e82-af8b-d50a9007c8c5&sid=b4e42984-05fe-4fd6-e2d3-9fec22f8ce66&pvid=c81893cb-93ed-422e-b9a3-01166ac8fc14&tzo=420&ua=Mozilla%2F5.0%20(Macintosh%3B%20Intel%20Mac%20OS%20X%2010_10_4)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Chrome%2F44.0.2403.155%20Safari%2F537.36&l=en-US&os=MacIntel&scd=24&scrh=1080&scrw=1920&ref=&rs=6skz5sswm2oz85mi&sref=-1&uref=-1&sppx=0&sppc=0&dh=3130&ct=Predictive%20Analytics%20%7C%20Improve%20CTR%20%7C%20Taboola%20%7C%20Outbrain%20%7C%20Build%20Web%20Traffic&plh=c64b9d15f3b6aab193d17b9f0c156b78&e=pageview
Request Method:GET
Status Code:200 OK
Response Headers
view source
Connection:keep-alive
Content-Length:35
Content-Type:image/gif
Date:Wed, 19 Aug 2015 19:08:48 UTC
Server:mustang
Request Headers
view source
Accept:image/webp,*/*;q=0.8
Accept-Encoding:gzip, deflate, sdch
Accept-Language:en-US,en;q=0.8
Connection:keep-alive
Host:api.petametrics.com
Referer:http://www.liftigniter.com/
User-Agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/44.0.2403.155 Safari/537.36
Query String Parameters
view source
view URL encoded
ts:1440011328177
jsk:vba4vdhq7eo382ub
jsv:0.4
cu:http://www.liftigniter.com/
uid:c25c93e4-6b80-4e82-af8b-d50a9007c8c5
sid:b4e42984-05fe-4fd6-e2d3-9fec22f8ce66
pvid:c81893cb-93ed-422e-b9a3-01166ac8fc14
tzo:420
ua:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/44.0.2403.155 Safari/537.36
l:en-US
os:MacIntel
scd:24
scrh:1080
scrw:1920
ref:
rs:6skz5sswm2oz85mi
sref:-1
uref:-1
sppx:0
sppc:0
dh:3130
ct:Predictive Analytics | Personalization | Machine Learning
plh:c64b9d15f3b6aab193d17b9f0c156b78
e:pageview

"Query String Parameters"では、人の目で読み取りができる形式でフォーマットされた、クエリのパラメータについて下記のとおり説明します。

イベントごとに変化するパラメータは下記のとおりです:

  • [e]は、イベントのタイプを示します。上記の例では、このパラメータは"pageview"と表記されています。この他に[stuck_10s]と[stuck_3m]（死活監視のためのイベント）と、ウィジェットトラッキングに関連するタイプのものがあります。</li> <li>[sppx]（デフォルトでは送信しません、別途設定が必要です）は、ピクセル単位でユーザがどこまでスクロールしたかを示します。pageviewのイベントタイプでは、ユーザがスクロールしなかった場合は0になります。pageviewのイベントはWebページの読み込みとほぼ同時に送られるため、この値は0である可能性が高くなります。
  • `[sppc]（デフォルトでは送信しません、別途設定が必要です）は、パーセント表示でユーザがWebページをどこまでスクロールしたかを示します。

同じWebページ閲覧の中ですべてのイベントに共通し、異なるページ閲覧で変化するパラメータ:

  • [pvid]は、Webページ閲覧ごとに生成されるユニークIDを示します。同じページ閲覧において発生するイベントに対してはすべて共通したものを使用し、異なるページ閲覧に対しては別のIDを生成します。</li> <li>[cu]は、現在閲覧しているWebページのURLを示します。
  • [ct]は、現在閲覧しているWebページのタイトルを示します。</li> <li>[ref]は、現在閲覧しているWebページのリファラ（参照元URL）を示します。

同じセッション（ユーザがブラウザを閉じるまで）の中ですべてのイベントに共通する、Cookieをもとにしたパラメータ（詳細はCookieとローカルストレージのドキュメントを参照してください）

  • [sid]は、セッションのIDを示します。この値は、Cookieの[_igt]の値と一致します。</li> <li>[sref]は、現在のセッションの最初のWebページ閲覧のリファラ（参照元URL）を示します。最初のWebページ閲覧にリファラがない場合は、この値は"-1"になります。この値は、Cookieの[_igsr]の値と一致します。

Cookieをもとにしたユーザ単位のパラメータ（詳細はCookieに関する説明を参照してください）:

  • [uid]は、ユーザIDを示します。この値は、Cookieの[_ig]の値と一致します。</li> <li>[uref]は、ユーザの最初のWebサイト訪問に対する参照元URLを示します。最初のWebサイト訪問に参照元がない場合は、この値は"-1"になります。この値は、Cookieの[_igur]の値と一致します。

ブラウザ、デバイス、システム設定をもとにしたパラメータ。通常では同じユーザにおいては、継続して同じ値が使用されます。

  • [ua]はユーザエージェントを示します。</li> <li>[l]は、ユーザのブラウザの言語設定を示します。
  • [os]は、ユーザが使用するOSを示します。</li> <li>[scd]（デフォルトでは送信しません、別途設定が必要です）は、ユーザが使用するモニタの色深度（SCD）を示します。
  • [scrh]（デフォルトでは送信しません、別途設定が必要です） は、ユーザが使用するモニタの縦幅を示します。</li> <li>[scrw]（デフォルトでは送信しません、別途設定が必要です） は、ユーザが使用するモニタの横幅を示します。

ユーザのIPアドレスはクエリのパラメータとしては送られませんが、リクエストにはこの文字列が含まれます。IPアドレスを使用してユーザの所在地（国、市町村名、郵便番号）を解析します。 petametrics.comのcookieは、リクエストとあわせて送られます。

2. フィールドが正しく送信されているか確認する

上記の説明で、リクエストごとに送られる情報について理解が深まったことと思います。この情報をもとにフィールドの値が正しく送られていることを確認してください。下記に、この確認を行う際のいくつかのポイントを説明します:

  • Emulatorを使って異なるデバイスの環境でテストを行ってください。Emulatorでデバイスの種類を変更してWebページの再読込を行うと、ユーザエージェントのパラメータが変化します。ここではEmulatorがOSの設定に変化を加えないため、OSのパラメータは変わりません。
  • ピクセル単位またはパーセンテージで、Webページのスクロールを示すパラメータを有効にしている場合: ピクセル単位またはパーセンテージで、Webページのスクロールを示すパラメータが正常に機能しているかを確認する場合は、死活監視とあわせて送られる値（[stuck_10s]または[stuck_3m]）を確認してください。この確認は、死活監視のイベントが送られる前にWebページをスクロールしてから行ってください。
  • Cookieと一致する値を持つパラメータは、上記に説明したCookieの値と値を比較して確認を行ってください。
  • 複数のページ閲覧を通じて送られるリクエストについては、Networkパネルで"Preserve log"のオプションをチェックして確認してください。
  • 新しいシークレットモードのウィンドウをブラウザで開いて、新しいユーザとして新しいセッションを開始してください。Chromeでは、一度に一つのユーザセッションしかサポートしないため、新しいユーザとして新しいセッションを開始する場合は、これまでのウインドウを閉じてからセッションを開始してください。
  • 同じユーザとして新たなセッションを開始する場合は、ブラウザを終了してからサイドブラウザを開いてください。WindowsとLinuxのシステムでは、ChromeやFirefoxでウインドウを閉じると、そのプロセスも終了します。Macでは、ウインドウを閉じるだけではプロセスは終了しないため、プロセス終了の処理を別に行う必要があります。

3. レスポンスエラーのレポート

殆どの場合では、200 OK以外のレスポンスを受け取ることはありません。これ以外のレスポンスを受け取った場合は、エラーに関するできるだけ詳しい情報とあわせてLiftIgniterにご連絡ください。