AMP

AMP ページの基本的なアナリティクスを構成するには

Important: this documentation is not applicable to your currently selected format email!

アナリティクス プラットフォームは、インライン JavaScript スニペットと関数呼び出しを使用してウェブサイトに統合するのが一般的で、ウェブサイトでイベントがトリガーされると、このメカニズムによってアナリティクス システムに通知されます。AMP は、複数のアナリティクスパートナー向けに、柔軟な JSON 構成構文を提供してこのプロセスを再現しています。

ヒント – アナリティクスプロバイダとして Google アナリティクスを使用している場合は、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 では、typegoogleanalytics に設定して、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 よりも軽量なソリューションと言えます。詳細は、アナリティクス: 基本ガイドをご覧ください。