מיקוד

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

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

לפני שממשיכים, מגדירים את GMA Next-Gen SDK.

RequestConfiguration

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

יוצרים אובייקט RequestConfiguration עם תגי הטרגוט שרוצים להשתמש בהם באמצעות כלי הבנייה שלו, ואז מגדירים את ההגדרה על ידי קריאה ל-MobileAds.setRequestConfiguration().

נקודה חשובה: הקריאה ל-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 צריך להחיל הגנות ספציפיות על הצגת מודעות לילדים או לבני נוער. כשמשתמשים בהגדרה,‏ GMA Next-Gen SDK כולל פרמטר tfat בבקשות להצגת מודעות. כדאי להתייעץ עם היועצים המשפטיים שלכם כדי לקבוע את הגיל הרלוונטי לזכאות שחל על המשתמשים שלכם, בהתאם למחויבויות המשפטיות והרגולטוריות שלכם. מידע נוסף זמין במאמר בנושא תיוג בקשה להצגת מודעה מאפליקציה בתג התאמה להגבלת גיל.

אפשר להגדיר את הטיפול בנתוני הגיל באמצעות השיטה 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)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

הגדרת טיפול שמותאם לבני נוער

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

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have teenage treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have teenage treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

הגדרת טיפול לא ספציפי לפי גיל

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

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have unspecified age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

מעבר לטיפול בהגבלות שקשורות לגיל מתגי 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

אם הגדרתם הגדרת טיפול לפי גיל והגדרות TFCD או TFUA, ‏ Google תחיל את הטיפול השמרני ביותר.

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

הגדרה של תוכן לילדים

אזהרה: השיטה setTagForChildDirectedTreatment() הוצאה משימוש. במקום זאת, מגדירים את השיטה setAgeRestrictedTreatment().

לצורך 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 = 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);

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

משתמשים מתחת לגיל ההסכמה

אזהרה: השיטה setTagForUnderAgeOfConsent() הוצאה משימוש. במקום זאת, צריך להגדיר את method‏ setAgeRestrictedTreatment().

אתם יכולים לסמן בקשות להצגת מודעות כמודעות שיוצגו למשתמשים מתחת לגיל ההסכמה שנמצאים באזור הכלכלי האירופי (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 = 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_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_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);

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

• הגדרת סיווג תוכן מקסימלי לכל בקשה להצגת מודעה

• הגדרת סיווג מקסימלי לתוכן מודעה באפליקציה או בחשבון

הערה: הגדרות של מסנן סיווג התוכן שצוינו באמצעות GMA Next-Gen SDK מבטלות את כל ההגדרות שהוגדרו באמצעות ממשק המשתמש של AdMob.

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

‫API‏ Publisher Privacy Treatment‏ (PPT) הוא כלי אופציונלי שמאפשר לאפליקציות לציין אם להשבית את התאמה אישית של מודעות לכל בקשות המודעות באמצעות השיטה 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);

הערה: בבקשות להצגת מודעות עם כמה אותות פרטיות של משתמשים, האות הכי מגביל יקבל עדיפות. דוגמאות ספציפיות זמינות במסמכי העזרה בנושא Publisher Privacy Treatment API.

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

האובייקט 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);