أحداث التطبيق للألعاب على فيسبوك

تم إيقاف استخدام واجهة API أحداث التطبيق في مجموعة Facebook SDK (JS) هذه ولم تعد مدعومة اعتبارًا من 1 يوليو 2022. لا توجد خطط لإضافة ميزات جديدة إلى هذا المنتج. بدلاً من استخدام FB.AppEvents.LogEvent، نوصي بإرسال هذه الأحداث عبر بيكسل Meta.

تتيح لك أحداث التطبيق قياس أداء الإعلان و بناء الجماهير لاستهداف الإعلانات في لعبتك على الفيسبوك.

ويتم إجراء ذلك عن طريق إرسال حدث من تطبيقك عبر مجموعة Facebook SDK للغة JavaScript. يمكن أن يكون هذا الحدث واحدًا من الأحداث المحددة مسبقًا مثل "إضافة إلى عربة التسوق" في تطبيق تجاري أو "المستوى الذي تم تحقيقه" في لعبة، أو أحداث مخصصة أخرى.

المتطلبات الأساسية

قبل تضمين الرمز لقياس الأحداث، ستحتاج إلى تسجيل تطبيقك على فيسبوك. إذا لم تقم بتسجيل تطبيقك على فيسبوك،ف يمكنك القيام بذلك هنا: البدء السريع للألعاب على فيسبوك.

التنفيذ

يجب أن تتضمن لعبتك على فيسبوك بالفعل مجموعة Facebook SDK للغة JavaScript. إذا لم تكن كذلك، فاقرأ دليل البدء السريع للغة JavaScript.

يمكنك عرض الأحداث المسجلة باستخدام مدير أحداث فيسبوك.

التسجيل التلقائي للأحداث

نقوم تلقائيًا بتسجيل الأحداث التالية من أجل الألعاب على الفيسبوك:

تثبيت التطبيق: المرة الأولى التي يقبل فيها شخص ما شروط الخدمة في تطبيقك.
بدء تشغيل التطبيق: أي وقت يفتح خلاله الشخص صفحة الويب التي تحتوي على تطبيقك.

إذا قمت بتمكين عمليات الدفع من خلال فيسبوك، فسيتم تسجيل الأحداث الإضافية التالية:

بدء إتمام الشراء: يبدأ الشخص عملية الدفع لإجراء عملية شراء.
تم الشراء: قام شخص بإكمال عملية الدفع بنجاح في تطبيقك.
إلغاء الشراء: قام شخص بإلغاء عملية الدفع (بما في ذلك كل عمليات الدفع الملغاة يدويًا وعندما تفشل طريقة الدفع).

ملاحظة: قد لا يتم تسجيل حدث "إلغاء الشراء" إذا قام الشخص بإغلاق نافذة المتصفح في منتصف عملية الشراء. ولهذا السبب قد لا تساوي أحداث "إلغاء الشراء" الفرق بين أحداث "بدء إتمام الشراء" وأحداث "عمليات الشراء".

يمكنك عرض الأحداث المسجلة باستخدام مدير أحداث فيسبوك.

تسجيل الأحداث من خلال المعلمات

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

فيما يلي مثال على كيفية تسجيل حدث مع معلمة تصف هذا الحدث:

var params = {};
params[FB.AppEvents.ParameterNames.LEVEL] = '12'; //player level
FB.AppEvents.logEvent(
  FB.AppEvents.EventNames.ACHIEVED_LEVEL,
  null,  // numeric value for this event - in this case, none
  params
);

نوصي باستخدام واحد من الأحداث المحددة مسبقًا. ومع ذلك، ندعم أيضًا تسجيل الأحداث المخصصة.

أقصى عدد لأسماء الأحداث المختلفة هو 1,000. ملاحظة: لن يتم تسجيل أنواع الأحداث الجديدة بمجرد الوصول إلى هذا الحد، وإذا تجاوزت هذا الحد، فقد يظهر لك الخطأ 100 Invalid parameter عند التسجيل. يمكنك الاطلاع على المزيد حول تقييدات الأحداث في الأسئلة المتكررة.

تسجيل عمليات الشراء

تتضمن مجموعة Facebook SDK وظيفة مخصصة لتسجيل عمليات الشراء، مما يتطلب تحديد عملة ما.

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

var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = 'QW-12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

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

var params = {};
params[FB.AppEvents.ParameterNames.CONTENT_ID] = '12345';
FB.AppEvents.logPurchase(98.76, 'USD', params);

أحداث التطبيق المخصصة

يمكنك أيضًا اختيار إنشاء أحداثك المخصصة عن طريق تحديد اسم الحدث كسلسلة:

FB.AppEvents.logEvent('battledAnOrc');

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

استثناءات التسجيل

إذا قمت باستدعاء وظيفة SDK JavaScript المتوفرة من خلال معلمات غير صحيحة، فسترجع الوظيفة استثناءً. تأكد من أن الرمز لديك يُدخل المعلمات الصحيحة، ويسجل أي استثناءات في حالة حدوثها.

تصحيح الأخطاء

لتحسين الأداء، يتم تحميل مجموعة JavaScript SDK بشكل مصغر. يمكنك أيضًا تحميل إصدار تصحيح أخطاء لمجموعة SDK للغة JavaScript يتضمن المزيد من عمليات التسجيل والتحقق من الوسيطات بشكل أكثر دقة بالإضافة إلى كونه غير مختصر. لإجراء ذلك، قم بتغيير القيمة js.src في رمز التحميل لديك لتصبح هكذا:

js.src = "https://connect.facebook.net/en_US/sdk/debug.js";