پشتیبانی از iOS 14

با iOS 14.5، اپل از توسعه‌دهندگان می‌خواهد که مجوز کاربر را از طریق چارچوب شفاف ردیابی برنامه برای ردیابی یا دسترسی به شناسه تبلیغاتی دستگاهشان (IDFA) دریافت کنند. برای جزئیات بیشتر به اسناد حریم خصوصی کاربر و استفاده از داده‌های اپل و مستندات شفافیت پیگیری برنامه اپل مراجعه کنید.

محصولات Firebase تحت تأثیر قرار گرفته است

Firebase SDK به IDFA دسترسی ندارد، اگرچه برخی از آنها با Google Analytics یکپارچه شده اند که ممکن است شامل دسترسی IDFA باشد.

جدول زیر محصولات Firebase را که در پلتفرم‌های اپل در دسترس هستند فهرست می‌کند و توضیح می‌دهد که اگر IDFA در دسترس نباشد، چگونه بر عملکرد هر محصول تأثیر می‌گذارد.

ادغام های Firebase تحت تأثیر قرار گرفته است

جدول زیر محصولات ادغام شده با Firebase را فهرست می کند که در صورت عدم دسترسی IDFA تحت تأثیر قرار می گیرند.

درخواست مجوز ردیابی برنامه در iOS 14

اگر می‌خواهید برنامه اپل شما بتواند به IDFA دسترسی داشته باشد، می‌توانید چارچوب شفافیت پیگیری اپلیکیشن اپل را به برنامه خود اضافه کنید و درخواست مجوز برای ردیابی یا دسترسی به IDFA کاربران خود کنید.

بسیاری از برنامه‌ها ترجیح می‌دهند قبل از درخواست اجازه، یک صفحه گرم‌آپ یا توضیح‌دهنده ارائه دهند. صفحه توضیح دهنده به شما این امکان را می دهد که قبل از درخواست دسترسی، زمینه بیشتری را در مورد نحوه استفاده برنامه شما از IDFA به کاربران ارائه دهید.

اگر یک ناشر برنامه AdMob یا Ad Manager هستید، از Funding Choices استفاده کنید، که به کسب رضایت برای ارائه تبلیغات شخصی‌شده و همچنین رضایت برای ردیابی کاربر طبق دستورالعمل‌های اپل به صورت خودکار رسیدگی می‌کند. برای جزئیات بیشتر به صفحه AdMob Consent with User Messaging مراجعه کنید.

راهنمای زیر راه حلی با استفاده از Firebase In-App Messaging برای ایجاد و نمایش یک صفحه توضیح دهنده قبل از درخواست دسترسی ردیابی از طریق App Tracking Transparency ارائه می دهد.

In-App Messaging به برنامه خود اضافه کنید

دستورالعمل‌ها را دنبال کنید تا In-App Messaging به برنامه Apple خود اضافه کنید .

رسیدگی به رد پیام درون برنامه ای

اول، از نمایش صفحه توضیح دهنده در دستگاه هایی که نمی توانند گفتگوی رضایت را ارائه دهند، مانند دستگاه هایی که iOS 13 دارند، خودداری کنید. مطمئن شوید که این کد بلافاصله پس از FirebaseApp.configure() اجرا می شود.

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

پروتکل InAppMessagingDisplayDelegate را برای مدیریت رویدادهایی که کاربر صفحه توضیح دهنده را رد می کند، پیاده سازی کنید. اگر کاربر روی OK ضربه بزند، درخواست سیستم را از طریق چارچوب شفافیت پیگیری برنامه نمایش دهید.

// 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. در بخش Targeting ، مطمئن شوید که کمپین فقط آخرین نسخه برنامه شما و بالاتر را هدف قرار می دهد.

می‌توانید با دنبال کردن دستورالعمل‌های موجود در اسناد 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 ، به منوی Conversions بروید، سپس یک رویداد تبدیل جدید با همان نام رویداد ثبت شده با کد نمونه بالا اضافه کنید.

یک آزمایش جدید ایجاد کنید

در منوی In-App Messaging کنسول، روی «آزمایش جدید» کلیک کنید، سپس دستورالعمل‌های صفحه‌های به‌دست‌آمده را دنبال کنید.

• در بخش Targeting ، مطمئن شوید که کمپین فقط آخرین نسخه برنامه شما و بالاتر را هدف قرار می دهد.
• در بخش اهداف ، رویداد تبدیلی را که با کد نمونه بالا ایجاد کرده‌اید و همچنین سایر معیارهایی که می‌خواهید ردیابی کنید، انتخاب کنید.

هنگامی که آزمایش خود را منتشر کردید، قبل از اینکه بتواند نتایج قطعی به دست آورد، باید برای مدتی داده ها را جمع آوری کند.

اسناد Firebase A/B Testing را برای اطلاعات در مورد نحوه نظارت بر آزمایش و ارائه یک نوع موفق بخوانید.