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

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

پیش نیازها

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

  • به آخرین نسخه UMP SDK به روز رسانی کنید. برای پشتیبانی از پیام‌رسانی مقررات ایالات متحده، توصیه می‌کنیم از نسخه 2.1.0 یا بالاتر استفاده کنید.
  • کامل شروع کنید . حتماً یک نقطه ورودی گزینه های حریم خصوصی را پیاده سازی کنید و در صورت لزوم آن را رندر کنید. با تکمیل این راهنما، شما یک نقطه ورودی برای ارائه پیام مقررات ایالت های ایالات متحده به کاربران خود دارید.
  • یک پیام مقررات ایالت های ایالات متحده برای برنامه ها ایجاد کنید .
  • اگر از پیام مقررات ایالت‌های ایالات متحده در کنار پیام‌های دیگر استفاده می‌کنید، با انواع پیام‌های کاربر موجود مشورت کنید تا متوجه شوید چه زمانی پیام‌های مختلف برای کاربران شما نمایش داده می‌شود.

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

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

جاوا

ConsentRequestParameters params = new ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build();

consentInformation = UserMessagingPlatform.getConsentInformation(this);
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    (OnConsentInfoUpdateSuccessListener) () -> {
      // ...
    },
    (OnConsentInfoUpdateFailureListener) requestConsentError -> {
      // ...
    });

کاتلین

val params = ConsentRequestParameters
    .Builder()
    // Indicate the user is under age of consent.
    .setTagForUnderAgeOfConsent(true)
    .build()

consentInformation = UserMessagingPlatform.getConsentInformation(this)
consentInformation.requestConsentInfoUpdate(
    this,
    params,
    ConsentInformation.OnConsentInfoUpdateSuccessListener {
      // ...
    },
    ConsentInformation.OnConsentInfoUpdateFailureListener {
      requestConsentError ->
      // ...
    })

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

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

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