http://developers.facebook.com/docs/reference/plugins/recommendations/
Recommendations Pluginは、ユーザに対してパーソナライズされたレコメンデーションを表示します。
コンテンツはFacebookによって提供されるので、ユーザがあなたのサイトにログインしていようがいまいが、表示されるレコメンデーションはパーソナライズされたものとなります。レコメンデーションの生成は、あなたのサイトで起こる全ての交流が対象です。Facebookにログインしているユーザには、ユーザの友達が"交流"したコンテンツが優先的に表示されます。
Recommendations Pluginは、ユーザに対してパーソナライズされたレコメンデーションを表示します。
コンテンツはFacebookによって提供されるので、ユーザがあなたのサイトにログインしていようがいまいが、表示されるレコメンデーションはパーソナライズされたものとなります。レコメンデーションの生成は、あなたのサイトで起こる全ての交流が対象です。Facebookにログインしているユーザには、ユーザの友達が"交流"したコンテンツが優先的に表示されます。
まず、レコメンデーションを表示するサイトを指定します。ドメインは完全に一致しなくてはなりません。つまり、site="facebook.com"と指定されているのなら、developers.facebook.comは対象になりません。複数のドメインを統合して表示するのは、今のところは不可能です。
シンプルなiframeをサイトに書き込む方法と、JavaScript SDKを使用してXFBMLの<fb:recommendations>タグを書き込む方法があります。(注:下記はXFBMLを表示した例です。)
例:
シンプルなiframeをサイトに書き込む方法と、JavaScript SDKを使用してXFBMLの<fb:recommendations>タグを書き込む方法があります。(注:下記はXFBMLを表示した例です。)
<fb:recommendations site="facebook-docs.oklahome.net" width="300"
height="300" header="true" font="arial"
recommendations="false"></fb:recommendations>
Attributes
- site アクティビティを表示する対象のドメインです。XFBML版のデフォルトは表示中のページです。
- width プラグイン表示領域横幅のピクセル値。デフォルトは300pxです。
- height プラグイン表示領域縦幅のピクセル値。デフォルトは300pxです。
- header Facebookヘッダを表示するか否か
- colorscheme プラグインのカラースキーマ。オプションは、lightとdarkです。
- font プラグイン表示のフォント指定です。オプションは、'arial', 'lucida grande', 'segoe ui', 'tahoma', 'trebuchet ms', 'verdana'です。
- border_color プラグインのボーダー色です
- recommendations プラグインにレコメンデーションを表示するか否か。trueの場合。下半分にレコメンデーションが表示されます。
- filter プラグインに表示されるURLをフィルタリングできます。URLの最初の二つのパスパラメータにフィルタの対象を含むURLのみ表示されます。合致するものが無い場合、そのURLは表示されません。
- ref 参照元の追跡用ラベルです。50文字以下で数字/アルファベット/いくつかの記号(今のところ+/=-.:_のみ)で指定します。refを指定すると、
ユーザがプラグインのリンクをクリックした場合のリファラURLにfb_refというパラメータが足されます。
トラフィックがサイト上のどのプラグインからのものだか把握するには、どうすれば良いですか。
先述のrefパラメータを指定してください。例:
<fb:recommendations ref="homepage"></fb:recommendations>もしくは
<iframe src="...&ref=homepage"></iframe>ユーザがプラグイン上のリンクをクリックすると、下記のようにリファラURLにfb_refが含まれます。
http://www.facebook.com/l.php?fb_ref=homepage