Google Mobile Ads SDK'sını yapay zeka araçlarıyla entegre etme

Android Studio'da Gemini'ı optimize etmek için projenizde bir AGENTS.md dosyası kullanın. Projenize AGENTS.md dosyası ekleyerek Gemini'a Google Mobile Ads SDK ile ilgili bağlam bilgisi sağlayabilir ve yapay zeka destekli kod oluşturma özelliğinin çıktısını iyileştirebilirsiniz. Ayrıntılar için AGENTS.md dosyalarını kullanarak Gemini'ı özelleştirme başlıklı makaleyi inceleyin.

Bu kılavuzda, Android Studio'da Gemini'ı Google Mobile Ads SDK için optimize etme konusu ele alınmaktadır.

Başlamadan önce

Devam etmeden önce aşağıdakileri yapın:

Projenize AGENTS.md dosyası ekleme

Google, aşağıdaki entegrasyon adımlarında size yardımcı olmak için Gemini'a yönelik talimatların yer aldığı bir AGENTS.md dosyası sağlar:

  • Projenize Google Mobile Ads SDK ekleyin.
  • Banner reklamları uygulayın.

Yapay zeka kod yardımında Google Mobile Ads SDK ile ilgili talimatları kullanmak için aşağıdaki adımları uygulayın:

  1. Projenizin dosya sisteminde herhangi bir yerde AGENTS.md adlı yeni bir dosya oluşturun.

  2. AGENTS.md dosyanıza aşağıdaki talimatları ekleyin:

# 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.
*   Resolve each `com.google.android.gms.ads.*` class to its specific
    counterpart in `com.google.android.libraries.ads.mobile.sdk.*`.
    *   If the change involves the
        `com.google.android.gms.ads.mediation.Adapter` class, ask me if I'm sure
        I want to migrate this class before making the change.
    *   When you need a class, search for that class name specifically in the
        `com.google.android.libraries.ads.mobile.sdk` package. Read the class
        stub or source file found in the library. Look at the public method
        signatures in that file.
*   Preserve the `com.google.android.gms.ads.APPLICATION_ID` `<meta-data>` tag
    in the `AndroidManifest.xml` file if present.
*   When performing UI-related operations within Google Mobile Ads callbacks,
    make sure you explicitly dispatch them to the UI thread.
*   Run a build/compile check. If there are **0 errors** related to the files
    you modified and no more references to `com.google.android.gms.ads`,
    consider the migration complete.

### Migrate Banner Ads

*   Declare the preferred
    `com.google.android.libraries.ads.mobile.sdk.banner.AdView` class to load a
    "Next-Gen" banner ad instead of the deprecated `BannerAd` APIs.

Temsilci Modu'nda Gemini'a istem girme

AGENTS.md dosyanızı yapılandırdıktan sonra Android Studio'da Gemini'a Aracı Modu'nda istem girebilirsiniz.

Aracı Modu'nda aşağıdaki örnek istemleri kullanabilirsiniz:

SDK'yı entegre etme

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

Banner ekle

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

Geri bildirim gönderme

Gemini'ı Google Mobile Ads SDK için optimize etme konusunda geri bildiriminiz varsa Google Mobile Ads SDK Discord kanalına katılın.