پشتیبانی IAB ایالات متحده

پلتفرم مورد نظر: اندروید، iOS و یونیتی

این راهنما مراحل مورد نیاز برای پشتیبانی از پیام مقررات ایالت‌های ایالات متحده را به عنوان بخشی از UMP SDK تشریح می‌کند. این دستورالعمل‌ها را با «شروع کنید» همراه کنید، که جزئیات نحوه اجرای برنامه شما با UMP SDK و تنظیم پیام شما را شرح می‌دهد. راهنمایی زیر مختص پیام مقررات ایالت‌های ایالات متحده است.

پیش‌نیازها

قبل از ادامه، مطمئن شوید که موارد زیر را انجام می‌دهید:

  • افزونه Unity را به آخرین نسخه به‌روزرسانی کنید. برای پشتیبانی از پیام‌رسانی مقررات ایالت‌های ایالات متحده، توصیه می‌کنیم از نسخه ۸.۷.۰ یا بالاتر استفاده کنید.
  • شروع به کار را کامل کنید. حتماً یک نقطه ورود برای گزینه‌های حریم خصوصی پیاده‌سازی کنید و در صورت لزوم آن را رندر کنید. با تکمیل این راهنما، یک نقطه ورود برای ارائه پیام مقررات ایالت‌های ایالات متحده به کاربران خود دارید.
  • یک پیام مربوط به مقررات ایالت‌های آمریکا برای برنامه‌ها ایجاد کنید .
  • اگر از پیام مقررات ایالت‌های ایالات متحده در کنار سایر پیام‌ها استفاده می‌کنید، برای اطلاع از زمان نمایش پیام‌های مختلف به کاربرانتان، به بخش «انواع پیام‌های موجود برای کاربران» مراجعه کنید.

برای نشان دادن اینکه آیا کاربر زیر سن قانونی است یا خیر، tagForUnderAgeOfConsent (TFUA) را تنظیم کنید. وقتی TFUA را روی true تنظیم می‌کنید، UMP SDK از کاربر درخواست رضایت نمی‌کند. اگر برنامه شما مخاطبان مختلطی دارد، این پارامتر را برای کاربران کودک تنظیم کنید تا اطمینان حاصل شود که رضایت درخواست نمی‌شود. مسئولیت تنظیم این پارامتر در صورت لزوم برای رعایت COPPA و سایر مقررات مربوطه بر عهده شماست.

مثال زیر، TFUA را در درخواست رضایت UMP روی true تنظیم می‌کند:

  ConsentRequestParameters params = new ConsentRequestParameters
  {
      // Indicate the user is under age of consent.
      TagForUnderAgeOfConsent = true;
  };

  ConsentInformation.Update(params, (FormError updateError) =>
  {
    // ...
  });

پس از اینکه کاربر تصمیمی در مورد مقررات ایالت‌های ایالات متحده گرفت، می‌توانید انتخاب او را از حافظه محلی و طبق مشخصات پلتفرم جهانی حریم خصوصی (GPP) بخوانید. برای جزئیات بیشتر، به جزئیات درون برنامه مراجعه کنید. توجه داشته باشید که UMP SDK فقط کلیدهای IABGPP_GppSID و IABGPP_HDR_GppString را پر می‌کند.

پیام‌رسانی مقررات ایالت‌های آمریکا را آزمایش کنید

برای آزمایش پیام‌رسانی مربوط به مقررات ایالت‌های ایالات متحده، debugGeography UMPDebugGeographyRegulatedUSState استفاده کنید تا UMP SDK را مجبور کنید با دستگاه آزمایشی شما طوری رفتار کند که انگار در یک ایالت تحت نظارت ایالات متحده قرار دارد. همچنین می‌توانید از UMPDebugGeographyOther برای سرکوب اجباری پیام‌های مربوط به مقررات ایالت‌های ایالات متحده استفاده کنید. برای جزئیات بیشتر در مورد debugGeography ، به Force a geography مراجعه کنید.

،
پلتفرم مورد نظر: اندروید، iOS و یونیتی

این راهنما مراحل مورد نیاز برای پشتیبانی از پیام مقررات ایالت‌های ایالات متحده را به عنوان بخشی از UMP SDK تشریح می‌کند. این دستورالعمل‌ها را با «شروع کنید» همراه کنید، که جزئیات نحوه اجرای برنامه شما با UMP SDK و تنظیم پیام شما را شرح می‌دهد. راهنمایی زیر مختص پیام مقررات ایالت‌های ایالات متحده است.

پیش‌نیازها

قبل از ادامه، مطمئن شوید که موارد زیر را انجام می‌دهید:

  • افزونه Unity را به آخرین نسخه به‌روزرسانی کنید. برای پشتیبانی از پیام‌رسانی مقررات ایالت‌های ایالات متحده، توصیه می‌کنیم از نسخه ۸.۷.۰ یا بالاتر استفاده کنید.
  • شروع به کار را کامل کنید. حتماً یک نقطه ورود برای گزینه‌های حریم خصوصی پیاده‌سازی کنید و در صورت لزوم آن را رندر کنید. با تکمیل این راهنما، یک نقطه ورود برای ارائه پیام مقررات ایالت‌های ایالات متحده به کاربران خود دارید.
  • یک پیام مربوط به مقررات ایالت‌های آمریکا برای برنامه‌ها ایجاد کنید .
  • اگر از پیام مقررات ایالت‌های ایالات متحده در کنار سایر پیام‌ها استفاده می‌کنید، برای اطلاع از زمان نمایش پیام‌های مختلف به کاربرانتان، به بخش «انواع پیام‌های موجود برای کاربران» مراجعه کنید.

برای نشان دادن اینکه آیا کاربر زیر سن قانونی است یا خیر، tagForUnderAgeOfConsent (TFUA) را تنظیم کنید. وقتی TFUA را روی true تنظیم می‌کنید، UMP SDK از کاربر درخواست رضایت نمی‌کند. اگر برنامه شما مخاطبان مختلطی دارد، این پارامتر را برای کاربران کودک تنظیم کنید تا اطمینان حاصل شود که رضایت درخواست نمی‌شود. مسئولیت تنظیم این پارامتر در صورت لزوم برای رعایت COPPA و سایر مقررات مربوطه بر عهده شماست.

مثال زیر، TFUA را در درخواست رضایت UMP روی true تنظیم می‌کند:

  ConsentRequestParameters params = new ConsentRequestParameters
  {
      // Indicate the user is under age of consent.
      TagForUnderAgeOfConsent = true;
  };

  ConsentInformation.Update(params, (FormError updateError) =>
  {
    // ...
  });

پس از اینکه کاربر تصمیمی در مورد مقررات ایالت‌های ایالات متحده گرفت، می‌توانید انتخاب او را از حافظه محلی و طبق مشخصات پلتفرم جهانی حریم خصوصی (GPP) بخوانید. برای جزئیات بیشتر، به جزئیات درون برنامه مراجعه کنید. توجه داشته باشید که UMP SDK فقط کلیدهای IABGPP_GppSID و IABGPP_HDR_GppString را پر می‌کند.

پیام‌رسانی مقررات ایالت‌های آمریکا را آزمایش کنید

برای آزمایش پیام‌رسانی مربوط به مقررات ایالت‌های ایالات متحده، debugGeography UMPDebugGeographyRegulatedUSState استفاده کنید تا UMP SDK را مجبور کنید با دستگاه آزمایشی شما طوری رفتار کند که انگار در یک ایالت تحت نظارت ایالات متحده قرار دارد. همچنین می‌توانید از UMPDebugGeographyOther برای سرکوب اجباری پیام‌های مربوط به مقررات ایالت‌های ایالات متحده استفاده کنید. برای جزئیات بیشتر در مورد debugGeography ، به Force a geography مراجعه کنید.