This feature is no longer available for new submissions. This documentation is intended solely for developers with existing games.
應用程式對用戶通知是一種簡短的自由格式訊息,您可向自家應用程式用戶傳送此類訊息,以便與他們再次互動。如果您想通知用戶重要活動的資訊、來自朋友的邀請或他們需要採取的行動,此類通知非常有效。您可以使用此類通知,向已對應用程式授權的用戶傳送訊息。
應用程式對用戶通知適用於所有 Facebook 網頁遊戲。這些通知只會在桌面電腦的網頁版 Facebook 中顯示。應用程式可以傳送通知給已向應用程式授權的用戶,而無需再取得任何特殊或延伸權限。
通知送達後,Facebook 上的通知圖示就會亮起,並在下拉式選單中顯示通知。通知的左邊會顯示應用程式圖示,並按時間順序穿插在其他通知之間。
通知本身屬於簡短的自訂文字字串,最多包含 120 個字元。如果您想在通知中稱呼用戶,可以輸入用戶的 Facebook 應用程式範圍編號。系統會根據有關編號顯示用戶的實際名稱,但有關名稱將不可供點擊。請參閱下方的訊息範本區塊,以了解更多詳情。
用戶點擊通知後,將被帶往您在通知中指定的網址。
應用程式可以向 /user_id/notifications
Graph API 發出 HTTP POST
要求,並在其中加入 app access_token
,以產生通知。請參閱 Graph API 通知關係連線,以了解更多詳情。
POST /{recipient_userid}/notifications?access_token=... &template=...&href=...
參數 | 說明 |
---|---|
| 目標的相對路徑或 GET 參數(例如 |
| 通知的自訂文字。請參閱下方的訊息範本區塊,以了解更多詳情。 |
| 將通知分類,以便在應用程式分析工具中獨立追蹤。 |
如果呼叫成功,Graph API 會傳回以下回應:
{ "success": true }
備註:如果我們預測接收者與通知互動的可能性偏低,便可能不會向接收者顯示這則通知,即使 Graph API 呼叫成功亦然。
如果呼叫失敗,Graph API 的回應中將包含錯誤和相應的異常情況訊息。
若您嘗試向未驗證應用程式的用戶傳送通知,會收到如下回應:
{ "error": { "message": "(#200) Cannot send notifications to a user who has not installed the app", "type": "OAuthException", "code": 200 } }
若您嘗試標註未驗證應用程式的用戶,會收到如下回應:
{ "error": { "message": "(#200) Cannot tag users who have not installed the app", "type": "OAuthException", "code": 200 } }
若您的範本文字超過 180 個字元,API 會傳回如下錯誤。請注意,任何超過 120 個字元的內容都會被截斷。
{ "error": { "message": "(#100) template parameter cannot be longer than 180 characters.", "type": "OAuthException", "code": 100 } }
備註:如果用戶關閉您的應用程式通知,通知還是會成功發佈,但不會在用戶介面中顯示。
通知訊息屬於自由填入文字。Graph API message
欄位的上限為 180 個字元,並會截斷所有超過 120 個字元的訊息。
此類通知可以透過以下 Graph API 呼叫產生:
POST /{recipient_userid}/notifications? access_token=...& href=...& template=You have people waiting to play with you, play now!
您可以使用 @[USER_ID]
以加入 user_id,系統會將這部分換成用戶的全名,並在呈現時加以突顯。
如要產生上述通知,您可以透過加入用戶編號來設定範本格式,具體請參考下方程式碼。
POST /{recipient_userid}/notifications? access_token=...& href=...& template=@[596824621] started a game with you, play now!
同樣地,下方通知也使用了 @[USER_ID]
語法,只是範本中有多個對象(用戶)。
POST /{recipient_userid}/notifications? access_token=...& href=...& template=@[596824621] and @[10149999096285761] started a game with you!
Graph API 會驗證每一個 USER_ID
,以確保均為有效的 Facebook 用戶,且有關用戶已驗證您的應用程式。若有任何編號無效,API 呼叫都會失敗。
點閱率是衡量通知成效最重要的指標之一。通知點閱率較高代表用戶認為有趣和吸引。通知點閱率較低則會被視為品質欠佳。經過一段時間後,用戶通常會忽略或停用點閱率較低的通知,這會對您應用程式的成效及其他方面造成負面影響。
為了確保通知渠道可以一直引起 Facebook 用戶的興趣,我們規定每週傳送超過 50,000 則通知的應用程式必須維持至少 17% 的每週點閱率。有關資料顯示,若應用程式可以維持此水平或更高的點閱率,用戶會互動得更久。若應用程式無法維持此每週點閱率,可能會被暫時停用。
對於大多數應用程式而言,只要採納以下部分的簡易最佳操作實例,便能輕鬆維持此點閱率。
如要傳送非英文通知,開發人員需要手動追蹤用戶的地區設定。用戶登入後,開發人員可以透過 Graph API 關係連線 /{user-id}?fields=locale 存取用戶的地區設定。若是 Facebook.com 上的遊戲,則可以使用 HTTP POST 要求來檢索地區設定資訊。開發人員掌握此類資訊後,便可以手動建立與用戶地區設定對應的訊息範本。
開發人員可以在用戶清醒的時候傳送通知,以此進一步優化通知成效。用戶登入後,開發人員可以透過 Graph API 關係連線 /{user-id}?fields=timezone 存取用戶所在時區。透過掌握時區資訊並使用參考參數,開發人員可以優化受眾目標設定,並選擇最佳時機來向用戶傳送通知。
您可以使用自動受眾目標設定功能,在傳送應用程式對用戶通知時加以善用 Facebook 的加強受眾目標設定功能。啟用自動受眾目標設定功能後,您就不用自己辛苦維持 17% 的高水平點閱率,因為 Facebook 會自動向最有可能與您的應用程式互動的用戶傳送通知。
啟用此功能後,您就可以鎖定更大範圍的受眾族群傳送通知,Facebook 亦會自動向最有可能與您應用程式互動的用戶傳送通知。例如,我們發現多日前建立的通知多半成效不彰,因此會減少傳送這類通知。大部分開發人員在啟用自動受眾目標設定功能並增加通知傳送次數後,都已經發現應用程式對用戶通知的互動率大幅提升。
如要享受自動受眾目標設定功能帶來的效益,您可以在應用程式管理中心設定的設定分頁中啟用此功能。
請注意,如果應用程式之前未曾使用應用程式對用戶通知,並在最近開始執行此功能,系統會自動為其選用自動受眾目標設定功能。
我們十分重視通知的品質,因此開放讓 Facebook 接收者輕鬆關閉不喜歡的通知,或將其舉報為垃圾訊息。我們運用這些訊號來推廣用戶喜歡的通知,並減少散佈用戶不喜歡的通知。這有助為所有人帶來實用的通知。
用戶將通知與其他 Facebook 體驗一視同仁,所以每一則訊息都大有影響力。只要一則擾人的訊息,就足以讓用戶開始無視通知,或直接停用通知功能。
為了幫助您建立清晰和吸引的通知,我們整理出以下一些最佳操作實例供您參考。