מיקוד

בחירת פלטפורמה: Android iOS Unity Flutter Android (Legacy)

במדריך הזה מוסבר איך לספק מידע לטירגוט ל-Google Mobile Ads SDK.

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

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

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

לפני שממשיכים, מגדירים את Google Mobile Ads SDK (Legacy).

RequestConfiguration

‫RequestConfiguration אוסף מידע על הטירגוט שמוגדר באופן גלובלי לכל בקשה להצגת מודעה. מידע על תגי טירגוט זמינים מופיע במאמרי העזרה בנושא RequestConfiguration.Builder.

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

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

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

כדי לוודא ששינויי ההגדרה של הבקשה יחולו על כל הבקשות להצגת מודעות, צריך להגדיר את הבקשה לפני הפעלת Google Mobile Ads SDK (Legacy).

הגדרת ההגבלות שקשורות לגיל

כדי לעזור לכם לפעול בהתאם לתקנות הרלוונטיות בנושא פרטיות שקשורות לילדים ולבני נוער, Google Mobile Ads SDK (Legacy) מספק הגדרת טיפול לפי גיל. ההגדרה 'הגבלות שקשורות לגיל' מאפשרת לציין אם Google Mobile Ads SDK (Legacy) צריך להחיל הגנות ספציפיות על הצגת מודעות לילדים, לבני נוער או למשתמשים בגיל לא ידוע.

אפשר להגדיר הגבלות גיל באמצעות ה-method‏ setAgeRestrictedTreatment() עם ה-API‏ RequestConfiguration.Builder.

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

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

  • TEEN
  • UNSPECIFIED

כשמשתמשים בהגדרה הזו, הפרמטר Google Mobile Ads SDK (Legacy) כולל את הפרמטר tfat בבקשות להצגת מודעות. כדי להבין מהו הגיל הרלוונטי לזכאות שחל על המשתמשים שלכם בהתאם לחובות המשפטיות והרגולטוריות שלכם, מומלץ להתייעץ עם יועץ משפטי. מידע נוסף זמין במאמר איך להגדיר בקשות להצגת מודעות מהאפליקציה כך שיכללו הגבלות שקשורות לגיל.

מעבר לטיפול בבקשות להצגת מודעות לפי סיווגי גיל מהתגים TFCD ו-TFUA

ההגדרה של הגבלות הגיל מחליפה את ההגדרות .setTagForChildDirectedTreatment() (TFCD) ו-.setTagForUnderAgeOfConsent() (TFUA) שהוצאו משימוש.

בטבלה הבאה מוצגות ההגדרות TFCD ו-TFUA וההגדרות המקבילות שלהן לטיפול בנתוני גיל:

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

אם הגדרתם את אופן הטיפול בנתוני הגיל באמצעות Google Mobile Ads SDK (Legacy), מתאמי המדיאציה מעבירים את אות הטיפול בנתוני הגיל לערכות SDK של צד שלישי שמוצגות באמצעות מדיאציה.

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

שם המתאם של הגישור הגרסה המינימלית הנתמכת
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 (Line) 3.1.1.1
maio 2.0.9.0
מטא (פייסבוק) 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), יש הגדרה שנקראת 'תיוג לצורך טיפול בהתאם להנחיות בנושא תוכן שמיועד לילדים'. הגדרת התג הזה מעידה שההודעה הזו מדויקת ושיש לך הרשאה לפעול בשם הבעלים של האפליקציה. ברור לך שניצול לרעה של ההגדרה הזו עלול להוביל לסגירת חשבון Google שלך.

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

אפשר להחיל את ההגדרה 'תוכן לילדים' דרך setTagForChildDirectedTreatment():

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

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

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

בדוגמה הבאה מצוין שאתם רוצים שהתוכן שלכם יסווג כתוכן שמיועד לילדים לצורך עמידה בדרישות COPPA:

Kotlin

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

Java

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

אתם יכולים לסמן בקשות להצגת מודעות כמודעות שיוצגו למשתמשים מתחת לגיל ההסכמה שנמצאים באזור הכלכלי האירופי (EEA). פיתחנו את התכונה הזו כדי לעזור לכם לפעול בהתאם לתקנה הכללית להגנה על מידע (GDPR). יכול להיות שיש לכם חובות משפטיות נוספות בכפוף ל-GDPR. מומלץ לעיין בהנחיות של האיחוד האירופי ולפנות לייעוץ משפטי. הכלים של Google מיועדים לסייע לציות לחוק, ולא פוטרים בעלי אפליקציות מהמחויבויות שלהם בכפוף לחוק. מידע נוסף על ההשפעה של GDPR על בעלי תוכן דיגיטלי

כשמשתמשים בתכונה הזו, בקשות להצגת מודעות כוללות פרמטר Tag For Users under the Age of Consent in Europe (תג לציון הצגה למשתמשים מתחת לגיל ההסכמה באירופה, 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 =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

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

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

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

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

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

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

  • MAX_AD_CONTENT_RATING_G
  • MAX_AD_CONTENT_RATING_PG
  • MAX_AD_CONTENT_RATING_T
  • MAX_AD_CONTENT_RATING_MA

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

Kotlin

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

Java

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

למידע נוסף על:

הטיפול בפרטיות של בעלי תוכן דיגיטלי (בטא)

‫Publisher Privacy Treatment, או בקיצור PPT, הוא כלי API אופציונלי שמאפשר לאפליקציות לציין אם להשבית את ההתאמה האישית של המודעות לכל הבקשות להצגת מודעות באמצעות השיטה setPublisherPrivacyPersonalizationState(). כשמשתמשים בתכונה הזו, פרמטר של העדפות המשתמש בנוגע לפרטיות (PPT) נכלל בכל הבקשות העתידיות להצגת מודעות למשך שארית הסשן.

כשנשלחות ל-Google בקשות להצגת מודעות, המערכת מציגה מודעות בהתאמה אישית כברירת מחדל. הקוד הבא משבית את ההתאמה האישית של מודעות לכל הבקשות להצגת מודעות:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

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

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

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

הוספת ערוצים או חבילות

פרטים נוספים על רשת המודעות הם פרטים נוספים שנשלחים עם בקשה להצגת מודעה, והם ספציפיים למקור מודעות יחיד.

בקטע הקוד הבא מוגדר מפתח פרמטר נוסף של collapsible עם ערך של bottom ב-Google:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);