トラッキングコードAPIの概要

関数呼び出しは、_hsq配列に含めます。

var _hsq = window._hsq = window._hsq || [];
_hsq.push(["method", "arg1"]);

トラッキングコードの読み込み時には_hsq配列にあるものすべてが処理されます。コードの読み込み前にidentify呼び出しを配列に含めることで、最初のtrackPageView呼び出しによって識別情報がプッシュされます。

注：trackPageViewは、トラッキングコード読み込み時に自動的に呼び出されます。ページ読み込みの前にはtrackPageView呼び出しを_hsqに含めないでください。

識別の仕組み

HubSpotのアナリティクスツールでは、2組のデータ、つまりusertoken（訪問者のブラウザーのhubspotutkcookieに保存される）とEメールアドレスを使用して個別のレコードが識別されます。HubSpotトラッキングコードにより訪問者のアクション（ページビューなど）がトラッキングされる際、アクションはusertokenに自動的に関連付けられます。トラッキングコードAPIを使用してEメールアドレスで訪問者を特定する場合、アナリティクスシステムによってEメールアドレスがusertokenと結び付けられることで、既存のコンタクトレコードの更新や新規作成を行える仕組みです。HubSpotでは、コンタクトレコードの作成または更新の処理に使用されるEメールアドレスの検証が行われます。usertokenに関連付けられているアナリティクスデータ（ページビューやオリジナルソースなど）が、コンタクトレコードに表示されます。

この点を考慮して、identifyメソッドの使用はページの閲覧者（Eメールアドレスなど）が把握できている場合に限定してください。不明な訪問者のためのプレースホルダーEメールを使用すると、プレースホルダーEメールによるコンタクトレコードが作成され、このレコードに訪問者のusertokencookieが関連付けられます。つまり、すべての不明な訪問者が1つのプレースホルダーコンタクトに関連付けられることになります。

identify機能で設定されるのは、トラッカーに含まれるIDだけという点に注意してください。個別にtrackPageViewまたはtrackEvent呼び出しを行うまでは、識別情報がHubSpotに渡されることはありません。

HTTP APIは、コンタクトレコードへのアナリティクスデータの関連付けには使用できません。ただし、URLの中でemail=パラメーターを使用して、Eメールアドレスが該当するコンタクトにイベントを関連付ける（または、Eメールアドレスが既存のレコードに含まれていない場合には新しいコンタクトを作成する）ことは可能です。

イベントをトラッキングする

注：イベントは、Marketing Hub Enterpriseが含まれるアカウント上でのみ処理できます。

HubSpotレポートの中でイベントをトラッキングするには、trackEvent関数を使用します。イベントは、何らかのアクションの発生をトラッキングするために使用します。また、コンタクトレコードとイベントを結び付けることにより、コンタクトによるイベントのトリガーの有無やタイミングを確認できます。HubSpotではシンプルなイベントも設定できますが、イベントAPIを使用することで、ウェブサイト上の複雑なプロセスをトラッキングしたり、オフラインで発生するイベントをトラッキングしたりすることが可能です。

イベントAPIは2つありますが、どのように使い分ければよいでしょうか？

HubSpotにはイベントを扱う2つのAPIが用意されています。1つはトラッキングコードAPI（推奨API）のtrackEvent関数、もう1つはHTTP APIです。

trackEvent関数の場合は、ページにHubSpotトラッキングコードがインストールされている必要があります。この関数はHubSpotのアナリティクストラッキングと連動しているため、JavaScript APIによってトリガーされたイベントが訪問者のhubspotutk cookie（ユーザートークン）に自動的に関連付けられます。これにより、イベントをユーザートークンに関連付けられたコンタクトへと自動的に結び付けることができます（詳しくは後述のIDについてのセクションを参照）。

HubSpotトラッキングコードをインストールできない場面ではHTTP APIを使用できます。例えば、オフラインイベントのトラッキングに使用できます（その結果、CRMで処理されたデータに基づいてイベントをトリガーすることが可能になります）。HTTP APIではアナリティクスデータをコンタクトレコードに結び付けることはできませんが、Eメールアドレスによるコンタクトレコードの識別は可能なので、オフラインイベントをコンタクトレコードに結び付けることは可能です。

イベントのIDと名前：

イベントは、数値IDまたは文字列の名前を使用してトリガーできます。HubSpotで作成したイベント（［レポート］>［アナリティクスツール］>［イベント］）には自動的に数値IDが割り当てられ、該当するイベントのトリガーにこの数値IDが使用されます。IDは、HubSpot上でそのイベントを表示するURLから取得できます。イベントの作成に関する詳細はこちらのページを参照してください。

イベントは、イベントの文字列名を使用してトリガーすることもできます。名前を使用したときに該当する名前のイベントが存在しない場合、その名前の新しいイベントが動的に作成されます。その名前のイベントが動的にすでに作成済みの場合、新しいイベントは既存のもののカウントに加えられます。これにより、HubSpot上での手動操作を伴うことなく新しいイベントを動的に作成し続けることができます。

単一ページアプリでトラッキングを行う：

HubSpotトラッキングコードでは、コードの初回読み込み時にページビューが記録されます。しかし、トラッキングコードを再読み込みすることなく単一ページアプリのページビューを手動でトラッキングすることもできます。現在のページを更新してトラッキングするには、setPath関数とtrackPageView関数を使用します。