Facebook Instant Game 怎麼設定智慧助手

為方便大家群策群力， 我 們 建立了一個 Facebook Instant Game   交流群： 814298516 。 歡迎同 學 們加入 交流開發和運營經驗。

設定智慧助手

小遊戲的一項重要功能是能附加 Messenger 平臺智慧助手。這項功能雖為選擇性配置，卻為遊戲提供了一個強有力的再參與渠道。以下指南說明了如何建立和設定遊戲智慧助手。

 

第 1 步：建立主頁

如需建立遊戲智慧助手，您首先需要建立 Facebook 主頁。主頁要正確地與小遊戲關聯，需要具備一些特殊的屬性：

 

主頁類別需要是應用主頁

主頁名稱需要包含應用名稱。

主頁不能與其他應用關聯。

您可以前往 “應用皮膚”，在小遊戲產品的應用主頁版塊建立滿足這些特殊條件的主頁。 在執行下一步操作前，請確保應用主頁版塊如右圖所示：

 

注意：如果小遊戲未與上述型別的主頁正確關聯，智慧助手將不會收到 messaging_game_plays 事件

 

第 2 步：啟用智慧助手

建立主頁後，您需要確保響應其訊息 webhooks 。 Webhooks 是在向您的主頁傳送訊息事件時，我們向您的後端傳送的 HTTP 呼叫。之後，您的伺服器的邏輯將決定如何正確地響應每個事件（如果響應適用）。 如需將伺服器的端點與主頁事件相關聯，請按照 Messenger 平臺快速入門教程中的說明為主頁啟用智慧助手。下表介紹了將智慧助手與小遊戲關聯所需的 webhooks 和許可權：

 

部分 值

主頁事件

 

messages 和 messaging_game_plays

 

許可權

 

pages_messaging

 

小遊戲智慧助手僅可使用標準訊息和 GAME_EVENT 訊息標籤，不能使用 pages_messaging_subscriptions 。

 

如果您的智慧助手具有需要用到訂閱訊息或客戶匹配的其他功能，您應建立單獨的應用並重新申請 Messenger 平臺許可權。

 

第 3 步：響應 messaging_game_plays webhooks

正確配置智慧助手後，您的伺服器端應用程式將開始在玩家每次關閉小遊戲時接收 messaging_game_plays webhooks 。下面是伺服器端應用程式檢測到並響應一個 webhook 的示例。

 

if (event.game_play) {

  var senderId = event.sender.id; // Messenger sender id

  var playerId = event.game_play.player_id; // Instant Games player id

  var contextId = event.game_play.context_id;

  var payload = event.game_play.payload;

  var playerWon = payload['playerWon'];

  if (playerWon) {

    sendMessage(

      senderId,

      contextId,

      'Congratulations on your victory!',

      'Play Again'

    );

 

  } else {

    sendMessage(

      senderId,

      contextId,

      'Better luck next time!',

      'Rematch!'

    );

  }

}

您可以參閱 Messenger 平臺文件，詳細瞭解 webhook ：“玩遊戲” Webhook 文件。

 

第 4 步：吸引玩家重回遊戲

以下是如何使用圖譜 API 向玩家傳送 game_play 按鈕的示例。

 

curl "

   -X POST

   -H "Content-Type: application/json"

   -d '{

  "messaging_type": "UPDATE",

  "recipient": {

    "id": "<RECIPIENT_ID>"

  },

  "message": {

    "attachment": {

      "type": "template",

      "payload": {

        "template_type": "generic",

        "elements": [

          {

            "title": "It has been a while since your last game. Time to get back",

            "buttons": [

              {

                "type": "game_play",

                "title": "Play Tic-Tac-Toe.",

                "payload": "{}",

                "game_metadata": {

                  "context_id": "<CONTEXT_ID>"

                }

              }

            ]

          }

        ]

      }

    }

  }

}'

 

您可以參閱 Messenger 平臺文件，詳細瞭解此按鈕：“玩遊戲”按鈕文件。

 

第 5 步：遵循我們的指南和政策

釋出至生產階段後，您的遊戲智慧助手應進入 Messenger 平臺提交流程。提交智慧助手之前，請確保遵守下面的最佳實踐：

 

建議：

向玩家提供相關、及時且有價值的更新。如需獲取更多資訊，請訪問我們的最佳實踐版塊。

 

給予使用者掌控權（例如：讓使用者確認他們是否想要接收通知以及以接收的頻率）。

 

對玩遊戲按鈕使用入口點資料，以環境相關的方式載入遊戲。

 

為智慧助手設定與遊戲相同的名稱。

 

利用社交更新，如回合提醒、比賽結果、限時獎勵和挑戰。

 

確保為玩家提供適當的獎勵刺激，促使他們透過智慧助手訊息開啟遊戲。為此，您可使用訊息負載為玩家提供有價值的遊戲內獎勵。一般來說，如果智慧助手訊息開啟的是遊戲的開始頁面，這條訊息便沒有什麼價值。

 

使用固定選單提供常見操作，如啟動遊戲。

 

設定預設操作，在自定義更新中使用 game_play ，以便整個圖片都能將使用者帶入遊戲中。

 

透過智慧助手公佈新功能或內容。

 

針對每位使用者最佳化每天的訊息傳送時段，考慮使用者所在的時區。

 

借鑑 Messenger 智慧助手的通用最佳實踐。

 

請勿：

 

在玩家關閉遊戲後立即傳送訊息。

 

 

傳送沒有任何背景資訊的訊息再次吸引玩家（例如： “立即回到遊戲中！”）。建議首選包含豐富背景資訊的訊息來重新吸引玩家（例如：“你的偵查員為你帶回了更多資訊”）

 

 

使用其他 Facebook 使用者的口吻，或誤導玩家以為他們好友在與他們溝通。

 

 

在使用者屢次不想加入遊戲的情況下繼續向他們傳送智慧助手訊息。這種情況將適用政策限制，並阻止您傳送訊息。當前的限制為，自最後一次遊戲會話結束後 10 天最多可傳送 5 條訊息。如需詳細瞭解，請參閱我們的開放平臺政策文件中的第 9.4 條

 

 

將 messaging_type 設定為 RESPONSE 或 UPDATE 以外的其他任何值

 

 

連結至任何應用商店。