ادغام SDK تبلیغات موبایلی گوگل با ابزارهای هوش مصنوعی

برای بهینه‌سازی Gemini در اندروید استودیو، از یک فایل AGENTS.md در پروژه خود استفاده کنید. با افزودن یک فایل AGENTS.md به پروژه خود، زمینه‌ای مختص به Google Mobile Ads SDK را در اختیار Gemini قرار می‌دهید و خروجی تولید کد با کمک هوش مصنوعی را بهبود می‌بخشید. برای جزئیات بیشتر، به بخش «سفارشی‌سازی Gemini با استفاده از فایل‌های AGENTS.md مراجعه کنید.

این راهنما بهینه‌سازی Gemini در اندروید استودیو برای Google Mobile Ads SDK را پوشش می‌دهد.

قبل از اینکه شروع کنی

قبل از ادامه، موارد زیر را انجام دهید:

فایل AGENTS.md را به پروژه خود اضافه کنید

گوگل یک فایل AGENTS.md با دستورالعمل‌هایی برای Gemini ارائه می‌دهد تا در مراحل ادغام زیر به شما کمک کند:

  • Google Mobile Ads SDK را به پروژه خود اضافه کنید.
  • تبلیغات بنری را پیاده سازی کنید.

برای استفاده از دستورالعمل‌های مخصوص Google Mobile Ads SDK در دستیار کد هوش مصنوعی، این مراحل را دنبال کنید:

  1. یک فایل جدید با نام AGENTS.md در هر جایی از سیستم فایل پروژه خود ایجاد کنید.

  2. در فایل AGENTS.md خود، دستورالعمل‌های زیر را اضافه کنید:

# 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.

Gemini را در حالت عامل فعال کنید

پس از پیکربندی فایل AGENTS.md ، می‌توانید Gemini را در اندروید استودیو در حالت Agent Mode اجرا کنید.

در حالت عامل، می‌توانید از نمونه‌های زیر برای دریافت اعلان‌ها استفاده کنید:

ادغام SDK

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

اضافه کردن بنر

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

بازخورد بگذارید

اگر در مورد بهینه‌سازی Gemini برای Google Mobile Ads SDK بازخوردی دارید، به کانال Discord Google Mobile Ads SDK بپیوندید.