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

انتخاب پلاتفرم: iOS+‎ Android


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

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

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

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

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

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

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

Swift

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

Objective-C

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

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

Swift

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

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

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

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

اگر لازم است جمع‌آوری Analytics را در نسخه‌ای از برنامه‌تان برای همیشه غیرفعال کنید، FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED را در فایل Info.plist برنامه‌تان روی 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 شما تنظیم نشده باشد.

غیرفعال کردن جمع‌آوری «شناسه تبلیغ‌کنندگان»

اگر واحد FirebaseAnalytics را ازطریق SPM یا CocoaPods در برنامه‌تان نصب کرده‌اید و می‌خواهید جمع‌آوری IDFA (شناسه تبلیغاتی دستگاه) را در برنامه Apple خود غیرفعال کنید، مطمئن شوید چارچوب AdSupport در برنامه‌تان گنجانده نشده باشد.

برای نصب Firebase بدون قابلیت جمع‌آوری «شناسه تبلیغ‌کننده»، به‌جای وابستگی FirebaseAnalytics از موارد زیر استفاده کنید:

مدیر بسته Swift

  .target(
    name: "MyTargetName",
    dependencies: [
      .product(name: "FirebaseAnalyticsCore", package: "Firebase"),
      // ...
    ]
  ),

CocoaPods

pod 'FirebaseAnalytics/Core'

در اسناد Apple درباره «شناسه تبلیغ‌کنندگان» بیشتر بدانید:

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

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

کنترل کردن جمع‌آوری داده‌ها برای تبلیغات شخصی‌سازی‌شده

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

بااستفاده از هریک از گزینه‌های زیر می‌توانید به‌صورت برنامه‌ریزی‌شده کنترل کنید که آیا باید از داده‌های Analytics کاربر برای تبلیغات شخصی‌سازی‌شده استفاده شود یا نه:

غیرفعال کردن ویژگی‌های تبلیغات شخصی‌سازی‌شده ازطریق دارایی کاربر

میانای برنامه‌سازی کاربردی حالت موافقت Google روش توصیه‌شده برای فعال و غیرفعال کردن تبلیغات شخصی‌سازی‌شده است.

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

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

فعال کردن مجدد ویژگی‌های تبلیغات شخصی‌سازی‌شده ازطریق دارایی کاربر

اگر از پارامتر AnalyticsUserPropertyAllowAdPersonalizationSignals برای کنترل شخصی‌سازی آگهی استفاده می‌کنید، می‌توانید با روش setUserProperty همان‌طور که در زیر نشان داده شده است، شخصی‌سازی آگهی را دوباره فعال کنید:

Swift

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

Objective-C

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

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

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

Swift

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

Objective-C

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

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

تأیید تنظیمات

وقتی سیگنال‌های شخصی‌سازی آگهی برای کاربری ازطریق یکی از سازوکارهای تعریف‌شده در بالا غیرفعال شده باشد، دسته‌های رویداد بعدی که از دستگاه آن کاربر گزارش می‌شود حاوی دارایی کاربری به‌نام non_personalized_ads با مقدار ۱ خواهد بود تا نشان دهد رویدادهای آن دسته برای تبلیغات شخصی‌سازی‌شده درحال‌حاضر دردسترس نیستند. غیرفعال کردن تبلیغات شخصی‌سازی‌شده بر استفاده از داده‌ها برای اهداف اندازه‌گیری، ازجمله گزارش‌دهی و اسنادی، تأثیر نمی‌گذارد.

دیدن تغییرات پیکربندی

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