Keuangan

Google Ads: koneksi dan konversi

Semua pengaturan Google ada di Sumber → Akun iklan → Google: aplikasi OAuth Anda, akun, tindakan, tag browser, biaya, dan riwayat pengiriman. Pada alur, cukup pilih sumber tersebut. Alur tidak memiliki koneksi Google atau ID tindakan terpisah.

Dalam panduan ini: kepemilikan resource · opsi koneksi · prasyarat · Google Cloud dan OAuth · menghubungkan sumber · pemilihan akun · ID tindakan manual · ID dan label · masing-masing alur · pengiriman postback · tag browser · pengeluaran · verifikasi · pemecahan masalah · pemeliharaan · pertanyaan umum.

1. Siapa pemilik akun dan izin?

Integrasi Ads ini tidak memakai aplikasi OAuth, project Cloud, developer token, atau MCC bersama milik ArtisanClo. Kredensial pelanggan lain tidak digunakan sebagai pengganti. Permintaan server tetap berjalan di infrastruktur ArtisanClo; memakai aplikasi sendiri tidak berarti permintaan berasal dari komputer Anda.

Client Secret serta token akses dan refresh disimpan terenkripsi. Rahasia yang tersimpan tidak dikirim kembali ke formulir pengaturan. Mengosongkan kolom rahasia yang sudah disimpan mempertahankan nilai sebelumnya. Pengunjung hanya menerima ID dan label tag publik. Pemisahan resource bukan jaminan terhadap pembatasan Google: aturannya tetap berlaku untuk akun, aplikasi, dan penggunaan layanan.

2. Pilih fitur yang diperlukan

Pengiriman server dan browser dapat diaktifkan bersamaan. Keduanya mengamati momen berbeda dan tidak otomatis digabung menjadi satu konversi. Tinjau duplikasi dan sasaran konversi.

3. Siapkan pelacakan dan sumber Anda

1. Paket Anda harus mencakup pengiriman konversi ke platform iklan. Impor pengeluaran merupakan fitur paket terpisah. Pengaturan menampilkan batasan paket jika suatu fitur tidak tersedia.
2. Gunakan alur dengan tracker aktif. Alur yang hanya memakai cloaking tidak mengirim konversi sumber. Pilih sumber dalam pengaturan pelacakan alur.
3. Konfigurasikan konversi masuk dari situs, jaringan afiliasi, atau tracker eksternal Anda. Teruskan ID klik ArtisanClo ke penawaran dan kembalikan melalui postback.
4. Pastikan kunjungan iklan menyimpan gclid, gbraid, atau wbraid asli. click_id internal ArtisanClo menghubungkan postback dengan kunjungan; pengenal Google menghubungkan kunjungan itu dengan iklan. Kedua hubungan tersebut diperlukan.
5. Gunakan pengguna Google dengan hak yang memadai pada akun Ads tujuan atau MCC yang dapat diakses. Izin Cloud saja tidak memberikan akses ke akun Google Ads.

Jangan mengarang ID klik Google untuk pengiriman biasa. gad_source, nilai UTM, email, dan ID transaksi tidak dapat menggantikannya. Menghubungkan Google belakangan tidak bisa memulihkan pengenal yang tidak ada pada kunjungan awal.

4. Siapkan aplikasi Google Cloud milik Anda

1. Buka Google Cloud Console, lalu pilih atau buat project yang Anda kendalikan.
2. Aktifkan Data Manager API di library API untuk pengiriman konversi server.
3. Untuk daftar akun, pembuatan tindakan otomatis, atau pengeluaran, aktifkan juga Google Ads API. Periksa tingkat akses project di Google Ads API Overview dan penuhi persyaratan Google untuk akun yang akan digunakan. Akses khusus pengujian tidak cukup untuk akun iklan produksi. Tingkat akses project.
4. Atur identitas aplikasi, email kontak, dan audiens di Google Auth Platform. Audiens internal organisasi hanya melayani pengguna organisasi tersebut. Dalam mode Testing, tambahkan alamat Google yang akan dipakai sebagai pengguna pengujian.
5. Buat OAuth Client ID bertipe Web application. Di ArtisanClo, buka sumber → Akun iklan → Google → konversi server → aplikasi OAuth Google Cloud Anda. Salin Authorized redirect URI yang ditampilkan ke pengaturan klien OAuth tersebut.
6. Salin Client ID dan Client Secret ke sumber. Client ID biasanya berakhiran .apps.googleusercontent.com. Jangan menempelkan kunci API, nomor akun Ads, atau seluruh file JSON ke kolom ini.

Salin URI callback secara persis, termasuk skema, domain, dan path. Jangan mengganti /en/ dengan bahasa dasbor: path callback tetap. Instalasi lokal dan produksi mungkin menampilkan alamat berbeda. Persyaratan OAuth web Google.

Koneksi server meminta openid, email, dan https://www.googleapis.com/auth/datamanager. Mengaktifkan opsi Google Ads API menambahkan https://www.googleapis.com/auth/adwords. Berikan izin yang diperlukan untuk fitur pilihan Anda. Izin Data Manager wajib untuk menyelesaikan koneksi server ini.

Nama layar Google dapat berubah. Gunakan identitas aplikasi sendiri dan hanya klaim domain yang Anda kendalikan. Jika Google meminta verifikasi domain atau aplikasi, ikuti persyaratan sesuai konfigurasi sebenarnya; menghubungkan ArtisanClo tidak menggantikan proses tersebut.

5. Hubungkan sumber

1. Buka Sumber, lalu buat atau edit sumber Google Anda. Beri nama yang menunjukkan bisnis atau akunnya.
2. Buka blok konversi/pengeluaran akun iklan, pilih Google, lalu aktifkan pengiriman lead/penjualan server.
3. Masukkan Client ID dan Client Secret. Aktifkan «Daftar akun, pembuatan konversi, dan pengeluaran (Google Ads API)» jika project Cloud Anda sudah siap untuk fitur tersebut.
4. Klik «Simpan dan hubungkan Google saya». Sumber disimpan sebelum Google dibuka. Pilih pengguna Google yang sesuai dan otorisasi aplikasi Anda sendiri.
5. Setelah kembali, periksa email yang terhubung lalu atur akun iklan dan tindakan konversi. «Terhubung» menegaskan otorisasi tersimpan, bukan pengiriman suatu konversi tertentu.

Login ke dasbor ArtisanClo dengan Google dan mengotorisasi sumber iklan adalah dua operasi terpisah. Koneksi Ads memakai Client ID yang disimpan pada sumber tersebut.

Selesaikan otorisasi dalam sesi browser yang sama dalam sepuluh menit. Memulai koneksi lain mengganti koneksi yang tertunda. Jika kembali ke tab lama atau permintaan kedaluwarsa, mulai ulang dari sumber.

Jika masuk gagal, kabinet menyebutkan penyebabnya:

6. Pilih akun dan atur tindakan secara otomatis

1. Setelah mengotorisasi Google Ads API, klik «Tampilkan akun saya». Daftar memuat akun iklan yang dapat diakses, termasuk klien MCC. Jika kosong, periksa pengguna Google, izin Ads, dan akses project Cloud Anda.
2. Cocokkan ID akun sepuluh digit lalu klik «Pilih dan konfigurasikan». Tombol ini dapat membuat tindakan konversi nyata di akun tersebut.
3. Tinjau ID akun yang terisi, ID pengelola jika diperlukan, serta ID tindakan lead dan penjualan.

Tindakan aktif dan kompatibel dengan nama persis tersebut dipakai kembali. Jenis atau status yang tidak kompatibel menghentikan konfigurasi dengan error; tindakan yang ada tidak diubah diam-diam. Pembuatan kedua tindakan merupakan operasi terpisah: jika yang kedua gagal, yang pertama mungkin sudah ada dan akan dipakai kembali setelah error diperbaiki dan Anda mencoba lagi.

Jika pelacakan konversi dimiliki akun lain dalam konfigurasi MCC, pengaturan otomatis mengembalikan google_shared_conversion_account. Periksa pemilik konversi di Google Ads terlebih dahulu; mengganti ID pengelola tidak memindahkan tindakan.

Pengaturan otomatis mengisi ID tindakan server. Fitur ini tidak membuat atau mengambil Conversion ID/label browser. Atur peristiwa browser secara terpisah, lalu tinjau sasaran konversi dan setelan bidding kampanye di Google Ads.

7. Gunakan ID manual tanpa Google Ads API

Data Manager API dengan otorisasi OAuth Anda dapat mengirim postback meskipun daftar akun dan pembuatan tindakan dinonaktifkan.

1. Siapkan tindakan konversi impor klik di Google Ads. Gunakan tindakan lead dan penjualan terpisah jika menginginkan kedua status.
2. Masukkan nomor akun iklan pada Google Ads Account ID, misalnya 123-456-7890. Tanda hubung dihapus dalam permintaan API.
3. Masukkan ID MCC jika itulah jalur akses Anda. Kosongkan untuk akses langsung.
4. Buka setiap tindakan konversi di Google Ads lalu salin ID numeriknya, yaitu parameter ctId pada URL halaman, ke kolom lead atau penjualan yang sesuai.
5. Simpan sumber dan jalankan validasi untuk setiap status yang aktif.

Kolom tindakan kosong menonaktifkan status tersebut. Untuk mengirim penjualan saja, isi penjualan dan kosongkan lead. Jangan masukkan AW-… atau Conversion label ke kolom ID tindakan server.

8. Bedakan ID akun, ID tindakan, dan label tag

Nilai berikut hanya contoh, bukan kredensial yang dapat digunakan.

9. Pilih sumber pada alur

Semua pengaturan Google ada di Sumber → Akun iklan → Google: aplikasi OAuth Anda, akun, tindakan, tag browser, biaya, dan riwayat pengiriman. Pada alur, cukup pilih sumber tersebut. Alur tidak memiliki koneksi Google atau ID tindakan terpisah.

Untuk akun Google atau tindakan berbeda, buat sumber lain dan pilih di alur. Perubahan sumber berlaku bagi semua alur yang memilihnya. Tag browser dan postback menggunakan sumber terpilih. Jika sumber berubah sebelum konversi antrean dikirim, pengiriman lama berhenti dengan google_connection_changed.

10. Ikuti perjalanan konversi server

1. Kunjungan iklan disimpan dengan pengenal klik Google asli dan ID klik internal ArtisanClo.
2. Situs atau jaringan Anda melaporkan lead/penjualan melalui penerima konversi yang dikonfigurasi, dengan mengembalikan ID klik ArtisanClo.
3. Semua pengaturan Google ada di Sumber → Akun iklan → Google: aplikasi OAuth Anda, akun, tindakan, tag browser, biaya, dan riwayat pengiriman. Pada alur, cukup pilih sumber tersebut. Alur tidak memiliki koneksi Google atau ID tindakan terpisah.
4. Server memakai token OAuth aplikasi Anda yang valid untuk memanggil Data Manager API bagi akun dan tindakan Anda.
5. Hasil dicatat dalam riwayat pengiriman. Google memproses dan mengatribusikan peristiwa secara terpisah.

Permintaan berisi pengenal klik Google, waktu peristiwa, nilai konversi dalam USD, dan pengenal peristiwa untuk perlindungan duplikasi. Nilai berasal dari payout konversi yang tercatat di ArtisanClo, bukan pengeluaran iklan. Pengiriman server tidak menunggu impor pengeluaran pagi hari.

Setiap pasangan konversi/status dikirim sekali. Perubahan lead menjadi penjualan dapat mengirim dua tindakan terpisah. Hold, rejected, dan trash tidak dikirim melalui pemetaan ini. Menolak lead yang sudah dikirim tidak otomatis menarik kembali konversinya di Google. Mengirim ulang nominal yang berubah pada status yang sama bukan penyesuaian nilai Google Ads.

11. Peristiwa browser dengan ID dan label Google

Dengan Google Ads API aktif dan akun dipilih, klik «Atur tag dari Google» pada bagian browser sumber. Tombol membuat atau memakai AC — Offer visit dan AC — Form lead serta mengambil ID/labelnya. Tindakan baru menjadi sasaran sekunder. Pasang tag JavaScript ArtisanClo di halaman; tombol tidak memasangnya. Tanpa API, gunakan kolom manual berikut.

Pengiriman browser tidak bergantung pada OAuth. Fitur ini mengamati kunjungan penawaran dan pengiriman formulir saat pengunjung masih di halaman; tidak dapat mengirim postback terlambat setelah pengunjung pergi.

1. Pasang tag JavaScript ArtisanClo di halaman dan aktifkan pelacakan alur.
2. Buka konversi situs yang sesuai di Google Ads → penyiapan tag → «Use Google Tag Manager». Salin Conversion ID dan Conversion label. Tab ini menampilkan nilainya; memakai ArtisanClo sendiri tidak mengharuskan pemasangan GTM.
3. Aktifkan konversi browser pada sumber. Isi GTAG ID dan GTAG Click Label untuk kunjungan penawaran, serta GTAG Conversion ID dan GTAG Conversion Label (Lead) untuk formulir.
4. Atau buka «Tempel cuplikan peristiwa» dan tempel cuplikan untuk satu tujuan. ArtisanClo mengekstrak ID/label; JavaScript yang ditempel tidak dijalankan.
5. Periksa AW-ID/label yang ditampilkan lalu simpan. Saat aktif, setidaknya satu peristiwa harus lengkap. Untuk menonaktifkan semuanya, matikan opsi browser.

Misalnya, gtag('event', 'conversion', {'send_to': 'AW-12345678901/ExampleLeadLabel'}); menjadi tujuan tersimpan AW-12345678901/ExampleLeadLabel. Jangan mencampurkan dua tujuan berbeda dalam satu kolom. ID tanpa label belum lengkap.

Kode memuat tag Google secara otomatis dan memakai kembali fungsi gtag yang sudah ada. Di prelander, peristiwa penawaran terjadi saat mengikuti tautan penawaran, bukan sekadar membuka prelander. Sebelum navigasi, kode menunggu callback peristiwa paling lama 800 ms, lalu tetap melanjutkan meskipun Google diblokir.

Peristiwa formulir biasa aktif setelah validasi kolom bawaan browser jika submit tidak dibatalkan. Ini tidak membuktikan bahwa server Anda menerima formulir. Untuk formulir AJAX, kirim peristiwa berikut setelah respons berhasil dari penangan formulir Anda:

document.dispatchEvent(new Event('artisanclo:lead'));

Jangan mengirimnya hanya saat tombol diklik, validasi gagal, atau sebelum respons server diterima. Peristiwa ini memberi tahu tag Google dan tidak membuat konversi ArtisanClo dengan sendirinya. Konfigurasikan konversi masuk secara terpisah.

Tag halaman induk tidak bisa mengamati formulir di iframe pihak ketiga atau tindakan lanjutan pada situs eksternal tanpa tag Anda. Pemblokir iklan, CSP, dan pengaturan persetujuan dapat memengaruhi pengiriman. Integrasi tidak mengesampingkan konfigurasi persetujuan situs Anda.

12. Hindari duplikasi dan pilih sasaran konversi

Hindari mengirim tindakan browser yang sama dari GTM dan ArtisanClo dengan ID/label yang sama. ArtisanClo membatasi pengulangan peristiwa sejenis untuk satu klik dan menyediakan pengenal transaksi kepada Google.

Peristiwa server dan browser memiliki mekanisme terpisah tanpa jaminan deduplikasi otomatis bersama. Pengiriman formulir browser dan postback terkonfirmasi dapat mewakili sasaran berbeda. Tinjau tindakan yang menjadi sasaran utama dan dipakai untuk optimasi kampanye Google Ads. Menolak postback tidak membatalkan peristiwa browser yang sudah dikirim.

13. Impor pengeluaran

1. Otorisasi aplikasi OAuth Anda untuk Google Ads API dan periksa akses project Cloud ke akun produksi.
2. Pilih Google dalam blok pengeluaran akun iklan pada sumber.
3. Tentukan akun iklan penyedia pengeluaran. Tinjau nomor yang disarankan setelah penyiapan akun otomatis; akun pengeluaran yang sudah terisi tidak ditimpa otomatis.
4. Simpan sumber. Pengeluaran diimpor sesuai jadwal jika paket Anda mencakup fitur ini.

Setiap pagi, proses impor membaca ulang tiga hari penuh sebelumnya untuk mengambil koreksi. Ini bukan penghitung langsung untuk pengeluaran hari ini. Nilai dibaca dalam mata uang akun iklan dan dikonversi ke USD dengan kurs yang tersedia.

Jika beberapa alur berbagi sumber, pertahankan ID kampanye pada klik, biasanya dengan utm_campaign={campaignid} di template Google Ads. Kampanye bersama dialokasikan berdasarkan porsi klik terkait tiap alur yang mencapai penawaran; jika tidak ada yang mencapai penawaran, semua klik terkait digunakan. Kampanye tanpa klik yang cocok tidak dialokasikan sembarangan: ID-nya muncul dalam error impor.

Jika sumber hanya memiliki satu alur dengan pelacakan, alur tersebut menerima seluruh pengeluaran akun yang diimpor. Jangan menganggap konfigurasi ini sebagai filter satu kampanye dalam akun yang lebih besar. Nilai impor tidak menimpa pengeluaran yang dimasukkan manual. Periksa waktu sinkronisasi terakhir dan error pada pengaturan pengeluaran.

14. Verifikasi pengaturan, pengiriman, dan atribusi secara terpisah

Semua pengaturan Google ada di Sumber → Akun iklan → Google: aplikasi OAuth Anda, akun, tindakan, tag browser, biaya, dan riwayat pengiriman. Pada alur, cukup pilih sumber tersebut. Alur tidak memiliki koneksi Google atau ID tindakan terpisah.

Validasi tanpa pencatatan. Klik «Simpan dan kirim validasi» di samping status server yang terisi. Formulir disimpan dan Google dipanggil dengan validateOnly = true untuk memvalidasi tanpa menjalankan konversi. Tidak ada konversi nyata yang dibuat di ArtisanClo; riwayat menandai percobaan validasi tersebut. Referensi validateOnly Google.

Semua pengaturan Google ada di Sumber → Akun iklan → Google: aplikasi OAuth Anda, akun, tindakan, tag browser, biaya, dan riwayat pengiriman. Pada alur, cukup pilih sumber tersebut. Alur tidak memiliki koneksi Google atau ID tindakan terpisah.

Pemeriksaan rangkaian lengkap. Dalam skenario pengujian yang diizinkan, catat klik iklan, periksa ID klik Google-nya, gunakan ID klik internal pada konversi baru, temukan konversi di ArtisanClo, dan periksa pengiriman Google biasa. Pastikan tujuan dan hasilnya, lalu periksa Google Ads kemudian. Ini pengiriman nyata yang dapat memengaruhi laporan.

Pemeriksaan browser. Gunakan Google Tag Assistant, lakukan tindakan, lalu periksa peristiwa conversion dan tujuan send_to. Formulir gagal tidak boleh mengirim peristiwa sukses Anda. Peristiwa browser tidak memiliki log respons Google di server atau tombol validateOnly.

15. Baca riwayat pengiriman

Sumber menampilkan sepuluh pengiriman terakhir, bukan ekspor riwayat lengkap. Hubungan pengiriman biasa dengan konversinya juga tersedia dalam riwayat konversi/klik. Untuk dukungan, sertakan sumber, alur, waktu, status, kode HTTP, teks error, dan requestId jika tersedia. Jangan kirim Client Secret, token akses, atau token refresh.

16. Pemecahan masalah

17. Hubungkan ulang, putuskan, dan migrasi dari JSON

Menambahkan Google Ads API. Aktifkan di project dan sumber, lalu hubungkan ulang. Menyimpan opsi tidak memperluas otorisasi yang sudah ada.

Mengubah Client ID atau Secret. Menyimpan kredensial aplikasi yang berubah menghapus otorisasi OAuth saat ini. Hubungkan lagi dan pertimbangkan semua alur yang berbagi sumber sebelum mengubahnya.

Menghentikan pengiriman postback saja. Matikan pengiriman server lalu simpan. Peristiwa browser, file terjadwal, dan pengeluaran memiliki pengaturan terpisah. Nonaktifkan setiap fitur yang digunakan untuk menghentikan seluruh aktivitas sumber dengan Google.

Memutuskan akses. Menghapus otorisasi OAuth yang tersimpan pada sumber ini. Tidak menghapus aplikasi atau tindakan di Google Ads. Tidak menjalankan pencabutan global Google yang dapat memengaruhi sumber lain dengan aplikasi pelanggan yang sama. Jika Anda sendiri mencabut izin di Google, tinjau semua sumber tersebut.

Kunci JSON akun layanan pelanggan yang sudah ada. Sumber yang terhubung sebelumnya tetap didukung. Untuk migrasi, siapkan dan otorisasi aplikasi OAuth Anda pada sumber. Memasukkan OAuth Client ID memilih jalur OAuth; jangan mengharapkan fallback otomatis ke kunci JSON lama selama login belum selesai. Otorisasi berhasil menghapus kunci konversi server sebelumnya. Periksa juga pengeluaran, izin Ads API, dan setiap tindakan.

File Google Ads terjadwal. Opsi terpisah ini mencakup hingga 90 hari peristiwa yang memenuhi syarat dengan gclid dan memakai nama konversi dari pengaturan feed. Nama tersebut bukan ctId atau label browser. Pilih satu jalur pengiriman utama untuk peristiwa yang sama agar tidak terjadi impor duplikat yang tidak disengaja.

18. Pertanyaan umum

Bisakah tanpa Google Cloud?

Bisa untuk pengiriman browser dengan ID/label atau file terjadwal. Pengiriman server otomatis melalui OAuth memerlukan project Cloud Anda sendiri.

Bisakah tanpa JSON?

Bisa. Koneksi baru memakai Client ID, Client Secret, dan otorisasi Google, bukan kunci akun layanan yang diunduh.

Apakah semuanya otomatis?

Dengan Google Ads API aktif dan akun dipilih, klik «Atur tag dari Google» pada bagian browser sumber. Tombol membuat atau memakai AC — Offer visit dan AC — Form lead serta mengambil ID/labelnya. Tindakan baru menjadi sasaran sekunder. Pasang tag JavaScript ArtisanClo di halaman; tombol tidak memasangnya. Tanpa API, gunakan kolom manual berikut.

Apakah perlu MCC ArtisanClo?

Tidak. Dengan akses langsung, MCC sendiri pun tidak diperlukan. Gunakan ID pengelola hanya jika jalur akses Anda memerlukannya.

Bisakah satu alur memakai akun lain?

Untuk akun Google atau tindakan berbeda, buat sumber lain dan pilih di alur. Perubahan sumber berlaku bagi semua alur yang memilihnya. Tag browser dan postback menggunakan sumber terpilih. Jika sumber berubah sebelum konversi antrean dikirim, pengiriman lama berhenti dengan google_connection_changed.

Apakah lead terkirim setelah pengunjung pergi?

Ya, jika postback yang cocok masuk dan syarat pengiriman server terpenuhi. Konfigurasi hanya browser tidak dapat melakukannya.

Mengapa peristiwa browser tidak ada dalam konversi ArtisanClo?

Tag Google tidak menggantikan penerima konversi. Atur postback/penangan situs dan ID klik internal.

Apakah validasi berhasil membuktikan atribusi?

Tidak. Konfirmasikan seluruh rangkaian dengan klik iklan asli yang diizinkan dan periksa hasil akhirnya di Google Ads.

Terkait: sumber, pelacakan alur, konversi masuk, riwayat konversi, laporan dan pengeluaran. Persyaratan API eksternal diperiksa berdasarkan dokumentasi Google pada 19 Oktober 2026; lihat antarmuka Google terbaru untuk pengaturan project dan nama layar.