Integrare l'SDK Google Mobile Ads con gli strumenti di AI

Per ottimizzare Gemini in Android Studio, utilizza un file AGENTS.md nel tuo progetto. Se aggiungi un file AGENTS.md al tuo progetto, fornisci a Gemini un contesto specifico per Google Mobile Ads SDK e migliori l'output della generazione di codice assistita dall'AI. Per maggiori dettagli, vedi Personalizzare Gemini utilizzando i file AGENTS.md.

Questa guida illustra l'ottimizzazione di Gemini in Android Studio per Google Mobile Ads SDK.

Prima di iniziare

Prima di continuare, completa queste operazioni:

Aggiungere il file AGENTS.md al progetto

Google fornisce un file AGENTS.md con le istruzioni per Gemini per aiutarti con i seguenti passaggi di integrazione:

  • Aggiungi Google Mobile Ads SDK al tuo progetto.
  • Implementa gli annunci banner.

Per utilizzare le istruzioni specifiche per Google Mobile Ads SDK in AI Code Assist, segui questi passaggi:

  1. Crea un nuovo file denominato AGENTS.md in qualsiasi punto del file system del progetto.

  2. Nel file AGENTS.md, aggiungi le seguenti istruzioni:

# AI Coding Agent Instructions for the Google Mobile Ads SDK

## Integrate the SDK

*   When I ask to integrate the Google Mobile Ads SDK, **always** use the latest
    stable version for `com.google.android.gms:play-services-ads`.
*   After looking up the latest stable version of
    `com.google.android.gms:play-services-ads`, **always** check the project for
    a version catalog to manage dependencies.
*   Make sure the project meets the SDK requirements of `minSdk` 23 or higher
    and `compileSdk` of 35 or higher.
*   **Always** make sure there is a `<metadata>` tag for application ID in the
    project. If it's not there, add it.
*   You MUST initialize the Google Mobile Ads SDK on a background thread, as
    recommended in the Google Mobile Ads SDK v24.0.0 release notes.

## Banner Ads

*   When I ask to implement a banner ad or something similar, without specifying
    a type, **always** follow up to confirm the type of ad.
*   When I ask for an "anchored adaptive" ad, ask me if I want the ad anchored
    to the top or bottom of the screen.
*   When I ask for an "inline" adaptive banner ad, explain that inline adaptive
    ads are used for scrolling content. If my application has no scrollable view
    elements (e.g. `ScrollView` or `List`), default to implement an anchored
    adaptive banner ad.
*   When I ask for a "collapsible" banner ad, create an extra parameter that
    aligns the expanded ad to the `AdView`. Ask me if I want the ad collapsed to
    the top or bottom.
*   When I ask for a "fixed size" banner ad, **always** ask me if I'm sure or
    would I like to implement an anchored adaptive banner ad. Explain why
    anchored adaptive banner ads perform better than fixed size ads.

*   **Mandatory `AdView` Implementation Steps:**
    *   **Always** provide the code for a UI container intended to host the
        `AdView`.
    *   **Always** call `adView.destroy()` to prevent memory leaks.

## Migrate to the GMA Next-Gen SDK

*   When I ask to migrate to the "Next Gen" SDK, **always** use the latest
    stable version for
    `com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk`.
*   Make sure the project meets the SDK requirements of `minSdk` 24 or higher
    and `compileSdk` of 35 or higher.
*   Replace the `com.google.android.gms:play-services-ads` dependency with the
    Next Gen `com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk`
    dependency.
*   All `com.google.android.gms.ads.*` import statements must change to
    `com.google.android.libraries.ads.mobile.sdk.*`.
    *   If the change is in a custom event adapter, ask me if I'm sure I want to
        migrate this class before making the change.
*   Preserve the `com.google.android.gms.ads.APPLICATION_ID` `<meta-data>` tag
    in the `AndroidManifest.xml` file if present.
*   YOU MUST analyze the code until all errors have been resolved. Resolve the
    errors by using the APIs from the GMA Next-Gen SDK. Refer to the Android
    documentation.

Chiedere a Gemini in modalità agente

Dopo aver configurato il file AGENTS.md, puoi chiedere a Gemini in Android Studio in modalità Agent.

In modalità Agente, puoi utilizzare i seguenti prompt di esempio:

Integrare l'SDK

Integrate the latest version of the GMA SDK to my project. Refer to the Android
documentation.

Aggiungere un banner

Add an anchored adaptive banner ad to the bottom of the screen. Refer to the
Android documentation.

Lasciare un feedback

Se hai feedback sull'ottimizzazione di Gemini per Google Mobile Ads SDK, unisciti al canale Discord di Google Mobile Ads SDK.