AMP ページの基本的なアナリティクスを構成するには
Important: this documentation is not applicable to your currently selected format email!
アナリティクス プラットフォームは、インライン JavaScript スニペットと関数呼び出しを使用してウェブサイトに統合するのが一般的で、ウェブサイトでイベントがトリガーされると、このメカニズムによってアナリティクス システムに通知されます。AMP は、複数のアナリティクスパートナー向けに、柔軟な JSON 構成構文を提供してこのプロセスを再現しています。
amp-analytics
を学習してください。 コンテキスト別: 非 AMP ページでのアナリティクス
以下は、従来の JavaScript 主導の Google アナリティクスによるトラッキングの例です。これを amp-analytics
JSON 形式に書き換えますが、まずは従来のアプローチを見てみましょう。
<script>
(function (i, s, o, g, r, a, m) {
i['GoogleAnalyticsObject'] = r;
(i[r] =
i[r] ||
function () {
(i[r].q = i[r].q || []).push(arguments);
}),
(i[r].l = 1 * new Date());
(a = s.createElement(o)), (m = s.getElementsByTagName(o)[0]);
a.async = 1;
a.src = g;
m.parentNode.insertBefore(a, m);
})(
window,
document,
'script',
'//www.google-analytics.com/analytics.js',
'ga'
);
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
</script>
非常にシンプルなこの JavaScript は、ページビュー イベントをトラッキングするための通知を送信します。
手順 1: amp-analytics
スクリプトを含める
AMP でこの機能を再現するには、まず、対象ドキュメントの 内に
amp-analytics
コンポーネント ライブラリを含める必要があります。
<script
async
custom-element="amp-analytics"
src="https://cdn.ampproject.org/v0/amp-analytics-0.1.js"
></script>
手順 2: 構成コードを追加する
次に、amp-analytics
コンポーネントをドキュメントの body
の最後に追加してみましょう。
<amp-analytics type="googleanalytics">
<script type="application/json">
{
"vars": {
"account": "UA-YYYY-Y"
},
"triggers": {
"default pageview": {
"on": "visible",
"request": "pageview",
"vars": {
"title": "Name of the Article"
}
}
}
}
</script>
</amp-analytics>
ページ上部の JavaScript の例と同様に、この amp-analytics
スニペットは、ページが表示されたことを示す通知を Google アナリティクスに送信します。
これを指定するため、AMP では、type
を googleanalytics
に設定して、JSON で「default pageview」という名前のトリガーを作成しました。このトリガーは、ページが表示されると("on": "visible"
の指定に従って)起動し、続いて vars
に指定された値を含む pageview
アナリティクスリクエストを Google アナリティクスに送信します。
amp-analytics
の設定に使用される JSON は非常に柔軟な形式で、送信するアナリティクスデータと送信するタイミングを記述することができます。形式に関する詳細な情報は、amp-analytics
に記載されています。
手順 3: ほかのトリガーを追加する
上記の例を基にして、次のように別のトリガー "click on #header trigger"
を追加することもできます。
<amp-analytics type="googleanalytics">
<script type="application/json">
{
"vars": {
"account": "UA-YYYY-Y"
},
"triggers": {
"default pageview": {
"on": "visible",
"request": "pageview",
"vars": {
"title": "Name of the Article"
}
},
"click on #header trigger": {
"on": "click",
"selector": "#header",
"request": "event",
"vars": {
"eventCategory": "examples",
"eventAction": "clicked-header"
}
}
}
}
</script>
</amp-analytics>
名前から推測できるように、この新しいトリガーは ID "header"
を持つ要素がクリックされたときに起動します("on": "click"
および "selector": "#header"
によって指定されています)。このトリガーは、指定された 2 つの変数を含む event
リクエストをアナリティクスプロバイダに送信します。
カスタムトラッキングプラットフォームを統合する場合でも、amp-analytics
を使用して、トラッキングデータの送信先となる独自の URL エンドポイントを定義できます。詳しくは、amp-analytics
コンポーネントのリファレンス ドキュメントをご覧ください。
“UA-YYYY-Y”
は Google アナリティクスアカウントの例です。このサンプルをご自身のサイトで使用する場合は、実際のウェブサイトの Google アナリティクストラッキングコードに置き換える必要があります。
amp-pixel
をご覧ください。ページビューのみをトラッキングする必要がある場合は、従来のピクセルトラッキングの要件を解決することのみを目的としている amp-pixel
を使用することが、amp-analytics
よりも軽量なソリューションと言えます。詳細は、アナリティクス: 基本ガイドをご覧ください。