اکنون که حساب تبلیغات خود را مرتبط کرده اید، می توانید ادغام Google Analytics برای Firebase SDK را آغاز کنید.
Google Analytics برای Firebase SDK را ادغام کنید
با آخرین نسخه Google Analytics برای Firebase SDK یکپارچه شوید.
از کوکوپود استفاده کنید
اگر برنامه شما از Cocoapods استفاده می‌کند، بررسی کنید که Podfile پروژه‌تان حاوی غلاف GoogleAppAdsOnDeviceConversion است، از طریق غلاف اصلی FirebaseAnalytics یا با گنجاندن صریح آن به‌عنوان یک غلاف مستقل:
pod'FirebaseAnalytics'# includes 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++ را به سایر تنظیمات لینکر در تنظیمات ساخت هدف برنامه خود اضافه کنید.
فعال کردن حالت اشکال زدایی (اختیاری)
حالت اشکال زدایی را با افزودن -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
...
[FirebaseAnalytics][I-ACS023278] Conversion service GoogleAdsOnDeviceConversion framework is linked
حدود 15 ثانیه صبر کنید و بررسی کنید که پیام _psmvalue_gads در کنسول اشکال زدایی Xcode ظاهر شود:
[FirebaseAnalytics][I-ACS023087] User property set. Name, value: _psmvalue_gads, XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 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-event-data/index-event-driven) |\n| Step 1: [Link Your Ads Account with Google Analytics](/docs/tutorials/ads-ios-on-device-measurement-event-data/step-1) |\n| **Step 2: Integrate Google Analytics** \u003cbr /\u003e |\n| Step 3: [Troubleshoot and handle common issues](/docs/tutorials/ads-ios-on-device-measurement-event-data/step-3) |\n\n\u003cbr /\u003e\n\nNow that you've linked your Ads account, you can begin integrating the\nGoogle Analytics for Firebase 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\n| requirements](//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, verify your project's Podfile contains the\n`GoogleAppAdsOnDeviceConversion` pod, through either the main\n`FirebaseAnalytics` pod or by including it explicitly as a standalone pod: \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\nEnable debug mode (optional)\n\nEnable debug mode by adding `-FIRDebugEnabled` under\n**Arguments Passed on Launch** in Xcode's scheme editor.\n\nUpon launching the app in Xcode, verify that a message like the following\nappears 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 [FirebaseAnalytics][I-ACS023278] Conversion service GoogleAdsOnDeviceConversion framework is linked\n\nWait around 15 seconds and verify that the `_psmvalue_gads` message appears in\nthe Xcode debug console: \n\n [FirebaseAnalytics][I-ACS023087] User property set. Name, value: _psmvalue_gads, XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\n\n| **Note:** This message won't appear for users/devices located in the European Economic Area (EEA), the United Kingdom, and Switzerland.\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\n\u003cbr /\u003e\n\n[arrow_back_ios**Step 1** Link Your Ads Account with Google Analytics](/docs/tutorials/ads-ios-on-device-measurement-event-data/step-1)\n[**Step 3** : Troubleshoot and handle common issuesarrow_forward_ios](/docs/tutorials/ads-ios-on-device-measurement-event-data/step-3)\n\n\u003cbr /\u003e\n\n*** ** * ** ***"]]
