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

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

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

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

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

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

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

Java

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

Kotlin

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 זמינים במאמר איך מגדירים מיקום גיאוגרפי.