ハードコードされたイメージリクエストを使用した実装
アドビが提供する AppMeasurement ライブラリは、ページ上に存在する変数をコンパイルし、イメージリクエストとしてアドビに送信します。 AppMeasurement ライブラリを完全に使用せずに、手動でアドビにイメージリクエストを送信することもできます。 この方法では、イメージリクエストとクエリ文字列を手動で作成する必要があります。
この実装方法は、外部ソースからの画像を表示する任意のプラットフォームで使用できます。 JavaScript にはまったく依存しません。
イメージリクエスト構文
次に、HTML を使用したハードコードされたイメージリクエストの例を示します。
<img src="https://example.data.adobedc.net/b/ss/examplersid/1/s234234238479?AQB=1&g=http%3A%2F%2Fexample.com&pageName=Example%20hardcoded%20hit&v1=Example%20value&AQE=1"/>
https://はプロトコルを指定します。 イメージリクエストで使用されるプロトコルと、サイトの残りの部分で使用されるプロトコルとを一致させます。example.data.adobedc.netは、trackingServerSecure変数に含まれる値です。/b/ss/は、すべてのイメージリクエストに含まれます。 これは、アドビのデータ収集サーバーに保存される画像のファイル構造の一部です。examplersidは、データの送信先のレポートスイート ID です。 複数のレポートスイートの場合、ID をコンマで区切り、スペースは使用しません（examplersid1,examplersid2など）。/1/はヒットソースです。 詳しくは、『エクスポートユーザーガイド』の データ列の参照 でhit_sourceを参照してください。 訪問者を識別するために Cookie やその他の方法が使用する順序を制御します。/s234234238479（"s"+ 乱数）は、ブラウザーによるイメージリクエストのキャッシュを防ぎます。- クエリ文字列の区切り文字（
?）の後にあるのはすべて、レポートに含めるデータです。 イメージリクエストに含めることができるすべてのパラメーターのリストについては、 データ収集クエリーパラメーター を参照してください。
Microsoft Outlook のハードコードされたイメージリクエスト
ほとんどの電子メールは HTML ベースなので、開かれた電子メールを追跡し、そのデータを Adobe Analytics に送信できます。 組織でこの方法の使用を選択する場合は、次の点に注意してください。
- メールのレンダリングごとに、課金対象のサーバーコールが増加します。
- HTML をサポートし、画像を許可しているメールクライアントのみが追跡されます。 Microsoft Outlook など、一部のメールクライアントは、外部画像をデフォルトでブロックします。 これらの電子メールは、受信者が外部画像のダウンロードを選択するまで追跡されません。
イメージリクエストを含む Outlook メールを作成するには、以下を実行します。
- HTML エディターを開きます。 HTML エディターが使用できない場合は、プレーンテキストエディターを使用することもできます。
- 新しい HTML ファイルで、タグに含まれたハードコードされたイメージリクエスト
<img>タグを挿入し<body>タブでラップします。 - HTML ファイルを保存します。
- Microsoft Outlook を開き、電子メールを作成します。
- 「挿入」タブに移動し、「ファイルを添付」をクリックします。 イメージリクエスト HTML ファイルを選択します。
- 「挿入」の横のポップアップメニューをクリックし、「テキストとして挿入」を選択します。 ポップアップメニューを表示せずに「挿入」ボタンをクリックすると、HTML ファイルが添付ファイルになり、機能しなくなります。
イメージリクエストは 1x1 の透過ピクセルなので、電子メールは変更されないように見えます。 テスト用にイメージリクエストを表示する場合は、HTML ファイルを変更して、ボーダーや追加のテキスト、その他のコンテンツを追加します。
FAQ
ハードコードされたイメージリクエストに関するよくある質問について説明します。
クエリ文字列パラメーターでは大文字と小文字が区別されますか。
はい。 クエリ文字列パラメーターが完全に一致していることを確認してください。一致していない場合は記録されません。 例えば、pagename は有効なクエリ文字列パラメーターではありませんが、pageName は有効です。
クエリ文字列にスペースを含めることはできますか。
各クエリ文字列パラメーターの値は、URL エンコードされています。 URL エンコードは、通常 URL で使用できない文字を、使用できる文字に変換します。 例えば、スペース文字は %20 に変換されます。 英数字以外の文字が URL エンコードされていることを確認します。 イメージリクエストがデータ収集サーバーに到達すると、アドビは自動的に値を URL デコードします。
URL エンコーディングの仕組みについて詳しくは、W3Schools の HTML URL Encoding Reference を参照してください。
1 つの値に指定できる最大文字数は何文字ですか。
最大文字数は変数によって異なります。 ほとんどのトラフィック変数は最大 100 バイトを保持し、ほとんどのコンバージョン変数は最大 255 バイトを保持します。 イメージリクエストがデータ収集サーバーに到達すると、アドビはこれらの値を自動的に最大長に切り詰めます。