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

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


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

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

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

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

اگر می‌خواهید جمع‌آوری Analytics را به‌طور موقت غیرفعال کنید، مثلاً برای اینکه قبل‌از جمع‌آوری داده‌ها رضایت کاربر نهایی را دریافت کنید، می‌توانید مقدار firebase_analytics_collection_enabled را در AndroidManifest.xml برنامه در برچسب application روی false تنظیم کنید. برای مثال:

<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 روی درست تنظیم کنید. برای مثال:

<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 روش توصیه‌شده برای فعال و غیرفعال کردن تبلیغات شخصی‌سازی‌شده است.

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

برای غیرفعال کردن رفتار تبلیغات شخصی‌سازی‌شده به‌طور پیش‌فرض، فیلد زیر را در 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);

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

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