应用对用户通知

分类目录: 游戏

应用对用户通知

概览

应用对用户通知是您向应用用户发送的、自由格式的简短通知,用以再次吸引用户。通知是您向用户告知重要事件、好友邀请或用户需执行的操作的最有效方式之一。您可以使用通知将消息发送给已向应用授权的用户。

应用对用户通知适用于 Facebook.com 上的所有应用,而不仅仅是游戏应用。通知只在 Facebook 的桌面网页版中显示。应用可以将通知发送给已向应用授权的用户。无需特殊权限或扩展权限。

通知送达后,Facebook 的通知图标将亮起并在下拉列表中显示。显示通知时,应用图标位于左侧,与其他通知按时间顺序同时显示。

通知本身是简短的自定义文本字符串,最多 180 个字符。您可以使用用户的 Facebook 应用范围编号来引用用户。这些编号将以展开的形式显示用户的真实姓名,但是姓名不可点击。详细信息请参阅下方的消息模板版块。

用户点击通知后,将跳转至您在通知中指定的网址。

实施

发送通知

应用可以使用 app access_token,通过向 /user_id/notifications 图谱 API 发送 HTTP POST 请求来生成通知。您可以参阅图谱 API 通知连线,了解更多详情。

POST /{recipient_userid}/notifications?access_token=... &template=...&href=...

参数

参数 说明

href

目标的相对路径或 GET 参数(例如 index.html?gift_id=123?gift_id=123)。这可用于根据应用设置来构建绝对目标网址。逻辑是:在网页上,如果存在 Facebook.com 游戏的设置,目标网址将包含游戏应用网址 + href。如果没有,则不会显示通知。绝对网址将包含目标网址的一些特殊追踪参数(fb_sourcenotif_idnotif_t),方便开发者自行追踪。

template

通知的定制文本。详细信息请参阅下方的消息模板版块。

ref

将通知分为多组,以便可以在应用分析中单独予以追踪。

处理返回值

如果调用成功,图谱 API 将给出以下响应:

{
  "success": true
}

如果不成功,图谱 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 将返回如下错误:

{
   "error": {
      "message": "(#100) template parameter cannot be longer than 180 characters.",
      "type": "OAuthException",
      "code": 100
   }
}

注意:如果用户关闭来自应用的通知,帖子仍将成功发布,只是通知不会显示在用户界面中。

消息模板

通知消息采用自由格式文本。图谱 API 规定 message 字段中最多只能包含 180 个字符。

纯文本消息

此通知可以通过以下图谱 API 调用生成:

POST /{recipient_userid}/notifications?
     access_token=...& 
     href=...& 
     template=You have people waiting to play with you, play now!

个性化消息模板

您使用 @[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!

图谱 API 将验证每一个 USER_ID,确保它是有效的 Facebook 用户,且已经验证应用。如果无效,API 调用将失败。

追踪表现

最小点击展示次数比

点击展示次数 (CTI) 比是衡量通知有效性的最重要指标之一。高 CTI 通知对用户的吸引力非常大。低 CTI 通知将被视为低质量通知。随着时间的推移,用户将忽略或禁用低 CTI 通知,这将影响到您和其他开发者的应用的表现。

为确保通知渠道始终能吸引 Facebook 用户的注意,一周内发送超过 50,000 条通知的应用必须至少维持 17% 的每周点击展示次数比。数据显示,当应用维持此比率或更高比率时,用户使用应用的时间更长。每周未维持此比率的应用可能会被暂时禁用。

如果遵循下述简单的最佳实践,大多数应用都可以轻而易举地维持此比率。

在应用分析中使用引用参数

在 Facebook 应用分析中,您可以在“集成”>“应用通知”中追踪通知的表现。选择按引用参数显示后,您可以查看不同的通知活动的表现。引用参数是向图谱 API 提交通知时,可以由开发者定义的集合。详情请参阅上述关于发送通知的部分。

手动优化

消息模板本地化

要发送非英语通知,开发者需要手动追踪用户的区域设置。用户登录后,可以通过图谱 API 连线 /{user-id}?fields=locale 访问区域设置。对于 Facebook.com 上的游戏,可以从 HTTP POST 请求检索区域设置信息。知道区域设置后,开发者可以手动创建符合用户区域设置的消息模板。

发送时机

开发者可以更好地优化通知,在用户活跃时段发送。用户登录后,可以通过图谱 API 连线 /{user-id}?fields=timezone 访问时区。知道时区信息并使用引用参数,开发者可以更好地确定向用户发送通知的最佳时机并进行优化。

通知目标自动设置(测试)

通过通知目标自动设置功能,您可以在发送应用对用户通知的同时,利用 Facebook 的增强版定位功能。启用通知目标自动设置功能后,您就无需花很大心思去维持 17% 的高点击展示次数比,因为 Facebook 会自动向最可能与应用互动的用户推送通知。

启用此功能后,您的通知可定位至更大规模的受众群,且 Facebook 会自动向最可能与您的应用互动的用户推送通知。例如,我们发现存在了数天的旧通知一般表现不好 — 因此我们会减少这类通知的推送量。大部分开发者打开通知目标自动设置功能并增加通知发送量后,其应用对用户通知的参与度有显著提高。

如需使用通知目标自动设置功能,您可以前往应用面板设置设置选项卡开启此功能。

请注意,对于过去未使用应用对用户通知,但最近加入此功能的应用,系统会自动认为您开启了通知目标自动设置功能。

手动设置应用对用户通知的目标

关闭通知目标自动设置功能后,您就可以覆盖作为通知发送对象的每一位用户。但我们的政策规定,如果一周发送的通知数量超过 50,000 条,就必须保持至少 17% 的点击展示次数比。

最佳实践

通知的质量至关重要,Facebook 接收方可以轻松关闭不喜欢的通知或将这些通知举报为垃圾信息。我们会利用这些信号来推广用户喜欢的通知,并减少用户不喜欢的通知的传播。这有助于保证通知对每个用户都有价值。

用户不会将通知与他们在 Facebook 的其他体验区分开来,因此,每条消息都影响重大。一条多余的消息可能会让某个用户开始忽略通知或将它完全关闭。

为帮助您创建清晰而极具吸引力的通知,我们总结了以下最佳实践。

  1. 不向不活跃的用户发送通知。应用不应向过去 28 天内未使用应用的用户发送通知。数据显示,此群体的参与度明显较低。此外,他们还最有可能将您的通知举报为垃圾信息。垃圾信息举报度高的应用可能会被禁用。
  2. 从少做起。即便您有一个大型应用,开始时也只应通过少数用户测试通知表现,以便保持在每周 50,000 条通知的分界值之下。这样,您可以试验通知,直至了解到最适合用户的内容。
  3. 每天仅向用户发送一条或两条通知。如果一天超出两条通知,许多用户会停止响应或将应用标记为垃圾信息。
  4. 谨防受众疲劳。在短时间内向同一用户发送过多通知通常不是明智的做法。使用应用分析,开发者可以根据不同时间(2 小时、6 小时、1 天、3 天、1 周或甚至长达 2 周)的引用参数来比较结果,从而找到再次吸引玩家的最佳时间点。
  5. 自动设置通知目标。如果您一周发送的通知数量超过 50,000 条,但保持 17% 的 CTI 非常困难,则建议您开启通知目标自动设置功能,让 Facebook 自动向最有可能与您的应用互动的用户推送通知。