بدء استخدام أحداث التطبيق في نظام iOS

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

قبل البدء

ستحتاج إلى ما يلي:

• حساب مطوّر على فيسبوك
• حساب إعلاني على فيسبوك
• حافظة أعمال على فيسبوك (إنشاء حافظة أعمال جديدة إذا لم يكن لديك واحدة بالفعل)
• تطبيق فيسبوك

الخطوة الأولى: تكوين تطبيقك على فيسبوك

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

مرّر لأسفل الصفحة وانقر على إضافة منصة. اختر iOS وأضف التفاصيل، ثم احفظ التغييرات التي أجريتها.

قم بإعداد تطبيقك للإعلان عن طريق إضافة التفاصيل التالية:

• نطاقات التطبيق - أدخل عنوان URL لمتجر App Store الخاص بتطبيقك.
• عنوان URL لسياسة الخصوصية - احرص على توفير عنوان URL لسياسة الخصوصية. ويجب توفيره لجعل تطبيقك متوفرًا للعامة.
• عنوان URL لشروط الخدمة - احرص على توفير عنوان URL لشروط الخدمة.
• المنصة - مرّر لأسفل لوحة الإعدادات لإضافة منصة نظام iOS.

لمعرفة المزيد حول إضافة التفاصيل إلى تطبيقك مثل أيقونة أو فئة، تفضل بزيارة مستندات تطوير التطبيق.

الخطوة الثانية: ربط الإعلان وحافظات الأعمال

لتشغيل الإعلانات وقياس عمليات التثبيت في مدير الإعلانات، يجب ربط حساب إعلاني وحافظة أعمال واحدة على الأقل مع التطبيق.

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

الخطوة الثالثة: إعداد بيئة التطوير

يستخدم الإجراء التالي مدير حزمة Swift لإعداد بيئة التطوير في Xcode.

1. في Xcode، انقر على الملف > إضافة الحزم....
2. في حقل البحث الذي يظهر، أدخل عنوان URL للمستودع: https://github.com/facebook/facebook-ios-sdk.
3. في قاعدة التبعية، حدّد حتى الإصدار الرئيسي التالي وأدخل إصدارًا حديثًا. تم إدراج أحدث إصدار حالي في https://github.com/facebook/facebook-ios-sdk/releases/
4. اختر المكتبات التي تنوي استخدامها والأهداف التي تريد إضافتها إلى تلك المكتبات.
5. انقر على إضافة حزمة لإكمال الإعداد.

الخطوة الرابعة: التسجيل وتكوين تطبيقك للعمل مع فيسبوك

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

الخطوة الخامسة: تكوين مشروعك

الخطوة السادسة: ربط تفويض التطبيق وتفويض المشهد

    
// AppDelegate.swift
import UIKit
import FacebookCore

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )
    }  
}

// SceneDelegate.swift
import FacebookCore
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

الخطوة السابعة: إضافة أحداث التطبيق

تتوفر ثلاث طرق لتتبع الأحداث في تطبيقك:

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

الأحداث المسجّلة تلقائيًا

الحصول على موافقة الجهاز

بدايةً من الإصدار iOS 14.5، ستحتاج إلى تعيين isAdvertiserTrackingEnabled والتسجيل في كل مرة تمنح فيها الجهاز إذنًا لمشاركة البيانات مع فيسبوك.

إذا قدم الجهاز الموافقة، فيمكنك تعيين Settings.shared.isAdvertiserTrackingEnabled = true.

إذا لم يسمح الجهاز بالتتبع، فيمكنك تعيين Settings.shared.isAdvertiserTrackingEnabled = false.

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

<key>FacebookAdvertiserIDCollectionEnabled</key>
<false/>

تسجيل الأحداث يدويًا

لتسجيل حدث مخصص، ما عليك سوى إدخال اسم الحدث على أنه AppEvents.Name:

AppEvents.shared.logEvent(AppEvents.Name("battledAnOrc"))

معلمات الأحداث

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

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

يتم إدخال المعلمات عبر قاموس حيث يحمل المفتاح اسم المعلمة على أنه AppEvents.ParameterName، ويجب أن تكون بالقيمة String أو رقم (Int وDouble، إلخ).

الخطوة الثامنة: اختبار الأحداث

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

1. افتح مساعد إعلانات التطبيق.
2. من تحديد تطبيق، اختر تطبيقك ثم إرسال.
3. مرّر لأسفل واختر اختبار الحدث.
4. ابدأ تشغيل تطبيقك وأرسل حدثًا. من المفترض أن يظهر الحدث في الصفحة.

معرفة المزيد

• دليل أفضل الممارسات - يعرض مجموعة متنوعة من نماذج التطبيقات وكيف يعالج كل نموذج أحداث التطبيق.
• الأسئلة المتكررة - يمكنك الاطلاع على الأسئلة المتكررة.
• دورة Meta Blueprint التدريبية: تكوين مجموعة SDK وأحداث التطبيق في نظام iOS
• دورة Meta Blueprint التدريبية: استخدم أحداث التطبيق لأغراض الاستهداف والتحسين والقياس

أمثلة على التطبيقات

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