MobileAds

public class MobileAds

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

סיכום

קבועים
static final String
ERROR_DOMAIN = "com.google.android.gms.ads"

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

שיטות ציבוריות
static void

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

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

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

הפונקציה מקבלת את הגרסה החיצונית (לדוגמה, 20.6.0) של Google Mobile Ads SDK.
static void
@RequiresPermission(value = Manifest.permission.INTERNET)
initialize(Context context)

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

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

פתיחת ממשק המשתמש של הכלי לבדיקת מודעות.
static void
openDebugMenu(Context context, String adUnitId)

פתיחת תפריט ניפוי הבאגים.
static boolean

קובע אם מזהה מאינטראקציה ישירה של בעל האפליקציה ב-Google Mobile Ads SDK, שנקרא בעבר מפתח אפליקציה זהה, מופעל.
static @Nullable CustomTabsSession
registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

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

הרשמה של WebView ב-Google Mobile Ads SDK כדי לשפר את המונטיזציה ממודעות באפליקציה ב-WebView הזה.
static void
setAppMuted(boolean muted)

מציין אם האודיו של האפליקציה מושתק.
static void
setAppVolume(float volume)

הגדרת עוצמת הקול של האודיו באפליקציה.
static void
setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

הגדרת RequestConfiguration הגלובלי שמשמש לכל AdRequest במהלך הסשן של האפליקציה.
static void
startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

השיטה הזו הוצאה משימוש.

במקום זאת, צריך להשתמש בפונקציה start או start.

קבועים

ERROR_DOMAIN

public static final String ERROR_DOMAIN = "com.google.android.gms.ads"

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

שיטות ציבוריות

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

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

getInitializationStatus

public static @Nullable InitializationStatus getInitializationStatus()

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

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

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

getVersion

public static VersionInfo getVersion()

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

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

אתחול

@RequiresPermission(value = Manifest.permission.INTERNET)
public static void initialize(Context context)

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

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

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

פרמטרים
Context context

Context שבו פועל ה-SDK.

אתחול

public static void initialize(Context context, OnInitializationCompleteListener listener)

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

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

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

פרמטרים
Context context

הפעילות Context שבה פועל ה-SDK.
OnInitializationCompleteListener listener

פונקציית קריאה חוזרת (callback) שתופעל בסיום האינטראקציה.

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

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

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

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

פרמטרים
Context context

הפעילות Context שבה פועל ה-SDK.
String adUnitId

כל מזהה של יחידת מודעות ב-Ad Manager שמשויך לאפליקציה.

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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

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

פרמטרים
boolean enabled

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

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

registerCustomTabsSession

public static @Nullable CustomTabsSession registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

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

פרמטרים
@NonNull Context context

Context שבו פועל ה-SDK.
@NonNull CustomTabsClient client

CustomTabsClient ששימש ליצירת המכונה CustomTabsSession.
@NonNull String origin

מחרוזת המשמשת כמקור ב-Digital Asset Link לצורך אימות.
@Nullable CustomTabsCallback callback

CustomTabsCallback אופציונלי כדי לקבל שיחות חזרה מ-.
החזרות
@Nullable CustomTabsSession

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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

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

פרמטרים
boolean muted

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

setAppVolume

public static void setAppVolume(float volume)

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

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

פרמטרים
float volume

עוצמת הקול כערך צף מ-0 (מושתק) ל-1.0 (עוצמת קול מלאה של המדיה). ברירת המחדל היא 1.0
זריקות
java.lang.IllegalArgumentException

אם עוצמת הקול נמצאת מחוץ לטווח החוקי

setRequestConfiguration

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

public static void startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

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

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

פרמטרים
@NonNull Context context

Context שבו פועל ה-SDK.
@NonNull List<PreloadConfiguration> preloadConfigurations

ההגדרות לטעינה מראש של מודעות.
@NonNull PreloadCallback preloadCallback

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