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

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


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

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

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

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

اگر می‌خواهید جمع‌آوری Analytics را موقتاً غیرفعال کنید، مثلاً برای دریافت رضایت کاربر نهایی قبل‌از جمع‌آوری داده، می‌توانید مقدار FIREBASE_ANALYTICS_COLLECTION_ENABLED را روی NO (بولی) در فایل Info.plist برنامه‌تان تنظیم کنید. برای مثال، در 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 بدون هیچ‌گونه قابلیت جمع‌آوری IDFA، به‌جای وابستگی FirebaseAnalytics از موارد زیر استفاده کنید:

Swift Package Manager

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

CocoaPods

pod 'FirebaseAnalytics/Core'

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

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

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

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

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

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

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

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

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

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

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

اگر از پارامتر 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);

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

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 ایجاد می‌کنید، ممکن است چند دقیقه طول بکشد تا در برنامه‌تان اعمال شود. اگر برنامه‌تان فعال باشد، ممکن است تکمیل فرایند کامل اعمال تغییرات تا یک ساعت طول بکشد.