Google Mobile Ads React Native API

Das Modul @google/mobile-ads bietet die wichtigsten TypeScript-Schnittstellen, -Klassen und -Funktionen der obersten Ebene für die Integration von Google Mobile Ads in React Native-Anwendungen.

Übersicht

Typaliasse
AdapterState
Stellt die möglichen Initialisierungsstatus eines Vermittlungsadapters dar.
AdChoicesPlacement
Positionen für das Datenschutzinfo-Symbol in der Anzeigenansicht.
AdFormat
Das Format der angeforderten Anzeige.
AdInspectorError
Fehlerinformationen dazu, warum das Anzeigenprüftool fehlgeschlagen ist.
AdInspectorErrorCode
Fehler, die sich auf das Öffnen oder den Betrieb des Anzeigenprüftools auswirken.
AdOrientation
Ausrichtungsoptionen für adaptive Inline-Banneranzeigen und große adaptive Ankerbanneranzeigen.
AdSize
Stellt die Abmessungen einer Anzeige dar.
AgeRestrictedTreatment
Definiert die Optionen für die Altersbeschränkung für Anzeigenanfragen.
ConsentStatus
Werte für den Einwilligungsstatus.
DebugGeography
Debug-Werte für geografische Tests.
FormErrorCode
Stellt Fehlercodes für Fehler bei UMP-Formularvorgängen (User Messaging Platform) dar.
FullScreenContentErrorCode
LoadAdErrorCode
Stellt Fehlercodes für Fehler beim Laden von Anzeigen dar.
MaxAdContentRating
Definiert die höchste Altersfreigabe für Anzeigeninhalte für die App und klassifiziert die Arten von Anzeigen, die ausgeliefert werden können.
NativeAdAssetNames
Namen, die zum Identifizieren von Standard-Assets für native Anzeigen verwendet werden.
NativeAdType
Gibt das Format einer geladenen nativen Anzeige an.
NativeMediaAspectRatio
Einstellungen für das Seitenverhältnis der zurückgegebenen Media für native Anzeigen.
OnAdInspectorClosedListener
Schnittstellendefinition für einen Callback, der aufgerufen wird, wenn die Benutzeroberfläche des Anzeigeninspektors geschlossen wird.
PrecisionType
Die Genauigkeit des gemeldeten Anzeigenwerts.
PrivacyOptionsRequirementStatus
Status der Anforderungen an Datenschutzoptionen.
PublisherPrivacyPersonalizationState
Gibt die Personalisierungsstatus für Publisher Privacy Treatment an.
ResizeMode
Optionen zum Anpassen des Skalierungsmodus von Bildinhalten in „NativeAdMediaView“.
ResolvedAdSize
Stellt den endgültigen aufgelösten Status einer Anzeigengröße nach dem Laden einer Anzeige dar.
SwipeGestureDirection
Anleitung für benutzerdefinierte Klick- und Wischgesten.
Variablen
AdSize
Vordefinierte Anzeigengrößen und Hilfsmethoden zum Erstellen responsiver und benutzerdefinierter Größen.
Funktionen
canRequestAds
Prüft, ob der aktuelle Einwilligungsstatus das Anfordern von Anzeigen zulässt.
getConsentStatus
Ruft den aktuellen Einwilligungsstatus des Nutzers ab.
getInitializationStatus
Gibt den Initialisierungsstatus des SDK zurück.
getPrivacyOptionsRequirementStatus
Prüft, ob für Ihre App ein Einstiegspunkt für die Datenschutzoptionen erforderlich ist.
getRequestConfiguration
Ruft die globale Anfragekonfiguration ab.
initialize
Initialisiert das Google Mobile Ads SDK.
isConsentFormAvailable
Prüft, ob ein Einwilligungsformular verfügbar ist.
loadAndShowConsentFormIfRequired
Lädt ein Einwilligungsformular und präsentiert es dem Nutzer, wenn sein aktueller Einwilligungsstatus dies erfordert (z.B. wenn der Status „REQUIRED“ ist).
openAdInspector
Öffnet das Overlay des Anzeigenprüftools im Google Mobile Ads SDK.
openDebugMenu
Öffnet das Debug-Menü.
parseLoadAdError
Parst einen nativen Fehler, der beim Laden von Anzeigen ausgelöst wird, und umschließt ihn mit einem LoadAdError.
requestConsentInfoUpdate
Fordert eine Aktualisierung der Einwilligungsinformationen an.
reset
Löscht den gesamten Einwilligungsstatus aus dem nichtflüchtigen Speicher.
setPublisherFirstPartyIdEnabled
Steuert, ob die eigene Publisher-ID aktiviert ist.
setRequestConfiguration
Legt die globale Anfragekonfiguration für Compliance und Targeting fest.
setUserControlledAppVolume
Legt die Audiolautstärke der vom Nutzer gesteuerten Anwendung fest.
setUserMutedApp
Legt fest, ob die Anwendung stummgeschaltet ist.
showPrivacyOptionsForm
Zeigt das Formular für Datenschutzoptionen an.

Typaliasse

AdapterState

AdapterState: typeof AdapterState[keyof typeof AdapterState]
Stellt die möglichen Initialisierungsstatus eines Vermittlungsadapters dar.
Attribute
NOT_READY
Gibt an, dass der Vermittlungsadapter noch nicht initialisiert wurde oder die Initialisierung fehlgeschlagen ist.
READY
Gibt an, dass der Vermittlungsadapter erfolgreich initialisiert wurde und bereit ist, Anzeigen auszuliefern.

AdChoicesPlacement

AdChoicesPlacement: typeof AdChoicesPlacement[keyof typeof AdChoicesPlacement]
Positionen für das Datenschutzinfo-Symbol in der Anzeigenansicht.
Attribute
BOTTOM_LEFT
Linke untere Ecke der Anzeige.
BOTTOM_RIGHT
Rechte untere Ecke der Anzeige.
TOP_LEFT
Linke obere Ecke der Anzeige.
TOP_RIGHT
Oben rechts in der Anzeige.

AdFormat

AdFormat: typeof AdFormat[keyof typeof AdFormat]
Das Format der angeforderten Anzeige.
Attribute
APP_OPEN
App-Start-Anzeigenformat
BANNER
Banneranzeigenformat
INTERSTITIAL
Interstitial-Anzeigenformat
NATIVE
Natives Anzeigenformat.
REWARDED
Anzeigenformat mit Prämie.
REWARDED_INTERSTITIAL
Anzeigenformat „Interstitial-Anzeige mit Prämie“

AdInspectorError

AdInspectorError: BaseError<AdInspectorErrorCode>
Fehlerinformationen dazu, warum das Anzeigenprüftool fehlgeschlagen ist.

AdInspectorErrorCode

AdInspectorErrorCode: typeof AdInspectorErrorCode[keyof typeof AdInspectorErrorCode]
Fehler, die sich auf das Öffnen oder den Betrieb des Anzeigenprüftools auswirken.
Attribute
ALREADY_OPEN
Der Anzeigenprüftool kann nicht geöffnet werden, da er bereits geöffnet ist.
FAILED_TO_LOAD
Das Anzeigenprüftool konnte nicht geladen werden.
INTERNAL_ERROR
Im Anzeigenprüftool ist ein interner Fehler aufgetreten.
NOT_IN_TEST_MODE
Das Anzeigenprüftool kann nicht geöffnet werden, da sich das Gerät nicht im Testmodus befindet.

AdOrientation

AdOrientation: typeof AdOrientation[keyof typeof AdOrientation]
Ausrichtungsoptionen für adaptive Inline-Banneranzeigen und große adaptive Ankerbanneranzeigen.
Attribute
CURRENT
LANDSCAPE
PORTRAIT

AdSize

Stellt die Abmessungen einer Anzeige dar.

Kann eine vordefinierte Größe (z.B. AdSize.LARGE_BANNER) oder eine adaptive Größe sein.

AgeRestrictedTreatment

AgeRestrictedTreatment: typeof AgeRestrictedTreatment[keyof typeof AgeRestrictedTreatment]
Definiert die Optionen für die Altersbeschränkung für Anzeigenanfragen.
Attribute
CHILD
Gibt an, dass Anzeigenanfragen eine Alterskennzeichnung für Kinder erhalten sollen.
TEEN
Gibt an, dass Anzeigenanfragen eine Alterskennzeichnung für Teenager erhalten sollen.
UNSPECIFIED
Gibt an, dass für die Anzeigenanfrage kein bestimmtes Signal für die Behandlung von Inhalten mit Altersbeschränkung gilt.

ConsentStatus

ConsentStatus: typeof ConsentStatus[keyof typeof ConsentStatus]
Werte für den Einwilligungsstatus.
Attribute
NOT_REQUIRED
Keine Einwilligung erforderlich.
OBTAINED
Eingeholte Nutzereinwilligung, personalisiert im Vergleich zu nicht personalisiert undefined.
REQUIRED
Die Nutzereinwilligung ist erforderlich, wurde aber noch nicht eingeholt.
UNKNOWN
Unbekannter Einwilligungsstatus.

DebugGeography

DebugGeography: typeof DebugGeography[keyof typeof DebugGeography]
Debug-Werte für geografische Tests.
Attribute
DISABLED
Die Debug-Geografie ist für Debug-Geräte deaktiviert.
EEA
Die geografische Einheit wird auf Debugging-Geräten wie im EWR angezeigt.
OTHER
Die geografische Einheit wird als Region ohne geltende Verordnung für das Debugging-Gerät angezeigt.
REGULATED_US_STATE
Die geografische Einheit wird auf Debugging-Geräten wie in einem regulierten US-Bundesstaat angezeigt.

FormErrorCode

FormErrorCode: typeof FormErrorCode[keyof typeof FormErrorCode]
Stellt Fehlercodes für fehlgeschlagene Vorgänge im UMP-Formular (User Messaging Platform) dar.
Attribute
ALREADY_USED
Das Einwilligungsformular wurde bereits verwendet.
INTERNAL_ERROR
Im SDK ist ein interner Fehler aufgetreten.
INVALID_OPERATION
Der Vorgang war ungültig.
NETWORK_ERROR
Der Formularvorgang ist aufgrund der Netzwerkverbindung fehlgeschlagen.
TIMEOUT
Zeitüberschreitung beim Formularvorgang.
UNAVAILABLE
Es ist kein Einwilligungsformular verfügbar.
UNKNOWN
Der Fehlercode konnte keinem bekannten Fehlercode zugeordnet werden.

FullScreenContentErrorCode

FullScreenContentErrorCode: typeof FullScreenContentErrorCode[keyof typeof FullScreenContentErrorCode]
Attribute
AD_ALREADY_USED
Die Anzeige wurde bereits ausgeliefert.
AD_NOT_READY
Die Anzeige ist noch nicht bereit für die Auslieferung.
AD_TOO_LARGE
Die Anzeige ist zu groß für die Szene (nur iOS).
APP_NOT_FOREGROUND
Die App befindet sich nicht im Vordergrund.
INTERNAL_ERROR
Ein interner Fehler ist aufgetreten, z. B. eine Ausnahme beim Vorbereiten der Anzeigeinhalte.
MEDIATION_ERROR
Der Vermittlungsadapter konnte die Anzeige nicht präsentieren. Den zugrunde liegenden Grund finden Sie unter FullScreenContentError.mediationAdError.
UNKNOWN
Der Fehlercode konnte keinem bekannten Fehlercode zugeordnet werden.

LoadAdErrorCode

LoadAdErrorCode: typeof LoadAdErrorCode[keyof typeof LoadAdErrorCode]
Stellt Fehlercodes für Fehler beim Laden von Anzeigen dar.
Attribute
AD_ALREADY_USED
Die Anzeigenantwort wurde bereits zum Laden einer Anzeige verwendet.
APP_ID_MISSING
Die Anzeigenanfrage wurde nicht gestellt, weil die Anwendungs-ID fehlt.
CANCELLED
Die Anzeigenanfrage wurde abgebrochen (nur Android).
INTERNAL_ERROR
Im SDK ist ein interner Fehler aufgetreten.
INVALID_REQUEST
Die Anzeigenanfrage war ungültig, z. B. weil die Anzeigenblock-ID falsch war.
INVALID_RESPONSE
Die Server-zu-Server-Anzeigenantwort ist ungültig. Beispiel: Die Anzeigenantwort enthält keine Anfrage-ID.
MEDIATION_ERROR
Der Vermittlungsadapter wurde nicht gefunden oder die Anzeigenanfrage konnte nicht ausgeführt werden.
NETWORK_ERROR
Die Anzeigenanfrage war aufgrund der Netzwerkverbindung nicht erfolgreich.
NO_FILL
Die Anzeigenanfrage war erfolgreich, aber es wurde kein Anzeigeninventar zurückgegeben.
TIMEOUT
Zeitüberschreitung bei der Anzeigenanfrage.
UNKNOWN
Der Fehlercode konnte keinem bekannten Fehlercode zugeordnet werden.

MaxAdContentRating

MaxAdContentRating: typeof MaxAdContentRating[keyof typeof MaxAdContentRating]
Definiert die höchste Altersfreigabe für Anzeigeninhalte für die App und klassifiziert die Arten von Anzeigen, die ausgeliefert werden können.
Attribute
G
Inhalte, die für alle Zielgruppen, einschließlich Familien und Kinder, geeignet sind.
MA
Nur für Erwachsene geeigneter Content.
PG
Content ist für Nutzer unter elterlicher Aufsicht geeignet.
T
Für Teenager und ältere Zielgruppen geeignet.
UNSPECIFIED
Keine Altersfreigabe angegeben.

NativeAdAssetNames

NativeAdAssetNames: typeof NativeAdAssetNames[keyof typeof NativeAdAssetNames]
Namen, die zum Identifizieren von Standard-Assets für native Anzeigen verwendet werden.
Attribute
ADCHOICES_CONTAINER_VIEW
Der Container für das Datenschutzinfo-Overlay.
ADVERTISER
Der Name des Werbetreibenden.
BODY
Der Haupttext der Anzeige.
CALL_TO_ACTION
Der Call-to-Action-Text für die Anzeige, z. B. „Installieren“ oder „Weitere Informationen“.
HEADLINE
Der Titel der Anzeige.
ICON
Das Symbolbild für die Anzeige.
MEDIA_CONTENT
Der primäre Media-Inhalt der Anzeige (Bild oder Video).
PRICE
Der Preis der beworbenen App oder des beworbenen Produkts.
STAR_RATING
Die Sternebewertung für die beworbene App oder das beworbene Produkt.
STORE
Der Name des Geschäfts.

NativeAdType

NativeAdType: typeof NativeAdType[keyof typeof NativeAdType]
Gibt das Format einer geladenen nativen Anzeige an.
Attribute
BANNER
Banneranzeige.
CUSTOM_NATIVE
Anzeige im benutzerdefinierten nativen Format.
NATIVE
Native Anzeige

NativeMediaAspectRatio

NativeMediaAspectRatio: typeof NativeMediaAspectRatio[keyof typeof NativeMediaAspectRatio]
Einstellungen für das Seitenverhältnis der zurückgegebenen Media für native Anzeigen.
Attribute
ANY
Keine Präferenz für das Seitenverhältnis der zurückgegebenen nativen Anzeigenmedien.
LANDSCAPE
Fordert ein Querformat für die zurückgegebenen nativen Anzeigenmedien an.
PORTRAIT
Fordern Sie ein Hochformat für die zurückgegebenen nativen Anzeigenmedien an.
SQUARE
Fordern Sie ein quadratisches Seitenverhältnis für die zurückgegebenen nativen Anzeigenmedien an.
UNKNOWN
Das Seitenverhältnis ist unbekannt.

OnAdInspectorClosedListener

OnAdInspectorClosedListener: ((error?) => void)
Schnittstellendefinition für einen Callback, der aufgerufen wird, wenn die Benutzeroberfläche des Anzeigeninspektors geschlossen wird.

PrecisionType

PrecisionType: typeof PrecisionType[keyof typeof PrecisionType]
Die Genauigkeit des gemeldeten Anzeigenwerts.
Attribute
ESTIMATED
Ein Anzeigenwert, der anhand von aggregierten Daten geschätzt wird.
PRECISE
Der genaue Wert, der für diese Anzeige gezahlt wird.
PUBLISHER_PROVIDED
Ein vom Publisher bereitgestellter Anzeigenwert, z. B. manuelle CPMs in einer Vermittlungsgruppe.
UNKNOWN
Ein Anzeigenwert mit unbekannter Genauigkeit.

PrivacyOptionsRequirementStatus

PrivacyOptionsRequirementStatus: typeof PrivacyOptionsRequirementStatus[keyof typeof PrivacyOptionsRequirementStatus]
Status der Anforderungen an Datenschutzoptionen.
Attribute
NOT_REQUIRED
Ein Einstiegspunkt für Datenschutzoptionen ist nicht erforderlich.
REQUIRED
Ein Einstiegspunkt für Datenschutzoptionen ist erforderlich.
UNKNOWN
Der Status der Datenschutzoptionen ist unbekannt.

PublisherPrivacyPersonalizationState

PublisherPrivacyPersonalizationState: typeof PublisherPrivacyPersonalizationState[keyof typeof PublisherPrivacyPersonalizationState]
Gibt die Personalisierungsstatus für Publisher Privacy Treatment an.
Attribute
DEFAULT
Gibt an, dass die Anzeigenanfrage die Standardeinstellungen für den Datenschutz des Publishers erhalten soll.
DISABLED
Gibt an, dass für die Anzeigenanfrage die Datenschutzbehandlung für Publisher für nicht personalisierte Anzeigen gelten soll.
ENABLED
Gibt an, dass die Anzeigenanfrage die personalisierte Datenschutzbehandlung für Publisher erhalten soll.

ResizeMode

ResizeMode: typeof ResizeMode[keyof typeof ResizeMode]
Optionen zum Anpassen des Skalierungsmodus von Bildinhalten in „NativeAdMediaView“.
Attribute
CONTAIN
Gleichmäßig skalieren, damit das Bild in die Ansicht passt.

Höhe und Breite des Bildes werden gemeinsam skaliert, sodass jede Dimension kleiner oder gleich der entsprechenden Dimension der Ansicht ist. Das Bild wird so skaliert, dass es in die Ansicht passt, ohne dass das Seitenverhältnis verzerrt oder das Bild zugeschnitten wird.
COVER
Gleichmäßig skalieren, um die Ansicht abzudecken.

Bildhöhe und -breite werden gemeinsam skaliert, sodass jede Dimension gleich oder größer als die entsprechende Dimension der Ansicht ist. Das Bild wird so zugeschnitten, dass es in die Ansicht passt, ohne dass sich das Seitenverhältnis ändert.
STRETCH
Breite und Höhe werden unabhängig voneinander skaliert, um die Ansicht auszufüllen.

Bildhöhe und ‑breite werden separat skaliert, um den Abmessungen der Ansicht zu entsprechen. Das Bild wird so skaliert, dass es die Ansicht vollständig ausfüllt, ohne zugeschnitten zu werden. Das Seitenverhältnis des Bilds wird jedoch nicht beibehalten.

ResolvedAdSize

ResolvedAdSize: FixedAdSize | FluidAdSize
Stellt den endgültigen aufgelösten Status einer Anzeigengröße dar, nachdem eine Anzeige geladen wurde.

Bei den meisten Anzeigen wird dies zu einer FixedAdSize mit den genauen Abmessungen width und height aufgelöst. Bei dynamisch dimensionierten Banneranzeigen wird dies zu einer FluidAdSize aufgelöst, wobei die Dimensionen von der Ansichtshierarchie verwaltet werden.

SwipeGestureDirection

SwipeGestureDirection: typeof SwipeGestureDirection[keyof typeof SwipeGestureDirection]
Anleitung für benutzerdefinierte Klick- und Wischgesten.
Attribute
DOWN
Wische nach unten.
LEFT
Wischen Sie nach links.
RIGHT
Wischen Sie nach rechts.
UP
Wischen Sie nach oben.

Variablen

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;
}
Vordefinierte Anzeigengrößen und Hilfsmethoden zum Erstellen responsiver und benutzerdefinierter Größen.

Funktionen

canRequestAds

canRequestAds(): boolean
Prüft, ob der aktuelle Einwilligungsstatus das Anfordern von Anzeigen zulässt.
Ausgabe
boolean true, wenn Sie Anzeigen anfordern können, false andernfalls.

getConsentStatus

getConsentStatus(): ConsentStatus
Ruft den aktuellen Einwilligungsstatus des Nutzers ab.
Ausgabe
ConsentStatus Der aktuelle Einwilligungsstatus.

getInitializationStatus

getInitializationStatus(): InitializationStatus
Gibt den Initialisierungsstatus des SDK zurück.

Mit dieser Methode können Sie prüfen, ob die Initialisierung des SDK abgeschlossen ist, und den Status einzelner Vermittlungsadapter abrufen.
Ausgabe
InitializationStatus Der aktuelle Initialisierungsstatus.

getPrivacyOptionsRequirementStatus

getPrivacyOptionsRequirementStatus(): PrivacyOptionsRequirementStatus
Prüft, ob für Ihre App ein Einstiegspunkt für Datenschutzoptionen erforderlich ist.

Wenn ein Einstiegspunkt erforderlich ist, fügen Sie Ihrer App ein sichtbares und interaktives UI-Element hinzu, das showPrivacyOptionsForm aufruft, um das Formular für Datenschutzoptionen anzuzeigen. Wenn kein Einstiegspunkt erforderlich ist, konfigurieren Sie das UI-Element so, dass es nicht sichtbar und nicht interaktiv ist.
Ausgabe
PrivacyOptionsRequirementStatus Der Status der Anforderungen an die Datenschutzoptionen.

getRequestConfiguration

getRequestConfiguration(): RequestConfiguration
Ruft die globale Anfragekonfiguration ab.

Verwenden Sie diese Methode, um die aktuelle Anfragekonfiguration abzurufen, die global angewendet wurde.
Ausgabe
RequestConfiguration Die aktuelle globale Anfragekonfiguration.

initialize

initialize(config, onInitializationComplete?): void
Initialisiert das Google Mobile Ads SDK.

Rufen Sie diese Methode auf, bevor Sie eine Anzeige laden und bevor Sie mit dem Rest des Google Mobile Ads SDK interagieren.
Parameter
config: InitializationConfig Optionen zum Steuern der SDK-Initialisierung.
Optional onInitializationComplete: ((status) => void) Eine Callback-Funktion, die ausgeführt wird, wenn die Initialisierung des SDK abgeschlossen ist.

isConsentFormAvailable

isConsentFormAvailable(): boolean
Prüft, ob ein Einwilligungsformular verfügbar ist.
Ausgabe
boolean true, wenn ein Einwilligungsformular verfügbar ist, andernfalls false.

loadAndShowConsentFormIfRequired

loadAndShowConsentFormIfRequired(onDismissed?): void
Lädt ein Einwilligungsformular und präsentiert es dem Nutzer, wenn sein aktueller Einwilligungsstatus dies erfordert (z.B. wenn der Status „REQUIRED“ ist).
Parameter
Optional onDismissed: ((error?) => void) Callback-Funktion, die aufgerufen wird, wenn das Formular geschlossen wird oder kein Formular erforderlich ist. Sie enthält optional einen FormError, wenn die Präsentation fehlgeschlagen ist.

openAdInspector

openAdInspector(_listener): void
Öffnet das Overlay des Anzeigenprüftools im Google Mobile Ads SDK.

Mit dieser Methode können Sie Vermittlungseinrichtungen und Anzeigenquellen debuggen.
Parameter
_listener: OnAdInspectorClosedListener

openDebugMenu

openDebugMenu(adUnitId): void
Öffnet das Debug-Menü.

Mit dieser Methode können Sie das Debug-Menü für einen bestimmten Anzeigenblock öffnen, um Anzeigenkonfigurationen zu testen und Fehler zu beheben.
Parameter
adUnitId: string Die Anzeigenblock-ID, für die das Menü zur Fehlerbehebung geöffnet werden soll.

parseLoadAdError

parseLoadAdError(error): LoadAdError
Parst einen nativen Fehler, der beim Laden von Anzeigen ausgelöst wird, und umschließt ihn mit einem LoadAdError.
Parameter
error: unknown Das vom nativen Modul ausgelöste Fehlerobjekt.
Ausgabe
LoadAdError Ein geparstes LoadAdError-Objekt.

requestConsentInfoUpdate

requestConsentInfoUpdate(params?, onComplete?): void
Fordert eine Aktualisierung der Einwilligungsinformationen an.

Diese API muss in jeder App-Sitzung aufgerufen werden, bevor getConsentStatus aufgerufen wird.

Nachdem diese API aufgerufen wurde, wird der Rückgabewert von getConsentStatus synchron aktualisiert, um den Einwilligungsstatus aus der vorherigen App-Sitzung zu enthalten, sofern eine vorhanden ist.

getConsentStatus kann nach dem Aufruf des onComplete-Callbacks noch einmal auf den aktuellen Status aktualisiert werden.
Parameter
Optional params: ConsentRequestParameters Optionale Konfigurationen für die Fehlerbehebung und das Targeting.
Optional onComplete: ((error?) => void) Callback-Funktion, die aufgerufen wird, wenn die Aktualisierung der Einwilligungsinformationen abgeschlossen ist. Optional wird ein FormError zurückgegeben, wenn die Anfrage fehlgeschlagen ist.

Zurücksetzen

reset(): void
Löscht den gesamten Einwilligungsstatus aus dem nichtflüchtigen Speicher.

Nur zu Debugging-Zwecken verwenden.

setPublisherFirstPartyIdEnabled

setPublisherFirstPartyIdEnabled(enabled): void
Legt fest, ob die eigene Publisher-ID aktiviert ist.

Aktiviert oder deaktiviert die eigene Publisher-ID im Google Mobile Ads SDK, die früher als App-interner Schlüssel (SameAppKey) bezeichnet wurde.
Weitere Informationen
Parameter
enabled: boolean „true“, um die eigene Publisher-ID zu aktivieren, „false“, um sie zu deaktivieren. Die Standardeinstellung ist true.

setRequestConfiguration

setRequestConfiguration(_config): void
Legt die globale Anfragekonfiguration für Compliance und Targeting fest.

Mit dieser Methode können Sie Targeting-Details wie die höchste Altersfreigabe für Anzeigeninhalte, Compliance-Einstellungen wie das Tag für die Alterskennzeichnung und Testgeräte-IDs angeben.
Parameter
_config: RequestConfiguration

setUserControlledAppVolume

setUserControlledAppVolume(volume): void
Legt die vom Nutzer gesteuerte Lautstärke der Anwendung fest.

Verwenden Sie diese Methode, um die Lautstärke aller Anzeigen im Verhältnis zu anderen Audioausgaben auf dem Gerät anzupassen.
Parameter
volume: number Die Lautstärke zwischen 0,0 (stumm) und 1,0 (maximal). Jeder Gleitkommawert in diesem Bereich ist gültig (z.B.0,001 oder 0,33333). Der Wert ist nicht auf bestimmte Schrittgrößen wie 0, 1 beschränkt.

setUserMutedApp

setUserMutedApp(muted): void
Legt fest, ob die Anwendung stummgeschaltet ist.

Verwenden Sie diese Methode, um den anfänglichen Stummschaltungsstatus nachfolgender Anzeigen zu steuern.
Parameter
muted: boolean Gibt an, ob der Audioausgang der Anwendung stummgeschaltet werden soll. Die Standardeinstellung ist false.

showPrivacyOptionsForm

showPrivacyOptionsForm(onDismissed?): void
Zeigt das Formular für Datenschutzoptionen an.

Stellt ein Formular für Datenschutzoptionen bereit, wenn getPrivacyOptionsRequirementStatus REQUIRED ist.

Diese Methode sollte nur als Reaktion auf eine Nutzereingabe aufgerufen werden, um das Formular für Datenschutzoptionen anzuzeigen.

Das Formular für Datenschutzoptionen wird vom SDK automatisch vorab geladen, wenn ein Formular verfügbar ist. Wenn kein Formular vorab geladen wurde, versucht das SDK, eines asynchron zu laden.

Der onDismissed-Callback wird aufgerufen, nachdem dem Nutzer das Formular präsentiert wurde, er eine Option ausgewählt und das Formular geschlossen hat. Es kann auch ein FormError zurückgegeben werden, wenn:
  • Das Formular ist nicht verfügbar.
  • Das Formular wird nicht angezeigt.
  • Das Formular wird noch vorab geladen.
Parameter
Optional onDismissed: ((error?) => void) Callback-Funktion, die aufgerufen wird, wenn das Formular geschlossen wird. Sie enthält optional einen FormError, wenn die Darstellung fehlgeschlagen ist.