Kategori tindakan konversi

Panduan ini memberikan daftar berbagai jenis tindakan konversi yang dapat Anda buat menggunakan Google Ads API, dan informasi tentang cara pemetaannya ke antarmuka web Google Ads.

Memilih jenis tindakan konversi yang tepat

Untuk membantu memilih jenis tindakan konversi dan panduan penyiapan yang tepat untuk integrasi Anda, gunakan jalur keputusan berikut:

1. Di mana peristiwa konversi terjadi?

   • Di dunia offline (misalnya, di kantor, lokasi bisnis, atau melalui telepon): Lanjutkan ke langkah 2.
   • Langsung di situs Anda (misalnya, pembelian situs, pendaftaran, atau pengiriman formulir): Buka langkah 3.
   • Dalam aplikasi seluler: Buka langkah 4.
   • Melalui panggilan telepon yang dilakukan langsung dari iklan Anda: Gunakan Panggilan telepon dari iklan (AD_CALL) (menggunakan CallAsset).

2. Konversi Offline:

   • Apakah ini panggilan telepon?

     • Ya: Penggunaan

       Impor Konversi Panggilan (UPLOAD_CALLS) untuk melacak hasil panggilan.

   • Apakah ini penjualan toko fisik?

     • Ya: Penggunaan

       Konversi Penjualan di Toko (STORE_SALES).

   • Apakah ini penjualan offline atau progres prospek yang dihasilkan dari kunjungan situs?

     • Ya: Gunakan Konversi yang Disempurnakan untuk Lead menggunakan Data Manager API. (Catatan: Mengupload konversi klik menggunakan UPLOAD_CLICKS atau UploadClickConversion tidak digunakan lagi mulai 15 Juni 2026).

3. Konversi Online (Situs):

   • Apakah Anda ingin melacak pemuatan halaman (pembelian, tanda terima) atau klik pengguna?
     • Ya: Gunakan Konversi Situs dengan cuplikan tag yang ditetapkan ke WEBPAGE atau WEBPAGE_ONCLICK.

   • Apakah Anda ingin melacak panggilan yang dipicu oleh nomor telepon yang tercantum di situs Anda? website?

     • Lacak durasi panggilan sebenarnya?

       • Ya: Penggunaan

         Panggilan dari situs (WEBSITE_CALL) dengan cuplikan peristiwa tag dan nomor penerusan Google dinamis.

       • Tidak (hanya melacak klik tombol/link di situs seluler)? Gunakan

         Klik pada nomor telepon seluler Anda (CLICK_TO_CALL).

4. Konversi Aplikasi Seluler:

   • Apakah pelacakan penginstalan atau pembelian dari Google Play Store sudah cukup?
     • Ya: Gunakan Konversi aplikasi (GOOGLE_PLAY_DOWNLOAD atau GOOGLE_PLAY_IN_APP_PURCHASE).

   • Apakah Anda melacak tindakan aplikasi menggunakan Google Analytics (GA4) atau analisis aplikasi pihak ketiga?

     • Ya: Penggunaan

       Firebase dan analisis aplikasi pihak ketiga (dengan mengaktifkan tindakan konversi FIREBASE_* atau THIRD_PARTY_*).

Konversi offline

Peringatan: Mulai 15 Juni 2026, permintaan UploadClickConversion akan gagal jika token developer belum pernah mengirim permintaan untuk mengupload konversi offline atau konversi yang disempurnakan untuk lead. Gunakan Data Manager API sebagai gantinya; lihat Penghentian penggunaan fitur untuk mengetahui detailnya.

Catatan: Token developer telah dihentikan penggunaannya dan digantikan dengan project Google Cloud, tetapi pembatasan akses historis ini tetap berlaku.

Konversi offline membantu Anda melacak peristiwa konversi yang terjadi di dunia offline, seperti di kantor, lokasi bisnis, atau melalui telepon.

Tabel berikut menunjukkan parameter API ConversionActionType yang setara untuk digunakan bagi setiap Sumber di antarmuka web Google Ads dan link ke dokumentasi untuk setiap jenis tindakan konversi tertentu:

Jenis Tindakan Konversi	Sumber Google Ads	Panduan Penyiapan API
UPLOAD_CLICKS	Melacak konversi dari klik dan konversi yang disempurnakan untuk prospek	Gunakan Data Manager API
UPLOAD_CALLS	Lacak konversi dari panggilan telepon	Panduan Mengimpor Konversi Panggilan
STORE_SALES	Melacak penjualan toko konversi	Lihat Penjualan toko: impor ke tindakan konversi dengan pelaporan untuk mengetahui detailnya

Konversi online (situs)

Konversi situs memungkinkan Anda melacak tindakan situs seperti penjualan online, klik link, tayangan halaman, dan pendaftaran.

Untuk melacak konversi di situs, Anda harus membuat ConversionAction dengan ConversionActionType yang ditetapkan ke WEBPAGE, dan menambahkan cuplikan kode yang disebut tag ke halaman konversi di situs Anda.

ConversionAction mencakup beberapa jenis konversi situs, yang dibedakan dalam API oleh kolom type di setiap TagSnippet yang tercantum dalam kolom tag_snippets dari ConversionAction.

TagSnippet memberikan kode pelacakan yang harus disertakan di situs Anda untuk melacak tindakan konversi. Konversi Situs dan Klik nomor telepon memerlukan event_snippet, yang harus ditempatkan di halaman web yang menunjukkan tindakan konversi seperti konfirmasi checkout atau halaman pengiriman formulir prospek, dan global_site_tag, yang harus diinstal di setiap halaman situs Anda. Anda dapat mengambil kedua atribut ini dengan ConversionActionService. Lihat Pusat Bantuan kami untuk mengetahui informasi selengkapnya tentang cara memberi tag pada halaman Anda.

Tabel berikut menunjukkan parameter API yang setara untuk digunakan bagi setiap Sumber di antarmuka web Google Ads:

Jenis Kode Pelacakan	Sumber Google Ads
WEBPAGE	Situs, Situs (Google Analytics (GA4))
WEBPAGE_ONCLICK	Situs, Situs (Google Analytics (GA4))
CLICK_TO_CALL	Klik nomor telepon

Catatan: WEBPAGE dan WEBPAGE_ONCLICK memiliki sumber yang sama dengan Situs. Perbedaannya terletak pada opsi Cuplikan peristiwa di antarmuka web. WEBPAGE sesuai dengan Pemuatan halaman untuk opsi ini, sedangkan WEBPAGE_ONCLICK sesuai dengan Klik. Lihat artikel Pusat Bantuan ini untuk mengetahui informasi selengkapnya.

Konversi aplikasi

Konversi aplikasi memungkinkan Anda melacak penginstalan aplikasi seluler atau pembelian dalam aplikasi dari Google Play Store.

Tabel berikut menunjukkan parameter API ConversionActionType yang setara untuk digunakan bagi setiap Sumber di antarmuka web Google Ads:

Jenis Tindakan Konversi	Sumber Google Ads
GOOGLE_PLAY_DOWNLOAD	Google Play > Penginstalan
GOOGLE_PLAY_IN_APP_PURCHASE	Google Play > Pembelian dalam aplikasi

Untuk melacak tindakan aplikasi seluler lainnya menggunakan properti Google Analytics 4 atau analisis aplikasi pihak ketiga, lihat Jenis Tindakan Konversi Tambahan.

Catatan: Jika Anda juga menentukan kolom category, tetapkan ke DOWNLOAD hanya jika jenis konversinya adalah GOOGLE_PLAY_DOWNLOAD.

Konversi panggilan telepon

Pelacakan konversi panggilan telepon memungkinkan Anda melacak panggilan dari iklan, panggilan ke nomor di situs Anda, dan klik pada nomor di situs seluler.

Tabel berikut menunjukkan parameter API ConversionActionType yang setara untuk digunakan bagi setiap Sumber di antarmuka web Google Ads:

Jenis Tindakan Konversi	Sumber Google Ads
AD_CALL	Panggilan telepon dari iklan yang menggunakan ekstensi panggilan atau iklan khusus panggilan telepon
WEBSITE_CALL	Panggilan ke nomor telepon di situs Anda
CLICK_TO_CALL	Klik pada nomor telepon di situs seluler Anda

AD_CALL

Tindakan konversi AD_CALL akan muncul sebagai konversi Panggilan dari iklan di antarmuka web Google Ads. Setelah membuat tindakan konversi AD_CALL, tentukan nama resource-nya di kolom call_conversion_action saat Anda membuat CallAsset. Aset panggilan memungkinkan Anda menampilkan nomor telepon langsung di iklan.

Panggilan dilaporkan sebagai konversi jika berlangsung lebih lama dari durasi yang ditentukan. Defaultnya adalah 60 detik.

WEBSITE_CALL

Tindakan konversi WEBSITE_CALL muncul sebagai konversi Panggilan telepon dari situs di antarmuka web Google Ads.

Tidak seperti AD_CALL, pelacak ini memerlukan event_snippet dan global_site_tag untuk ditambahkan ke situs Anda guna mengambil nomor penerusan Google dinamis untuk pelacakan panggilan pada nomor yang tercantum di situs Anda. Selain itu, Anda harus menyiapkan aset panggilan dan

menautkannya di tingkat pelanggan, kampanye, atau grup iklan.

CLICK_TO_CALL

Tindakan konversi CLICK_TO_CALL muncul sebagai konversi Klik pada nomor Anda di situs seluler Anda di antarmuka web Google Ads.

Jenis CLICK_TO_CALL berbeda dari jenis AD_CALL karena tidak melacak panggilan telepon yang sebenarnya. Sebaliknya, CLICK_TO_CALL hanya melacak klik pada nomor telepon dari perangkat seluler. Hal ini berguna jika Anda tidak dapat menggunakan nomor penerusan Google untuk melacak panggilan telepon.

Konversi yang disempurnakan

Peringatan: Mulai 15 Juni 2026, permintaan UploadClickConversion akan gagal jika token developer belum pernah mengirim permintaan untuk mengupload konversi offline atau konversi yang disempurnakan untuk lead. Gunakan Data Manager API sebagai gantinya; lihat Penghentian penggunaan fitur untuk mengetahui detailnya.

Catatan: Token developer telah dihentikan penggunaannya dan digantikan dengan project Google Cloud, tetapi pembatasan akses historis ini tetap berlaku.

Konversi yang disempurnakan membantu Anda meningkatkan akurasi pengukuran konversi dengan melengkapi tag konversi yang ada dengan data konversi pihak pertama, seperti alamat email, nama, alamat rumah, dan nomor telepon.

Tabel berikut menunjukkan parameter API yang setara untuk digunakan bagi setiap Jenis Konversi yang Disempurnakan:

Jenis Tindakan Konversi	Jenis Konversi yang Disempurnakan	Panduan Penyiapan API
UPLOAD_CLICKS	Konversi yang disempurnakan untuk lead Meningkatkan kualitas pengukuran transaksi offline yang berasal dari lead atau pengunjung situs	Gunakan Data Manager API
WEBPAGE	Konversi yang disempurnakan untuk web Meningkatkan akurasi pengukuran konversi online	Panduan Penyiapan API

Jenis tindakan konversi tambahan

Google Ads API menyediakan jenis tindakan konversi tambahan dalam laporan, tetapi dapat membatasi atau melarang pembuatan atau modifikasi tindakan tersebut.

Konversi SKAdNetwork

Jika Anda menjalankan kampanye Aplikasi iOS dan telah menerapkan SKAdNetwork, Anda dapat mengakses data SKAdNetwork yang diberikan kepada Google di tingkat Customer dan Campaign menggunakan referensi berikut:

Kolom laporan	Deskripsi
metrics.sk_ad_network_installs	Jumlah penginstalan yang dilaporkan oleh Apple. Metrik ini hanya dapat disegmentasikan berdasarkan kombinasi segments.sk_ad_network_conversion_value dan segmen terkait tanggal.
metrics.sk_ad_network_total_conversions	Jumlah total konversi, termasuk penginstalan dan jenis konversi lainnya yang dilaporkan oleh Apple. Metrik ini hanya dapat disegmentasikan menurut segmen terkait SKAdNetwork dan segmen terkait tanggal.
segments.sk_ad_network_ad_event_type	Jenis peristiwa yang terjadi untuk konversi tertentu.
segments.sk_ad_network_attribution_credit	Cara atribusi dikreditkan untuk konversi tertentu.
segments.sk_ad_network_fine_conversion_value	Nilai konversi yang dilaporkan oleh Apple. Segmen ini tidak dapat diterapkan ke metrik selain metrics.sk_ad_network_installs, metrics.sk_ad_network_total_conversions, dan hanya dapat digabungkan dengan segmen terkait tanggal. Nilai 0 akan ditampilkan jika Apple melaporkan nilai 0 dan tidak ada nilai jika sebaliknya. Periksa keberadaan kolom untuk membedakan kedua kasus tersebut.
segments.sk_ad_network_coarse_conversion_value	Nilai kasar untuk konversi individual.
segments.sk_ad_network_postback_sequence_index	Posisi postback, secara berurutan, untuk konversi tertentu.
segments.sk_ad_network_source_app.sk_ad_network_source_app_id	ID aplikasi tempat iklan yang mendorong penginstalan Jaringan Iklan iOS Store Kit ditampilkan.
segments.sk_ad_network_source_domain	Situs tempat iklan yang mendorong penginstalan Jaringan Iklan iOS Store Kit ditampilkan. Nilai null berarti segmen ini tidak berlaku--misalnya, kampanye non-iOS--atau tidak ada dalam postback yang dikirim oleh Apple.
segments.sk_ad_network_source_type	Jenis sumber tempat iklan yang mendorong penginstalan Jaringan Iklan iOS Store Kit ditampilkan. Nilai null berarti segmen ini tidak berlaku — misalnya, kampanye non-iOS — atau domain sumber maupun aplikasi sumber tidak ada dalam postback yang dikirim oleh Apple.
segments.sk_ad_network_user_type	Jenis pengguna yang menghasilkan konversi tertentu.
segments.sk_ad_network_redistributed_fine_conversion_value	Nilai konversi dalam segmen ini mencakup nilai null yang didistribusikan ulang ke nilai konversi. Segmen ini merepresentasikan jumlah nilai konversi terperinci yang diamati yang ditampilkan oleh Apple dan nilai null sesuai model dari Google.
segments.sk_ad_network_version	Versi iOS Store Kit Ad Network API yang digunakan.

Google Analytics

Konversi dari properti Google Analytics tertaut memiliki salah satu nilai type berikut:

• Konversi properti GA4:

  • GOOGLE_ANALYTICS_4_CUSTOM
  • GOOGLE_ANALYTICS_4_PURCHASE

  Anda juga dapat mengambil ID properti GA4, nama properti, dan nama peristiwa dari kolom google_analytics_4_settings.

Anda dapat melakukan perubahan berikut pada konversi properti GA4:

• Impor konversi dari properti GA4 ke akun Google Ads dengan mengubah kolom status dari HIDDEN menjadi ENABLED.
• Ubah kolom primary_for_goal dan category untuk menunjukkan pengaruhnya terhadap bidding dan laporan Google Ads.
• Perbarui name atau value_settings-nya.
• Hapus konversi dari akun Google Ads Anda menggunakan operasi remove.

Setiap upaya untuk mengubah atribut lain dari konversi GA4 yang diimpor atau atribut konversi Universal Analytics yang diimpor akan menghasilkan error MUTATE_NOT_ALLOWED. Anda hanya dapat melakukan perubahan tersebut menggunakan UI Google Ads.

Firebase dan analisis aplikasi pihak ketiga

Untuk mengimpor konversi analisis aplikasi pihak ketiga atau Firebase, ubah status dari ConversionAction dari HIDDEN menjadi ENABLED menggunakan metode mutate dari ConversionActionService. Memperbarui app_id tidak didukung untuk tindakan konversi ini.

• FIREBASE_ANDROID_FIRST_OPEN
• FIREBASE_ANDROID_IN_APP_PURCHASE
• FIREBASE_ANDROID_CUSTOM
• FIREBASE_IOS_FIRST_OPEN
• FIREBASE_IOS_IN_APP_PURCHASE
• FIREBASE_IOS_CUSTOM
• THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
• THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

Penjualan toko: impor ke tindakan konversi dengan pelaporan

Penting: Upgrade alur kerja penjualan toko Anda ke Data Manager API untuk mendapatkan pengalaman developer yang lebih baik dan akses ke fitur tambahan. Sebaiknya jangan menerapkan alur kerja penjualan di toko baru menggunakan Google Ads API.

Meskipun Anda tidak dapat membuat tindakan konversi STORE_SALES atau STORE_SALES_DIRECT_UPLOAD menggunakan Google Ads API, API ini mendukung pengimporan transaksi penjualan toko.

• STORE_SALES
• STORE_SALES_DIRECT_UPLOAD

Jenis tindakan konversi hanya baca

Jenis tindakan konversi berikut bersifat hanya baca di Google Ads API dan disediakan untuk tujuan pelaporan.

• ANDROID_APP_PRE_REGISTRATION
• ANDROID_INSTALLS_ALL_OTHER_APPS
• FLOODLIGHT_ACTION
• FLOODLIGHT_TRANSACTION
• GOOGLE_HOSTED
• LEAD_FORM_SUBMIT
• SALESFORCE
• SEARCH_ADS_360
• SMART_CAMPAIGN_AD_CLICKS_TO_CALL
• SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
• SMART_CAMPAIGN_MAP_DIRECTIONS
• SMART_CAMPAIGN_TRACKED_CALLS
• STORE_VISITS
• WEBPAGE_CODELESS

Tidak diketahui

Jika akun Google Ads Anda menyertakan jenis tindakan konversi lainnya, Anda mungkin menemukan bahwa kueri dan laporan menampilkan tindakan konversi dengan ConversionAction.type adalah UNKNOWN. API tidak mendukung pengelolaan tindakan konversi ini, tetapi menampilkannya dalam laporan untuk memberikan hasil yang lengkap untuk metrik konversi utama seperti metrics.conversions dan metrics.conversions_value.