מיקוד

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

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

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

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

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

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

RequestConfiguration

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

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

Kotlin

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

Java

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

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

הגדרת הטיפול לפי גיל

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

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

Java

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

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

• TEEN
• UNSPECIFIED

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

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

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

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

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

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

לצורך חוק הגנת הפרטיות של ילדים באינטרנט (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)
RequestConfigurationSnippets.kt

Java

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

הערה: באפליקציות שמשתתפות בתוכנית 'לכל המשפחה' ומסווגות כאפליקציות שפונות בעיקר לילדים, ובאפליקציות שמשתמשים מחוברים בהן לחשבונות 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 =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

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

התגים להפעלת ההגדרה 'תוכן לילדים' ו-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)
RequestConfigurationSnippets.kt

Java

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

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

הערה: הגדרות של מסנן סיווג התוכן שצוינו באמצעות Google Mobile Ads SDK מבטלות את כל ההגדרות שהוגדרו באמצעות ממשק המשתמש של Ad Manager.

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

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

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

Kotlin

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

Java

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

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

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

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

Java

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

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

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

Kotlin

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

Java

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

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

Kotlin

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

Java

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

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

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

אפשר להוסיף לרמה של בקשה רמת החרגה של קטגוריה ברמת משבצת באמצעות ה-method‏ addCategoryExclusion():

Kotlin

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

Java

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

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

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

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

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

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

Kotlin

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

Java

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

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

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

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

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();
AdRequestSnippets.java

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

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

Kotlin

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

Java

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

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

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

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

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();
AdRequestSnippets.java

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

הערה: setNeighboringContentUrls משתמש רק בארבע כתובות ה-URL הראשונות ברשימה. המערכת מתעלמת מהשאר.