מיקוד

במדריך הזה מוסבר איך לספק פרטי טירגוט לבקשה להצגת מודעה. לדוגמה, הורידו את אפליקציית ההדגמה של Android API.

להורדת הדגמת API

דרישה מוקדמת

בקשת תצורה

RequestConfiguration הוא אובייקט שאוסף מידע על טירגוט כדי להחיל אותו באופן גלובלי באמצעות MobileAds אובייקט סטטי.

כדי לעדכן את תצורת הבקשה, משיגים כלי לבניית אתרים מהתצורה הקיימת, מבצעים את העדכונים הרצויים ומגדירים אותם באופן הבא:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

הגדרה מותאמת לילדים

למטרות חוק הגנת הפרטיות של ילדים באינטרנט (COPPA) (COPPA), יש הגדרה שנקראת "תג להתאמה לילדים (&quot); הגדרת התג מבטאת את אישורך לכך שההודעה הזו מדויקת ומותר לך לפעול בשם הבעלים של האפליקציה. מובן לך שניצול לרעה של ההגדרה הזו עלול להוביל לסגירת חשבון Google שלך.

כשאתם, בתור מפתחי אפליקציות, שולחים בקשה להצגת מודעה, אתם יכולים לציין אם אתם רוצים ש-Google תתיחס לתוכן שלכם כתוכן מותאם לילדים. אם תציינו שאתם רוצים ש-Google תתייחס לתוכן שלכם כתוכן מותאם לילדים, אנחנו ננקוט צעדים כדי להשבית מודעות בנושא IBA ומודעות רימרקטינג בבקשות להצגת מודעות.

אפשר להשתמש בהגדרה הזו בכל הגרסאות של Google Play Services SDK דרך RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

  • עליך להתקשר אל setTagForChildDirectedTreatment עם TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE כדי לציין שברצונך לטפל בתוכן שמיועד לילדים, בהתאם לחוק COPPA. הדבר ימנע את ההעברה של מזהה הפרסום של Android (AAID).

  • עליך להתקשר אל setTagForChildDirectedTreatment עם TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE כדי לציין שאינך רוצה שהתוכן שלך ייחשב כמיועד לילדים על פי חוק COPPA.

  • אפשר להתקשר אל setTagForChildDirectedTreatment עם TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED אם אינך רוצה לציין איך ברצונך שהתוכן שלך יתייחס ל-COPPA בבקשות למודעות.

הדוגמה הבאה מציינת שאתם רוצים שהתוכן שלכם יהיה מותאם לילדים למטרות של COPPA:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.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 ייכלל בבקשות שלכם להצגת מודעות:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

אין להפעיל את ההגדרה ו-setTagForUnderAgeOfConsent() את האפשרות true בו-זמנית. במקרה כזה, ההגדרה 'במיוחד לילדים' תקבל עדיפות.

סינון תוכן מודעות

אפליקציות יכולות להגדיר סיווג מקסימלי לתוכן מודעות לבקשות של המודעות באמצעות השיטה setMaxAdContentRating. מודעות AdMob שהוחזרו כאשר הוגדר להן סיווג תוכן ברמת זו או מתחת לה. הערכים האפשריים של הרשת הנוספת הזו מבוססים על סיווגי תוויות של תוכן דיגיטלי, ועליהם להיות אחת מהמחרוזות הבאות:

  • MAX_AD_CONTENT_RATING_G
  • MAX_AD_CONTENT_RATING_PG
  • MAX_AD_CONTENT_RATING_T
  • MAX_AD_CONTENT_RATING_MA

הקוד הבא מגדיר אובייקט RequestConfiguration כדי לציין שתוכן המודעה שיוחזר צריך להתאים לסיווג של תווית תוכן דיגיטלי שלא עולה על G:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

בקשה להצגת מודעה

האובייקט AdRequest אוסף פרטי טירגוט שצריך לשלוח עם בקשה להצגת מודעה.

היעזרו בדוגמה לטירגוט מודעות כדי ליישם טירגוט של מודעות באפליקציית ה-API של Android.