Google Mobile Ads React Native API

מודול @google/mobile-ads מספק את הממשקים, המחלקות והפונקציות ברמה העליונה של TypeScript, שנדרשים לשילוב Google Mobile Ads באפליקציות React Native.

סקירה כללית

סוג כינויים
AdapterState
מייצג את מצבי האתחול האפשריים של מתאם למנגנון בחירת הרשת.
AdChoicesPlacement
המיקומים של סמל AdChoices בתצוגת המודעה.
AdFormat
הפורמט של המודעה המבוקשת.
AdInspectorError
פרטי השגיאה שמסבירים למה הכלי לבדיקת המודעות נכשל.
AdInspectorErrorCode
שגיאות שמשפיעות על הפתיחה או על הפעולה של הכלי לבדיקת מודעות.
AdOrientation
אפשרויות הכיוון של מודעות באנר מותאמות שמוצגות בתוך הטקסט ושל מודעות באנר מותאמות גדולות ומעוגנות.
AdSize
מייצג את המאפיינים של מודעה.
AgeRestrictedTreatment
הגדרת האפשרויות של הגבלות שקשורות לגיל בבקשות להצגת מודעות.
ConsentStatus
ערכים של סטטוס ההסכמה.
DebugGeography
ערכי ניפוי באגים לבדיקת מיקום גיאוגרפי.
FormErrorCode
מייצג קודי שגיאה של כשלים בפעולות של טופס User Messaging Platform ‏ (UMP).
FullScreenContentErrorCode
LoadAdErrorCode
מייצג קודי שגיאה של כשלים בפעולת טעינת המודעות.
MaxAdContentRating
הסיווג המקסימלי לתוכן מודעה באפליקציה, שמסווג את סוגי המודעות שאפשר להציג.
NativeAdAssetNames
שמות שמשמשים לזיהוי נכסים רגילים של מודעות מותאמות.
NativeAdType
מזהה את הפורמט של מודעה מותאמת שנטענה.
NativeMediaAspectRatio
העדפות לגבי יחס הגובה-רוחב של נכסי מדיה שמוחזרים במודעות מותאמות.
OnAdInspectorClosedListener
הגדרת ממשק לקריאה חוזרת שתופעל כשממשק המשתמש של הכלי לבדיקת מודעות ייסגר.
PrecisionType
רמת הדיוק של ערך המודעה שדווח.
PrivacyOptionsRequirementStatus
סטטוס הדרישה בנושא אפשרויות פרטיות.
PublisherPrivacyPersonalizationState
מציין את מצבי ההתאמה האישית של אמצעי ההגנה על הפרטיות של בעל התוכן הדיגיטלי.
ResizeMode
אפשרויות להתאמה אישית של מצב שינוי הגודל של תוכן תמונה ב-NativeAdMediaView.
ResolvedAdSize
מייצג את המצב הסופי של גודל המודעה אחרי שהמודעה נטענה.
SwipeGestureDirection
הוראות לתנועות החלקה מותאמות אישית לקליקים.
משתנים
AdSize
גדלים מוגדרים מראש של מודעות ושיטות עזר ליצירת גדלים מותאמים וגדלים בהתאמה אישית.
פונקציות
canRequestAds
הפונקציה בודקת אם סטטוס ההסכמה הנוכחי מאפשר לכם לשלוח בקשות להצגת מודעות.
getConsentStatus
קבלת סטטוס ההסכמה הנוכחי של המשתמש.
getInitializationStatus
קבלת סטטוס האתחול של ה-SDK.
getPrivacyOptionsRequirementStatus
בודקת אם נדרשת נקודת כניסה לאפשרויות הפרטיות באפליקציה.
getRequestConfiguration
אחזור של הגדרת הבקשה הגלובלית.
initialize
מאפשר לאתחל את Google Mobile Ads SDK.
isConsentFormAvailable
בודק אם טופס הסכמה זמין.
loadAndShowConsentFormIfRequired
טוען טופס הסכמה ומציג אותו למשתמש אם סטטוס ההסכמה הנוכחי שלו מחייב זאת (למשל, הסטטוס הוא REQUIRED).
openAdInspector
הפעולה הזו פותחת את שכבת העל של הכלי לבדיקת מודעות ב-Google Mobile Ads SDK.
openDebugMenu
פתיחת התפריט לניפוי באגים.
parseLoadAdError
מנתח שגיאה מקורית שמוחזרת במהלך טעינת מודעה ועוטף אותה ב-LoadAdError.
requestConsentInfoUpdate
שליחת בקשה לעדכון פרטי ההסכמה.
reset
מחיקת כל מצב ההסכמה מהאחסון המתמיד.
setPublisherFirstPartyIdEnabled
הפרמטר הזה קובע אם המזהה הישיר מבעל התוכן הדיגיטלי מופעל.
setRequestConfiguration
מגדיר את ההגדרה הגלובלית של הבקשה לצורך עמידה בדרישות וטירגוט.
setUserControlledAppVolume
הגדרת עוצמת הקול של האודיו באפליקציה שבשליטת המשתמש.
setUserMutedApp
הגדרה שקובעת אם האפליקציה מושתקת.
showPrivacyOptionsForm
הצגת טופס אפשרויות הפרטיות.

סוג כינויים

AdapterState

AdapterState: typeof AdapterState[keyof typeof AdapterState]
מייצג את מצבי האתחול האפשריים של מתאם למנגנון בחירת הרשת.
מאפיינים
NOT_READY
מציין שמתאם הבחירה של רשת מודעות עדיין לא אותחל או שהאתחול שלו נכשל.
READY
מציין שהמתאם לתהליך בחירת הרשתות הופעל בהצלחה ומוכן להצגת מודעות.

AdChoicesPlacement

AdChoicesPlacement: typeof AdChoicesPlacement[keyof typeof AdChoicesPlacement]
המיקומים של סמל AdChoices בתצוגת המודעה.
מאפיינים
BOTTOM_LEFT
הפינה השמאלית התחתונה של המודעה.
BOTTOM_RIGHT
הפינה הימנית התחתונה של המודעה.
TOP_LEFT
הפינה השמאלית העליונה של המודעה.
TOP_RIGHT
הפינה הימנית העליונה של המודעה.

AdFormat

AdFormat: typeof AdFormat[keyof typeof AdFormat]
הפורמט של המודעה המבוקשת.
מאפיינים
APP_OPEN
פורמט מודעה בפתיחת אפליקציה.
BANNER
פורמט של מודעת באנר.
INTERSTITIAL
פורמט של מודעת מעברון.
NATIVE
פורמט של מודעה מותאמת.
REWARDED
פורמט של מודעה מתגמלת.
REWARDED_INTERSTITIAL
פורמט של מודעת מעברון מתגמלת.

AdInspectorError

AdInspectorError: BaseError<AdInspectorErrorCode>
פרטי השגיאה שמסבירים למה הכלי לבדיקת המודעות נכשל.

AdInspectorErrorCode

AdInspectorErrorCode: typeof AdInspectorErrorCode[keyof typeof AdInspectorErrorCode]
שגיאות שמשפיעות על הפתיחה או על הפעולה של הכלי לבדיקת מודעות.
מאפיינים
ALREADY_OPEN
אי אפשר לפתוח את הכלי לבדיקת מודעות כי הוא כבר פתוח.
FAILED_TO_LOAD
טעינת הכלי לבדיקת מודעות נכשלה.
INTERNAL_ERROR
אירעה שגיאה פנימית בכלי לבדיקת מודעות.
NOT_IN_TEST_MODE
אי אפשר לפתוח את הכלי לבדיקת מודעות כי המכשיר לא נמצא במצב בדיקה.

AdOrientation

AdOrientation: typeof AdOrientation[keyof typeof AdOrientation]
אפשרויות הכיוון של מודעות באנר מותאמות שמוצגות בתוך הטקסט ושל מודעות באנר מותאמות גדולות ומעוגנות.
מאפיינים
CURRENT
LANDSCAPE
PORTRAIT

AdSize

מייצג את המימדים של מודעה.

יכול להיות אחד מסט מוגדר מראש של גדלים (לדוגמה, AdSize.LARGE_BANNER) או גודל מותאם.

AgeRestrictedTreatment

AgeRestrictedTreatment: typeof AgeRestrictedTreatment[keyof typeof AgeRestrictedTreatment]
הגדרת האפשרויות של הגבלות שקשורות לגיל בבקשות להצגת מודעות.
מאפיינים
CHILD
מציין שבקשות להצגת מודעות צריכות לקבל טיפול שמותאם לילדים.
TEEN
מציין שבקשות להצגת מודעות צריכות לקבל טיפול שמותאם לבני נוער.
UNSPECIFIED
מציין שלא חל על הבקשה להצגת מודעה אות ספציפי של הגבלות שקשורות לגיל.

ConsentStatus

ConsentStatus: typeof ConsentStatus[keyof typeof ConsentStatus]
ערכים של סטטוס ההסכמה.
מאפיינים
NOT_REQUIRED
לא נדרשת הסכמה.
OBTAINED
הסכמה שהתקבלה מהמשתמש, מותאמת אישית לעומת לא מותאמת אישית undefined.
REQUIRED
נדרשת הסכמה מהמשתמש, אבל היא עדיין לא התקבלה.
UNKNOWN
סטטוס ההסכמה לא ידוע.

DebugGeography

DebugGeography: typeof DebugGeography[keyof typeof DebugGeography]
ערכי ניפוי באגים לבדיקת מיקום גיאוגרפי.
מאפיינים
DISABLED
האפשרות 'ניפוי באגים של מיקום גיאוגרפי' מושבתת במכשירים לניפוי באגים.
EEA
המיקום הגיאוגרפי מופיע באזור הכלכלי האירופי במכשירים לניפוי באגים.
OTHER
המיקום הגיאוגרפי מופיע כאילו הוא באזור שאין בו תקנות בתוקף עבור מכשיר לניפוי באגים.
REGULATED_US_STATE
המיקום הגיאוגרפי מופיע במכשירים לניפוי באגים כמיקום במדינה בארה"ב שחלות עליה תקנות.

FormErrorCode

FormErrorCode: typeof FormErrorCode[keyof typeof FormErrorCode]
מייצג קודי שגיאה של כשלים בפעולות של טופס User Messaging Platform ‏ (UMP).
מאפיינים
ALREADY_USED
כבר השתמשתם בטופס ההסכמה.
INTERNAL_ERROR
משהו קרה באופן פנימי ב-SDK.
INVALID_OPERATION
הפעולה לא תקינה.
NETWORK_ERROR
הפעולה בטופס נכשלה בגלל בעיות בקישוריות לרשת.
TIMEOUT
הזמן הקצוב לפעולת הטופס הסתיים.
UNAVAILABLE
אין טופס הסכמה זמין.
UNKNOWN
לא הייתה אפשרות למפות את קוד השגיאה לקוד שגיאה מוכר.

FullScreenContentErrorCode

FullScreenContentErrorCode: typeof FullScreenContentErrorCode[keyof typeof FullScreenContentErrorCode]
מאפיינים
AD_ALREADY_USED
המודעה כבר הוצגה.
AD_NOT_READY
המודעה לא מוכנה להצגה.
AD_TOO_LARGE
המודעה גדולה מדי בשביל הסצנה (ב-iOS בלבד).
APP_NOT_FOREGROUND
האפליקציה לא בחזית.
INTERNAL_ERROR
משהו קרה באופן פנימי; לדוגמה, חריגה התרחשה במהלך ההכנה להצגת תוכן מודעה.
MEDIATION_ERROR
המתאם לתהליך בחירת הרשת לא הצליח להציג את המודעה. אפשר לעיין בסיבה הבסיסית ב-FullScreenContentError.mediationAdError.
UNKNOWN
לא הייתה אפשרות למפות את קוד השגיאה לקוד שגיאה מוכר.

LoadAdErrorCode

LoadAdErrorCode: typeof LoadAdErrorCode[keyof typeof LoadAdErrorCode]
מייצג קודי שגיאה של כשלים בפעולת טעינת המודעות.
מאפיינים
AD_ALREADY_USED
התגובה לבקשה להצגת מודעה כבר שימשה לטעינת מודעה.
APP_ID_MISSING
בקשת הצגת המודעה לא נשלחה כי חסר מזהה האפליקציה.
CANCELLED
בקשת הצגת המודעה בוטלה (ב-Android בלבד).
INTERNAL_ERROR
משהו קרה באופן פנימי ב-SDK.
INVALID_REQUEST
הבקשה להצגת מודעה לא תקינה. למשל, מזהה יחידת המודעות שגוי.
INVALID_RESPONSE
תגובה לבקשה להצגת מודעה מהשרת לשרת לא תקינה. לדוגמה, אין מזהה בקשה בתגובה לבקשה להצגת מודעה.
MEDIATION_ERROR
לא נמצא המתאם למנגנון בחירת הרשת או שהוא נכשל בביצוע בקשה להצגת מודעה.
NETWORK_ERROR
הבקשה להצגת מודעה נכשלה בגלל בעיה בחיבור לרשת.
NO_FILL
הבקשה להצגת מודעה התקבלה בהצלחה, אבל לא הוחזרה מודעה בגלל מחסור במלאי שטחי פרסום.
TIMEOUT
הזמן שהוקצב לבקשה להצגת מודעה פג.
UNKNOWN
לא הייתה אפשרות למפות את קוד השגיאה לקוד שגיאה מוכר.

MaxAdContentRating

MaxAdContentRating: typeof MaxAdContentRating[keyof typeof MaxAdContentRating]
הסיווג המקסימלי לתוכן מודעה באפליקציה, שמסווג את סוגי המודעות שאפשר להציג.
מאפיינים
G
תוכן שמתאים לקהל הרחב, כולל משפחות וילדים.
MA
תוכן שמתאים למבוגרים בלבד.
PG
תוכן שמתאים לרוב הקהלים, עם השגחת הורים.
T
תוכן שמתאים לבני נוער ומעלה.
UNSPECIFIED
לא צוין סיווג תוכן.

NativeAdAssetNames

NativeAdAssetNames: typeof NativeAdAssetNames[keyof typeof NativeAdAssetNames]
שמות שמשמשים לזיהוי נכסים רגילים של מודעות מותאמות.
מאפיינים
ADCHOICES_CONTAINER_VIEW
הקונטיינר של שכבת העל של AdChoices.
ADVERTISER
שם המפרסם.
BODY
הטקסט העיקרי של גוף המודעה.
CALL_TO_ACTION
הטקסט של הקריאה לפעולה במודעה (לדוגמה, 'התקנה' או 'מידע נוסף').
HEADLINE
הכותרת של המודעה.
ICON
תמונת הסמל של המודעה.
MEDIA_CONTENT
תוכן המדיה הראשי של המודעה (תמונה או סרטון).
PRICE
המחיר של האפליקציה או המוצר שמפורסמים.
STAR_RATING
דירוג הכוכבים של האפליקציה או המוצר שמפורסמים.
STORE
שם החנות.

NativeAdType

NativeAdType: typeof NativeAdType[keyof typeof NativeAdType]
מזהה את הפורמט של מודעה מותאמת שנטענה.
מאפיינים
BANNER
מודעת באנר.
CUSTOM_NATIVE
מודעה בפורמט מותאם אישית של מודעה מותאמת.
NATIVE
מודעה מותאמת.

NativeMediaAspectRatio

NativeMediaAspectRatio: typeof NativeMediaAspectRatio[keyof typeof NativeMediaAspectRatio]
העדפות לגבי יחס הגובה-רוחב של נכסי מדיה שמוחזרים במודעות מותאמות.
מאפיינים
ANY
אין העדפה לגבי יחס הגובה-רוחב של המדיה במודעה המקורית שהוחזרה.
LANDSCAPE
בקשה ליחס גובה-רוחב לרוחב עבור המדיה של המודעה המקורית שהוחזרה.
PORTRAIT
שליחת בקשה ליחס גובה-רוחב לאורך עבור המדיה של המודעה המקורית שהוחזרה.
SQUARE
שליחת בקשה ליחס גובה-רוחב ריבועי למדיה של המודעה המותאמת שהוחזרה.
UNKNOWN
יחס הגובה-רוחב לא ידוע.

OnAdInspectorClosedListener

OnAdInspectorClosedListener: ((error?) => void)
הגדרת ממשק לקריאה חוזרת שתופעל כשממשק המשתמש של הכלי לבדיקת מודעות ייסגר.

PrecisionType

PrecisionType: typeof PrecisionType[keyof typeof PrecisionType]
רמת הדיוק של ערך המודעה שדווח.
מאפיינים
ESTIMATED
הערך המשוער של המודעה על סמך נתונים נצברים.
PRECISE
הערך המדויק ששולם על המודעה הזו.
PUBLISHER_PROVIDED
ערך מודעה שסופק על ידי בעל האפליקציה, כמו עלויות לאלף חשיפות שהוגדרו ידנית בקבוצה לבחירת רשת (Mediation).
UNKNOWN
ערך המודעה עם רמת דיוק לא ידועה.

PrivacyOptionsRequirementStatus

PrivacyOptionsRequirementStatus: typeof PrivacyOptionsRequirementStatus[keyof typeof PrivacyOptionsRequirementStatus]
סטטוס הדרישה בנושא אפשרויות פרטיות.
מאפיינים
NOT_REQUIRED
לא נדרשת נקודת כניסה לאפשרויות הפרטיות.
REQUIRED
חובה להטמיע נקודת כניסה לאפשרויות הפרטיות.
UNKNOWN
סטטוס הדרישה של אפשרויות הפרטיות לא ידוע.

PublisherPrivacyPersonalizationState

PublisherPrivacyPersonalizationState: typeof PublisherPrivacyPersonalizationState[keyof typeof PublisherPrivacyPersonalizationState]
מציין את מצבי ההתאמה האישית של אמצעי ההגנה על הפרטיות של בעל התוכן הדיגיטלי.
מאפיינים
DEFAULT
מציין שבקשה להצגת מודעה צריכה לקבל את הטיפול שמוגדר כברירת מחדל בנושא פרטיות של בעלי תוכן דיגיטלי.
DISABLED
מציין שבקשה להצגת מודעה צריכה לקבל טיפול בנושא פרטיות שמותאם לבעלי תוכן דיגיטלי ללא התאמה אישית.
ENABLED
מציין שהבקשה להצגת מודעה צריכה לקבל טיפול בהתאם למדיניות הפרטיות של בעלי האפליקציה.

ResizeMode

ResizeMode: typeof ResizeMode[keyof typeof ResizeMode]
אפשרויות להתאמה אישית של מצב שינוי הגודל של תוכן תמונה ב-NativeAdMediaView.
מאפיינים
CONTAIN
התמונה מותאמת באופן אחיד כך שתתאים לתצוגה.

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

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

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

ResolvedAdSize

ResolvedAdSize: FixedAdSize | FluidAdSize
מייצג את המצב הסופי של גודל המודעה אחרי שהמודעה נטענה.

ברוב המודעות, הערך הזה הוא FixedAdSize עם מידות מדויקות של width ו-height. במקרה של מודעות באנר בגודל דינמי, הערך שמתקבל הוא FluidAdSize, והמידות מנוהלות על ידי היררכיית התצוגה.

SwipeGestureDirection

SwipeGestureDirection: typeof SwipeGestureDirection[keyof typeof SwipeGestureDirection]
הוראות לתנועות החלקה מותאמות אישית לקליקים.
מאפיינים
DOWN
להחליק למטה.
LEFT
מחליקים שמאלה.
RIGHT
מחליקים ימינה.
UP
מחליקים למעלה.

משתנים

AdSize

AdSize: {
  BANNER: FixedAdSize;
  custom: ((width, height) => FixedAdSize);
  FLUID: FluidAdSize;
  FULL_BANNER: FixedAdSize;
  getCurrentOrientationInlineAdaptiveBannerAdSize: ((width) => InlineAdaptiveAdSize);
  getInlineAdaptiveBannerAdSize: ((width, maxHeight) => InlineAdaptiveAdSize);
  getLandscapeInlineAdaptiveBannerAdSize: ((width) => InlineAdaptiveAdSize);
  getLargeAnchoredAdaptiveBannerAdSize: ((width) => Promise<LargeAnchoredAdaptiveAdSize>);
  getLargeLandscapeAnchoredAdaptiveBannerAdSize: ((width) => Promise<LargeAnchoredAdaptiveAdSize>);
  getLargePortraitAnchoredAdaptiveBannerAdSize: ((width) => Promise<LargeAnchoredAdaptiveAdSize>);
  getPortraitInlineAdaptiveBannerAdSize: ((width) => InlineAdaptiveAdSize);
  LARGE_BANNER: FixedAdSize;
  LEADERBOARD: FixedAdSize;
  MEDIUM_RECTANGLE: FixedAdSize;
}
גדלי מודעות שהוגדרו מראש ושיטות עזר ליצירת גדלים מותאמים וגדלים בהתאמה אישית.

פונקציות

canRequestAds

canRequestAds(): boolean
הפונקציה בודקת אם סטטוס ההסכמה הנוכחי מאפשר לכם לשלוח בקשות להצגת מודעות.
החזרות
boolean true אם אפשר לבקש מודעות, false אחרת.

getConsentStatus

getConsentStatus(): ConsentStatus
קבלת סטטוס ההסכמה הנוכחי של המשתמש.
החזרות
ConsentStatus סטטוס ההסכמה הנוכחי.

getInitializationStatus

getInitializationStatus(): InitializationStatus
מקבלים את סטטוס ההפעלה של ה-SDK.

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

getPrivacyOptionsRequirementStatus

getPrivacyOptionsRequirementStatus(): PrivacyOptionsRequirementStatus
הפונקציה בודקת אם נדרשת נקודת כניסה לאפשרויות הפרטיות באפליקציה שלכם.

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

getRequestConfiguration

getRequestConfiguration(): RequestConfiguration
אחזור ההגדרה הגלובלית של הבקשה.

אפשר להשתמש בשיטה הזו כדי לאחזר את ההגדרה הנוכחית של הבקשה שהוחלה באופן גלובלי.
החזרות
RequestConfiguration ההגדרה הנוכחית של הבקשה הגלובלית.

initialize

initialize(config, onInitializationComplete?): void
הפעלת Google Mobile Ads SDK.

צריך להפעיל את השיטה הזו לפני טעינת מודעה ולפני אינטראקציה עם שאר הרכיבים של Google Mobile Ads SDK.
פרמטרים
config: InitializationConfig אפשרויות לשליטה בהפעלה של SDK.
Optional onInitializationComplete: ((status) => void) פונקציית קריאה חוזרת להרצה כשהאתחול של ה-SDK מסתיים.

isConsentFormAvailable

isConsentFormAvailable(): boolean
בודק אם טופס הסכמה זמין.
החזרות
boolean true אם יש טופס הסכמה, false אחרת.

loadAndShowConsentFormIfRequired

loadAndShowConsentFormIfRequired(onDismissed?): void
טוען טופס הסכמה ומציג אותו למשתמש אם סטטוס ההסכמה הנוכחי שלו מחייב זאת (למשל, הסטטוס הוא REQUIRED).
פרמטרים
Optional onDismissed: ((error?) => void) פונקציית קריאה חוזרת שמופעלת כשהטופס נסגר או אם לא נדרש טופס, עם FormError אופציונלי אם ההצגה נכשלה.

openAdInspector

openAdInspector(_listener): void
הפונקציה פותחת את שכבת העל של הכלי לבדיקת מודעות ב-Google Mobile Ads SDK.

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

openDebugMenu

openDebugMenu(adUnitId): void
פותח את תפריט ניפוי הבאגים.

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

parseLoadAdError

parseLoadAdError(error): LoadAdError
מנתח שגיאה מקורית שמוחזרת במהלך טעינת המודעה ועוטף אותה ב-LoadAdError.
פרמטרים
error: unknown אובייקט השגיאה שנוצר על ידי המודול המקורי.
החזרות
LoadAdError אובייקט LoadAdError שנותח.

requestConsentInfoUpdate

requestConsentInfoUpdate(params?, onComplete?): void
שליחת בקשה לעדכון פרטי ההסכמה.

חובה להפעיל את ה-API הזה בכל סשן של האפליקציה לפני שמפעילים את getConsentStatus.

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

אפשר לעדכן שוב את getConsentStatus לסטטוס העדכני אחרי שמפעילים את הקריאה החוזרת onComplete.
פרמטרים
Optional params: ConsentRequestParameters הגדרות אופציונליות לניפוי באגים ולטירגוט.
Optional onComplete: ((error?) => void) פונקציית קריאה חוזרת שמופעלת כשעדכון פרטי ההסכמה מסתיים, עם FormError אופציונלי אם הבקשה נכשלה.

איפוס

reset(): void
מנקה את כל מצב ההסכמה מאחסון מתמיד.

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

setPublisherFirstPartyIdEnabled

setPublisherFirstPartyIdEnabled(enabled): void
ההגדרה הזו קובעת אם המזהה הישיר מבעל התוכן הדיגיטלי מופעל.

ההגדרה הזו מפעילה או משביתה את המזהה הישיר מבעל התוכן הדיגיטלי ב-Google Mobile Ads SDK, שנקרא בעבר מפתח אפליקציה זהה (SameAppKey).
ראה גם
פרמטרים
enabled: boolean הערך True מפעיל את המזהה הישיר מבעל התוכן הדיגיטלי, והערך False משבית אותו. ברירת המחדל היא true.

setRequestConfiguration

setRequestConfiguration(_config): void
השיטה הזו מגדירה את התצורה הגלובלית של הבקשה לצורך תאימות וטירגוט.

אפשר להשתמש בשיטה הזו כדי לציין פרטי טירגוט, כמו סיווג מקסימלי לתוכן המודעה, הגדרות תאימות כמו תג הגבלות שקשורות לגיל (TFAT) ומזהי מכשירי בדיקה.
פרמטרים
_config: RequestConfiguration

setUserControlledAppVolume

setUserControlledAppVolume(volume): void
השיטה הזו מגדירה את עוצמת הקול של האודיו באפליקציה שבשליטת המשתמש.

אפשר להשתמש בה כדי לשנות את עוצמת הקול של כל המודעות ביחס לפלט אודיו אחר במכשיר.
פרמטרים
volume: number רמת עוצמת הקול, בין 0.0 (ללא קול) ל-1.0 (מקסימום). כל ערך של נקודה צפה בטווח הזה הוא תקין (לדוגמה, 0.001 או 0.33333). הערך לא מוגבל לתוספות של גודל צעד ספציפי, כמו 0.1.

setUserMutedApp

setUserMutedApp(muted): void
קובעת אם האפליקציה מושתקת.

משתמשים בשיטה הזו כדי לשלוט במצב ההשתקה הראשוני של האודיו במודעות הבאות.
פרמטרים
muted: boolean האם להשתיק את האודיו של האפליקציה. ברירת המחדל היא false.

showPrivacyOptionsForm

showPrivacyOptionsForm(onDismissed?): void
הצגת הטופס של אפשרויות הפרטיות.

הצגת טופס של אפשרויות פרטיות אם הערך של getPrivacyOptionsRequirementStatus הוא REQUIRED.

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

טופס אפשרויות הפרטיות נטען מראש על ידי ה-SDK באופן אוטומטי כשהטופס הופך לזמין. אם לא נטען מראש טופס, ה-SDK ינסה לטעון טופס באופן אסינכרוני.

הקריאה החוזרת onDismissed מתבצעת אחרי שהטופס מוצג למשתמש, אחרי שהוא בוחר אפשרות ואחרי שהוא סוגר את הטופס. היא יכולה גם להחזיר FormError אם:
  • הטופס לא זמין.
  • הטופס לא מוצג.
  • הטופס עדיין נטען מראש.
פרמטרים
Optional onDismissed: ((error?) => void) פונקציית קריאה חוזרת שמופעלת כשהטופס נסגר, עם FormError אופציונלי אם הצגת הטופס נכשלה.