amp-pixel

動作

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

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

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

属性

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 ルールをご覧ください。