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 menginstalnya dan berada di jalur Anda.
    • gemini-cli diinstal.
    • jq (pemroses JSON command line). Skrip penginstalan akan mencoba menginstal ini 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: Sekarang Anda dapat mengajukan pertanyaan atau memberikan perintah dalam bahasa alami.

Fitur utama

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

    • "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 dibuat 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 tabel dari panggilan API ke file CSV.

    • "Simpan hasilnya 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 untuk kueri saya?"

  • Konteks tambahan: Tambahkan basis kode Anda untuk konteks.

    • Mulai v2.3.0, gunakan flag context_dir untuk menyertakan file project Anda: ./update.sh --context_dir /path/to/your/codebase Hal ini memungkinkan Asisten menyertakan logika aplikasi Anda dalam pertimbangannya saat membuat respons.
    • Fitur ini memungkinkan Asisten membuat contoh kode tersimpan dalam bahasa yang Anda pilih, sehingga memberikan dukungan meskipun library klien resmi tidak tersedia.
    • Sebelum meminta output kode, beri tahu Asisten: write saved code examples in <language of your application>

Contoh kasus penggunaan

  • Pelaporan:
    • "Dapatkan 5 kata kunci teratas berdasarkan 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-debug hal ini menggunakan API?"
  • Pembelajaran:
    • "/jelaskan apa yang dimaksud dengan kumpulan bersama"
  • Pembuatan Kode:
    • "Tulis kode untuk membuat kampanye Performa Maksimal untuk company name."

Komunitas dan dukungan

Pedoman kontribusi

Kontribusi Anda sangat kami harapkan. Lihat file CONTRIBUTING.md di repositori GitHub untuk mengetahui pedomannya.

Sebelumnya
Apa itu Asisten Developer Google Ads API?