إشعارات من التطبيق إلى المستخدم

This feature is no longer available for new submissions. This documentation is intended solely for developers with existing games.

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

تتوفر إشعارات من التطبيق إلى المستخدم لجميع ألعاب فيسبوك على الويب. لا تظهر الإشعارات إلا في إصدار فيسبوك للويب لأجهزة الكمبيوتر. يمكن للتطبيقات إرسال إشعارات إلى الأشخاص الذين صرَّح لهم بالتطبيق. لا يلزم إذن خاص أو موسّع.

عندما يتم تسليم إشعار، فإنه يضيء جوهرة الإشعارات على فيسبوك ويظهر في القائمة المنسدلة. تظهر الإشعارات مع أيقونة التطبيق على اليسار، متخللة مع إشعارات أخرى بناءً على الفرز الزمني.

الإشعارات نفسها عبارة عن سلاسل قصيرة - حتى 120 حرفًا - من النصوص المخصصة. يمكنك الإشارة إلى الأشخاص من خلال معرفاتهم على نطاق تطبيق فيسبوك. سيتم توسيعها لإظهار الأسماء الفعلية للأشخاص، ولكن لن تكون الأسماء قابلة للنقر عليها. انظر قسم قوالب الرسائل أدناه لمزيد من التفاصيل.

عندما ينقر الأشخاص على الإشعار، يتم نقلهم إلى عنوان URL الذي تحدده بالإشعار.

التنفيذ

إرسال الإشعارات

يمكن للتطبيقات إنشاء إشعارات عن طريق إصدار طلب HTTP POST إلى /user_id/notifications واجهة Graph API باستخدام app access_token. قد تجد المزيد من التفاصيل بالرجوع إلى عنصر ربط إشعارات Graph API.

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

المعلمات

المعلمة	الوصف
`href`	المسار النسبي أو معلمات GET للهدف (على سبيل المثال: `index.html?gift_id=123` أو `?gift_id=123`). سيتم استخدام هذا لإنشاء عنوان URL مستهدف مطلق استنادًا إلى إعدادات التطبيق. المنطق هو أنه، على الويب، إذا كان الإعداد موجودًا للألعاب على Facebook.com، فإن عنوان URL المستهدف سيشتمل على عنوان URL لتطبيق اللعبة + `href`. إذا لم يكن الأمر كذلك، فلن يتم عرض الإشعار. سيتضمن عنوان URL المطلق بعض معلمات التتبع الخاصة (`fb_source`، `notif_id`، `notif_t`) إلى عنوان URL المستهدف حتى يتتبعه المطورون من جانبهم.
`template`	النص المخصص للإشعار. انظر قسم قوالب الرسائل أدناه لمزيد من التفاصيل.
`ref`	قم بتقسيم إشعاراتك إلى مجموعات حتى يمكن تتبعها بشكل مستقل في تحليلات التطبيقات.

التعامل مع قيم الإرجاع

إذا نجح الاستدعاء، فإن واجهة 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 180 حرفًا كحد أقصى في حقل message، وستقوم باقتطاع الرسائل بعد 120 حرفًا.

رسائل نصية عادية

يمكن إنشاء هذا الإشعار باستخدام استدعاء واجهة Graph API التالي:

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

قوالب الرسائل الشخصية

يُمكنك استخدام @[USER_ID] لتضمين user_ids، الذي سيتم استبداله بالاسم الكامل للشخص وإبرازه في وقت العرض.

يمكن إنشاء الإشعار أعلاه عن طريق تنسيق القالب بمعرفات المستخدمين كما هو موضح في الرمز أدناه.

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 للتأكد من صحة مستخدم فيسبوك وأنه قد قام بالفعل بمصادقة تطبيقك. إذا كان أي منهما غير صالح، فسيفشل استدعاء واجهة API.

تتبع الأداء

الحد الأدنى لنسبة النقر إلى الظهور

نسبة النقر إلى الظهور (CTR) هي أحد أهم مقاييس فعالية إشعاراتك. الإشعارات التي لها نسبة مرتفعة من النقر إلى الظهور تكون مثيرة للاهتمام وجذابة للناس. تعتبر الإشعارات ذات نسبة منخفضة من النقر إلى الظهور رديئة الجودة. بمرور الوقت، سيميل الناس إلى تجاهل أو تعطيل الإشعارات ذات النسب المنخفضة من النقر إلى الظهور، مما يؤثر سلبًا على أداء تطبيقك والآخرين أيضًا.

لضمان بقاء قناة الإشعارات مثيرة للاهتمام للأشخاص على فيسبوك، يلزم أن تحافظ التطبيقات التي ترسل أكثر من 50,000 إشعار في الأسبوع على تحقيق نسبة قدرها 17% على الأقل من النقر إلى الظهور أسبوعيًا. تُظهِر البيانات أن الأشخاص يتفاعلون لفترة أطول عندما تحافظ التطبيقات على هذه النسبة أو أعلى. قد يتم تعطيل التطبيقات التي لا تحافظ على هذه النسبة أسبوعيًا مؤقتًا.

يمكن أن تحافظ معظم التطبيقات على هذه النسبة بسهولة تامة إذا اتبعت أفضل الممارسات البسيطة الموضحة في القسم أدناه.

التحسين اليدوي

ترجمة قالب الرسائل

لإرسال إشعارات بلغة غير الإنجليزية، يحتاج المطورون إلى تتبع لغة الشخص يدويًا. بعد تسجيل الدخول، يمكن الوصول إلى اللغة عبر عنصر ربط واجهة Graph API /{user-id}?fields=locale. بالنسبة للألعاب على Facebook.com، يمكن استرجاع معلومات اللغة من طلب منشور HTTP. من خلال معرفة اللغة، يمكن للمطورين إنشاء قوالب رسائل يدويًا تتوافق مع لغة المستخدم.

توقيت الإرسال

يمكن للمطورين تحسين الإشعارات التي سيتم إرسالها في ساعات استيقاظ الشخص بشكل أفضل. بعد تسجيل الدخول، يمكن الوصول إلى المنطقة الزمنية عبر عنصر ربط واجهة Graph API /{user-id}?fields=timezone. بفضل معلومات المنطقة الزمنية واستخدام المعلمات المرجعية، يمكن للمطورين استهداف وتحسين أفضل توقيت بشكل أفضل لإرسال الإشعارات إلى الأشخاص.

الاستهداف التلقائي (تجريبي)

يمكّنك الاستهداف التلقائي من إرسال إشعارات من التطبيق إلى المستخدم مع الاستفادة من الاستهداف المحسّن لفيسبوك. تمكين الاستهداف التلقائي يحررك من عبء الحفاظ على نسبة النقر إلى الظهور عند 17% بنفسك؛ لأن فيسبوك سيقوم تلقائيًا بتسليم الإشعارات للأشخاص الذين من المرجح أن يتفاعلوا مع تطبيقك.

مع تمكين هذه الميزة، يمكنك استهداف شرائح جمهور أكبر بإشعاراتك وسيقوم فيسبوك تلقائيًا بتسليم الإشعارات للأشخاص الذين من المرجح أن يتفاعلوا مع تطبيقك. على سبيل المثال، لقد حددنا أن الإشعارات التي يزيد عمرها عن بضعة أيام أداؤها ضعيف عمومًا؛ وبالتالي سنقوم بتسليم عدد أقل منها. شهد معظم المطورين الذين قاموا بتشغيل الاستهداف التلقائي وزيادة إرسال الإشعارات، زيادات كبيرة في التفاعل مع إشعارات من التطبيق إلى المستخدم.

للاستفادة من الاستهداف التلقائي، يُمكنك تشغيله من علامة التبويب الإعدادات في إعدادات لوحة معلومات التطبيقات.

لاحظ أنه بالنسبة للتطبيقات التي لم تستخدم إشعارات من التطبيق إلى المستخدم في الماضي والتي قامت بتنفيذها مؤخرًا، سيتم اشتراكك تلقائيًا في الاستهداف التلقائي.

أفضل الممارسات

نظرًا لأن الجودة مهمة للغاية، يمكن للمستلمين على فيسبوك إيقاف تشغيل الإشعارات التي لا يحبونها أو الإبلاغ عنها كمحتوى غير مهم أو احتيالي بسهولة. نستخدم هذه الإشارات لترويج الإشعارات التي يحبها الناس وتقليل توزيع الإشعارات التي لا يحبها الناس. وهذا يساعد في الحفاظ على أن تكون الإشعارات مفيدة للجميع.

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

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

لا يوجد أشخاص غير نشطين. يجب ألَّا يرسل تطبيقك إشعارات إلى الأشخاص الذين لم يستخدموه خلال آخر 28 يومًا. تُظهِر البيانات أن التفاعل بين هذه المجموعة أقل بكثير. وهم أيضًا الأكثر احتمالية للإبلاغ عن إشعاراتك كمحتوى غير مهم أو احتيالي. قد يتم تعطيل التطبيقات التي تتلقى درجة عالية من بلاغات المحتوى غير المهم أو الاحتيالي.
ابدأ صغيرًا. حتى إذا كان لديك تطبيق كبير، ابدأ باختبار إشعاراتك على عدد قليل من الأشخاص حتى تبقى أقل من حد 50,000 في الأسبوع. بهذه الطريقة، يمكنك تجربة إشعاراتك حتى تتعرف على أفضل ما يناسب الناس.
أرسل إشعار أو إشعارين فقط إلى الأشخاص كل يوم. بعد إشعارين في يوم واحد، يتوقف العديد من الأشخاص عن الاستجابة أو يضعون علامة على التطبيقات على أنها محتوى غير مهم أو احتيالي.
لا تُرهِق جمهورك. بصفة عامة، ليس من الممارسة الجيدة إرسال الكثير من الإشعارات إلى الشخص نفسه خلال فترة زمنية قصيرة. باستخدام "تحليلات التطبيق"، يمكن للمطورين العثور على النقطة المثالية لإعادة تفاعل اللاعبين من خلال مقارنة النتائج باستخدام المعلمات المرجعية لتوقيتات مختلفة: ساعتان أو 6 ساعات أو يوم واحد أو 3 أيام أو أسبوع واحد أو حتى أسبوعين.
الاستهداف التلقائي. إذا كنت ترسل أكثر من 50,000 إشعار في الأسبوع وتجد صعوبة في الحفاظ على نسبة النقر إلى الظهور عند 17%، فعليك بتشغيل الاستهداف التلقائي للسماح لفيسبوك بإرسال الإشعارات تلقائيًا للأشخاص الذين من المرجح أن يتفاعلوا مع تطبيقك.