Checklist Pemula Developer Google Ads

Checklist ini akan memandu Anda melalui proses untuk memulai Google Ads API. Langkah-langkahnya dibagi menjadi beberapa kategori, beberapa di antaranya mungkin Anda putuskan untuk dilewati jika tidak berlaku untuk kebutuhan Anda. Untuk mendapatkan hasil maksimal dari dokumen ini, baca dan jalankan langkah-langkah secara berurutan.

Daftar ini berisi tiga jenis item:

	Todo: Langkah-langkah yang diperlukan untuk melakukan tugas tertentu atau menyiapkan bagian tertentu dari alat Anda.
	Info: Informasi yang tidak penting untuk proses, tetapi akan membantu Anda memahami konteks atau memperjelas langkah-langkah tertentu.
	Peringatan: Hal-hal yang perlu diperhatikan selama proses, karena mungkin melibatkan upaya penerapan tambahan atau menimbulkan risiko tertentu.

Jika mencetak checklist, Anda dapat menggunakan kotak centang di sebelah kiri untuk menandai langkah mana yang telah selesai. Checklist ini memberikan urutan pembacaan yang direkomendasikan untuk informasi yang ditemukan di dokumen Google Ads API.

Akses dan penyiapan

	Dapatkan token developer dari Pusat API di akun pengelola tingkat teratas Anda. Semua kolom pada formulir Akses API harus diisi, dan Persyaratan dan Ketentuan harus disetujui. Pastikan email kontak API yang Anda berikan mengarah ke kotak masuk yang dipantau secara rutin. Anda akan diberi token developer dengan tingkat akses akun pengujian.
	Itu saja yang Anda perlukan untuk mencoba Google Ads API dengan akun percobaan. Anda dapat menggunakan akun pengujian untuk membuat kampanye dan iklan, tetapi tidak ada iklan yang benar-benar ditayangkan (menyebabkan biaya) dan semua statistik pelaporan akan bernilai 0. Agar token developer Anda dapat mengakses akun produksi, token tersebut harus disetujui oleh tim peninjauan token kami.
	Agar token Anda disetujui untuk akses produksi, Anda harus mengisi formulir permohonan tindak lanjut kami dan menjelaskan cara Anda ingin menggunakan API. Anda juga harus memberikan dokumen desain. Anda dapat menggunakan template kami untuk memulai. Berikan detail sebanyak mungkin. Tim peninjauan token kami akan menghubungi Anda jika memerlukan informasi lebih lanjut, tetapi Anda juga dapat menghubungi kami melalui formulir kontak jika tidak ada masukan dalam waktu 2 hari kerja.
	Setelah token developer disetujui, Anda dapat menggunakannya untuk melakukan panggilan API ke akun produksi. Awalnya, Anda akan diberi Akses Dasar, yang memungkinkan 15.000 operasi per hari dan batas 1.000 operasi get per hari.
	Jika permohonan Anda ditolak, Anda akan menerima email yang menyatakan alasannya. Anda dapat melakukan perubahan pada permohonan, memberikan detail selengkapnya tentang solusi Anda, dan mengajukan permohonan lagi.

Menyiapkan library klien

	Kami menggunakan OAuth 2.0 untuk mengautentikasi permintaan Anda terhadap API. Ikuti petunjuk dalam panduan OAuth 2.0 untuk menyiapkan kredensial untuk OAuth 2.0. Untuk pemecahan masalah, Anda dapat menggunakan OAuth 2.0 playground.
	Kami menyediakan library klien untuk beberapa bahasa pemrograman umum. Download library untuk bahasa yang ingin Anda gunakan dan siapkan file konfigurasinya dengan kredensial yang diperoleh sebelumnya.

Token Developer - Tingkat Akses

Baca tentang Tingkat Akses, dan tentukan apakah alat Anda akan memerlukan lebih dari 15.000 operasi per hari pada suatu waktu di masa mendatang. Jika demikian, Anda harus mengajukan permohonan untuk Akses Standar untuk operasi mutate dan permintaan GoogleAdsService.Search serta GoogleAdsService.SearchStream yang tidak terbatas per hari. Namun, hal ini masih tunduk pada batas harian 1.000 operasi get.

Tinjau Tarif untuk memahami cara penghitungan operasi untuk tingkat akses Anda. Perhatikan bahwa permintaan GoogleAdsService.Search dengan kumpulan kolom page_token tidak diperhitungkan dalam batas operasi.

Fungsi Minimum yang Dibutuhkan (RMF)

	Baca tentang Fungsi Minimum yang Diperlukan (RMF), yang merupakan kumpulan fungsi yang harus diterapkan alat Anda, berdasarkan sifat alat tersebut.
	Alat yang dapat digunakan dengan Akses Dasar, yaitu kurang dari 15.000 permintaan per hari, dikecualikan dari RMF. Alat yang tidak dapat diakses oleh pengiklan, dan hanya ditujukan untuk penggunaan internal, dikecualikan dari RMF. Jika alat Anda hanya melakukan pelaporan, hanya RMF pelaporan yang akan berlaku. Jika alat Anda sangat terbatas dan khusus, seperti khusus Shopping atau Promosi Aplikasi, hanya bagian RMF yang digunakan alat Anda yang akan berlaku. Jika tidak yakin apakah kebijakan RMF berlaku untuk alat Anda atau tidak, hubungi tim Kepatuhan Google Ads API.
	Baca tentang Biaya ketidakpatuhan untuk memahami hal yang akan terjadi jika RMF tidak diterapkan dengan benar.
	Jika alat Anda dimaksudkan untuk digunakan di luar organisasi (dengan kata lain, bukan alat khusus internal), alat tersebut harus menerapkan RMF yang berlaku sebelum Anda mengajukan permohonan Akses Standar. Ingat bahwa RMF dapat berubah seiring perubahan API. Jika memutuskan untuk mengajukan permohonan Akses Standar, Anda harus terus memperbarui alat dengan RMF terbaru.
	Pastikan alat Anda menerapkan RMF yang berlaku.
	Ajukan permohonan Akses Standar.

Mulai menggunakan API

	Baca artikel Melakukan Panggilan API Pertama, yang menjelaskan cara mendapatkan kampanye menggunakan API. Semua objek dapat dijangkau dengan cara yang serupa, jadi sebaiknya hafal strukturnya.
	Pahami dasar-dasar Struktur API Resource dan Layanan.
	Lihat Mengubah & memeriksa objek dan Mengambil objek.
	Baca tentang Metadata Resource untuk memahami cara memintanya secara dinamis.
	Baca Ringkasan Kampanye untuk membuat dan mengelola berbagai jenis kampanye dan iklan.

Contoh kode

	Lihat dan jalankan kode contoh kami untuk memahami cara menggunakan API. Sebaiknya jalankan setidaknya contoh berikut untuk memahami cara mengelola objek Google Ads dasar.
	Basic Operations > Get Campaigns
	Basic Operations > Get Expanded Text Ads
	Operasi Dasar > Tambahkan Kampanye
	Basic Operations > Add Keywords
	Basic Operations > Update Keyword
	Pengelolaan Kampanye > Dapatkan Semua Iklan yang Tidak Disetujui
	Pengelolaan Kampanye > Tambahkan Pengubah Bid Kampanye
	Pengelolaan Akun > Dapatkan Informasi Akun
	Pengelolaan Akun > Buat Pelanggan
	Pengelolaan Akun > Dapatkan Perubahan Akun

Pelaporan

	Untuk pelaporan, Anda harus menggunakan akun yang telah menayangkan iklan selama jangka waktu yang memadai untuk menghasilkan metrik performa (sebaiknya minimal 7 hari).
	Lihat ringkasan pelaporan, dan contoh untuk meringkas performa akun selama 30 hari terakhir menggunakan GoogleAdsService sebagai satu sumber tepercaya untuk pelaporan di pelaporan Google Ads.
	Baca Google Ads Query Language (GAQL) untuk memahami tata bahasa kueri, struktur kueri, dan konsep resource, segmen, dan metrik.
	Baca artikel tentang Metrik Kriteria untuk memahami cara mengambil data performa untuk berbagai kriteria dengan resource *_view, misalnya, KeywordView, TopicView, dan GenderView.

Pembuat Kueri Google Ads Interaktif

	Temukan fitur yang tersedia di alat developer Pembuat Kueri Google Ads Interaktif. Alat berbasis web ini menemukan semua kolom dan filter yang tersedia untuk resource yang dipilih, dan membuat kueri secara interaktif.
	Gunakan editor di alat ini untuk membuat pernyataan Google Ads Query Language untuk resource tertentu; misalnya, AdGroup. Salin dan tempel pernyataan GAQL yang dihasilkan ke dalam aplikasi Anda.

Riset kata kunci

Jika Anda belum memahami alat Keyword Planner kami, coba alat ini untuk melihat cara kerja perencanaan kata kunci di UI Google Ads.

Google Ads API menyediakan beberapa layanan yang mencerminkan fungsi Keyword Planner dan membantu Anda melakukan riset kata kunci. KeywordPlanIdeaService mengusulkan ide kata kunci berdasarkan parameter tertentu, dan KeywordPlanService memberikan estimasi statistik tentang performa kata kunci dan membantu Anda menilai kualitasnya. Sebaiknya gunakan akun Google Ads dengan kampanye aktif untuk membuat permintaan API ini guna mendapatkan metrik yang akurat.

Contoh kode

	Temukan fungsi perencanaan kata kunci dengan menjalankan contoh kode di bawah.
	Contoh Perencanaan -> Buat Metrik Perkiraan
	Contoh Perencanaan -> Buat Ide Kata Kunci

Mengotomatiskan anggaran

	Baca artikel tentang Metode dan setelan pembayaran untuk memahami opsi penagihan yang tersedia di Google Ads, seperti pembayaran otomatis, pembayaran manual, invoice bulanan (kredit maksimum).
	Jika tidak menggunakan invoice bulanan dan tidak berencana mendaftar untuknya, Anda dapat melewati bagian ini.
	Lihat artikel Penyiapan Penagihan untuk memahami cara mengelola profil pembayaran dan akun pembayaran secara terprogram.
	Baca artikel tentang Anggaran Akun untuk memahami cara anggaran dapat ditetapkan secara otomatis ke akun.
	Untuk menggunakan AccountBudgetProposalService, akun pengelola Google Ads Anda harus diizinkan untuk tujuan ini. Anda tidak akan dapat menggunakan layanan ini hingga proses ini selesai. Anda juga harus menyiapkan invoice bulanan dengan Google. Hubungi Partner Manager Strategi Anda (SPM) di Google untuk mengatur proses ini. Akses hanya tersedia untuk Partner Google.
	Hubungi perwakilan bisnis Anda di Google untuk mengajukan permohonan agar diikutsertakan dalam penagihan bulanan.
	Hubungi perwakilan bisnis Anda di Google untuk mengajukan permohonan akses ke AccountBudgetProposalService .
	Buat AccountBudgetProposal dan tetapkan ke akun. Coba gunakan anggaran bersama dengan anggaran kampanye.

Iklan Shopping

	Jika akan menggunakan Iklan Shopping, Anda mungkin perlu menggunakan Google Merchant Center dan Content API untuk Shopping untuk mengelola data produk. Bagian ini menjelaskan langkah-langkah dasar untuk memulai API tersebut.
	Siapkan Akun Merchant Center dan dapatkan MerchantID.
	Dapatkan kunci akun layanan jika aplikasi Anda hanya memerlukan akses ke akun Merchant Center Anda sendiri. Namun, jika Anda menulis aplikasi pihak ketiga yang memerlukan akses ke akun Merchant Center klien, tinjau panduan Mengizinkan Permintaan dengan OAuth 2.0.
	Download library klien untuk bahasa pilihan Anda.
	Lihat contoh kode Content API untuk Java, .NET, PHP, Python, dan sebagainya.
	Pelajari cara menautkan secara manual akun Merchant Center dan Google Ads.
	Pelajari cara menyiapkan daftar produk menggunakan Content API.
	Lihat panduan Membuat Kampanye Shopping menggunakan Google Ads API.

Rekomendasi & status perubahan

	Jika Anda belum memahami fungsi Rekomendasi dan Histori perubahan, coba gunakan di UI Google Ads.
	Google Ads API menyediakan dua layanan yang mencerminkan fungsi ini. RecommendationService mengusulkan rekomendasi pengoptimalan dengan perkiraan dampak, sedangkan ChangeStatusService mengambil histori perubahan di akun Anda, yang dapat digunakan untuk beberapa tujuan seperti sinkronisasi salinan lokal, audit sederhana, dan lainnya.

RecommendationService

	Baca panduan kami tentang cara menggunakan RecommendationService untuk mengambil dan menerapkan rekomendasi Google ke akun Anda guna meningkatkan performa iklan secara keseluruhan.
	Temukan fungsi rekomendasi dengan menjalankan contoh kode ini: Contoh Rekomendasi -> Mendapatkan Rekomendasi Iklan Teks.

ChangeStatusService

	Baca panduan kami tentang cara menggunakan ChangeStatusService untuk mengambil histori perubahan guna melacak perubahan pada akun Anda, seperti kampanye dan iklan.
	Temukan fungsi histori perubahan dengan menjalankan contoh kode ini: Contoh ChangeStatus -> Dapatkan Perubahan Akun..

Selalu mendapatkan info terbaru

Perbarui kode Anda dengan perubahan di Google Ads API.

Pembuatan Versi

	Jika versi utama sebelumnya dihentikan, versi tersebut tidak lagi didukung dan panggilan API yang dibuat menggunakan versi API sebelumnya akan gagal. Jangan lupa untuk terus mendapatkan informasi terbaru tentang API dengan mengikuti langkah-langkah di bawah ini.
	Saat API baru dirilis, dapatkan library klien kami versi terbaru.
	Tambahkan bookmark ke Catatan Rilis terbaru dan tinjau perubahan utama dalam setiap versi.
	Ganti panggilan ke library klien versi sebelumnya dengan panggilan ke versi baru.
	Ikuti blog ini untuk berlangganan feed RSS kami guna mendapatkan postingan blog melalui email, dan lihat forum untuk mendapatkan informasi terbaru terkait Google Ads API.
	Pastikan email kontak API yang terdaftar di Pusat API akun pengelola utama Anda sudah yang terbaru, karena ini adalah cara kami menghubungi Anda jika kami menemukan masalah teknis terkait penggunaan API oleh Anda.

Produk Google Terkait Iklan

	Google Merchant Center	Google Merchant Center membantu Anda mengupload data toko dan produk ke Google serta menyediakannya untuk iklan Shopping dan layanan Google lainnya.
	Profil Bisnis	Profil Bisnis membantu Anda menjangkau dan berinteraksi dengan pelanggan lokal di Google Penelusuran dan Maps.
	Google Analytics	Google Analytics memberikan pelaporan mendalam tentang cara orang menggunakan situs Anda. Anda dapat menggunakan Google Analytics untuk mempelajari tindakan yang dilakukan orang setelah mengklik iklan Anda.
	Google Tag Manager	Google Tag Manager adalah sistem pengelolaan tag (TMS) yang memungkinkan Anda memperbarui kode pelacakan dan fragmen kode terkait dengan cepat, yang secara keseluruhan dikenal sebagai tag, di situs atau aplikasi seluler.
	Google Optimize	Google Optimize menawarkan alat pengujian A/B, pengujian situs, dan personalisasi untuk bisnis kecil guna membantu memberikan pengalaman pelanggan yang menarik.
	Google Data Studio	Data Studio mengubah data Anda menjadi dasbor dan laporan yang informatif, mudah dibaca, mudah dibagikan, dan dapat disesuaikan sepenuhnya.

Mendapatkan bantuan

	Tambahkan bookmark ke panduan Google Ads API. Sebagian besar konsep dasar dijelaskan secara mendetail di sana.
	Tambahkan bookmark ke referensi Google Ads API. Semua fungsi API dijelaskan secara mendetail di sana.
	Tambahkan bookmark ke halaman dukungan Google Ads API, yang menjelaskan saluran dukungan utama.
	Lihat channel YouTube Developer Google Ads.
	Hubungi perwakilan bisnis / partner manager Anda di Google untuk menjadwalkan pertemuan guna membahas masalah strategis yang lebih kompleks terkait API.