Recommendations Boxはユーザに対し、パーソナライズされたレコメンデーションを表示します。コンテンツはFacebook上にありますので、ユーザがサイトにログインしていなくてもパーソナライズされたレコメンデーションを表示できます。レコメンデーションを生成する際、このプラグインはあなたのサイト上での全ソーシャルインタラクションを考慮に入れます。Facebookにログインしているユーザに対しては、プラグインはユーザの友だちがインタラクションを持ったオブジェクトをハイライトします。

このプラグイン利用の際、レコメンデーション表示の対象となるドメインの指定が必須です。ドメインは完全に一致しなくてはなりませんので、site=facebooik.comと指定されていればdevelopers.facebook.comやwww.facebook.comは対象となりません。今のところ、クロスドメイン対応はしていません。

Recommendations Boxは以下の項目で設定できます。

  • アプリケーションID
  • 一つ以上のアクションタイプ
  • ドメイン

App ID
アプリケーションIDを指定した場合、そのアプリケーションに紐づく全アクションが表示の対象となります。

<fb:recommendations 
  site="jerrycain.com"
  app_id="118280394918580">
</fb:recommendations>

One or more action types
一つ以上のアクションタイプを指定するには、カンマ区切りのアクションタイプを渡します。ここには、デフォルト/カスタム両方のアクションタイプを指定できます。

<fb:recommendations 
  site="jerrycain.com"
  action="critiqueapp:despise,critiqueapp:review,critiqueapp:grade">
</fb:recommendations>

Domain
アクティビティ表示の対象となるドメインを指定すると、そのドメインに紐づく全デフォルトアクション (like,read,watch,play,listen)が表示対象になります。このドメインは完全一致しなくてはならないので、 site=facebook.comはdevelopers.facebook.comやwww.facebook.comは含まれません。今のところ、 複数のドメインには対応できません。 

<fb:recommendations 
  site="jerrycain.com">
</fb:recommendations>

プラグインはシンプルなiframeでも表示できますし、JavaScript SDKでXFBMLの<fb:recommendations>タグをパースして表示することもできます。

Attributes

  • site - レコメンデーション表示の対象とするドメインです。XFBMLバージョンでのデフォルト値は表示中のドメインです。 
  • action - レコメンデーション表示する対象となるアクションをカンマ区切りで指定します。
  • app_id - ここで指定するアプリケーションIDに紐づく全アクションタイプがレコメンデーション表示の対象になります。 
  • width - プラグイン表示の横幅です。デフォルトは300pxです。
  • height - プラグイン表示の高さです。デフォルトは300pxです。
  • header - Facebookヘッダを表示するか否かです。
  • colorscheme - プラグインのカラースキーマです。オプションはlightとdarkです。
  • font - プラグインのフォントです。オプションは、 'arial', 'lucida grande', 'segoe ui', 'tahoma', 'trebuchet ms', 'verdana'です。
  • border_color - プラグインのボーダ色です。
  • linktarget - コンテンツのリンクが開かれるコンテキストを指定します。デフォルトでは全リンクは新規ウィンドウで表示されます。同一ウィンドウで表示させたい場合に は、このパラメータに_topもしくは_parentを指定してください。Facebook URLへのリンクは常に新規ウィンドウで開きます。
  • ref - 参照元の追跡用ラベルです。50文字以下で数字/アルファベット/いくつかの記号(今のところ+/=-.:_のみ)で指定します。refを指定すると、 ユーザがプラグインのリンクをクリックした場合のリファラURLにfb_refというパラメータが足されます。異なる表示位置や設定の場合に異なる値を refに指定することで、どのプラグイン表示が最も良いパフォーマンスを持っているか計測できます。
  • max_age - レコメンデーションや記事の生成日時のリミットで、デフォルトは0です(ageは考慮に入れられません)。それ以外の場合、有効な値は1~180までで日数を指定します。

サイト上のどのプラグインが最も多くトラフィックを稼いでいるか知るにはどうしたら良いですか?

プラグインにrefパラメータを指定してください。

例:

<fb:recommendations ref="homepage"></fb:recommendations>
<iframe src="...&ref=homepage"></iframe>
ユーザがプラグイン上のリンクをクリックすると、refの値がfb_refパラメータとしてリファラーURLに付加されます。
http://www.facebook.com/l.php?fb_ref=homepage