AMP

amp-pixel

Description

ページビューをカウントするトラッキング ピクセルです。

 

Supported Layouts

説明 ページビューをカウントする一般的なトラッキング ピクセルとして使用できます。
サポートされるレイアウト fixed、nodisplay
AMP By Example の amp-pixel サンプルをご覧ください。

動作

amp-pixel コンポーネントは、シンプルなトラッキング ピクセル img と同じように機能します。単一の URL を取りますが、リクエストの作成時に URL 文字列内のコンポーネントで置き換えられる変数を備えています。詳細については、置換をご覧ください。

以下の基本的な例の場合、amp-pixel は、指定 URL に対してシンプルな GET リクエストを発行し、結果を無視します。

<amp-pixel src="https://foo.com/tracker/foo"
    layout="nodisplay"></amp-pixel>

アナリティクス リクエストのリファラー ヘッダー内の AMP URL を処理する際は、usqp パラメータを削除するか無視します。このパラメータは、Google が Google AMP キャッシュのテストをトリガーする際に使用されます。

属性

src(必須)

リモート エンドポイントへのシンプルな URL。https プロトコルの必要があります。

referrerpolicy(省略可)

この属性は、<img>referrerpolicy 属性と似ていますが、使用できる値は no-referrer だけに限られています。referrerpolicy=no-referrer が指定されている場合、HTTP リクエストから referrer ヘッダーが削除されます。

<amp-pixel src="https://foo.com/tracker/foo"
    layout="nodisplay"
    referrerpolicy="no-referrer"></amp-pixel>
allow-ssr-img(省略可)

AMP4ADS クリエイティブ内で使用されるこの属性は、検証後の変換の一環として、img 要素を amp-pixel 要素内に直接配置し、AMP ランタイム フェッチ / 実行と並行して ping を送信できるようにします。つまり、URL 内のマクロは展開されません。src 内にマクロが存在しない場合に限り、この属性を使用するようにしてください。

共通の属性

この要素には、AMP コンポーネントに拡張された共通の属性が含まれます。

置換

amp-pixel では、標準的な URL 変数置換がすべて許可されています。詳細については、置換ガイドをご覧ください。

以下の例の場合、インプレッションごとに RANDOM 値がランダムに生成され、https://foo.com/pixel?0.8390278471201 といった URL に対してリクエストが作成されます。

<amp-pixel src="https://foo.com/pixel?RANDOM"
    layout="nodisplay"></amp-pixel>

スタイル設定

amp-pixel にはスタイルを設定しないでください。

検証

AMP 検証ツール仕様の amp-pixel ルールをご覧ください。

さらに支援が必要ですか?

このドキュメントを何度読み返しても、ご質問のすべてを完全に解消することができませんか?他にも同じ事を感じた人がいるかもしれません。Stack Overflow で問い合わせてみましょう。

Stack Overflow にアクセスする
バグや不足している機能がありますか?

AMP プロジェクトでは皆さんの参加と貢献を強くお勧めしています!当社はオープンソースコミュニティに継続的にご参加いただくことを希望しますが、特に熱心に取り組んでいる問題があれば1回限りの貢献でも歓迎します。

GitHub にアクセスする