במדריך הזה מוסבר איך לספק מידע על טירגוט ל-Google Mobile Ads SDK.
דרישות מוקדמות
לפני שממשיכים, צריך להגדיר את GMA Next-Gen SDK.
RequestConfiguration
RequestConfiguration
אוסף מידע על הטירגוט שמוחל באופן גלובלי על כל בקשה להצגת מודעה. כדי לראות את תגי הטירגוט הזמינים, עיינו במסמכי התיעוד של RequestConfiguration.Builder.
יוצרים אובייקט RequestConfiguration עם תגי הטירגוט שצריך באמצעות ה-builder שלו, ואז מגדירים את התצורה באמצעות קריאה ל-MobileAds.setRequestConfiguration().
Kotlin
val requestConfiguration = RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
כדי להחיל תגי טירגוט מהבקשה הראשונה להצגת מודעה, צריך לספק את הגדרת הבקשה במהלך ההפעלה של ה-SDK:
Kotlin
val requestConfiguration = RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
CoroutineScope(Dispatchers.IO).launch {
// Initialize GMA Next-Gen SDK on a background thread.
MobileAds.initialize(
this@MainActivity,
InitializationConfig
// Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
.Builder("SAMPLE_APP_ID")
.setRequestConfiguration(requestConfiguration)
.build()
) {
// Adapter initialization is complete.
}
// Other methods on MobileAds can now be called.
}
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
// Set your targeting tags.
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
new Thread(
() -> {
// Initialize GMA Next-Gen SDK on a background thread.
MobileAds.initialize(
this,
// Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
new InitializationConfig
.Builder("SAMPLE_APP_ID")
.setRequestConfiguration(requestConfiguration)
.build(),
initializationStatus -> {
// Adapter initialization is complete.
});
// Other methods on MobileAds can now be called.
})
.start();
הגדרת הגבלות שקשורות לגיל
כדי לעזור לכם לנהל את העמידה שלכם בתקנות בנושא פרטיות הרלוונטיות בנושא ילדים ובני נוער, ב-GMA Next-Gen SDK יש הגדרה לטיפול במידע בהתאם לגיל. ההגדרה של הטיפול שמותאם לגיל מאפשרת לציין אם מערכת GMA Next-Gen SDK צריכה להחיל הגנות ספציפיות על הצגת מודעות לילדים, לבני נוער או לגיל לא מוגדר.
אפשר להגדיר הגבלות שקשורות לגיל באמצעות ה-method setAgeRestrictedTreatment() ב-API של RequestConfiguration.Builder.
בדוגמה הבאה מצוין שבקשות להצגת מודעות צריכות לקבל טיפול שמותאם לילדים:
Kotlin
val requestConfiguration =
RequestConfiguration.Builder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
new RequestConfiguration.Builder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);כדי לציין טיפול שמותאם לבני נוער או טיפול לא מוגדר, מחליפים את ההגדרה CHILD בהגדרה הבאה:
TEENUNSPECIFIED
כשמשתמשים בהגדרה הזו, GMA Next-Gen SDK כולל פרמטר tfat בבקשות להצגת מודעות. מומלץ לפנות לייעוץ משפטי כדי לקבוע את הטיפול בגיל הרלוונטי לזכאות עבור בסיס המשתמשים שלכם, בהתאם לדרישות המשפטיות והרגולטוריות. מידע נוסף זמין במאמר איך לסמן בקשות להצגת מודעות מהאפליקציה בתג הגבלות שקשורות לגיל.
מעבר מ-TFCD ו-TFUA להגבלות שקשורות לגיל
ההגדרה של הגבלות שקשורות לגיל מחליפה את ההגדרות .setTagForChildDirectedTreatment() (TFCD) ו-.setTagForUnderAgeOfConsent() (TFUA) שהוצאו משימוש.
בטבלה הבאה מוצגות ההגדרות של TFCD ו-TFUA וההגדרות המקבילות של TFAT:
TFCD
TFCD |
טיפול לפי גיל |
|---|---|
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE |
AgeRestrictedTreatment.CHILD |
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE |
AgeRestrictedTreatment.UNSPECIFIED |
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED |
AgeRestrictedTreatment.UNSPECIFIED |
לא הוקצה ערך .setTagForChildDirectedTreatment() |
AgeRestrictedTreatment.UNSPECIFIED |
| אין דוח מקביל | AgeRestrictedTreatment.TEEN |
TFUA
TFUA |
טיפול לפי גיל |
|---|---|
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE |
AgeRestrictedTreatment.CHILD |
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE |
AgeRestrictedTreatment.UNSPECIFIED |
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED |
AgeRestrictedTreatment.UNSPECIFIED |
לא הוקצה ערך .setTagForUnderAgeOfConsent() |
AgeRestrictedTreatment.UNSPECIFIED |
| אין דוח מקביל | AgeRestrictedTreatment.TEEN |
הסבר על האינטראקציות של הגבלות שקשורות לגיל עם TFCD ו-TFUA
אם תגדירו את התג TFAT וגם את התגים TFCD או TFUA, Google תחיל על הבקשות את ההגבלות הכי שמרניות.
העברת הגדרת הגיל בתהליך בחירת הרשת (Mediation) ב-AdMob
אם מגדירים את ההגבלות שקשורות לגיל באמצעות GMA Next-Gen SDK, מתאמי תהליך בחירת הרשת מעבירים את האות של ההגבלות שקשורות לגיל לערכות SDK של צד שלישי בתהליך בחירת הרשת.
בטבלה הבאה מפורטות הגרסאות של מתאם לבחירת רשת (Mediation) שתומכות בהעברת האות של הגבלת הגיל ל-SDK של הצד השלישי:
| שם המתאם של תהליך בחירת הרשת (Mediation) | הגרסה המינימלית הנתמכת |
|---|---|
| AppLovin | 13.6.3.0 |
| BidMachine | 3.7.1.1 |
| Bigo | 5.9.0.1 |
| Chartboost | 9.12.1.1 |
| DTExchange (Fyber) | 8.4.5.1 |
| i-mobile | 2.3.2.4 |
| InMobi | 11.3.0.1 |
| IronSource | 9.4.3.0 |
| Liftoff Monetize (Vungle) | 7.7.4.2 |
| LY (קו) | 3.1.1.1 |
| maio | 2.0.9.0 |
| Meta (Facebook) | 6.21.0.4 |
| Mintegral | 17.1.61.1 |
| Moloco | 4.10.0.0 |
| MyTarget | 5.47.1.1 |
| Pangle | 8.1.0.3.1 |
| PubMatic | 5.1.2.2 |
| Verve | 3.9.0.0 |
ההגדרה "התאמה לילדים"
למטרות של Children's Online Privacy Protection Act (חוק הגנת הפרטיות של ילדים באינטרנט, COPPA), יש הגדרה שנקראת "תג התאמה לילדים (TFCD)". הגדרת התג הזה מהווה אישור לכך שההודעה הזו מדויקת ושיש לך הרשאה לפעול בשם הבעלים של האפליקציה. ברור לך שניצול לרעה של ההגדרה הזו עלול לגרום לסגירת חשבון Google שלך.
כשמפתחי אפליקציות שולחים בקשה להצגת מודעה, הם יכולים לציין אם הם רוצים ש-Google תתייחס לתוכן שלהם כתוכן שמותאם לילדים. אם תציינו שאתם רוצים ש-Google תתייחס לתוכן שלכם כתוכן לילדים, נשבית את הפרסום לפי תחומי עניין (IBA) ואת מודעות הרימרקטינג בבקשה הזו להצגת מודעה.
אתם יכולים להחיל את ההגדרה "מיועד לילדים" דרך
setTagForChildDirectedTreatment():
כדי לציין שאתם רוצים שהתוכן שלכם יטופל כתוכן שמופנה לילדים למטרות COPPA, צריך להפעיל את
setTagForChildDirectedTreatmentעםTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE. כך אפשר למנוע את העברת מזהה הפרסום ב-Android (AAID).מפעילים את
setTagForChildDirectedTreatmentעםTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSEכדי לציין שאתם לא רוצים שהתוכן שלכם יוגדר כמיועד לילדים בהתאם ל-COPPA.אם אתם לא רוצים לציין בבקשות להצגת מודעות איך אתם רוצים שנתייחס לתוכן שלכם בהתאם ל-COPPA, אתם יכולים להפעיל את
setTagForChildDirectedTreatmentעםTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED.
הדוגמה הבאה מציינת שאתם רוצים שהתוכן שלכם יטופל כתוכן שמיועד לילדים למטרות COPPA:
Kotlin
val requestConfiguration = RequestConfiguration
.Builder()
.setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
משתמשים מתחת לגיל ההסכמה
אפשר לסמן בקשות להצגת מודעות כדי שיטופלו כמותאמות למשתמשים מתחת לגיל ההסכמה באזור הכלכלי האירופי (EEA). פיתחנו את התכונה הזאת כדי לעזור לכם לפעול בהתאם לתקנה הכללית להגנה על מידע (GDPR). יכול להיות שיש לכם חובות משפטיות נוספות בכפוף ל-GDPR. כדאי לעיין בהנחיות של האיחוד האירופי ולהתייעץ עם עורך דין. הכלים של Google מיועדים לסייע לציות לחוק, ולא פוטרים בעלי אפליקציות מהמחויבויות שלהם בכפוף לחוק. איך תקנות ה-GDPR משפיעות על בעלי התוכן הדיגיטלי
כשמשתמשים בתכונה הזאת, מתווסף לבקשות להצגת מודעות פרמטר של תג למשתמשים מתחת לגיל ההסכמה באירופה (TFUA). הפרמטר הזה משבית את האפשרות לפרסום מותאם אישית, כולל רימרקטינג, בכל הבקשות להצגת מודעות. בנוסף, הוא משבית העברה של בקשות לספקי מודעות של צד שלישי, למשל בקשות לפיקסלים למדידת ביצועים של מודעות ובקשות לשרתי מודעות של צד שלישי.
בדומה להגדרות של תוכן לילדים, יש שיטה ב-RequestConfiguration.Builder להגדרת הפרמטר TFUA:
setTagForUnderAgeOfConsent(),
עם האפשרויות הבאות.
מפעילים את
setTagForUnderAgeOfConsent()עםTAG_FOR_UNDER_AGE_OF_CONSENT_TRUEכדי לציין שאתם רוצים שהבקשה להצגת מודעה תטופל כמותאמת למשתמשים מתחת לגיל ההסכמה באזור הכלכלי האירופי (EEA). הפעולה הזו גם מונעת את העברת מזהה הפרסום ב-Android (AAID).מפעילים את
setTagForUnderAgeOfConsent()עםTAG_FOR_UNDER_AGE_OF_CONSENT_FALSEכדי לציין שאתם לא רוצים שהבקשה להצגת מודעה תטופל כמותאמת למשתמשים מתחת לגיל ההסכמה באזור הכלכלי האירופי (EEA).מפעילים את
setTagForUnderAgeOfConsent()עםTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIEDכדי לציין שלא הגדרתם אם הבקשה להצגת מודעה צריכה לקבל טיפול שמותאם למשתמשים מתחת לגיל ההסכמה באזור הכלכלי האירופי (EEA).
הדוגמה הבאה מציינת שאתם רוצים לכלול את הפרמטר TFUA בבקשות להצגת מודעות:
Kotlin
val requestConfiguration = RequestConfiguration
.Builder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
אין להגדיר גם את התגים להפעלת ההגדרה "במיוחד לילדים" וגם את setTagForUnderAgeOfConsent() לסטטוס true במקביל. אם תעשו את זה, ההגדרה "מיועד לילדים" תקבל עדיפות.
סינון תוכן מודעה
כדי לעמוד בדרישות המדיניות של Google Play בנושא מודעות בלתי הולמות, שכוללת מבצעים משויכים בתוך מודעה, כל המודעות והמבצעים המשויכים שמוצגים באפליקציה שלכם חייבים להתאים לסיווג התוכן של האפליקציה, גם אם התוכן עצמו עומד בדרישות אחרות של מדיניות Google Play.
כלים כמו סיווג מקסימלי לתוכן מודעה יכולים להגביר את השליטה שלכם בתוכן של המודעות שמוצגות למשתמשים. הסיווג המקסימלי יעזור לכם לעמוד בדרישות המדיניות של הפלטפורמה.
באפליקציות אפשר להגדיר סיווג מקסימלי לתוכן מודעה בבקשות להצגת מודעות באמצעות השיטה
setMaxAdContentRating
. המודעות שמוחזרות מ-AdMob כשההגדרה הזו מופעלת הן ברמת הסיווג הזו או ברמה נמוכה יותר. הערכים האפשריים לפרט הנוסף הזה על רשת המודעות מבוססים על סיווגים של תוויות תוכן דיגיטלי, והם חייבים להיות אחת מהמחרוזות הבאות:
MAX_AD_CONTENT_RATING_GMAX_AD_CONTENT_RATING_PGMAX_AD_CONTENT_RATING_TMAX_AD_CONTENT_RATING_MA
הקוד הבא מגדיר אובייקט RequestConfiguration כדי לציין שתוכן המודעה שמוחזר צריך להתאים לתווית התאמת תוכן דיגיטלי לקהל שלא גבוהה מ-G:
Kotlin
val requestConfiguration = RequestConfiguration
.Builder()
.setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
למידע נוסף על:
Publisher Privacy Treatment (בטא)
Publisher Privacy Treatment (או בקיצור PPT) הוא כלי API אופציונלי שמאפשר לאפליקציות לציין אם להשבית את ההתאמה האישית של המודעות בכל הבקשות להצגת מודעות באמצעות השיטה setPublisherPrivacyPersonalizationState(). כשמשתמשים בתכונה הזו, פרמטר של טיפול בפרטיות של בעלי תוכן דיגיטלי (PPT) נכלל בכל הבקשות להצגת מודעות שיישלחו בהמשך הסשן.
כברירת מחדל, Google מציגה מודעות בהתאמה אישית בתגובה לבקשות להצגת מודעות. הקוד הבא משבית את ההתאמה האישית של המודעות בכל הבקשות להצגת מודעות:
Kotlin
val requestConfiguration = RequestConfiguration
.Builder()
.setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Java
RequestConfiguration requestConfiguration = new RequestConfiguration
.Builder()
.setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
איסוף מיקום משוער
GMA Next-Gen SDK יכול לאסוף מיקום משוער כדי לטרגט מודעות על סמך מיקום המכשיר. אם משתמש נותן לאפליקציה הרשאת מיקום, GMA Next-Gen SDK אוספת מיקום משוער.
החל מגרסה 1.7.0 של GMA Next-Gen SDK, איסוף נתוני מיקום משוער מופעל כברירת מחדל. אפשר להשבית את איסוף המיקום המשוער באמצעות ה-method setCoarseLocationCollectionEnabled().
בדוגמה הבאה מושבת איסוף המיקום המשוער:
Kotlin
val requestConfiguration =
RequestConfiguration.Builder()
// Disable automatic coarse location collection by the SDK.
.setCoarseLocationCollectionEnabled(false)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
new RequestConfiguration.Builder()
// Disable automatic coarse location collection by the SDK.
.setCoarseLocationCollectionEnabled(false)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);בקשה להצגת מודעה
האובייקט AdRequest אוסף מידע על טירגוט כדי לשלוח אותו עם בקשה להצגת מודעה.
הוספת פרטים נוספים על רשת המודעות
פרטים נוספים על רשת המודעות הם פרטים נוספים שנשלחים עם בקשה להצגת מודעה, והם ספציפיים למקור מודעות יחיד.
קטע הקוד הבא מגדיר מפתח פרמטר נוסף של collapsible עם ערך של bottom ל-Google:
Kotlin
val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build()
NativeAdLoader.load(adRequest, adCallback)
Java
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build();
NativeAdLoader.load(adRequest, adCallback);