如果用戶先前往 Facebook 後,再前往您建置社交外掛程式的網站,則瀏覽器會傳送一些資訊給我們,以便在該頁面上載入 Facebook 內容。我們收到的資料可能包括用戶編號、用戶前往的網站、日期和時間,以及其他瀏覽器相關資訊。我們會記錄部分資訊,並可能用於改善我們的產品和服務,以及用於向用戶顯示更貼近興趣且實用的廣告。
使用 HTML5 或 XFBML 版本時,您應該在實例化程式庫時包含語言代碼。
載入 SDK 後,變更 js.src
的值來使用您的語言設定。將 en_US
替換為您的語言設定,例如 fr_FR
為法語(法國):
// Example 1: 'https://connect.facebook.net/fr_FR/sdk.js'; // Example 2: js.src = "https://connect.facebook.net/fr_FR/sdk.js#xfbml=1&version=v2.6";
支援的語言設定列於 Facebook 語言設定 XML 檔案中。
您可能需要調整社交外掛程式的寬度來配合不同語言。您可在本地化和翻譯頁面找到更多資訊。
視社交外掛程式而定,您可能需要針對手機、平板電腦和桌上型電腦建置各自的版本。請參閱所要建置外掛程式的常見問題或「新手指南」文件。注意:不建議使用 CSS 媒體查詢來調整社交外掛程式的大小。
我需要將粉絲專頁移至不同網址。您無法將按讚次數、分享次數或留言直接移至新網址,但您可以將舊網址做為新網址按讚或分享次數的標準來源。以下為操作方式(含背景資訊)。
為了解析讚或分享動作應該歸因於哪個網址,Facebook 使用的程序可以解析已載入網址的標準網址。載入網址時,網路爬蟲會搜尋以下項目:
og:url
開放社交關係圖標籤rel=canonical
,如 RFC 6596 中所述(Facebook 網路爬蟲僅支援內容,不支援 HTTP 標頭)。如果上述任一方法產生的網址與原先載入的網址不同,則該指定網址會被視為原始網址的「標準網址」。如有必要,網路爬蟲會循著重新導向鏈結找出標準網址。
所有按讚與分享次數會歸因於標準網址,而非載入網址。
提示:使用偵錯工具可查看 Facebook 編目粉絲專頁時所見的情形。
透過控制標準網址,您便可以在不同網址間移動內容,而且只要您讓 Facebook 繼續將新網址解析為舊網址,即可保有按讚與分享次數。這可以透過下列兩種方法完成:
og:url
標籤加入新網址(偏好方法)您應該在新網址中包含指向舊網址的連結。例如,如果新網址為 https://example.com/new-url
,而舊網址為 https://example.com/old-url
,則應該在 new-url
中包含以下程式碼片段:
<meta property="og:url" content="https://example.com/old-url" />
使用這個方法會讓網路爬蟲知道標準網址位於舊位置,並據此產生粉絲專頁的按讚與分享次數。任何新的按讚與分享次數也會繼續在舊網址累計。
同時,至少在 Facebook 網路爬蟲載入舊網址時,舊網址仍必須使用開放社交關係圖標籤呈現文件,並且傳回 HTTP 200 回應。如果想要重新導向前往該網址的其他用戶端,您必須向所有非 Facebook 網路爬蟲用戶端傳送 301 HTTP 回應。舊網址應該包含指向自身的 og:url
標籤。
如需瞭解如何辨識 Facebook 網路爬蟲,請參閱分享最佳作法指南。
這個方法也適用於 rel=canonical
,但建議使用 og:url
。
另一個可以達成目的的方法是,每當 Facebook 網路爬蟲前往新網址時,都將其重新導向至舊網址。如同上述方法,舊網址必須是使用開放社交關係圖標頭的有效文件。此外,若要在舊網址包含重新導向,請勿在 Facebook 網路爬蟲造訪舊網址時將其重新導向。
僅能內嵌公開內容。如果貼文、粉絲專頁或網址有任何的隱私設定限制,就無法內嵌。這適用於「讚」按鈕、「粉絲專頁外掛程式」和「內嵌貼文與影片」。
若要測試特定內容片段是否可供內嵌,一個快速的方法是嘗試使用瀏覽器的「無痕」或「私密」功能來載入該內容片段。
我們建議您在應用程式或網站設置所有按鈕,以便用戶選擇他們想要的內容分享方式。
當用戶點擊有關分享連結的串流動態上的連結時,ref
設定會造成兩個參數加入轉介人網址:
fb_ref
- ref
參數fb_source
- 讚/分享:由發生點擊的串流類型(home
、profile
、search
、ticker
、tickerdialog
或 other
)與動態類型(oneline
或 multiline
)兩者以底線串連而成。發送:發生點擊的動態類型(message
)。例如:
http://www.facebook.com/l.php?fb_ref=top_left&fb_source=profile_oneline
您可以使用分析工具軟體追蹤以上參數。
如果「讚」、「分享」或「發送」按鈕的位置靠近 HTML 元素邊緣,且 CSS overflow
屬性設為 hidden
,則點擊按鈕時,飛出視窗可能遭到裁切或完全隱藏。將 overflow
屬性設為 hidden
以外的值(如 visible
、scroll
或 auto
),即可解決這個問題。
Facebook 需要抓取分享至 Facebook 的連結,才能瞭解預覽資訊的連結內容,以便在 Facebook.com 或 iOS 和 Android 版 Facebook 上顯示。這項作業每 30 天就會執行一次,以確保屬性是最新的。在偵錯工具中輸入網址時,系統也會抓取連結頁面。
Facebook 會偵測網址的快取標頭,並依偏好設定尋找Expires
和 Cache-Control
。不過,即使您指定更長的時間間隔,Facebook 仍會每 30 天抓取您的頁面一次。
在某些情況下,您可能會想將頁面的另一個版本(包含更多開放社交關係圖中繼資料)提供給抓取程式,而不是用戶目前瀏覽的頁面。在這種情況下,您可以鎖定抓取程式使用的瀏覽器代理程式:
facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)
可以,只需在按鈕的 href
設定中指定您 Facebook 粉絲專頁的網址即可。
這是社交外掛程式內建的安全措施之一,目的在於確保真實性與預防垃圾訊息。如果您在正式上線前頻繁測試「讚」按鈕,可能意外觸發這些安全措施。此外,由於部分網域較有可能出現垃圾訊息,因此進行確認步驟的頻率也會相對提高。
這個確認按鈕為「讚」按鈕程序加上一道額外步驟,不過只要經過一定數量的用戶分別對按讚功能加以確認後,這道程序就不會繼續出現,之後只會顯示一般的「讚」按鈕。
這個數字代表以下項目的總和:
選項如下:
版面 | 預設尺寸 |
---|---|
| 寬度下限:225 像素。 |
| 寬度下限:55 像素。 |
| 寬度下限:90 像素。 |
| 寬度下限:47 像素。 |
這個數字代表以下項目的總和:
可以,雖然建議您使用「分享」按鈕,以便提供您的網站用戶最簡單一致的體驗,但我們也提供可使用 JavaScript SDK 或網址連結叫用的獨立對話方塊。請參閱「分享」對話方塊使用指南。
您可以在外掛程式的設定部分中啟用文法篩選功能。
針對每個網址的留言都可以透過圖形 API 存取,只需向以下網址發出 HTTP GET 要求即可:
https://graph.facebook.com/v2.6/?fields=og_object{comments} &id=<YOUR_URL> &access_token=<YOUR_TOKEN>