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



این صفحه ویژگی‌هایی را که Google 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)

هدف-سی

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

وحدت 

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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

سویفت

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

هدف-سی 

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

وحدت 

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 شما دارد.

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

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

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

مدیر بسته سوئیفت 

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

کوکوپادز 

pod 'FirebaseAnalytics/Core'

برای کسب اطلاعات بیشتر در مورد IDFA به مستندات اپل مراجعه کنید:

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

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

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

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

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

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

رابط برنامه‌نویسی کاربردی (API) حالت رضایت گوگلروش پیشنهادی برای فعال و غیرفعال کردن تبلیغات شخصی‌سازی‌شده است.

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

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

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

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

سویفت

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

هدف-سی

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

وحدت 

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

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

سویفت

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

هدف-سی

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

وحدت 

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

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

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

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

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