מיקוד

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

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

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

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

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

RequestConfiguration

RequestConfiguration אוסף מידע על הטירגוט שמוחל באופן גלובלי על כל בקשה להצגת מודעה. תגי הטירגוט הזמינים מפורטים במסמכי התיעוד של RequestConfiguration.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 לתג TFAT

ההגדרה של הגבלות שקשורות לגיל מחליפה את ההגדרות שהוצאו משימוש: .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

אם מגדירים את הטיפול בהתאם לגיל באמצעות Google Mobile Ads SDK (Legacy), מתאמי תהליך בחירת הרשת מעבירים את אות הטיפול בהתאם לגיל לערכות 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():

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

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

  • אם אתם לא רוצים לציין בבקשות להצגת מודעות איך אתם רוצים שנתייחס לתוכן שלכם בהתאם ל-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 משפיעות על בעלי התוכן הדיגיטלי

כשמשתמשים בתכונה הזאת, מתווסף לבקשות להצגת מודעות פרמטר 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 (בטא)

‫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);