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 keahlian 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

Keahlian 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 orientasi: Centang kotak untuk stack Google Ads API.
  • Di Setelan:
    1. Buka Setelan > Penyesuaian.
    2. Di bagian Plugin Build with Google, klik Sesuaikan, 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 keahlian agen Google Ads API secara langsung dengan menambahkan endpoint repositori GitHub keahlian (misalnya, https://github.com/google/skills) di setelan editor Anda di bagian aturan kustom. Untuk mengetahui detail selengkapnya, lihat dokumentasi Kursor tentang menginstal keahlian dari GitHub.

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

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

Agen lainnya

Untuk asisten AI lainnya yang mendukung standar Agent Skills terbuka, Anda dapat menginstal keahlian 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 menghapus keahlian 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 keahlian 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 lainnya yang mendukung standar Agent Skills terbuka, Anda dapat mengupdate 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. Keahlian yang diinstal secara global akan tetap tidak aktif dalam project yang tidak terkait, kecuali jika konteks perintah Anda cocok dengan tugas Google Ads API.

Keahlian juga dapat dipanggil secara manual dengan mengetik / di chat agen dan menelusuri nama keahlian.

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 standar terkait performa, keamanan, dan integrasi yang ditentukan oleh tim Google Ads API DevRel.
  • Skrip otomatisasi: Skrip yang dapat dieksekusi (seperti untuk validasi lingkungan atau penyiapan ruang kerja) yang disertakan dalam paket keahlian untuk menjalankan tugas secara lokal.

Manfaat menggunakan keahlian

Keahlian 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:

  • Pada tahap awal, asisten AI hanya memeriksa nama dan deskripsi keahlian untuk melihat apakah keahlian tersebut relevan dengan permintaan Anda.
  • Petunjuk dan referensi lengkap keahlian 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.
  • Ambil konversi kampanye dan data diagnostik 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 Google Ads API Model Context Protocol (MCP):

  • 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 keahlian untuk pengembangan dengan Google Ads API:

Keahlian Deskripsi
google-ads-api-account-diagnostics Mendiagnosis masalah performa akun Google Ads seperti kehilangan konversi, volume prospek 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 dalam menyiapkan lingkungan pengembangan, mengonfigurasi kredensial, dan melakukan panggilan API pertama ke Google Ads API.

Langkah berikutnya