Mengintegrasikan Google Mobile Ads SDK dengan alat AI (beta)

Untuk mengoptimalkan output yang dibantu AI, tambahkan keterampilan ke lingkungan AI Anda. Dengan menambahkan keterampilan, Anda memberikan konteks khusus untuk Google Mobile Ads SDK kepada alat AI dan meningkatkan output pembuatan kode yang dibantu AI.

Panduan ini membahas cara mengoptimalkan model AI untuk Google Mobile Ads SDK.

Prasyarat

Jika Anda menggunakan Android Studio, lakukan hal berikut:

Pelajari Tentang Gemini di Android Studio.
Siapkan Gemini di Android Studio menggunakan Android Studio Panda 3 Canary 2 atau yang lebih baru.

Menambahkan keterampilan

Google menyediakan file SKILL.md dengan petunjuk untuk alat AI Anda guna membantu Anda dalam langkah-langkah integrasi berikut:

Menambahkan Google Mobile Ads SDK ke project Anda.
Menerapkan iklan banner.

Untuk menggunakan keterampilan khusus untuk Google Mobile Ads SDK dengan alat AI Anda, ikuti langkah-langkah berikut:

Android Studio

Di direktori utama project Anda, buat folder bernama .skills/.
Buat direktori untuk keterampilan Anda yang bernama gma-android-integrate.
Di direktori gma-android-integrate, buat file bernama SKILL.md.

Catatan: Nama direktori harus sama persis dengan kolom name di file SKILL.md.

Di file SKILL.md, tambahkan petunjuk berikut:

---
name: gma-android-integrate
description: Provides technical specifications and implementation details for
  the play-services-ads Google Mobile Ads SDK
  (com.google.android.gms:play-services-ads), including Gradle dependencies,
  manifest metadata, initialization patterns, and banner ad configurations. Use
  ONLY for the play-services-ads Google Mobile Ads SDK. Do NOT use for GMA
  Next-Gen SDK (com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk)
  integrations.
metadata:
  version: 1.0
---

# AI Integration Agent Instructions for the Play Services Google Mobile Ads SDK

## SDK Integration Workflow

*   **Configure Gradle**:
    -   [ ] Add the latest stable version of
        `com.google.android.gms:play-services-ads` to dependencies.
    -   [ ] Configure `minSdk` (23+) and `compileSdk` (35+).
    -   [ ] Sync Gradle before moving on to the next step.
*   **Manifest Configuration**:
    -   [ ] Add the following metadata to the `<application>` tag in the
        `AndroidManifest.xml` file:
        ```xml
        <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-3940256099942544~3347511713"/>
        ```
        **Note**: The sample AdMob App ID
        `ca-app-pub-3940256099942544~3347511713` is for testing purposes only.
        **ALWAYS** remind the user to replace it with their actual AdMob App ID
        before publishing.
*   **Initialize SDK**:
    -   [ ] Initialize SDK on a background thread.

### Implementation Details

*   **Version Management**: **ALWAYS** look up and use the latest stable
    version. Do not assume a version number.
*   **Initialization**: **ALWAYS** call `MobileAds.initialize()` on a background
    thread.

## Banner Ads

Banner ads are rectangular image or text ads that occupy a spot within an app's
layout. They remain on screen during user interaction and can refresh
automatically.

### Strategic Recommendations

*   **Confirm Ad Type**: If the user asks for a "banner ad" without specifying a
    type, confirm the desired type.
*   **Suggest Large Anchored Adaptive**: Suggest large anchored adaptive banners
    over "fixed size". Explain they are designed to increase engagement and
    revenue potential. If told that large adaptive is too large, suggest
    standard anchored adaptive over fixed size ads.
*   **Type Clarifications**:
    *   **Anchored Adaptive**: Ask if it should be anchored to the **top** or
        **bottom**.
    *   **Inline Adaptive**: Use this type for ads placed inside scrollable
        content (e.g., `RecyclerView` or `ScrollView`). **Validate** the ad
        container is scrollable before implementing; if not scrollable, default
        to **Large Anchored Adaptive**.

### Implementation Checklist

-   [ ] Create UI container for `AdView`.
-   [ ] Initialize `AdView` with ad unit ID and ad size.
-   [ ] Call `adView.loadAd()`.
-   [ ] **Mandatory**: Add `adView.destroy()` to the appropriate lifecycle
    cleanup (e.g., `onDestroy`).

Untuk mengetahui detailnya, lihat Memperluas Mode Agen dengan keterampilan.

Memanggil keterampilan dalam perintah Anda

Setelah menambahkan keterampilan ke project Anda, gunakan contoh perintah berikut untuk memanggilnya di alat AI Anda:

Android Studio

Untuk memanggil keterampilan, ketik @, lalu pilih keterampilan gma-android-integrate.