Démarrage
Copiez un prompt de configuration avec les étapes d'installation et la guide Markdown complet pour cette extension.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-admob`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/admob/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Installation
Sous-titre « Installation »Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil d'IA en utilisant la commande suivante :
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsEnsuite, utilisez la prompt suivante :
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-admob` plugin in my project.Si vous préférez la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à la plateforme ci-dessous :
bun add @capgo/capacitor-admobbunx cap syncImporter
Section intitulée « Importer »import { AdMob } from '@capgo/capacitor-admob';API Vue d'ensemble
Section intitulée « API Vue d'ensemble »Initialiser et démarrer l'SDK AdMob.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.start();configure
Section intitulée « Configurer »Configurer les paramètres AdMob.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.configure({ appMuted: false, appVolume: 0.5});configRequest
Section intitulée « configRequest »Configurez les paramètres de demande publicitaire.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.configRequest({ maxAdContentRating: MaxAdContentRating.PG, tagForChildDirectedTreatment: true, testDeviceIds: ['test-device-id']});adCreate
Section intitulée « adCreate »Créez une nouvelle instance publicitaire.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adCreate({ adUnitId: 'ca-app-pub-3940256099942544/1033173712'});adIsLoaded
Section intitulée « adIsLoaded »Vérifiez si une publicité est chargée et prête à être affichée.
import { AdMob } from '@capgo/capacitor-admob';
const isLoaded = await AdMob.adIsLoaded({ id: 1 });if (isLoaded) { await AdMob.adShow({ id: 1 });}Chargez une publicité.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adLoad({ id: 1 });Afficher une publicité chargée.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adShow({ id: 1 });Cacher une publicité affichée actuellement.
import { AdMob } from '@capgo/capacitor-admob';
await AdMob.adHide({ id: 1 });trackingAuthorizationStatus
Section intitulée « trackingAuthorizationStatus »Obtenir le statut actuel d'autorisation de suivi (seulement iOS).
import { AdMob } from '@capgo/capacitor-admob';
const { status } = await AdMob.trackingAuthorizationStatus();if (status === TrackingAuthorizationStatus.notDetermined) { await AdMob.requestTrackingAuthorization();}requestTrackingAuthorization
Section intitulée « requestTrackingAuthorization »Demander à l'utilisateur l'autorisation de suivi (seulement iOS).
import { AdMob } from '@capgo/capacitor-admob';
const { status } = await AdMob.requestTrackingAuthorization();console.log('User tracking status:', status);Référence de type
Sous-section intitulée « Référence de type »AdMobConfig
Sous-section intitulée « AdMobConfig »Options de configuration pour AdMob.
export type AdMobConfig = { /** Whether the app should be muted */ appMuted?: boolean; /** The app volume (0.0 to 1.0) */ appVolume?: number;};RequestConfig
Sous-section intitulée « RequestConfig »Configuration des requêtes publicitaires.
export type RequestConfig = { /** Maximum ad content rating */ maxAdContentRating?: MaxAdContentRating; /** Whether to use the same app key */ sameAppKey?: boolean; /** Tag for child-directed treatment (true, false, or null for unspecified) */ tagForChildDirectedTreatment?: boolean | null; /** Tag for under age of consent (true, false, or null for unspecified) */ tagForUnderAgeOfConsent?: boolean | null; /** Array of test device IDs */ testDeviceIds?: string[];};MobileAdOptions
Sous-section intitulée « MobileAdOptions »Options de base pour les publicités mobiles.
export type MobileAdOptions = { /** The ad unit ID from AdMob */ adUnitId: string;};TrackingAuthorizationStatus
Titre de la section « État d'autorisation de suivi »État d'autorisation de suivi pour l'App Tracking Transparency d'iOS.
export enum TrackingAuthorizationStatus { /** User has not yet received an authorization request */ notDetermined = 0, /** User restricted, device is unable to provide authorization */ restricted = 1, /** User denied authorization */ denied = 2, /** User authorized access */ authorized = 3,}MaxAdContentRating
Titre de la section « Note maximale de contenu publicitaire »Énumération de la note maximale de contenu publicitaire utilisée pour restreindre les publicités en fonction de la note de contenu.
export enum MaxAdContentRating { /** General Audiences */ G = 'G', /** Mature Audiences */ MA = 'MA', /** Parental Guidance */ PG = 'PG', /** Teen */ T = 'T', /** Unspecified rating */ UNSPECIFIED = '',}Source de Vérité
Titre de la section « Source de Vérité »Cette page est générée à partir du plugin’s src/definitions.ts. Re-run la synchronisation lorsque la publication API change en amont.
Continuez de la section « Continuez de la section « Commencer » »
Titre de la section « Continuez de la section « Commencer » »Si vous utilisez Prise en main pour planifier votre tableau de bord et les opérations API, connectez-l’à Utilisation de @capgo/capacitor-admob pour la capacité native dans Utilisation de @capgo/capacitor-admob, API Vue d'ensemble pour les détails d'implémentation dans API Vue d'ensemble, Introduction pour les détails d'implémentation dans Introduction, API Clés pour les détails d'implémentation dans API Clés, et Appareils pour les détails d'implémentation sur les appareils.