תמיכה ב-IAB בארה"ב

במדריך הזה מפורטים השלבים הנדרשים כדי לתמוך בהודעה בנושא תקנות של מדינות בארה"ב כחלק מ-UMP SDK. מומלץ לקרוא גם את המאמר תחילת העבודה, שבו מוסבר איך להפעיל את האפליקציה עם UMP SDK ולהגדיר את ההודעה. ההנחיות הבאות ספציפיות להודעה בנושא תקנות במדינות בארה"ב.

דרישות מוקדמות

לפני שממשיכים, חשוב לבצע את הפעולות הבאות:

כדי לציין אם משתמש הוא מתחת לגיל ההסכמה, מגדירים את הערך setTagForUnderAgeOfConsent (TFUA). כשמגדירים את TFUA לערך true, ערכת ה-SDK של UMP לא מבקשת מהמשתמש הסכמה. אם לאפליקציה שלכם יש קהל מעורב, צריך להגדיר את הפרמטר הזה למשתמשים ילדים כדי לוודא שלא תתבצע בקשה להסכמה. באחריותכם להגדיר את הפרמטר הזה במקרים שבהם יש צורך, כדי לעמוד בדרישות של חוק COPPA ובתקנות רלוונטיות אחרות.

בדוגמה הבאה, הערך של TFUA מוגדר כ-true בבקשת הסכמה של UMP:

JavaKotlin
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 ->
      // ...
    })

אחרי שהמשתמש מקבל החלטה לגבי תקנות במדינות בארה"ב, אפשר לקרוא את הבחירה שלו מהאחסון המקומי בהתאם למפרט של Global Privacy Platform‏ (GPP). פרטים נוספים זמינים בקטע פרטים באפליקציה. שימו לב ש-UMP SDK מאכלס רק את המפתחות IABGPP_GppSID ו-IABGPP_HDR_GppString.

בדיקה של ההודעות בנושא תקנות במדינות בארה"ב

כדי לבדוק את ההודעות בנושא תקנות במדינות ארה"ב, צריך להשתמש ב-UMPDebugGeographyRegulatedUSState debugGeography כדי לאלץ את UMP SDK להתייחס למכשיר הבדיקה כאילו הוא נמצא במדינה בארה"ב שבה יש תקנות בנושא. אפשר גם להשתמש ב-UMPDebugGeographyOther כדי לאלץ הסרה של הודעות לבקשת הסכמה בהתאם לתקנות במדינות בארה"ב. פרטים נוספים על debugGeography זמינים במאמר אילוץ מיקום גיאוגרפי.