Adobe Document Cloud | Update – Adobe Analytics上でのPDF分析機能の紹介

Document Cloud API の中の「PDF Embed API」という機能を利⽤することで、PDF に対するページビューや閲覧者数などのアクセス数や、検索キーワードなど閲覧行動履歴を、Adobe Analytics 経由で解析できるようになります。

これまで視覚化しにくかったPDFファイルへの効果測定を、詳細に⾏うことが可能になります。

Adobe Developers – PDF Embed API | Embed PDF in HTML | Adobe Document Services

https://www.adobe.io/apis/documentcloud/dcsdk/pdf-embed.html

PDF Embed API を利用して PDF をページへ埋め込む方法として「full-size windows, in-line display, lightnoxes」の３パターンの方法が用意されています。

その他、Save Control 機能による「ファイルの保存方法」の設定、メニューやツールの設定なども行うことができます。

計測のしくみ

Document Cloud SDK の一部は、JavaScript (JS) ライブラリとして提供しています。
ページへの訪問者がHTMLへアクセスした際にこのライブラリが読み込まれます。バックグラウンドの処理として、記述されている Application Key をもとに Document Cloud 上にある main.js にアクセスされます。この一連の処理により、指定したPDFをページに埋め込まれるわけですが、この処理上で Adobe Analytics への計測コードも自動的に有効化されており、訪問者がPDFをめくったり保存したりする行動履歴を Adobe Analytics へコールしてゆきます。

注意点

Viewerで表⽰しているウェブページ上のものだけが計測可能対象です。ダウンロードされ
たものは対象外となります。
計測の際には埋め込みを⾏っているウェブページで AppMeasurement が読み込まれている
必要があります。
AppMeasurement の設定を⼀部利⽤するため、レポートスイートID（RSID）は、読み込
みを⾏っているものと同じものを利⽤する必要があります。
計測時はPDFのページが切り替わるごとに、サーバーコールが発⽣します。
本レポート配信時点では Embed API は無料で利⽤が可能ですが、今後、サービスの体系が
変わる可能性もございます。

設定の流れ

Embed PDFでの計測を⾏うためには以下の⼿順で⾏う必要があります。
※⻘枠は初回のみ、オレンジ枠はPDF埋め込みを実施する都度⾏う必要があります。

ステップ1：API Keyの取得

Embed APIを利用するにあたり、Document CloudのAPI Keyを発行します。Adobe I/Oからプロジェクトを作成し、取得を行います。PDFの埋め込みを行うドメイン単位での発行となります。
参照：Adobe I/O Project

ステップ2：ページ埋め込みの実施

PDFをページ内に埋め込み表示する方法は大きく4つ存在し、メニューに表示する機能などをパラメータによりコントロールすることが可能です。

Full Window
Sized Container
In-Line
Lightbox

デモサイトで確認しながら埋め込み用のコードを発行することが可能です。ぜひご利用ください。
参照：PDF Embed Mode Demo Site

ステップ3：計測設定の実施（埋め込み側）

埋め込み設定をしたJSファイル内に2カ所設定をすることでサーバーコール自体の設定が可能になります。
adobeDCViewをNewしているところでRSIDを設定する
registerCallbackの箇所で、enablePDFAnalyticsをTrueにする

RSIDの設定箇所は下記となります。

document.addEventListener(“adobe_dc_view_sdk.ready”, function () {
/* Initialize the AdobeDC View object */
var adobeDCView = new AdobeDC.View({
/* Pass your registered client id */
clientId: “YOUR DC API KEY”,
/* Pass the div id in which PDF should be rendered */
divId: “adobe-dc-view”,
//Adobe Analytics RSID//
reportSuiteId: “REPORTSUITE ID”,
});

計測をONにする