了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

جمع آوری و استفاده از داده های Analytics را پیکربندی کنید

Google Analytics ویژگی هایی را ارائه می دهد که به شما امکان می دهد جمع آوری و استفاده از داده های Analytics را کنترل کنید.

جمع آوری داده های Analytics را غیرفعال کنید

در برخی موارد، ممکن است بخواهید به طور موقت یا دائمی مجموعه داده های Analytics را غیرفعال کنید، مانند جمع آوری رضایت کاربر نهایی یا انجام تعهدات قانونی. Google Analytics چندین گزینه برای غیرفعال کردن و غیرفعال کردن مجموعه Analytics ارائه می دهد. آنها با هم استفاده می شوند، بسیاری از موارد استفاده معمولی را پشتیبانی می کنند.

غیرفعال کردن موقت مجموعه

اگر می‌خواهید به طور موقت مجموعه Analytics را غیرفعال کنید، مانند دریافت رضایت کاربر نهایی قبل از جمع‌آوری داده‌ها، می‌توانید مقدار FIREBASE_ANALYTICS_COLLECTION_ENABLED را در فایل Info.plist برنامه خود روی NO (Boolean) تنظیم کنید. به عنوان مثال، مشاهده شده در منبع XML:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key>
<false/>

برای فعال کردن مجدد مجموعه، مانند پس از رضایت کاربر نهایی، روش نمونه setAnalyticsCollectionEnabled Analytics را فراخوانی کنید. مثلا:

سریع

توجه: این محصول Firebase در هدف macOS در دسترس نیست.
Analytics.setAnalyticsCollectionEnabled(true)

هدف-C

توجه: این محصول Firebase در هدف macOS در دسترس نیست.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

در صورت نیاز به تعلیق مجدد مجموعه به هر دلیلی می توانید تماس بگیرید

سریع

توجه: این محصول Firebase در هدف macOS در دسترس نیست.
Analytics.setAnalyticsCollectionEnabled(false)

هدف-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

و مجموعه تا زمانی که دوباره آن را فعال نکنید به حالت تعلیق در می آید. مقدار تنظیم شده توسط روش setAnalyticsCollectionEnabled در سراسر اجرای برنامه باقی می ماند و مقدار FIREBASE_ANALYTICS_COLLECTION_ENABLED در فایل Info.plist برنامه شما را لغو می کند. هنگامی که مقداری را برای setAnalyticsCollectionEnabled تنظیم کردید، مجموعه Analytics در آن حالت باقی می ماند تا زمانی که setAnalyticsCollectionEnabled دوباره فراخوانی شود، حتی اگر کاربر برنامه شما را ببندد و دوباره باز کند.

مجموعه را برای همیشه غیرفعال کنید

اگر می‌خواهید مجموعه Analytics را به‌طور دائم در نسخه‌ای از برنامه خود غیرفعال کنید، FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED را در Info.plist file برنامه خود روی YES (بولی) تنظیم کنید. تنظیم FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED روی YES (بولی) نسبت به مقادیر FIREBASE_ANALYTICS_COLLECTION_ENABLED در Info.plist برنامه شما و همچنین مقادیر تنظیم شده با setAnalyticsCollectionEnabled اولویت دارد.

برای فعال کردن مجدد مجموعه، FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED را از Info.plist خود حذف کنید. تنظیم FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED روی NO (بولی) تأثیری ندارد و به همان رفتاری منجر می‌شود که FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED در فایل Info.plist شما تنظیم نشده است.

مجموعه IDFA را غیرفعال کنید

اگر Firebase را از طریق CocoaPods با افزودن pod 'Firebase/Analytics' به Podfile برنامه خود نصب کرده اید و می خواهید مجموعه IDFA (شناسه تبلیغاتی دستگاه) را در برنامه Apple خود غیرفعال کنید، مطمئن شوید که چارچوب AdSupport در برنامه شما گنجانده نشده است.

برای نصب Firebase بدون هیچ گونه قابلیت مجموعه IDFA، از زیرمجموعه زیر به جای pod 'Firebase/Analytics' استفاده کنید:

pod 'Firebase/AnalyticsWithoutAdIdSupport'

درباره IDFA در اسناد اپل بیشتر بیاموزید:

مجموعه IDFV را غیرفعال کنید

اگر می‌خواهید مجموعه IDFV (شناسه فروشنده) را در برنامه Apple خود غیرفعال کنید، مقدار GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED را در فایل Info.plist برنامه خود روی NO (Boolean) تنظیم کنید.

استفاده از داده های Analytics را پیکربندی کنید

غیرفعال کردن ویژگی های تبلیغات شخصی

اگر پروژه Google Analytics خود را به یک حساب تبلیغاتی مرتبط کرده‌اید یا یکپارچه‌سازی تبلیغات را فعال کرده‌اید، یا اشتراک‌گذاری داده را انتخاب کرده‌اید، داده‌های Analytics شما ممکن است برای استفاده در تبلیغات شخصی‌شده واجد شرایط باشند. به عنوان مثال، این بدان معناست که می‌توانید از رویدادهای جمع‌آوری‌شده مانند first_open برای ایجاد و استقرار فهرست‌های مخاطب برای بازاریابی مجدد استفاده کنید، مگر اینکه نشان دهید که چنین داده‌هایی برای تبلیغات شخصی‌شده در دسترس نیستند.

برای کنترل برنامه‌نویسی که آیا داده‌های Analytics کاربر باید برای تبلیغات شخصی‌سازی شده استفاده شوند، رفتار پیش‌فرض مناسب را در فایل AndroidManifest.xml برنامه تنظیم کنید و سپس از روش‌های شرح داده شده در زیر برای لغو این رفتار پیش‌فرض استفاده کنید.

برای تنظیم رفتار تبلیغات شخصی‌شده پیش‌فرض، مقدار GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS را در فایل Info.plist برنامه خود روی NO (بولی) تنظیم کنید.

همچنین می‌توانید کنترل کنید که آیا داده‌های جمع‌آوری‌شده از کاربران نهایی ممکن است برای شخصی‌سازی آگهی‌ها از طریق تنظیمات شخصی‌سازی آگهی‌ها که در تنظیمات ویژگی Google Analytics یافت می‌شود، استفاده شود.

دوباره فعال کردن ویژگی های تبلیغات شخصی

برای فعال کردن مجدد ویژگی‌های تبلیغات شخصی‌شده برای کاربر در زمان اجرا، مانند پس از رضایت کاربر نهایی، از روش setUserProperty مانند شکل زیر استفاده کنید:

سریع

توجه: این محصول Firebase در هدف macOS در دسترس نیست.
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

هدف-C

توجه: این محصول Firebase در هدف macOS در دسترس نیست.
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

اگر انتخاب کرده اید که به طور موقت مجموعه تجزیه و تحلیل را غیرفعال کنید (به عنوان مثال، تا زمانی که کاربر نهایی رضایت خود را ارائه کند)، و می خواهید ویژگی های تبلیغات شخصی را با فعال کردن مجدد مجموعه تجزیه و تحلیل برای یک کاربر کنترل کنید، مطمئن شوید که تماس شما برای تعیین این تنظیم قبل از برای فعال کردن مجدد مجموعه تجزیه و تحلیل تماس بگیرید. مثلا:

سریع

توجه: این محصول Firebase در هدف macOS در دسترس نیست.
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

هدف-C

توجه: این محصول Firebase در هدف macOS در دسترس نیست.
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

تنظیمات خود را تایید کنید

هنگامی که سیگنال‌های شخصی‌سازی آگهی برای کاربر از طریق یکی از مکانیسم‌های تعریف‌شده در بالا غیرفعال شده باشد، بسته‌های رویداد بعدی که از دستگاه آن کاربر ثبت می‌شوند دارای ویژگی کاربری با نام «non_personalized_ads» با مقدار 1 خواهند بود که نشان می‌دهد رویدادهای آن بسته در دسترس نیستند. برای تبلیغات شخصی غیرفعال کردن تبلیغات شخصی‌شده تأثیری بر استفاده از داده‌ها برای اهداف اندازه‌گیری، از جمله گزارش‌دهی و انتساب ندارد.

تغییرات پیکربندی خود را مشاهده کنید

هنگامی که تغییراتی را در تنظیمات Google Analytics خود ایجاد کردید، SDK تغییرات را دانلود می کند. این فرآیند سریع و بدون درز است، بنابراین می توانید به سرعت تغییرات خود را آزمایش کنید. وقتی در Analytics تغییراتی ایجاد می‌کنید، ممکن است چند دقیقه طول بکشد تا در برنامه شما اجرا شود. اگر برنامه شما فعال است، فرآیند استقرار کامل ممکن است تا یک ساعت طول بکشد.