Menginstal dan menggunakan Asisten Developer Google Ads API

Prasyarat

Sebelum memulai, pastikan Anda memiliki hal-hal berikut:

  1. Akses Google Ads API:

  2. Software:

    • Python 3.10 atau yang lebih baru. Python adalah bahasa default, jadi Anda harus menginstal dan menyertakannya di jalur Anda.
    • gemini-cli diinstal.
    • jq (pemroses JSON command line). Skrip penginstalan akan mencoba menginstalnya jika tidak ada.

  3. Repositori:

Mulai

  1. Buka direktori project:

    cd <full path>/google-ads-api-developer-assistant

  2. Jalankan skrip penyiapan: Skrip ini mengonfigurasi gemini-cli untuk menggunakan file konteks GEMINI.md asisten dan alat yang diperlukan.

    ./install.sh

    Jika Anda menggunakan Windows, jalankan skrip PowerShell setup.ps1.

  3. Mulai gemini-cli:

    gemini

  4. Berinteraksi dengan Asisten: Anda kini dapat mengajukan pertanyaan atau memberikan perintah dalam bahasa alami.

Fitur utama

  • Tanya jawab bahasa alami: Ajukan pertanyaan tentang fitur Google Ads API, praktik terbaik, atau resource tertentu.

    • "Apa saja jenis kampanye yang tersedia?"
    • "Bagaimana cara memfilter menurut tanggal di GAQL?"
    • "Jelaskan perbedaan antara click_view dan impression_view."

  • Pembuatan kode: Buat kueri GAQL dan cuplikan kode Python yang dapat dieksekusi.

    • "Tampilkan kampanye dengan konversi terbanyak dalam 30 hari terakhir."
    • "Dapatkan semua nama grup iklan yang diaktifkan untuk ID kampanye 12345."
    • "Temukan iklan yang tidak disetujui di semua kampanye." Kode yang dihasilkan disimpan di direktori saved_code/.

  • Eksekusi API langsung: Jalankan skrip Python hanya baca yang dibuat langsung dari gemini-cli dan lihat hasil yang diformat di terminal Anda. Setelah Asisten membuat kode, Anda akan menerima perintah di layar:

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

Masukkan run, dan skrip akan dieksekusi dalam konteks Asisten jika bahasa default Anda adalah Python, Ruby, atau PHP. Bahasa yang dikompilasi tidak akan berjalan karena kebijakan keamanan.

  • Ekspor CSV: Simpan hasil tabular dari panggilan API ke file CSV.

    • "Simpan hasil ke file CSV." File disimpan di direktori saved_csv/.

  • Bantuan pemecahan masalah: Dapatkan bantuan terkait pesan error atau perilaku API yang tidak terduga.

    • "Saya mendapatkan error 'AuthenticationError.OAUTH_TOKEN_INVALID', apa yang harus saya lakukan?"
    • "Mengapa saya tidak melihat hasil apa pun untuk kueri saya?"

Contoh kasus penggunaan

  • Pelaporan:
    • "Get me the top 5 keywords by cost for last month for customer 12345678." (Berikan 5 kata kunci teratas menurut biaya untuk bulan lalu bagi pelanggan 12345678).
  • Struktur akun:
    • "Cantumkan semua nama kampanye dan ID-nya."
  • Pemecahan masalah:
    • "Saya mengupload 100 konversi, tetapi hanya 78 yang muncul di UI. Bagaimana cara men-debugnya menggunakan API?"
  • Pembelajaran:
    • "/explain what a shared set is" (jelaskan apa itu set bersama)
  • Pembuatan Kode:
    • "Tulis kode untuk membuat kampanye Performa Maksimal untuk company name."

Komunitas dan dukungan

Panduan kontribusi

Kami menerima kontribusi. Lihat file CONTRIBUTING.md di repositori GitHub untuk mengetahui panduannya.