أحداث التطبيق بدون رمز برمجي

أحداث التطبيق بدون رمز هي ميزة متوفرة في الإصدار 4.34 وتمكّنك من استخدام مدير الأحداث لإضافة أحداث التطبيق أو حذفها دون تنفيذ رمز أو طرح إصدار جديد لتطبيقك.

Android

المتطلبات

يجب أن يتوفر لديك أحد المتطلبات التالية:

• مجموعة Facebook SDK لنظام Android - الإصدار الكامل 4.34 أو الإصدارات الأحدث
• مجموعة Facebook SDK لنظام Android - الإصدار الأساسي 4.38 أو الإصدارات الأحدث
• مجموعة Facebook SDK لنظام Android - الإصدار الأساسي 4.34 - 4.37 ومجموعة التسويق

يُرجى الاطلاع على كل من دليل بدء استخدام أحداث التطبيق لنظام Android لتثبيت أحدث إصدار من مجموعة Facebook SDK لنظام Android، ودليل الترقية للترقية إلى أحدث إصدار من مجموعة SDK، أو إذا قمت بتثبيت الإصدارات من 4.34 حتى 4.37، فقم بإضافة مجموعة التسويق عن طريق فتح <your_app> | Gradle Scripts | build.gradle (Module: app) وإضافة ما يلي إلى القسم dependencies{}.

implementation 'com.facebook.android:facebook-marketing:[4,5)' 

لا تنسَ إعادة تصميم مشروعك.

تنفيذ ميزة أحداث التطبيق بدون رمز

لتشغيل حدث تصحيح الأخطاء بدون رمز، أضف السطور التالية في AndroidManifest.xml:

<meta-data
    android:name="com.facebook.sdk.CodelessDebugLogEnabled"
    android:value="true" />

إضافة أحداث التطبيق

انتقل إلى مدير الأحداث لإضافة أحداث التطبيق التي تريد تتبعها بدون رمز.

1. في مدير الأحداث، انقر على إضافة مصدر بيانات جديد وحدّد أحداث التطبيق في القائمة المنسدلة.
2. انقر على استخدام أداة إعداد الأحداث بدون رمز، ثم حدّد التطبيق الذي تريد إضافة الأحداث إليه.
3. اختر المنصة بالنقر على بدء الإعداد.
4. إذا كانت هذه هي المرة الأولى التي تزور فيها التدفق بدون رمز، فسيظهر لك عرضًا توضيحيًا موجزًا. وبعد انتهاء العرض التوضيحي، افتح جلسة جديدة لتطبيقك على جهازك المحمول.
5. قم بهز هاتفك حتى يظهر إصدار تطبيقك.
6. انقر على أي عنصر لإضافة حدث تطبيق. انتقل إلى صفحات مختلفة من تطبيقك لتحديد العناصر داخل التطبيق.
7. انقر على حفظ في القائمة المنبثقة أو إلغاء لعدم إضافة الحدث.
8. بعد إضافة كل الأحداث، انقر على معاينة وإنهاء.
9. انقر على اختبار الأحداث أو حفظ وخروج.

ملاحظة: قد يستغرق الأمر 30 دقيقة حتى تظهر الأحداث في مدير الأحداث.

التحقق من الدمج

انتقل إلى مساعد إعلانات التطبيق.

• حدد تطبيقًا، ثم انقر على إرسال.
• مرر لأسفل إلى القسم أدوات المطوّر وانقر على اختبار أحداث التطبيق.
• إذا كان تطبيقك يرسل أحداث fb_codeless_debug، فسيتم إدراج أحداث الاختبار التي حددتها في الجدول.

ملاحظة: لا يمكن تشغيله إلا مع مجموعة Facebook SDK بالإصدار 4.35 والإصدارات الأحدث.

iOS

المتطلبات

• مجموعة Facebook SDK لنظام iOS الكاملة الإصدار 4.34 إلى الإصدار 7.1.1
• مجموعة Facebook SDK لنظام iOS الأساسية الإصدار 4.38 إلى الإصدار 7.1.1
• مجموعة Facebook SDK لنظام iOS الأساسية الإصدار 4.34 - 4.37 إلى الإصدار 7.1.1 ومجموعة التسويق

التقييدات

• هذه الميزة غير متوفرة للإصدار 8.0.0 أو الإصدارات الأحدث. معرفة المزيد.

يُرجى الاطلاع على كل من دليل بدء استخدام أحداث التطبيق لنظام iOS لتثبيت أحدث إصدار من مجموعة SDK لنظام التشغيل iOS، ودليل الترقية للترقية إلى أحدث إصدار من مجموعة SDK، أو إذا قمت بتثبيت الإصدار 4.34 - 4.37 من مجموعة SDK الأساسية، فقم بإضافة مجموعة التسويق عن طريق إضافة ما يلي إلى Podfile.

pod 'FBSDKMarketingKit' 

لا تنسَ تشغيل pod update ثم pod install --repo-update.

تنفيذ ميزة أحداث التطبيق بدون رمز

قم بتشغيل تسجيل حدث تصحيح الأخطاء بدون رمز من خلال فتح .plist الخاص بالتطبيق كرمز في Xcode، وإضافة XML التالي إلى قاموس الخواص:

<key>FacebookCodelessDebugLogEnabled</key>
<true/>

إضافة أحداث التطبيق

انتقل إلى مدير الأحداث لإضافة أحداث التطبيق التي تريد تتبعها بدون رمز.

1. في مدير الأحداث، انقر على إضافة مصدر بيانات وحدّد أحداث التطبيق في القائمة المنسدلة.
2. انقر على استخدام أداة إعداد الأحداث بدون رمز، ثم حدّد التطبيق الذي تريد إضافة الأحداث إليه.
3. اختر المنصة بالنقر على بدء الإعداد.
4. إذا كانت هذه هي المرة الأولى التي تزور فيها التدفق بدون رمز، فسيظهر لك عرضًا توضيحيًا موجزًا. وبعد انتهاء العرض التوضيحي، افتح جلسة جديدة لتطبيقك على جهازك المحمول.
5. قم بهز هاتفك حتى يظهر إصدار تطبيقك.
6. انقر على أي عنصر لإضافة حدث تطبيق. انتقل إلى صفحات مختلفة من تطبيقك لتحديد العناصر داخل التطبيق.
7. انقر على حفظ في القائمة المنبثقة أو إلغاء لعدم إضافة الحدث.
8. بعد إضافة كل الأحداث، انقر على معاينة وإنهاء.
9. انقر على اختبار الأحداث أو حفظ وخروج.

ملاحظة: قد يستغرق الأمر 30 دقيقة حتى تظهر الأحداث في مدير الأحداث.

التحقق من الدمج

انتقل إلى مساعد إعلانات التطبيق.

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

منصة Unity

نتطلب الإصدار 4.34 من مجموعة Facebook Unity SDK أو الإصدارات الأحدث.

راجع بدء استخدام مجموعة Facebook Unity SDK لتثبيت أحدث إصدار من مجموعة Facebook Unity SDK، واتبع الإعدادات الخاصة بالمنصة في Unity iOS أو Unity Android.

تمكين أحداث التطبيق بدون رمز

لتشغيل هذا الخيار، في Unity Editor حدّد Facebook | Edit Settings ثم حدّد Auto Logging App Events:

إضافة أحداث التطبيق

يمكنك في هذه المرحلة إضافة أحداث التطبيق باستخدام مدير الأحداث:

1. ضمن Add Data Source، حدّد App Events.

2. انقر على User our codeless event setup tool

3. وحدّد التطبيق الذي تريد إضافة الأحداث إليه.

4. انقر على Start Setup لتحديد المنصة. إذا كانت هذه هي المرة الأولى التي تزور فيها الدفق بدون رمز، فسيظهر لك عرضًا توضيحيًا موجزًا.

5. وبعد انتهاء العرض التوضيحي، افتح جلسة جديدة لتطبيقك على جهازك المحمول.

6. قم بهز الجهاز المحمول حتى يظهر إصدار تطبيقك.

7. انقر على أي عنصر في تطبيقك لإضافة حدث تطبيق. انتقل إلى صفحات مختلفة من تطبيقك لتحديد العناصر داخل التطبيق.

8. في Unity Editor، انقر على Save لإضافة الحدث.

9. بعد إضافة كل الأحداث انقر على Review and Finish.

10. انقر على Test Events أو Save and Exit.

قد يستغرق الأمر 30 دقيقة حتى تظهر الأحداث في مدير الأحداث. كرّر هذه الخطوات لكل منصة تدعمها لعبتك، مثل iOS أو Android.

التحقق من الدمج

انتقل إلى مساعد إعلانات التطبيق.

• ضمن Select an App، انقر على Submit.

• اختر App Events Tester.

• إذا كان تطبيقك يرسل أحداث fb_codeless_debug، فستظهر في الجدول.

الأسئلة المتكررة

عام

Android

Android SDK build Error:Execution failed for task ':app:processDebugManifest'.> Manifest merger failed : 
Attribute activity#com.facebook.FacebookActivity@theme value=(@android:style/Theme.Translucent.NoTitleBar) 
from AndroidManifest.xml:69:13-72is also present at [com.facebook.android:facebook-android-sdk:4.16.0] 
AndroidManifest.xml:32:13-63 value=(@style/com_facebook_activity_theme).Suggestion: add
'tools:replace="android:theme"' to <activity> element at AndroidManifest.xml:66:9-70:47 to override.

<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>

<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

[!] Unable to find a specification for FBSDKMarketingKit