ハードコードされたイメージリクエストを使用した実装
アドビが提供する 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は、trackingServer変数に含まれる値です。/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 バイトを保持します。イメージリクエストがデータ収集サーバーに到達すると、アドビはこれらの値を自動的に最大長に切り詰めます。