تحديثات الألعاب عبر Messenger

يمكن للألعاب الفورية على فيسبوك ربط البرنامج التلقائي لمنصة Messenger. وعلى الرغم من أن هذه الميزة اختيارية، إلا أنها تمنح لعبتك قناة قوية لإعادة التفاعل. إليك طريقة إنشاء البرنامج التلقائي للعبتك وإعداده:

الخطوة 1: إنشاء صفحة

لإنشاء برنامج تلقائي للعبة، يجب إنشاء صفحة فيسبوك أولاً. وحتى تتمكّن الصفحة من العمل بشكل صحيح مع لعبتك الفورية، يجب أن تلبي بعض المعايير المحددة:

• يجب تعيين فئة الصفحة إلى صفحة تطبيق (وهذه الفئة فقط)
• يجب على اسم الصفحة أن يتضمن اسم التطبيق.
• لا يمكن ربط الصفحة بتطبيق آخر.

لإنشاء صفحة تتضمن هذه المعايير، تفضل بزيارة لوحة معلومات التطبيق واتباع الخطوات التالية:

1. في قائمة المنتج، قم بتوسيع القائمة المنسدلة للألعاب الفورية وحدد التفاصيل
2. من صفحة التفاصيل، ابحث عن القسم بعنوان صفحة التطبيق وانقر على إنشاء صفحة جديدة
3. انتقل إلى قسم صفحة التطبيق الخاصة بمنتج الألعاب الفورية. قبل الانتقال إلى الخطوة التالية، يجب التأكد من ظهور قسم صفحة التطبيق الخاص بك بالشكل الذي تظهر به الخطوة الموضحة ناحية اليسار:

الخطوة 2: تنشيط البرنامج التلقائي

بعد الانتهاء من إنشاء صفحتك، يجب عليك التأكد من الاستجابة إلى webhooks المراسلة الخاصة بها. Webhooks هي عبارة عن استدعاءات HTTP نرسلها إلى الخلفية التي تستخدمها في حالة إرسال حدث مراسلة إلى صفحتك. وبعد ذلك، سيحدد منطق الخادم لديك طريقة الاستجابة بشكل صحيح إلى كل حدث إذا كانت الاستجابة تمثل إجراءً مناسبًا. لربط نقاط النهاية الخاصة بخادمك مع أحداث صفحتك، اتبع الإرشادات المذكورة في العرض التوضيحي للبدء السريع لمنصة Messenger لتمكين البرنامج التلقائي لصفحتك. يحتوي الجدول التالي على معلومات حول webhooks والأذونات التي ستحتاج إليها بحيث يعمل البرنامج التلقائي مع الألعاب الفورية:

الخطوة 3: الاستجابة إلى webhooks messaging_game_plays

بمجرد الانتهاء من تكوين برنامجك التلقائي بشكل صحيح، سيبدأ تطبيق الخادم لديك في تلقي webhooks messaging_game_plays في كل مرة يغلق فيها اللاعب اللعبة الفورية. وفيما يلي مثال على تطبيق خادم يكتشف أحد أنواع webhooks هذه ويستجيب لها.

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!'
    );
  }
}

لمزيد من المعلومات حول هذا النوع من webhook، يمكنك الرجوع إلى وثائق منصة Messenger: وثائق webhook "تشغيل اللعبة".

الخطوة 4: استعادة جذب لاعبيك إلى اللعبة

وفيما يلي مثال على كيفية استخدام واجهة Graph API لإرسال زر game_play إلى اللاعبين.

curl "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>" -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. وتأكد من الرجوع إلى قائمة مراجعة البرنامج التلقائي قبل إرساله للمراجعة.