Panduan ini memberikan daftar berbagai jenis tindakan konversi yang dapat Anda buat menggunakan Google Ads API, dan informasi tentang cara tindakan konversi ini dipetakan 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:
Di mana peristiwa konversi terjadi?
- Di dunia offline (misalnya, di kantor, lokasi bisnis, atau melalui telepon): Buka 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 dari
iklan (
AD_CALL) (menggunakanCallAsset).
Konversi Offline:
- Apakah itu panggilan telepon?
- Ya: Gunakan Impor Konversi Panggilan (
UPLOAD_CALLS) untuk melacak hasil panggilan.
- Ya: Gunakan Impor Konversi Panggilan (
- Apakah itu penjualan toko fisik?
- Ya: Gunakan Konversi Penjualan Toko (
STORE_SALES).
- Ya: Gunakan Konversi Penjualan Toko (
- Apakah itu 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_CLICKSatauUploadClickConversiontidak digunakan lagi mulai 15 Juni 2026).
- Ya: Gunakan konversi yang disempurnakan untuk lead menggunakan Data
Manager API.
(Catatan: Mengupload konversi klik menggunakan
- Apakah itu panggilan telepon?
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
WEBPAGEatauWEBPAGE_ONCLICK.
- Ya: Gunakan Konversi Situs dengan cuplikan tag yang ditetapkan
ke
- Apakah Anda ingin melacak panggilan yang diminta oleh nomor telepon yang tercantum di
situs Anda?
- Lacak durasi panggilan sebenarnya?
- Ya: Gunakan Panggilan dari situs (
WEBSITE_CALL) dengan nomor penerusan Google dinamis dan cuplikan peristiwa tag. - Tidak (hanya melacak klik tombol/link di situs seluler)? Gunakan
Klik pada nomor telepon seluler Anda (
CLICK_TO_CALL).
- Ya: Gunakan Panggilan dari situs (
- Lacak durasi panggilan sebenarnya?
- Apakah Anda ingin melacak pemuatan halaman (pembelian, tanda terima) atau klik pengguna?
Konversi Aplikasi Seluler:
- Apakah melacak penginstalan atau pembelian dari Google Play Store sudah cukup?
- Ya: Gunakan Konversi aplikasi (
GOOGLE_PLAY_DOWNLOADatauGOOGLE_PLAY_IN_APP_PURCHASE).
- Ya: Gunakan Konversi aplikasi (
- Apakah Anda melacak tindakan aplikasi menggunakan Google Analytics (GA4) atau analisis aplikasi
pihak ketiga?
- Ya: Gunakan Firebase dan analisis aplikasi pihak ketiga (dengan
mengaktifkan tindakan konversi
FIREBASE_*atauTHIRD_PARTY_*).
- Ya: Gunakan Firebase dan analisis aplikasi pihak ketiga (dengan
mengaktifkan tindakan konversi
- Apakah melacak penginstalan atau pembelian dari Google Play Store sudah cukup?
Konversi offline
Konversi offline membantu Anda melacak peristiwa konversi yang terjadi di dunia offline, seperti di kantor, lokasi bisnis, atau melalui telepon.
Tabel berikut menunjukkan parameter
ConversionActionType API 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 | Menggunakan Data Manager API |
UPLOAD_CALLS |
Melacak konversi dari panggilan telepon | Panduan Mengimpor Konversi Panggilan |
STORE_SALES |
Melacak konversi penjualan toko | Panduan Mengimpor Konversi Penjualan Toko |
Konversi online (situs)
Konversi situs memungkinkan Anda melacak tindakan situs seperti penjualan online, klik link, kunjungan halaman, dan pendaftaran.
Untuk melacak konversi di situs Anda, 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 berdasarkan kolom type di setiap
TagSnippet yang tercantum di kolom tag_snippets dari ConversionAction.
A TagSnippet menyediakan kode pelacakan yang harus
disertakan di situs Anda untuk melacak tindakan konversi Anda.
Konversi Situs dan Klik nomor telepon memerlukan
event_snippet, yang harus
ditempatkan di halaman web yang menunjukkan tindakan konversi seperti halaman konfirmasi
checkout atau pengiriman formulir lead, dan global_site_tag, yang harus diinstal di setiap halaman
situs Anda. Anda dapat mengambil kedua atribut ini dengan the
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 |
Konversi aplikasi
Konversi aplikasi memungkinkan Anda melacak penginstalan aplikasi seluler atau pembelian dalam aplikasi dari Google Play Store.
Tabel berikut menunjukkan parameter ConversionActionType API
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.
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 ConversionActionType API
yang setara untuk digunakan bagi setiap Sumber di antarmuka web Google Ads:
| Jenis Tindakan Konversi | Sumber Google Ads |
|---|---|
AD_CALL |
Panggilan dari iklan yang menggunakan ekstensi panggilan atau iklan khusus panggilan |
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 muncul sebagai konversi
Panggilan dari iklan di antarmuka web Google Ads. Setelah Anda
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 Anda.
Panggilan dilaporkan sebagai konversi jika berlangsung lebih lama dari durasi yang ditentukan. Defaultnya adalah 60 detik.
WEBSITE_CALL
Tindakan konversi A
WEBSITE_CALL muncul sebagai konversi
Panggilan 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. Sebagai gantinya, 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
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 |
Menggunakan Data Manager API |
WEBPAGE |
Konversi yang disempurnakan untuk web
Meningkatkan kualitas 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 ke 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 berdasarkan 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 apa pun selain Nilai |
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 mewakili jumlah nilai konversi halus yang diamati yang ditampilkan oleh Apple dan nilai null yang dimodelkan dari Google. |
segments.sk_ad_network_version |
Versi iOS Store Kit Ad Network API yang digunakan. |
Google Analytics
Konversi dari properti Google Analytics yang ditautkan memiliki salah satu nilai
berikut type:
Konversi properti GA4:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_ANALYTICS_4_PURCHASE
Anda juga dapat mengambil ID properti GA4, nama properti, dan nama peristiwa dari
google_analytics_4_settingskolom.
Anda dapat melakukan perubahan berikut pada konversi properti GA4:
- Mengimpor konversi dari properti GA4 ke akun Google Ads Anda dengan mengubah kolom
statusdariHIDDENmenjadiENABLED. - Mengubah kolom
primary_for_goaldancategoryuntuk menunjukkan pengaruhnya terhadap bidding dan laporan Google Ads. - Memperbarui
nameatauvalue_settings. - Menghapus konversi dari akun Google Ads Anda menggunakan operasi
remove.
Upaya untuk mengubah atribut lain dari konversi GA4 yang diimpor atau atribut apa pun dari 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 analisis aplikasi pihak ketiga atau konversi Firebase, ubah
status ConversionAction dari HIDDEN menjadi ENABLED menggunakan
metode mutate dari ConversionActionService. Memperbarui yang
app_id tidak didukung untuk tindakan konversi ini.
FIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
Penjualan toko: impor ke tindakan konversi dengan pelaporan
Meskipun Anda tidak dapat membuat STORE_SALES atau STORE_SALES_DIRECT_UPLOAD
tindakan konversi menggunakan Google Ads API, API ini mendukung impor transaksi penjualan toko.
STORE_SALESSTORE_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_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_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 lengkap untuk metrik konversi utama seperti
metrics.conversions dan metrics.conversions_value.