מיקוד

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

אם מגדירים את ההגבלות שקשורות לגיל באמצעות 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():

  • כדי לציין שאתם רוצים שהתוכן שלכם יטופל כתוכן שמופנה לילדים למטרות 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 =
  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);

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

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

הוספת פרטים נוספים על רשת המודעות

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

קטע הקוד הבא מגדיר מפתח פרמטר נוסף של 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);

מיקוד מותאם אישית

אתם יכולים להעביר צמדים מותאמים אישית של מפתח/ערך כדי לטרגט קמפיינים (פריטים) ב-Google Ad Manager. בדוגמה הבאה מועבר צמד מותאם אישית של מפתח/ערך בבקשה להצגת מודעה:

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build()

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build();

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

Kotlin

.addCustomTargeting("age", listOf("24", "25", "26"))

Java

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

בדוגמה לטירגוט בהתאמה אישית ב-Ad Manager אפשר לראות איך מטמיעים טירגוט בהתאמה אישית באפליקציית Android API Demo.

החרגות של קטגוריות

כדי להוסיף לבקשה החרגה של קטגוריה ברמת מיקום המודעה, משתמשים ב-method‏ addCategoryExclusion():

Kotlin

// Example: Exclude "automobile" and "boat" categories.
val newRequest =
  AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build()

Java

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder()
        .addCategoryExclusion("automobile")
        .addCategoryExclusion("boat")
        .build();

בדוגמה הזו של החרגת קטגוריות ב-Ad Manager אפשר לראות איך מטמיעים החרגות של קטגוריות באפליקציית Android API Demo.

מזהים שניתנים על ידי בעל התוכן הדיגיטלי (PPID)

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

דוגמה להגדרת PPID:

Kotlin

val adRequest = AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build()

Java

AdManagerAdRequest adRequest =
    new AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build();

בדוגמה של PPID ב-Ad Manager מוסבר איך להטמיע מזהים שניתנים על ידי בעל התוכן הדיגיטלי (PPID) באפליקציית Android API Demo.

אותות שמספקים בעלי תוכן דיגיטלי

אתם יכולים לשלוח נתוני קהל ונתונים לפי הקשר בתור אותות שמספקים בעלי תוכן דיגיטלי (PPS) בבקשות להצגת מודעות. בעזרת PPS, אתם יכולים להשתמש בנתוני המשתמשים כדי לשפר את המונטיזציה הפרוגרמטית. לשם כך, אתם יכולים להעביר את מאפייני הקהל למגישי הצעות המחיר בכל סוגי העסקאות, באמצעות טקסונומיות סטנדרטיות, בלי לשתף את מזהי המשתמשים. המאפיינים של הקהל יכולים לכלול נתונים התנהגותיים ונתונים שמבוססים על תחומי עניין (IAB Audience Taxonomy 1.1) ונתונים לפי הקשר (IAB Content Taxonomy 2.2).

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6, 284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4, 5, 6))

val request =
  AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()

Java

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", new ArrayList<>(Arrays.asList(6, 284)));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", new ArrayList<>(Arrays.asList(4, 5, 6)));

AdManagerAdRequest request =
    new AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();

כתובת URL של תוכן

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

Kotlin

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()

Java

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();

הגנה על המותג (בטא)

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

Kotlin

val urls =
  mutableListOf(
    "https://www.mycontenturl1.com",
    "https://www.mycontenturl2.com",
    "https://www.mycontenturl3.com",
    "https://www.mycontenturl4.com",
  )

val requestWithContent = AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build()

Java

List<String> urls =
    Arrays.asList(
        "https://www.mycontenturl1.com",
        "https://www.mycontenturl2.com",
        "https://www.mycontenturl3.com",
        "https://www.mycontenturl4.com");

AdManagerAdRequest requestWithContent =
    new AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build();

.setNeighboringContentUrls() שונה מ-.setContentUrl() בכך שהוא משמש רק להגנה על המותג.