اکنون که یک سیستم احراز هویت برای جمع‌آوری ایمیل‌ها یا شماره تلفن کاربران پیاده‌سازی کرده‌اید، می‌توانید ادغام Google Analytics برای Firebase SDK را آغاز کنید.
Google Analytics برای Firebase SDK را ادغام کنید
با آخرین نسخه Google Analytics برای Firebase SDK یکپارچه شوید.
از کوکوپود استفاده کنید
اگر برنامه شما از Cocoapods استفاده می کند، مطمئن شوید که فایل Podfile پروژه شما حاوی یکی از این موارد است:
pod 'FirebaseAnalytics` # includes GoogleAdsOnDeviceConversion
یا
pod 'FirebaseAnalytics/Core'
pod 'GoogleAdsOnDeviceConversion'
سپس دستورات pod repo update و pod install را اجرا کنید.
از Swift Package Manager استفاده کنید
اگر برنامه شما از Swift Package Manager استفاده می‌کند، مراحل Swift Package Manager را برای Firebase دنبال کنید. وقتی به مرحله «انتخاب کتابخانه‌های Firebase که می‌خواهید در برنامه‌تان اضافه شوند» رسیدید، قبل از ادامه مراحل بعدی، FirebaseAnalytics بررسی کنید. یا FirebaseAnalytics/CoreوGoogleAdsOnDeviceConversion را بررسی کنید.
ادغام جایگزین
اگر برنامه شما از Cocoapods یا Swift Package Manager استفاده نمی کند، به صورت زیر ادغام کنید:
دستورالعمل های README را از فایل فشرده عمومی دنبال کنید تا چارچوب ها را مستقیماً به پروژه اضافه کنید. مطمئن شوید که چارچوب ها را از دایرکتوری FirebaseAnalytics اضافه کنید.
در Xcode، پرچم‌های -ObjC و -lc++ را به «تنظیمات دیگر لینک‌گر» در تنظیمات ساخت هدف برنامه‌تان اضافه کنید.
وحدت
FirebaseUnity SDK (به طور خاص، FirebaseAnalytics.unitypackage ) را به پروژه Unity خود اضافه کنید. دستورالعمل‌های دقیق‌تر را می‌توانید در Add Firebase Unity SDKs پیدا کنید.
پلتفرم iOS را در File > Build Settings انتخاب کنید، سپس روی Build and Run کلیک کنید.
در پوشه بیلد ایجاد شده، Podfile را بیابید و موارد زیر را اضافه کنید:
pod 'GoogleAdsOnDeviceConversion'
فعال کردن حالت اشکال زدایی (اختیاری)
حالت اشکال زدایی را با افزودن -FIRDebugEnabled در زیر "Arguments Passed on Launch" در ویرایشگر طرح Xcode فعال کنید. پس از راه اندازی برنامه در Xcode، مطمئن شوید که پیامی مانند زیر در کنسول اشکال زدایی Xcode ظاهر می شود:
[Firebase/Analytics][I-ACS023007] Analytics v.x.x.x started
...
[Firebase/Analytics][I-ACS023009] Debug logging enabled
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Step 2: Integrate Google Analytics\n\n\u003cbr /\u003e\n\n|----------------------------------------------------------------------------------------------------------------------------------|\n| Introduction: [Measure iOS Ads conversions](/docs/tutorials/ads-ios-on-device-measurement/index-first-party) |\n| Step 1: [Implement a sign-in experience](/docs/tutorials/ads-ios-on-device-measurement/step-1) \u003cbr /\u003e |\n| **Step 2: Integrate Google Analytics** \u003cbr /\u003e |\n| Step 3: [Initiate on-device conversion measurement using Google Analytics](/docs/tutorials/ads-ios-on-device-measurement/step-3) |\n| Step 4: [Troubleshoot and handle common issues](/docs/tutorials/ads-ios-on-device-measurement/step-4) |\n\n\u003cbr /\u003e\n\nNow that you've implemented an authentication system to collect users' emails\nor phone numbers, you can begin integrating the Google Analytics for\nFirebase SDK.\n\nIntegrate the Google Analytics for Firebase SDK\n\nIntegrate with the latest Google Analytics for Firebase SDK version.\n| **Note:** `GoogleAdsOnDeviceConversion` is not subject to [Apple's privacy manifest requirements](https://developer.apple.com/news/?id=3d8a9yyh) and does not include a privacy manifest. No additional action is required to enable on-device conversion measurement.\n\nUse Cocoapods\n\nIf your app uses Cocoapods, ensure your project's Podfile contains either: \n\n pod 'FirebaseAnalytics` # includes GoogleAdsOnDeviceConversion\n\nor \n\n pod 'FirebaseAnalytics/Core'\n pod 'GoogleAdsOnDeviceConversion'\n\nThen, run the commands `pod repo update` and `pod install`.\n\nUse Swift Package Manager\n\nIf your app uses Swift Package Manager, follow the steps at\n[Swift Package Manager for Firebase](/docs/ios/installation-methods#swift-package-manager).\nWhen you reach the step \"Choose the Firebase libraries that you want include in\nyour app\", check `FirebaseAnalytics` before continuing to the next steps.\nAlternatively, check `FirebaseAnalytics/Core` *and*\n`GoogleAdsOnDeviceConversion`.\n\nAlternative integration\n\nIf your app does not use Cocoapods or Swift Package Manager, integrate as\nfollows:\n\n1. Download the public zip file of Firebase from the [firebase-ios-sdk GitHub repo](https://github.com/firebase/firebase-ios-sdk/releases).\n2. Follow the README instructions from the public zip file to add the frameworks to the project directly. Be sure to add the frameworks from the `FirebaseAnalytics` directory.\n3. In Xcode, add the `-ObjC` and `-lc++` flags to \"Other Linker Settings\" in your app target's build settings.\n\nUnity\n\n1. Add the [Firebase Unity SDK](/download/unity)\n (specifically, `FirebaseAnalytics.unitypackage`) to your Unity project. More detailed instructions can be found in [Add Firebase Unity SDKs](https://firebase.google.com/docs/unity/setup#add-sdks).\n\n2. Select the platform iOS at **File** \\\u003e **Build Settings** , then click\n **Build and Run**.\n\n3. In the generated build folder, locate the Podfile and add the following:\n\n pod 'GoogleAdsOnDeviceConversion'\n\nEnable debug mode (optional)\n\nEnable debug mode by adding `-FIRDebugEnabled` under \"Arguments Passed on Launch\"\nin Xcode's scheme editor. Upon launching the app in Xcode, ensure that a\nmessage like the following appears in the Xcode debug console: \n\n [Firebase/Analytics][I-ACS023007] Analytics v.x.x.x started\n ...\n [Firebase/Analytics][I-ACS023009] Debug logging enabled\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\n\u003cbr /\u003e\n\n[arrow_back_ios**Step 1**: Implement a sign-in experience](/docs/tutorials/ads-ios-on-device-measurement/step-1)\n[**Step 3** : Initiate measurements using Google Analyticsarrow_forward_ios](/docs/tutorials/ads-ios-on-device-measurement/step-3)\n\n\u003cbr /\u003e\n\n*** ** * ** ***"]]
