| انتخاب پلاتفرم: | iOS+ Android |
این صفحه ویژگی‌هایی را که Google Analytics ارائه می‌دهد شرح می‌دهد که به شما امکان می‌دهد جمع‌آوری و استفاده از داده‌های Analytics را کنترل کنید.
غیرفعال کردن جمع‌آوری داده‌های Analytics
در برخی موارد، ممکن است بخواهید جمع‌آوری داده‌های Analytics را به‌طور موقت یا دائم غیرفعال کنید، مثلاً برای جمع‌آوری رضایت کاربر نهایی یا برای انجام تعهدات قانونی. Google Analytics گزینه‌های متعددی برای غیرفعال کردن و غیرفعال‌سازی مجموعه Analytics ارائه می‌دهد. اگر با هم استفاده شوند، از بسیاری از موارد استفاده معمول پشتیبانی می‌کنند.
غیرفعال کردن موقت جمع‌آوری
اگر می‌خواهید جمع‌آوری Analytics را موقتاً غیرفعال کنید، مثلاً برای دریافت
رضایت کاربر نهایی قبل‌از جمع‌آوری داده، می‌توانید مقدار
firebase_analytics_collection_enabled را روی false در
AndroidManifest.xml برنامه‌تان در برچسب application تنظیم کنید. برای مثال:
<meta-data android:name="firebase_analytics_collection_enabled" android:value="false" />
برای فعال کردن مجدد جمع‌آوری، مثلاً پس‌از اینکه کاربر نهایی رضایت داد،
setAnalyticsCollectionEnabled()
روش کلاس FirebaseAnalytics را فراخوانی کنید. برای مثال:
Kotlin
setAnalyticsCollectionEnabled(true);
Java
setAnalyticsCollectionEnabled(true);
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
اگر به هر دلیلی لازم بود جمع‌آوری را دوباره تعلیق کنید، می‌توانید کد زیر را فراخوانی کنید و جمع‌آوری تا زمانی که آن را دوباره فعال کنید تعلیق می‌شود.
Kotlin
setAnalyticsCollectionEnabled(false);
Java
setAnalyticsCollectionEnabled(false);
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);
غیرفعال کردن دائمی جمع‌آوری
اگر لازم است جمع‌آوری Analytics را به‌طور دائم در نسخه‌ای از برنامه‌تان غیرفعال کنید، firebase_analytics_collection_deactivated را در AndroidManifest.xml برنامه‌تان در برچسب application روی true تنظیم کنید. برای مثال:
<meta-data android:name="firebase_analytics_collection_deactivated" android:value="true" />
غیرفعال کردن جمع‌آوری «شناسه تبلیغاتی»
اگر می‌خواهید جمع‌آوری
شناسه تبلیغاتی
را در برنامه Android خود غیرفعال کنید، می‌توانید مقدار
google_analytics_adid_collection_enabled را در AndroidManifest.xml برنامه خود در برچسب application روی false تنظیم کنید. برای مثال:
<meta-data android:name="google_analytics_adid_collection_enabled" android:value="false" />
کنترل کردن جمع‌آوری داده‌ها برای تبلیغات شخصی‌سازی‌شده
اگر پروژه Google Analytics خود را به حساب آگهی پیوند داده‌اید یا
به‌نحوی دیگر ادغام آگهی‌ها را فعال کرده‌اید، یا با
هم‌رسانی داده موافقت کرده‌اید،
داده‌های Analytics شما ممکن است برای استفاده در تبلیغات شخصی‌سازی‌شده واجدشرایط باشد.
این یعنی برای مثال، می‌توانید از رویدادهای جمع‌آوری‌شده مانند first_open
برای ایجاد و به‌کارگیری فهرست‌های مخاطبان برای بازاریابی مجدد استفاده کنید، مگر اینکه نشان دهید
چنین داده‌هایی برای تبلیغات شخصی‌سازی‌شده دردسترس نیستند.
بااستفاده از هرکدام از گزینه‌های زیر می‌توانید به‌صورت برنامه‌نویسی‌شده کنترل کنید که آیا باید از داده‌های Analytics کاربر برای تبلیغات شخصی‌سازی‌شده استفاده شود یا نه:
توصیه‌شده: شخصی‌سازی آگهی را به‌طور پویا با احترام به انتخاب کاربر برای موافقت فعال یا غیرفعال کنید. ای‌پی‌آی حالت رضایت Google را پیاده‌سازی کنید.
فعال یا غیرفعال کردن شخصی‌سازی آگهی در سطح کاربر: کنترل شخصی‌سازی آگهی به‌عنوان ویژگی کاربر.
شخصی‌سازی آگهی را در سطح دارایی Analytics فعال یا غیرفعال کنید: شخصی‌سازی آگهی را براساس منطقه جغرافیایی در دارایی Analytics خود غیرفعال کنید.
غیرفعال کردن ویژگی‌های تبلیغات شخصی‌سازی‌شده بااستفاده از ویژگی کاربر
ای‌پی‌آی حالت رضایت Google روش توصیه‌شده برای فعال و غیرفعال کردن تبلیغات شخصی‌سازی‌شده است.
بااین‌حال، اگر برنامه‌تان هنوز از حالت موافقت استفاده نمی‌کند، می‌توانید شخصی‌سازی را با گزینه زیر کنترل کنید.
برای غیرفعال کردن رفتار تبلیغات شخصی‌سازی‌شده به‌طور پیش‌فرض، فیلد زیر را در AndroidManifest.xml برنامه‌تان در برچسب application مشخص کنید:
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="false" />
فعال کردن مجدد ویژگی‌های تبلیغات شخصی‌سازی‌شده ازطریق ویژگی کاربر
اگر از پارامتر google_analytics_default_allow_ad_personalization_signals
برای کنترل شخصی‌سازی آگهی استفاده می‌کنید، می‌توانید شخصی‌سازی آگهی را
با روش setUserProperty
همان‌طور که در زیر نشان داده شده است دوباره فعال کنید:
Kotlin
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );
Java
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);
اگر انتخاب کرده‌اید که جمع‌آوری داده‌های Analytics را موقتاً غیرفعال کنید (برای مثال، تا زمانی که کاربر نهایی رضایت دهد)، و می‌خواهید ویژگی‌های تبلیغات شخصی‌سازی‌شده را پس‌از فعال کردن مجدد جمع‌آوری داده‌های Analytics برای کاربر کنترل کنید، مطمئن شوید که فراخوانی شما برای مشخص کردن این تنظیمات قبل‌از فراخوانی شما برای فعال کردن مجدد جمع‌آوری داده‌های Analytics باشد. برای مثال:
Kotlin
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);
Java
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
تأیید تنظیمات
وقتی سیگنال‌های شخصی‌سازی آگهی برای کاربری ازطریق یکی از سازوکارهای تعریف‌شده در بالا غیرفعال شده باشد، دسته‌های رویداد بعدی که از دستگاه آن کاربر ثبت شده‌اند حاوی ویژگی کاربری به‌نام non_personalized_ads با مقدار ۱ خواهند بود تا نشان دهند رویدادهای آن دسته برای تبلیغات شخصی‌سازی‌شده دردسترس نیستند. غیرفعال کردن تبلیغات شخصی‌سازی‌شده بر استفاده از داده‌ها برای اهداف سنجش، ازجمله گزارش‌دهی و ارجاع، تأثیری ندارد.
مشاهده تغییرات پیکربندی
وقتی تغییراتی در تنظیمات Google Analytics ایجاد می‌کنید، کیت توسعه نرم‌افزار تغییرات را بارگیری می‌کند. این فرایند سریع و یکپارچه است، بنابراین می‌توانید به‌سرعت تغییراتتان را آزمایش کنید. وقتی تغییراتی در Analytics ایجاد می‌کنید، ممکن است چند دقیقه طول بکشد تا در برنامه‌تان اعمال شود. اگر برنامه‌تان فعال باشد، ممکن است تکمیل فرایند کامل اعمال تغییرات تا یک ساعت طول بکشد.