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

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

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

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

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

כדי לציין אם משתמש מסוים הוא מתחת לגיל ההסכמה, צריך להגדיר את התג setTagForUnderAgeOfConsent (TFUA). כשמגדירים את TFUA לערך true, ‏ UMP SDK לא מבקש הסכמה מהמשתמש. אם לאפליקציה שלכם יש קהל בגילאים שונים, צריך להגדיר את הפרמטר הזה למשתמשים שהם ילדים כדי לוודא שלא תתבקש מהם הסכמה. אתם אחראים להגדיר את הפרמטר הזה במקומות שבהם הדבר נדרש כדי לעמוד בדרישות של חוק 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 זמינים במאמר הגדרת מיקום גיאוגרפי.