במדריך הזה מפורטים השלבים הנדרשים כדי לתמוך בהודעה בנושא תקנות במדינות בארה"ב כחלק מ-UMP SDK. ההוראות האלה משלימות את ההוראות במאמר הגדרת UMP SDK, שמסביר איך להפעיל את האפליקציה עם UMP SDK ולהגדיר את ההודעה. ההנחיות הבאות ספציפיות להודעה לבקשת הסכמה בהתאם לתקנות במדינות בארה"ב.
דרישות מוקדמות
לפני שממשיכים, צריך לבצע את הפעולות הבאות:
- מעדכנים לגרסה העדכנית של UMP SDK. כדי להשתמש בהודעות בנושא תקנות במדינות בארה"ב, מומלץ להשתמש בגרסה 2.1.0 ואילך.
- מגדירים את UMP SDK. חשוב להטמיע נקודת כניסה לאפשרויות הפרטיות ולהציג אותה אם צריך. אחרי שתסיימו את השלבים במדריך הזה, תהיה לכם נקודת כניסה להצגת ההודעה לגבי התקנות במדינות בארה"ב למשתמשים.
- איך יוצרים בקשת הסכמה בהתאם לתקנות במדינה הרלוונטית בארה"ב באפליקציות
- אם אתם משתמשים בבקשת הסכמה בהתאם לתקנות במדינה הרלוונטית בארה"ב לצד הודעות אחרות, כדאי לעיין במאמר סוגים זמינים של הודעות למשתמשים כדי להבין מתי הודעות שונות מוצגות למשתמשים.
הגדרת התג "מתחת לגיל ההסכמה"
כדי לציין אם משתמש נמצא מתחת לגיל ההסכמה, מגדירים את הפרמטר
tagForUnderAgeOfConsent (TFUA). כשמגדירים את TFUA לערך true, ה-UMP SDK לא מבקש הסכמה מהמשתמש. אם לאפליקציה שלכם יש קהל בגילאים שונים, הגדירו את הפרמטר הזה למשתמשים שהם ילדים כדי לוודא שלא תתבקש הסכמה.
אתם אחראים להגדיר את הפרמטר הזה במקומות שבהם הוא נדרש כדי לעמוד בדרישות של חוק COPPA ותקנות רלוונטיות אחרות.
בדוגמה הבאה, הערך של TFUA מוגדר כ-true בבקשת הסכמה של UMP:
Swift
// Create a UMPRequestParameters object.
let parameters = RequestParameters()
// Indicate the user is under age of consent.
parameters.isTaggedForUnderAgeOfConsent = true
// Request an update for the consent information.
ConsentInformation.shared.requestConsentInfoUpdate(with: parameters) {
[weak self] requestConsentError in
guard let self else { return }
// ...
}
Objective-C
// Create a UMPRequestParameters object.
UMPRequestParameters *parameters = [[UMPRequestParameters alloc] init];
// Indicate the user is under age of consent.
parameters.tagForUnderAgeOfConsent = YES;
// Request an update for the consent information.
[UMPConsentInformation.sharedInstance
requestConsentInfoUpdateWithParameters:parameters
completionHandler:^(NSError *_Nullable requestConsentError) {
// ...
}];
קריאת אפשרויות ההסכמה
אחרי שהמשתמש קיבל החלטה לגבי התקנות במדינות בארה"ב, אתם יכולים לקרוא את הבחירה שלו מהאחסון המקומי בהתאם למפרט של Global Privacy Platform (הפלטפורמה הגלובלית להעדפות פרטיות, GPP). פרטים נוספים זמינים בקטע פרטי האפליקציה.
שימו לב ש-UMP SDK מאכלס רק את המפתחות IABGPP_GppSID ו-IABGPP_HDR_GppString.
בדיקת ההודעות לבקשת הסכמה בהתאם לתקנות במדינה הרלוונטית בארה"ב
כדי לבדוק את בקשת ההסכמה בהתאם לתקנות במדינה הרלוונטית בארה"ב, משתמשים ב-UMPDebugGeographyRegulatedUSState debugGeography כדי לאלץ את ה-UMP SDK להתייחס למכשיר הבדיקה כאילו הוא נמצא במדינה בארה"ב שחלות בה תקנות. אפשר גם להשתמש ב-UMPDebugGeographyOther כדי לאלץ את ביטול ההצגה של הודעות לבקשת הסכמה בהתאם לתקנות במדינות בארה"ב. למידע נוסף על debugGeography, קראו את המאמר אילוץ מיקום גיאוגרפי.
הערה: UMPDebugGeographyRegulatedUSState זמין רק ב-UMP מגרסה 2.7.0 ואילך.