PDFダウンロードをトラッキング機能で計測するには?
Synergy!LEADのトラッキング機能を応用すると、PDFファイルのクリックを計測できます。
たとえば、スペック表や図面データをPDF形式で配信しており、どのリードまたは取引先責任者がダウンロードしたのか追跡したい、という場面で役に立ちます。また、PDFをダウンロードしたリード・取引先責任者はキャンペーンメンバーとして登録されることから、メール配信(キャンペーン)機能と組み合わせ、ダウンロードした人だけにフォローメールを配信するなどの活用ができます。
このページでご紹介する応用方法は、「jQuery」というJavaScriptライブラリを使用するとともに、Synergy!LEADのトラッキングコードを修正するものです。実装の前に以下の注意点をご確認ください。
- トラッキングコードを貼り付けるWebページのHTMLやJavaScript等に依存し、正常に動作しない場合があります。
- Webページの本番公開前に、動作検証を十分に実施してください。
- PDFのクリック計測を「Googleタグマネージャ」で行う場合は、修正したコードをGoogleタグマネージャに貼り付けてください。(参考ページ:Googleタグマネージャを使ってWebページのトラッキングをするには?)
仕様
- PDFリンクのクリックをトラッキングします。
- ページ内のすべてのPDFリンクをトラッキングします。
- PDFリンクのURL(<a>タグのhref属性の値)が、「貼付け先ページURL(流入経路URL)」になります。また、リンクのラベル(<a>タグtitle属性の値)が、「貼付け先ページタイトル(キャンペーン名)」になります。
一度作成されたキャンペーン名を変更したい場合は、トラッキングコードではなく、キャンペーン名を変更してください。
キャンペーンが作成された後にトラッキングコードの「title」の部分を変更すると、別のキャンペーンが作成され、既存のトラッキング情報とは別に集計されます。
前提条件
- WebページにPDFリンクがあらかじめ必要です。
- <head>タグ内にjQuery呼び出しを追加してください。※以下、記述例です。GoogleにホストされているjQueryを読み込んでいます。
<script src="//ajax.googleapis.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>
補足説明:
- jQueryとは、JavaScriptライブラリのひとつです。jQueryの使用方法やWebページへの追加方法は、インターネットや書籍などでご確認ください。
- jQueryバージョン2.1.3で動作することを確認済みです。
- 「src="//」の部分はプロトコル表記(http:、https:)を省略したものです。詳細は「HTMLやCSSでのプロトコル表記(http:、https:)の省略について」をご参照ください。
実装方法
Webページの<body>~</body>の中にPDFトラッキング用に修正を行ったコードを貼り付けます。貼り付け位置は、なるべく</body>の直前とします。PDFトラッキング用の修正方法は、トラッキングコードを発行した日もしくは、Synergy!LEADのバージョンによって異なります。
なお、下記のコードはPDFファイルのクリック動作をトラッキングするためのものです。Webページ自体をトラッキングするためには、通常のSynergy!LEADトラッキングコードをページに貼り付ける必要があります。
2015年8月17日以降のトラッキングコードでの修正
<script language="JavaScript" type="text/javascript"> <!-- $("a").click(function(){ var $elm = $(this); var aurl = $elm.attr("href"); var atitle = $elm.attr("title"); if (aurl.match(/^.*\.pdf$/)) { var url=aurl; // Page URL var title=atitle; // Page TITLE var referrer=document.location.href; // Referrer var withoutparam=true; // Without URL parameter (true or false) var ver="201",cid="お客様のAPIクライアントID",host="f.msgs.jp",requri="//"+host+"/t/t.js"; var enc=function(str){return encodeURIComponent(str).replace(/[!*'()]/g, function(p){return "%" + p.charCodeAt(0).toString(16);});}; var elm=document.createElement("script"),hd=document.getElementsByTagName("script")[0],now=(1 * new Date()); elm.src=requri+"?ci="+enc(cid)+"&ht="+enc(host)+"&url="+enc(url)+"&ttl="+enc(title)+"&ref="+enc(referrer)+"&wp="+enc(withoutparam)+"&ver="+enc(ver)+"&now="+now; elm.async=1,hd.parentNode.insertBefore(elm,hd); } } ); //--> </script>
上記のコードをコピーして、以下内容を変更してください。
- (7行目) if (aurl.match(/^.*\.pdf$/)) {
ダウンロードするファイルの拡張子をPDF以外にしたい場合は、「.pdf」の部分を任意の拡張子に変更します。 - (13行目)cid="お客様のAPIクライアントID"
2015年8月17日以降に発行したトラッキングコードの7行目に相当しますので同じ内容に変更してください。
バージョン「2.10」以降のトラッキングコードでの修正
<script language="JavaScript" type="text/javascript"> <!-- $("a").click(function(){ var $elm = $(this); var aurl = $elm.attr("href"); var atitle = $elm.attr("title"); if (aurl.match(/^.*\.pdf$/)) { var url=aurl; var ttl=atitle; var ref=document.location.href; var wp=true; var doc=document,tag="script",enc=encodeURIComponent,ht="f.msgs.jp",ci="[お客様のクライアントIDを暗号化したもの]",req="//"+ht+"/t/t.js"; var encrep=function(str){return enc(str).replace(/'/g, function(p){return "%" + p.charCodeAt(0).toString(16);});}; var ec=encrep(ci),eh=enc(ht),eu=encrep(url),et=encrep(ttl),er=encrep(ref),ew=encrep(wp),elm=doc.createElement(tag),hd=doc.getElementsByTagName(tag)[0]; elm.async=1;elm.src=req+"?ci="+ec+"&ht="+eh+"&url="+eu+"&ttl="+et+"&ref="+er+"&wp="+ew;hd.parentNode.insertBefore(elm,hd); } } ); //--> </script>
- (7行目) if (aurl.match(/^.*\.pdf$/)) {
ダウンロードするファイルの拡張子をPDF以外にしたい場合は、「.pdf」の部分を任意の拡張子に変更します。 - (13行目)ci="[お客様のクライアントIDを暗号化したもの]"
バージョン「2.10」で発行したトラッキングコードの3行目に相当しますので同じ内容に変更してください。
バージョン「2.8」までのトラッキングコードでの修正
<script language="JavaScript" type="text/javascript"> <!-- $("a").click(function(){ var $elm = $(this); var aurl = $elm.attr("href"); var atitle = $elm.attr("title"); if (aurl.match(/^.*\.pdf$/)) { var host = "f.msgs.jp"; var url=encodeURIComponent(aurl); var title=encodeURIComponent(atitle); var referrer=encodeURIComponent(document.location.href); var clientid="[お客様のAPIクライアントID]"; var withoutparam="true"; $elm.add("<img width=0 height=0 border=0 src='//" + host + "/t/dummy.gif?url=" + url + "&title=" + title + "&referrer=" + referrer + "&clientid=" + clientid + "&withoutparam=" + withoutparam + "'>"); } } ); //--> </script>
- (8行目)var host="f.msgs.jp";
フォームで独自ドメインを使用している場合、f.msgs.jpの部分をその独自ドメイン名に書き換えます。 - (12行目)var clientid="[お客様のAPIクライアントID]";
バージョン「2.8」までに発行したトラッキングコードの8行目に相当しますので、同じ内容を設定してください。
- 2015年8月17日よりトラッキングコードが変更となり、古いバージョンのトラッキングコードは発行できません。
- 古いバージョンのトラッキングコードが必要な場合は、既にご利用になられているタグをご確認いただくか、「Synergy!LEADサポート」までお問い合わせください。