Keahlian agen Google Ads API

Keahlian agen Google Ads API adalah modul berisi pengetahuan, petunjuk, dan alur kerja khusus Google Ads API yang bersifat portabel dan berdiri sendiri. Keahlian agen Google Ads API dapat digunakan dengan asisten AI yang mendukung standar Agent Skills terbuka, termasuk Google Antigravity dan Claude Code.

Keahlian agen ini dirancang untuk membantu asisten AI memahami praktik terbaik Google Ads API, mengonfigurasi alat, dan menjalankan alur kerja dengan akurasi yang lebih tinggi dan biaya token yang lebih rendah. Untuk mengetahui daftar keahlian yang tersedia, lihat Keahlian yang tersedia.

Mulai

Instal kemampuan agen yang sesuai untuk lingkungan pengembangan Anda.

Menginstal keahlian agen Google Ads API

Dalam sebagian besar kasus, keahlian agen Google Ads API dapat diinstal di editor pilihan Anda dengan satu perintah:

Antigravity

Kemampuan agen Google Ads API disertakan sebagai salah satu paket integrasi Build with Google untuk Antigravity. Anda dapat mengaktifkan paket ini untuk akses tingkat global di dua titik:

  • Selama aktivasi: Centang kotak untuk stack Google Ads API.
  • Di Setelan:
    1. Buka Setelan > Penyesuaian.
    2. Di bagian Build with Google Plugins, klik Customize, lalu klik Download untuk integrasi Google Ads API.

Jika Anda lebih memilih akses level project, jalankan perintah berikut di direktori project Anda:

npx skills add google/skills/skills/ads --agent=antigravity

Claude Code 

npx skills add google/skills/skills/ads --agent=claude-code

Codex 

npx skills add google/skills/skills/ads --agent=codex

Kursor

Anda dapat menginstal keterampilan agen Google Ads API secara langsung dengan menambahkan endpoint repositori GitHub keterampilan (misalnya, https://github.com/google/skills) di setelan editor Anda di bagian aturan kustom. Untuk mengetahui detail selengkapnya, lihat dokumentasi Cursor tentang cara menginstal skill dari GitHub.

Anda juga dapat menginstal skill menggunakan npx (memerlukan Node.js):

npx skills add google/skills/skills/ads --agent=cursor

Agen lainnya

Untuk asisten AI lain yang mendukung standar Agent Skills terbuka, Anda dapat menginstal keterampilan menggunakan npx (memerlukan Node.js):

npx skills add google/skills/skills/ads

Mengupdate keahlian agen Google Ads API

Anda bisa mendapatkan semua update yang tersedia dan membersihkan skill yang sudah tidak berlaku dengan menjalankan perintah update:

Antigravity

Integrasi yang diaktifkan melalui Build with Google dikelola dan diupdate secara otomatis oleh editor.

Jika Anda menginstal skill agen menggunakan perintah npx, Anda bisa mendapatkan semua update yang tersedia dengan menjalankan perintah update:

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

Kursor 

npx skills update --all

Agen lainnya

Untuk asisten AI lain yang mendukung standar Agent Skills terbuka, Anda dapat memperbarui semua keahlian aktif menggunakan npx:

npx skills update --all

Menggunakan keahlian agen Google Ads API

Asisten AI dirancang untuk menggunakan keahlian secara otomatis setiap kali asisten AI tersebut mendeteksi bahwa deskripsi keahlian cocok dengan permintaan Anda saat ini. Skill yang diinstal secara global tetap tidak aktif dalam project yang tidak terkait, kecuali jika konteks perintah Anda cocok dengan tugas Google Ads API.

Keterampilan juga dapat dipanggil secara manual dengan mengetik / di chat agen dan menelusuri nama keterampilan.

Komponen inti keahlian

Setiap keahlian agen adalah paket khusus yang menyediakan komponen berikut untuk asisten AI:

  • Petunjuk khusus: Petunjuk perintah mendetail yang dimasukkan ke dalam jendela konteks untuk memandu asisten dalam membuat kueri GAQL, mengonfigurasi kredensial OAuth, dan menangani kode error umum.
  • Praktik terbaik: Rekomendasi performa, keamanan, dan integrasi standar yang ditentukan oleh tim DevRel Google Ads API.
  • Skrip otomatisasi: Skrip yang dapat dieksekusi (seperti untuk validasi lingkungan atau penyiapan ruang kerja) yang disertakan dalam paket kemampuan untuk menjalankan tugas secara lokal.

Manfaat menggunakan keahlian

Kemampuan agen memperluas kemampuan asisten dengan pengetahuan khusus sesuai permintaan tanpa beban memuat petunjuk yang besar ke dalam setiap percakapan.

Biaya token yang lebih rendah

Integrasi AI konvensional sering kali memuat dokumentasi dalam jumlah besar di awal, sehingga menghabiskan banyak token dan meningkatkan biaya sesi. Keahlian agen menggunakan pengungkapan progresif untuk meminimalkan beban ini:

  • Asisten AI awalnya hanya memeriksa nama dan deskripsi keahlian untuk melihat apakah keahlian tersebut relevan dengan permintaan Anda.
  • Petunjuk dan referensi lengkap keterampilan hanya ditambahkan ke jendela konteks aktif saat asisten menentukan bahwa petunjuk dan referensi tersebut diperlukan untuk tugas spesifik Anda, sehingga menghemat ruang konteks.

Penerapan yang dipandu AI

Daripada menelusuri dokumentasi secara manual, Anda dapat mendeskripsikan maksud Anda menggunakan bahasa alami. Keahlian akan memandu asisten AI Anda untuk melakukan tugas-tugas seperti berikut:

  • Buat kueri GAQL untuk mengambil metrik performa kampanye dari akun saya.
  • Tulis skrip Python menggunakan library klien untuk membuat kampanye baru.
  • Mengambil data diagnostik dan konversi kampanye menggunakan Google Ads API.

Untuk mengetahui daftar lengkap keahlian yang tersedia, lihat Keahlian yang tersedia.

Menggunakan keahlian bersama server MCP Google Ads API

Keahlian agen dirancang untuk melengkapi server Model Context Protocol (MCP) Google Ads API:

  • Server MCP Google Ads API: Dirancang untuk alur kerja pengembangan yang dibantu AI, sehingga memungkinkan asisten AI berinteraksi dengan resource, kampanye, dan metrik Google Ads API Anda secara terprogram.
  • Keahlian agen Google Ads API: Memberikan petunjuk perintah dan praktik yang direkomendasikan untuk memandu asisten dalam melakukan tugas melalui pengungkapan progresif yang hemat token. Keahlian ini menginstruksikan agen tentang cara menggunakan alat seperti server MCP dan library klien secara efektif.

Keahlian yang tersedia

Tim Google Ads API menyediakan serangkaian keterampilan untuk membangun dengan Google Ads API:

Badge Deskripsi
google-ads-api-account-diagnostics Mendiagnosis masalah performa akun Google Ads seperti kehilangan konversi, volume prospek yang rendah, dan pangsa tayangan iklan yang hilang karena peringkat iklan, bid, atau anggaran menggunakan server MCP Google Ads API.
google-ads-api-mcp-setup Membantu menyiapkan dan mengonfigurasi server Model Context Protocol (MCP) Google Ads API, sehingga menyederhanakan autentikasi dan konfigurasi di lingkungan lokal.
google-ads-api-quickstart Memandu Anda menyiapkan lingkungan pengembangan, mengonfigurasi kredensial, dan melakukan panggilan API pertama ke Google Ads API.

Langkah berikutnya