بدء استخدام أحداث التطبيق في نظام 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. انقر على إضافة حزمة لإكمال الإعداد.

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

1. في لوحة معلومات التطبيق ضمن إعدادات التطبيق > الأساسية مرّر لأسفل وانقر على + إضافة منصة.
2. مرّر لأسفل إلى البطاقة iOS وأضف معرف الحزمة. ابحث عن معرف الحزمة في هدف تطبيق iOS لمشروع Xcode. يمكنك تحديث معرف الحزمة الخاص بك في أي وقت.

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

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

  
// AppDelegate.swift
import UIKit
import FBSDKCoreKit

@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 FBSDKCoreKit
  ...
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.
• أداة أحداث التطبيق بدون رمز برمجي - استخدم هذه الأداة لإضافة الأحداث القياسية دون الحاجة إلى إضافة رمز برمجي إلى تطبيقك.
• الأحداث المسجّلة يدويًا - أضف رمزًا برمجيًا إلى تطبيقك لتتبع الأحداث القياسية والمخصصة.

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

الأحداث التي يتم تسجيلها تلقائيًا عند الشراء داخل التطبيق

توفر Apple أربعة أنواع مختلفة من عمليات الشراء داخل التطبيق: العناصر الاستهلاكية، والعناصر غير الاستهلاكية، والاشتراك القابل للتجديد تلقائيًا، والاشتراك غير المتجدد. إذا قمت بتنفيذ عمليات الشراء داخل التطبيق من خلالStoreKit 1، فسنقوم تلقائيًا بتسجيل كل أنواع عمليات الشراء داخل التطبيق هذه. إذا قمت بتنفيذ عمليات الشراء داخل التطبيق من خلال مع StoreKit 2، فسنقوم تلقائيًا بتسجيل العناصر غير القابلة للاستهلاك والاشتراكات القابلة للتجديد تلقائيًا والاشتراكات غير المتجددة. إذا كنت ترغب في تسجيل العناصر الاستهلاكية تلقائيًا أيضًا، فستحتاج إلى إضافة مفتاح SKIncludeConsumableInAppPurchaseHistory إلى Info.plist:

<key>SKIncludeConsumableInAppPurchaseHistory</key>

<true/>

في StoreKit 1، سنقوم تلقائيًا بتسجيل الحدث عندما يقوم المستخدم بشراء منتج بنجاح أو استعادة منتج ما أو محاولة شراء منتج ولكن عملية الشراء تفشل. في Store Kit 2، سنقوم تلقائيًا بتسجيل الحدث عندما يقوم المستخدم بشراء منتج بنجاح أو استعادة منتج ما. إذا كنت ترغب في تسجيل الحدث أيضًا عند فشل عملية شراء في Store Kit 2، فقد قمنا بتوفيرAPI يدوية يجب استدعاؤها. يمكنك استدعاء API هذه في دفق الشراء الخاص بـ StoreKit 2 بالطريقة التالية:

do {
   let result = try await product.purchase()
   switch result {
   case .success(let verificationResult):
       // Handle success case
   case .pending:
       // Handle pending case
   default:
       AppEvents.shared.logFailedStoreKit2Purchase(product.id)
   }
} catch {
   AppEvents.shared.logFailedStoreKit2Purchase(product.id)
}

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

بدايةً من الإصدار 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"))

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

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

إذا كنت ترغب في استخدام أحداث التطبيق لقياس تحويلات الإعلانات الديناميكية، يُرجى تعيين المعلمة fb_content_id لتكون قيمة معرف المنتج المستخدم في الإعلان الديناميكي المرتبط.

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

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

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

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

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

تعرَّف على المزيد

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

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

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