This feature is no longer available for new submissions. This documentation is intended solely for developers with existing games.
Thông báo của ứng dụng cho người dùng là tin nhắn ngắn dạng tự do mà bạn có thể gửi cho những người đang dùng ứng dụng của bạn để tái thu hút họ. Đây là một trong những cách hiệu quả nhất để truyền đạt sự kiện quan trọng, lời mời từ bạn bè hoặc hành động mà mọi người cần thực hiện. Loại thông báo này dùng để gửi tin nhắn đến những người đã ủy quyền cho ứng dụng.
Thông báo của ứng dụng cho người dùng có sẵn cho tất cả Game trên web của Facebook. Thông báo này chỉ hiển thị trên phiên bản web dành cho máy tính của Facebook. Ứng dụng có thể gửi thông báo cho những người đã ủy quyền cho ứng dụng. Không cần có quyền đặc biệt hay mở rộng nào.
Khi một thông báo được gửi, biểu tượng thông báo trên Facebook sẽ sáng lên và thông báo này sẽ xuất hiện trong menu thả xuống. Thông báo sẽ xuất hiện cùng biểu tượng ứng dụng ở bên trái, xen kẽ với các thông báo khác dựa trên cách sắp xếp theo trình tự thời gian.
Thực chất, thông báo là các chuỗi văn bản tùy chỉnh ngắn, dài tối đa 120 ký tự. Bạn có thể xem mọi người theo ID người dùng trong ứng dụng trên Facebook. Bạn có thể mở rộng những ID này để xem tên thực của mọi người, nhưng không thể nhấp vào tên. Hãy xem phần mẫu tin nhắn bên dưới để biết thêm chi tiết.
Khi nhấp vào thông báo, mọi người sẽ được chuyển đến URL bạn chỉ định bằng thông báo này.
Ứng dụng có thể tạo thông báo bằng cách gửi yêu cầu HTTP POST
đến API Đồ thị /user_id/notifications
, kèm theo app access_token
. Bạn có thể tham khảo phần Cạnh thông báo của API Đồ thị để biết thêm chi tiết.
POST /{recipient_userid}/notifications?access_token=... &template=...&href=...
Thông số | Mô tả |
---|---|
| Đường dẫn tương đối hoặc thông số GET của đích (ví dụ: |
| Văn bản tùy chỉnh của thông báo. Hãy xem phần mẫu tin nhắn ở bên dưới để biết thêm chi tiết. |
| Tách thông báo thành các nhóm để có thể theo dõi độc lập trong công cụ Phân tích ứng dụng. |
Nếu lệnh gọi thành công, API Đồ thị sẽ trả về phản hồi sau đây:
{ "success": true }
Lưu ý: Khi chúng tôi dự đoán người nhận sẽ có ít khả năng tương tác với thông báo, thông báo có thể không hiển thị với người nhận này mặc dù lệnh gọi API Đồ thị thành công.
Nếu không, phản hồi của API Đồ thị sẽ chứa lỗi cùng với thông báo tương ứng về trường hợp ngoại lệ.
Nếu người dùng mà bạn đang cố gửi thông báo chưa xác thực ứng dụng của bạn, bạn sẽ nhận được phản hồi có dạng như sau:
{ "error": { "message": "(#200) Cannot send notifications to a user who has not installed the app", "type": "OAuthException", "code": 200 } }
Nếu người mà bạn đang cố gắn thẻ chưa xác thực ứng dụng của bạn, bạn sẽ nhận được phản hồi sau đây:
{ "error": { "message": "(#200) Cannot tag users who have not installed the app", "type": "OAuthException", "code": 200 } }
Nếu văn bản mẫu của bạn có hơn 180 ký tự, API sẽ trả về lỗi như sau. Lưu ý rằng mọi nội dung vượt quá 120 ký tự sẽ bị cắt bớt.
{ "error": { "message": "(#100) template parameter cannot be longer than 180 characters.", "type": "OAuthException", "code": 100 } }
Lưu ý: Nếu mọi người tắt thông báo đến từ ứng dụng của bạn, hành động đăng sẽ vẫn thành công, chỉ có điều thông báo sẽ không xuất hiện trên giao diện người dùng.
Tin nhắn thông báo là văn bản dạng tự do. API Đồ thị chấp nhận tối đa 180 ký tự trong trường message
và sẽ cắt bớt tin nhắn sau khi đã đủ 120 ký tự.
Bạn có thể tạo thông báo này bằng lệnh gọi API Đồ thị sau đây:
POST /{recipient_userid}/notifications? access_token=...& href=...& template=You have people waiting to play with you, play now!
Bạn sử dụng @[USER_ID]
để thêm và nêu bật user_ids (ID này sẽ được thay thế bằng tên đầy đủ của người dùng) vào lúc hiển thị.
Bạn có thể định dạng mẫu bằng ID người dùng để tạo thông báo ở trên, như minh họa trong mã bên dưới.
POST /{recipient_userid}/notifications? access_token=...& href=...& template=@[596824621] started a game with you, play now!
Tương tự, thông báo dưới đây cũng sử dụng cú pháp @[USER_ID]
nhưng có nhiều tác nhân (người) trong mẫu.
POST /{recipient_userid}/notifications? access_token=...& href=...& template=@[596824621] and @[10149999096285761] started a game with you!
API Đồ thị xác minh từng USER_ID
để đảm bảo đó là người dùng Facebook hợp lệ và đã xác thực ứng dụng của bạn. Nếu có bất kỳ thông tin nào không hợp lệ, lệnh gọi API sẽ không thực hiện được.
Tỷ lệ nhấp (CTR) là một trong những thước đo quan trọng nhất về hiệu quả của thông báo. Thông báo có CTR cao là thông báo thú vị và hấp dẫn với mọi người. Thông báo có CTR thấp bị xem là có chất lượng kém. Theo thời gian, mọi người thường bỏ qua hoặc tắt thông báo có CTR thấp, dẫn đến giảm hiệu quả ứng dụng của bạn cũng như của người khác.
Để đảm bảo kênh thông báo luôn thú vị với mọi người trên Facebook, các ứng dụng gửi hơn 50.000 thông báo mỗi tuần phải duy trì tỷ lệ nhấp (CTR) hàng tuần ở mức tối thiểu là 17%. Dữ liệu cho thấy rằng mọi người tương tác lâu hơn khi ứng dụng duy trì được tỷ lệ này hoặc cao hơn. Ứng dụng không duy trì được tỷ lệ này trên cơ sở hàng tuần có thể bị vô hiệu hóa tạm thời.
Hầu hết ứng dụng có thể duy trì tỷ lệ này khá dễ dàng nếu họ tuân thủ cách làm đơn giản tốt nhất trong phần bên dưới.
Để gửi thông báo không phải tiếng Anh, nhà phát triển cần theo dõi thủ công ngôn ngữ của người dùng. Sau khi người đó đăng nhập, bạn có thể xem ngôn ngữ qua cạnh /{user-id}?fields=locale của API Đồ thị. Đối với game trên Facebook.com, bạn có thể truy xuất thông tin về ngôn ngữ từ yêu cầu đăng HTTP. Khi đã biết ngôn ngữ, nhà phát triển có thể tạo thủ công các mẫu tin nhắn tương ứng với ngôn ngữ của người dùng.
Nhà phát triển có thể tối ưu hóa tốt hơn các thông báo được gửi vào giờ mà người đó đang thức. Sau khi người đó đăng nhập, bạn có thể xem múi giờ qua cạnh /{user-id}?fields=timezone của API Đồ thị. Khi đã biết thông tin về múi giờ và sử dụng thông số ref, nhà phát triển có thể nhắm mục tiêu và tối ưu hóa hiệu quả hơn, từ đó tìm ra thời điểm phù hợp nhất để gửi thông báo cho mọi người.
Với tính năng Tự động nhắm mục tiêu, bạn có thể gửi Thông báo của ứng dụng cho người dùng mà vẫn tận dụng được tùy chọn nhắm mục tiêu nâng cao của Facebook. Khi bật tính năng Tự động nhắm mục tiêu, bạn không cần tự duy trì tỷ lệ nhấp (CTR) cao là 17% vì Facebook sẽ tự động gửi thông báo đến những người có nhiều khả năng tương tác với ứng dụng của bạn nhất.
Khi bật tính năng này, bạn có thể nhắm mục tiêu các phân khúc đối tượng lớn hơn bằng thông báo và Facebook sẽ tự động gửi thông báo cho những người có nhiều khả năng tương tác với ứng dụng của bạn nhất. Ví dụ: chúng tôi nhận ra rằng các thông báo gửi cách đây hơn một vài ngày thường có hiệu quả kém - do đó, chúng tôi sẽ gửi ít loại thông báo đó hơn. Hầu hết những nhà phát triển bật tính năng Tự động nhắm mục tiêu và tăng số lần gửi thông báo đã nhận thấy mức độ tương tác tăng lên đáng kể nhờ Thông báo của ứng dụng cho người dùng.
Để tận dụng tính năng Tự động nhắm mục tiêu, bạn có thể bật tính năng này trong tab Cài đặt của phần Cài đặt bảng điều khiển ứng dụng.
Lưu ý rằng đối với các ứng dụng chưa từng dùng Thông báo của ứng dụng cho người dùng và mới triển khai loại thông báo đó gần đây, hệ thống có thể tự động chọn bật tính năng Tự động nhắm mục tiêu cho bạn.
Vì chất lượng rất quan trọng nên người nhận trên Facebook có thể dễ dàng tắt thông báo khi họ không thích hoặc báo cáo thông báo là spam. Chúng tôi dùng những tín hiệu này để đẩy mạnh các thông báo mà mọi người thích và hạn chế phân phối các thông báo mà mọi người không thích. Như vậy, thông báo sẽ luôn hữu ích cho mọi người.
Mọi người không phân biệt thông báo với những trải nghiệm còn lại trên Facebook, vậy nên mỗi thông báo đều mang rất nhiều sức mạnh. Một thông báo không mong muốn có thể khiến ai đó bắt đầu bỏ qua hoặc tắt hoàn toàn thông báo.
Để trợ giúp bạn tạo thông báo rõ ràng và hấp dẫn, chúng tôi đã tổng hợp những cách làm tốt nhất sau đây.