כדי לדון במוצרים שלנו ולספק משוב, אתם יכולים להצטרף לערוץ הרשמי של AdMob ב-Discord בשרת Google Advertising and Measurement Community.

דף זה תורגם על ידי Cloud Translation API.

MobileAds

Kotlin |Java

class MobileAds

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

סיכום

קבועים
`const String!`	`ERROR_DOMAIN = "com.google.android.gms.ads"` שם ברירת המחדל של דומיין השגיאה ב-Google Mobile Ads SDK.

פונקציות ציבוריות
`java-static Unit`	`disableMediationAdapterInitialization(context: Context!)` צריך לבצע את הקריאה לפני `initialize` או לפני הבקשה הראשונה להצגת מודעה כדי להשבית את האינטליגנציה של מתאם תהליך בחירת הרשת.
`java-static InitializationStatus?`	`getInitializationStatus()` הפונקציה מקבלת את סטטוס האינטליקציה של ה-SDK.
`java-static RequestConfiguration`	`getRequestConfiguration()` הפונקציה מקבלת את `RequestConfiguration` ברמת האתר.
`java-static VersionInfo!`	`getVersion()` הפונקציה מקבלת את הגרסה החיצונית (לדוגמה, 20.6.0) של Google Mobile Ads SDK.
`java-static Unit`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(context: Context!)` הפונקציה מפעילה את Google Mobile Ads SDK.
`java-static Unit`	`initialize(context: Context!, listener: OnInitializationCompleteListener!)` הפונקציה מפעילה את Google Mobile Ads SDK.
`java-static Unit`	`openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!)` פתיחת ממשק המשתמש של הכלי לבדיקת מודעות.
`java-static Unit`	`openDebugMenu(context: Context!, adUnitId: String!)` פתיחת תפריט ניפוי הבאגים.
`java-static Boolean`	`putPublisherFirstPartyIdEnabled(enabled: Boolean)` קובע אם מזהה מאינטראקציה ישירה של בעל האפליקציה ב-Google Mobile Ads SDK, שנקרא בעבר מפתח אפליקציה זהה, מופעל.
`java-static CustomTabsSession?`	`registerCustomTabsSession( context: Context, client: CustomTabsClient, origin: String, callback: CustomTabsCallback? )` הרשמה של `CustomTabsClient` ב-Google Mobile Ads SDK כדי לשפר את המונטיזציה ממודעות באפליקציה ב-`CustomTabsSession` הזה.
`java-static Unit`	`registerWebView(webview: WebView)` הרשמה של `WebView` ב-Google Mobile Ads SDK כדי לשפר את המונטיזציה ממודעות באפליקציה ב-`WebView` הזה.
`java-static Unit`	`setAppMuted(muted: Boolean)` מציין אם האודיו של האפליקציה מושתק.
`java-static Unit`	`setAppVolume(volume: Float)` הגדרת עוצמת הקול של האודיו באפליקציה.
`java-static Unit`	`setRequestConfiguration(requestConfiguration: RequestConfiguration)` הגדרת `RequestConfiguration` הגלובלי שמשמש לכל `AdRequest` במהלך הסשן של האפליקציה.
`java-static Unit`	`startPreload( context: Context, preloadConfigurations: (Mutable)List<PreloadConfiguration!>, preloadCallback: PreloadCallback )` הפונקציה הזו הוצאה משימוש. במקום זאת, צריך להשתמש בפונקציה start או start.

קבועים

ERROR_DOMAIN

const val ERROR_DOMAIN = "com.google.android.gms.ads": String!

שם ברירת המחדל של דומיין השגיאה ב-Google Mobile Ads SDK.

פונקציות ציבוריות

disableMediationAdapterInitialization

java-static fun disableMediationAdapterInitialization(context: Context!): Unit

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

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

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

הפונקציה מקבלת את סטטוס האינטליקציה של ה-SDK.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

הפונקציה מקבלת את RequestConfiguration ברמת האתר.

getVersion

java-static fun getVersion(): VersionInfo!

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

אין צורך לקרוא ל-initialize לפני הפונקציה הזו.

אתחול

@RequiresPermission(value = Manifest.permission.INTERNET)
java-static fun initialize(context: Context!): Unit

הפונקציה מפעילה את Google Mobile Ads SDK.

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

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

פרמטרים
`context: Context!`	`Context` שבו פועל ה-SDK.

אתחול

java-static fun initialize(context: Context!, listener: OnInitializationCompleteListener!): Unit

הפונקציה מפעילה את Google Mobile Ads SDK.

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

פרמטרים
`context: Context!`	הפעילות `Context` שבה פועל ה-SDK.
`listener: OnInitializationCompleteListener!`	פונקציית קריאה חוזרת (callback) שתופעל בסיום האינטראקציה.

openAdInspector

java-static fun openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!): Unit

פתיחת ממשק המשתמש של הכלי לבדיקת מודעות.

openDebugMenu

java-static fun openDebugMenu(context: Context!, adUnitId: String!): Unit

פתיחת תפריט ניפוי הבאגים. צריך להפעיל את initialize לפני הפונקציה הזו.

פרמטרים
`context: Context!`	הפעילות `Context` שבה פועל ה-SDK.
`adUnitId: String!`	כל מזהה של יחידת מודעות ב-Ad Manager שמשויך לאפליקציה.

putPublisherFirstPartyIdEnabled

java-static fun putPublisherFirstPartyIdEnabled(enabled: Boolean): Boolean

קובע אם מזהה מאינטראקציה ישירה של בעל האפליקציה ב-Google Mobile Ads SDK, שנקרא בעבר מפתח אפליקציה זהה, מופעל.

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

צריך להפעיל את initialize לפני הפונקציה הזו.

פרמטרים
`enabled: Boolean`	בוליאני. הערך True אם המזהה מאינטראקציה ישירה (First-Party) של בעל האפליקציה מופעל, ו-False אחרת.

החזרות
`Boolean`	true אם ההחלטה נשמרת בהצלחה. False אם לא ניתן לשמור את המידע.

registerCustomTabsSession

java-static fun registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
): CustomTabsSession?

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

פרמטרים
`context: Context`	`Context` שבו פועל ה-SDK.
`client: CustomTabsClient`	`CustomTabsClient` ששימש ליצירת המכונה `CustomTabsSession`.
`origin: String`	מחרוזת המשמשת כמקור ב-Digital Asset Link לצורך אימות.
`callback: CustomTabsCallback?`	`CustomTabsCallback` אופציונלי כדי לקבל שיחות חזרה מ-.

החזרות
`CustomTabsSession?`	מופע `CustomTabsSession` שישמש לכוונת השימוש בכרטיסיות בהתאמה אישית כשפותחים דף של כרטיסיות בהתאמה אישית.

registerWebView

java-static fun registerWebView(webview: WebView): Unit

הרשמה של WebView ב-Google Mobile Ads SDK כדי לשפר את המונטיזציה ממודעות באפליקציה ב-WebView הזה.

setAppMuted

java-static fun setAppMuted(muted: Boolean): Unit

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

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

פרמטרים
`muted: Boolean`	true אם האפליקציה מושתקת, false אחרת. ברירת המחדל היא false.

setAppVolume

java-static fun setAppVolume(volume: Float): Unit

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

אזהרה: הפחתת עוצמת השמע של האפליקציה מפחיתה את הזכאות להצגת מודעות ועשויה להפחית את ההכנסות מפרסום באפליקציה. מומלץ להשתמש ב-API הזה רק אם האפליקציה מספקת למשתמש אמצעי בקרה מותאמים אישית של עוצמת הקול, ויש לשקף ב-API הזה את בחירת עוצמת הקול של המשתמש.

פרמטרים
`volume: Float`	עוצמת הקול כערך צף מ-0 (מושתק) ל-1.0 (עוצמת קול מלאה של המדיה). ברירת המחדל היא 1.0

זריקות
`java.lang.IllegalArgumentException`	אם עוצמת הקול נמצאת מחוץ לטווח החוקי

setRequestConfiguration

java-static fun setRequestConfiguration(requestConfiguration: RequestConfiguration): Unit

הגדרת RequestConfiguration הגלובלי שמשמש לכל AdRequest במהלך הסשן של האפליקציה.

startPreload

java-static fun startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
): Unit

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

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

פרמטרים
`context: Context`	`Context` שבו פועל ה-SDK.
`preloadConfigurations: (Mutable)List<PreloadConfiguration!>`	ההגדרות לטעינה מראש של מודעות.
`preloadCallback: PreloadCallback`	פונקציית קריאה חוזרת (callback) שתופעל כשהזמינות של המודעות משתנה בכל הגדרה של טעינה מראש.