MobileAds

Kotlin |Java

public class MobileAds

---

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

סיכום

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

‫methods ציבוריות
static void	disableMediationAdapterInitialization(Context context) מתקשרים לפני initialize או בקשת המודעה הראשונה כדי להשבית את האתחול של מתאם בחירת הרשת.
static @Nullable InitializationStatus	getInitializationStatus() קבלת סטטוס ההפעלה של ה-SDK.
static @NonNull RequestConfiguration	getRequestConfiguration() הפונקציה מחזירה את ה-RequestConfiguration הכללי.
static VersionInfo	getVersion() מקבל את הגרסה החיצונית (לדוגמה, 20.6.0) של Google Mobile Ads SDK.
static void	@RequiresPermission(value = Manifest.permission.INTERNET) initialize(Context context) הפונקציה מאתחלת את Google Mobile Ads SDK.
static void	initialize(Context context, OnInitializationCompleteListener listener) הפונקציה מאתחלת את Google Mobile Ads SDK.
static void	openAdInspector(Context context, OnAdInspectorClosedListener listener) ממשק המשתמש של הכלי לבדיקת מודעות נפתח.
static void	openDebugMenu(Context context, String adUnitId) תפריט הניפוי באגים ייפתח.
static boolean	putPublisherFirstPartyIdEnabled(boolean enabled) ההגדרה הזו קובעת אם מופעל מזהה מאינטראקציה ישירה של בעל האפליקציה ב-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	registerWebView(@NonNull WebView webview) הפונקציה רושמת 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 ) הmethod הזו הוצאה משימוש. במקומה, צריך להשתמש ב-start או ב-start.

קבועים

ERROR_DOMAIN

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

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

‫methods ציבוריות

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	הסביבה שבה פועל ה-SDK‏ Context.

אתחול

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	הסביבה שבה פועל ה-SDK‏ Context.
@NonNull CustomTabsClient client	השתמשתם ב-CustomTabsClient כדי ליצור את מופע CustomTabsSession.
@NonNull String origin	מחרוזת שמשמשת כמקור ב-Digital Asset Link לצורך אימות.
@Nullable CustomTabsCallback callback	אופציונלי: CustomTabsCallback כדי לקבל שיחות חוזרות מ-CustomTabsSession.

החזרות
@Nullable CustomTabsSession	מופע CustomTabsSession לשימוש ב-Custom Tabs Intent כשפותחים דף של כרטיסיות מותאמות אישית.

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.

מקפיצה את הודעות השגיאה (Throws)
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
)

ה-method הזו הוצאה משימוש.

במקומה, צריך להשתמש ב-start או ב-start.

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

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

פרמטרים
@NonNull Context context	הסביבה שבה פועל ה-SDK‏ Context.
@NonNull List<PreloadConfiguration> preloadConfigurations	ההגדרות לטעינה מראש של מודעות.
@NonNull PreloadCallback preloadCallback	קריאה חוזרת להפעלה כשזמינות המודעות משתנה בכל הגדרה של טעינה מראש.