التوافق مع نظام التشغيل iOS 14

في نظام iOS 14.5، تطلب Apple من المطوّرين الحصول على إذن المستخدم. من خلال إطار عمل "شفافية تتبّع التطبيقات" لتتبّعها أو الوصول إلى المعرِّف الإعلاني للجهاز (IDFA). عرض خصوصية المستخدم واستخدام البيانات في Apple أو شفافية تتبُّع التطبيقات من Apple للحصول على المزيد من التفاصيل.

منتجات Firebase المتأثّرة

ولا يمكن لحِزم تطوير البرامج (SDK) لمنصة Firebase الوصول إلى معرّف المعلِنين (IDFA)، على الرغم من أنّ بعضها يتضمّن عمليات دمج مع Google Analytics التي قد تتضمّن الوصول إلى معرّف المعلِنين (IDFA).

يسرد الجدول أدناه منتجات Firebase المتوفّرة على أنظمة Apple الأساسية. وتشرح كيفية تأثُّر وظائف كلّ منتج إذا لم يتمّ تحديد معرّف المعلِنين (IDFA) إليه على الفور.

عمليات دمج Firebase المتأثّرة

يسرد الجدول أدناه المنتجات المتكاملة في Firebase التي ستتأثّر في حال كان معرّف المعلِنين (IDFA) لا يمكن الوصول إليه.

طلب إذن تتبُّع التطبيقات على نظام التشغيل iOS 14

إذا أردت أن يتمكّن تطبيق Apple من الوصول إلى معرّف المعلِنين (IDFA)، يمكنك إضافة إطار عمل "شفافية تتبُّع التطبيقات" من Apple على تطبيقك وطلب الإذن لتتبُّع أنشطة المستخدمين معرّف المعلِنين (IDFA).

تختار العديد من التطبيقات تقديم شاشة إحماء أو شرح قبل يطلب الإذن. تتيح لك الشاشة التوضيحية منح المستخدمين المزيد من المعلومات سياق حول كيفية استخدام تطبيقك لمعرّف المعلِنين (IDFA) قبل طلب الوصول.

إذا كنت أحد ناشري التطبيقات في "AdMob" أو "مدير الإعلانات"، يمكنك استخدام خيارات التمويل, الذي يعالج الحصول على الموافقة لعرض الإعلانات المخصّصة أيضًا كموافقة على تتبُّع المستخدم تلقائيًا وفقًا لإرشادات Apple. يمكنك الاطّلاع على AdMob الموافقة على صفحة "رسائل المستخدم" لمزيد من التفاصيل.

يقدم الدليل التالي حلاً باستخدام Firebase In-App Messaging لإنشاء عرض شاشة توضيحية قبل طلب الوصول إلى التتبع عبر شفافية تتبُّع التطبيقات

إضافة "In-App Messaging" إلى تطبيقك

اتّبِع التعليمات إضافة In-App Messaging إلى تطبيق Apple

التعامل مع إغلاق الرسائل داخل التطبيق

أولاً، تجنَّب عرض الشاشة التوضيحية على الأجهزة التي لا يمكنها تقديم مربّع إفادة الموافقة، مثل الأجهزة التي تعمل بالإصدار 13 من iOS تأكَّد من تنفيذ هذه التعليمة البرمجية. بعد FirebaseApp.configure() مباشرةً.

if NSClassFromString("ATTrackingManager") == nil {
  // Avoid showing the App Tracking Transparency explainer if the
  // framework is not linked.
  InAppMessaging.inAppMessaging().messageDisplaySuppressed = true
}

نفِّذ InAppMessagingDisplayDelegate للتعامل مع الأحداث عندما يغلق المستخدم الشاشة التوضيحية. إذا كانت ينقر المستخدم على "حسنًا"، ويتم عرض طلب من النظام من خلال ميزة "شفافية تتبُّع التطبيقات". إطار العمل.

// The InAppMessaging delegate must be assigned before events can be handled.
InAppMessaging.inAppMessaging().delegate = self

func messageClicked(_ inAppMessage: InAppMessagingDisplayMessage,
                    with action: InAppMessagingAction) {
  switch action.actionText {
  case "OK":
    ATTrackingManager.requestTrackingAuthorization { status in
      switch status {
      case .authorized:
        // Optionally, log an event when the user accepts.
        Analytics.logEvent("tracking_authorized", parameters: nil)
      case _:
        // Optionally, log an event here with the rejected value.
      }
    }
  case _:
    // do nothing
  }
}

إنشاء حملة In-App Messaging

بعد وضع الرمز في تطبيقك، يمكنك إنشاء رسالة داخل التطبيق في وحدة تحكّم "Firebase"

1. في وحدة تحكُّم Firebase، إنشاء حملة In-App Messaging جديدة
2. عليك تعبئة الرسائل داخل التطبيق بالمحتوى المطلوب وضبط الرسالة. سيتم تشغيله في حدث app_launch
3. في قسم الاستهداف، تأكد من أن الحملة لا تستهدف سوى أكبر عدد ممكن أحدث إصدار من تطبيقك أو الإصدارات الأحدث.

يمكنك تخصيص مظهر الشاشة التوضيحية من خلال اتّباع التعليمات الواردة في مستندات In-App Messaging

اختياري: اختبار A/B للشاشات التوضيحية المختلفة

تقدّم شركة In-App Messaging عملية تكامل مضمَّنة مع Firebase A/B Testing، التي يمكنك استخدامها لإجراء التجارب باستخدام شاشات توضيحية مختلفة.

ينشئ Firebase A/B Testing مجموعات تجربة تلقائيًا ويساعدك على ذلك تصور كيفية تفاعل المستخدمين مع المتغيرات المختلفة لتطبيقك.

تسجيل أذونات تتبع التطبيقات

في حال عدم تسجيل حدث Google Analytics عند معالجة تتبُّع التطبيق من أجل قياس التغييرات في معدل الاستجابة عند إجراء تجربة A/B.

ATTrackingManager.requestTrackingAuthorization { status in
  switch status {
  case .authorized:
    // Optionally, log an event when the user accepts.
    Analytics.logEvent("tracking_authorized", parameters: nil)
  case _:
    // Optionally, log an event here with the rejected value.
  }
}

إنشاء حدث إحالة ناجحة جديد

في جلسة المعمل، قسم Analytics من وحدة تحكُّم Firebase، انتقِل إلى قائمة الإحالات الناجحة، ثم أضِف عمودًا جديدًا حدث إحالة ناجحة بالاسم نفسه كحدث مسجَّل باستخدام نموذج الرمز أعلاه.

إنشاء تجربة جديدة

في وحدة التحكم قائمة In-App Messaging، انقر على تجربة جديدة، ثم اتّبع التعليمات في علامة الشاشات.

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

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

اطّلِع على مستندات Firebase A/B Testing للحصول على معلومات حول كيفية مراقبة تجربة ما وطرح المتغير.