ConversionAction

Tindakan konversi.

Representasi JSON
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
Kolom
resourceName

string

Tidak dapat diubah. Nama resource tindakan konversi. Nama resource tindakan konversi memiliki bentuk:

customers/{customerId}/conversionActions/{conversion_action_id}

status

enum (ConversionActionStatus)

Status tindakan konversi ini untuk akrual peristiwa konversi.

type

enum (ConversionActionType)

Tidak dapat diubah. Jenis tindakan konversi ini.

origin

enum (ConversionOrigin)

Hanya output. Asal konversi tindakan konversi ini.

category

enum (ConversionActionCategory)

Kategori konversi yang dilaporkan untuk tindakan konversi ini.

valueSettings

object (ValueSettings)

Setelan yang terkait dengan nilai untuk peristiwa konversi yang terkait dengan tindakan konversi ini.

countingType

enum (ConversionActionCountingType)

Cara menghitung peristiwa konversi untuk tindakan konversi.

attributionModelSettings

object (AttributionModelSettings)

Setelan yang terkait dengan model atribusi tindakan konversi ini.

tagSnippets[]

object (TagSnippet)

Hanya output. Cuplikan yang digunakan untuk melacak konversi.

mobileAppVendor

enum (MobileAppVendor)

Hanya output. Vendor aplikasi seluler untuk tindakan konversi aplikasi.

firebaseSettings

object (FirebaseSettings)

Hanya output. Setelan Firebase untuk jenis konversi Firebase.

thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

Hanya output. Setelan Analisis Aplikasi Pihak Ketiga untuk jenis konversi pihak ketiga.

googleAnalytics4Settings

object (GoogleAnalytics4Settings)

Hanya output. Setelan Google Analytics 4 untuk jenis konversi Google Analytics 4.

id

string (int64 format)

Hanya output. ID tindakan konversi.

name

string

Nama tindakan konversi.

Kolom ini wajib diisi dan tidak boleh kosong saat membuat tindakan konversi baru.

primaryForGoal

boolean

Jika bit primaryForGoal tindakan konversi bernilai salah, tindakan konversi tidak dapat di-bid untuk semua kampanye, terlepas dari sasaran konversi pelanggan atau sasaran konversi kampanyenya. Namun, sasaran konversi kustom tidak mematuhi primaryForGoal, sehingga jika kampanye memiliki sasaran konversi kustom yang dikonfigurasi dengan primaryForGoal = false conversion action, tindakan konversi tersebut tetap dapat di-bid. Secara default, primaryForGoal akan bernilai benar jika tidak ditetapkan. Di V9, primaryForGoal hanya dapat ditetapkan ke false setelah dibuat melalui operasi 'update' karena tidak dinyatakan sebagai opsional.

ownerCustomer

string

Hanya output. Nama resource pelanggan pemilik tindakan konversi, atau null jika ini adalah tindakan konversi yang ditentukan sistem.

includeInConversionsMetric

boolean

Apakah tindakan konversi ini harus disertakan dalam metrik "konversi".

clickThroughLookbackWindowDays

string (int64 format)

Jumlah maksimum hari yang mungkin berlalu antara interaksi (misalnya, klik) dan peristiwa konversi.

viewThroughLookbackWindowDays

string (int64 format)

Jumlah hari maksimum yang mungkin berlalu antara tayangan iklan dan konversi tanpa interaksi.

phoneCallDurationSeconds

string (int64 format)

Durasi panggilan telepon dalam detik setelah konversi harus dilaporkan untuk tindakan konversi ini.

Nilainya harus antara 0 dan 10000, inklusif.

appId

string

ID aplikasi untuk tindakan konversi aplikasi.

ConversionActionStatus

Kemungkinan status tindakan konversi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
ENABLED Konversi akan dicatat.
REMOVED Konversi tidak akan dicatat.
HIDDEN Konversi tidak akan dicatat dan tindakan konversi tidak akan muncul di UI.

ConversionActionType

Kemungkinan jenis tindakan konversi.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
AD_CALL Konversi yang terjadi saat pengguna mengklik ekstensi panggilan iklan.
CLICK_TO_CALL Konversi yang terjadi saat pengguna yang menggunakan perangkat seluler mengklik nomor telepon.
GOOGLE_PLAY_DOWNLOAD Konversi yang terjadi saat pengguna mendownload aplikasi seluler dari Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Konversi yang terjadi saat pengguna melakukan pembelian di aplikasi melalui penagihan Android.
UPLOAD_CALLS Konversi panggilan yang dilacak oleh pengiklan dan diupload.
UPLOAD_CLICKS Konversi yang dilacak oleh pengiklan dan diupload dengan klik yang diatribusikan.
WEBPAGE Konversi yang terjadi di halaman web.
WEBSITE_CALL Konversi yang terjadi saat pengguna menelepon nomor telepon yang dibuat secara dinamis dari situs pengiklan.
STORE_SALES_DIRECT_UPLOAD Konversi Penjualan Toko berdasarkan upload data penjual pihak pertama atau ketiga. Hanya pelanggan dalam daftar yang diizinkan yang dapat menggunakan jenis upload langsung penjualan toko.
STORE_SALES Konversi Penjualan Toko berdasarkan upload data penjual pihak pertama atau pihak ketiga dan/atau dari pembelian di toko menggunakan kartu dari jaringan pembayaran. Hanya pelanggan dalam daftar yang diizinkan yang dapat menggunakan jenis penjualan toko. Hanya baca.
FIREBASE_ANDROID_FIRST_OPEN Konversi pertama aplikasi Android yang dibuka yang dilacak melalui Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Konversi pembelian dalam aplikasi Android yang dilacak melalui Firebase.
FIREBASE_ANDROID_CUSTOM Konversi kustom aplikasi Android yang dilacak melalui Firebase.
FIREBASE_IOS_FIRST_OPEN Konversi saat pertama kali dibuka aplikasi iOS yang dilacak melalui Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Konversi pembelian dalam aplikasi iOS yang dilacak melalui Firebase.
FIREBASE_IOS_CUSTOM Konversi kustom aplikasi iOS yang dilacak melalui Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Konversi saat pertama kali aplikasi Android dibuka yang dilacak melalui Analisis Aplikasi Pihak Ketiga.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Konversi pembelian dalam aplikasi Android yang dilacak melalui Analisis Aplikasi Pihak Ketiga.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Konversi kustom aplikasi Android yang dilacak melalui Analisis Aplikasi Pihak Ketiga.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Konversi saat pertama kali aplikasi iOS dibuka yang dilacak melalui Analisis Aplikasi Pihak Ketiga.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Konversi pembelian dalam aplikasi iOS yang dilacak melalui Analisis Aplikasi Pihak Ketiga.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Konversi kustom aplikasi iOS yang dilacak melalui Analisis Aplikasi Pihak Ketiga.
ANDROID_APP_PRE_REGISTRATION Konversi yang terjadi saat pengguna melakukan prapendaftaran untuk aplikasi seluler dari Google Play Store. Hanya baca.
ANDROID_INSTALLS_ALL_OTHER_APPS Konversi yang melacak semua download Google Play yang tidak dilacak oleh jenis khusus aplikasi. Hanya baca.
FLOODLIGHT_ACTION Aktivitas Floodlight yang menghitung berapa kali pengguna mengunjungi halaman tertentu setelah melihat atau mengklik salah satu iklan pengiklan. Hanya baca.
FLOODLIGHT_TRANSACTION Aktivitas Floodlight yang melacak jumlah penjualan yang dilakukan atau jumlah item yang dibeli. Juga dapat menangkap nilai total dari setiap penjualan. Hanya baca.
GOOGLE_HOSTED Konversi yang melacak tindakan lokal dari produk dan layanan Google setelah berinteraksi dengan iklan. Hanya baca.
LEAD_FORM_SUBMIT Konversi dilaporkan saat pengguna mengirim formulir prospek. Hanya baca.
SALESFORCE Konversi yang berasal dari Salesforce. Hanya baca.
SEARCH_ADS_360 Konversi yang diimpor dari data Floodlight Search Ads 360. Hanya baca.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Konversi panggilan yang terjadi pada Iklan kampanye Pintar tanpa penyiapan pelacakan panggilan, menggunakan kriteria kustom kampanye Pintar. Hanya baca.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Pengguna mengklik elemen panggilan dalam Google Maps. Khusus kampanye Pintar. Hanya baca.
SMART_CAMPAIGN_MAP_DIRECTIONS Pengguna meminta rute ke lokasi bisnis dalam Google Maps. Khusus kampanye Pintar. Hanya baca.
SMART_CAMPAIGN_TRACKED_CALLS Konversi panggilan yang terjadi pada Iklan kampanye Pintar dengan penyiapan pelacakan panggilan, menggunakan kriteria kustom kampanye Pintar. Hanya baca.
STORE_VISITS Konversi yang terjadi saat pengguna mengunjungi toko retail pengiklan. Hanya baca.
WEBPAGE_CODELESS Konversi yang dibuat dari peristiwa situs (seperti pengiriman formulir atau pemuatan halaman), yang tidak menggunakan cuplikan peristiwa yang dikodekan satu per satu. Hanya baca.
UNIVERSAL_ANALYTICS_GOAL Konversi yang berasal dari sasaran Universal Analytics tertaut.
UNIVERSAL_ANALYTICS_TRANSACTION Konversi yang berasal dari transaksi Universal Analytics tertaut.
GOOGLE_ANALYTICS_4_CUSTOM Konversi yang berasal dari konversi peristiwa kustom Google Analytics 4 tertaut.
GOOGLE_ANALYTICS_4_PURCHASE Konversi yang berasal dari konversi pembelian Google Analytics 4 tertaut.

ValueSettings

Setelan yang terkait dengan nilai untuk peristiwa konversi yang terkait dengan tindakan konversi ini.

Representasi JSON
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Kolom
defaultValue

number

Nilai yang akan digunakan jika peristiwa konversi untuk tindakan konversi ini dikirim dengan nilai yang tidak valid, tidak diizinkan, atau tidak ada, atau jika tindakan konversi ini dikonfigurasi untuk selalu menggunakan nilai default.

defaultCurrencyCode

string

Kode mata uang yang akan digunakan jika peristiwa konversi untuk tindakan konversi ini dikirim dengan kode mata uang yang tidak valid atau tidak ada, atau jika tindakan konversi ini dikonfigurasi untuk selalu menggunakan nilai default.

alwaysUseDefaultValue

boolean

Mengontrol apakah nilai default dan kode mata uang default digunakan sebagai pengganti nilai dan kode mata uang yang ditentukan dalam peristiwa konversi untuk tindakan konversi ini.

ConversionActionCountingType

Menunjukkan cara penghitungan konversi untuk tindakan ini. Untuk informasi selengkapnya, lihat https://support.google.com/google-ads/answer/3438531.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
ONE_PER_CLICK Hanya menghitung satu konversi per klik.
MANY_PER_CLICK Menghitung semua konversi per klik.

AttributionModelSettings

Setelan yang terkait dengan model atribusi tindakan konversi ini.

Representasi JSON
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Kolom
attributionModel

enum (AttributionModel)

Jenis model atribusi dari tindakan konversi ini.

dataDrivenModelStatus

enum (DataDrivenModelStatus)

Hanya output. Status model atribusi berbasis data untuk tindakan konversi.

AttributionModel

Model atribusi yang menjelaskan cara mendistribusikan kredit untuk konversi tertentu di banyak interaksi sebelumnya.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
EXTERNAL Menggunakan atribusi eksternal.
GOOGLE_ADS_LAST_CLICK Mengatribusikan semua kredit untuk konversi ke klik terakhirnya.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Mengatribusikan semua kredit untuk konversi ke klik pertamanya menggunakan atribusi Google Penelusuran.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Mengatribusikan kredit untuk konversi secara merata di semua kliknya menggunakan atribusi Google Penelusuran.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Mengatribusikan lebih banyak kredit untuk konversi ke klik yang lebih baru secara eksponensial menggunakan atribusi Google Penelusuran (paruh waktu adalah 1 minggu).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Mengatribusikan 40% kredit untuk konversi ke klik pertama dan terakhirnya. 20% sisanya didistribusikan secara merata di seluruh klik lainnya. Tindakan ini menggunakan atribusi Google Penelusuran.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Model fleksibel yang menggunakan machine learning untuk menentukan distribusi kredit yang sesuai di antara klik menggunakan atribusi Google Penelusuran.

DataDrivenModelStatus

Menghitung status model berbasis data.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
AVAILABLE Model berbasis data tersedia.
STALE Model berbasis data sudah tidak berlaku. Kode belum diperbarui selama setidaknya 7 hari. Data tersebut masih digunakan, tetapi akan habis masa berlakunya jika tidak diupdate selama 30 hari.
EXPIRED Model berbasis data sudah tidak berlaku. Perangkat ini belum diperbarui selama setidaknya 30 hari dan tidak dapat digunakan. Hal ini paling sering terjadi karena belum ada jumlah peristiwa yang diwajibkan dalam periode 30 hari terakhir.
NEVER_GENERATED Model berbasis data belum pernah dibuat. Hal ini paling sering terjadi karena belum pernah ada jumlah peristiwa yang diwajibkan dalam periode 30 hari.

FirebaseSettings

Setelan yang terkait dengan tindakan konversi Firebase.

Representasi JSON
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
Kolom
propertyId

string (int64 format)

Hanya output. ID properti GA konversi.

propertyName

string

Hanya output. Nama properti GA konversi.

eventName

string

Hanya output. Nama peristiwa konversi Firebase.

projectId

string

Hanya output. Project ID Firebase untuk konversi.

ThirdPartyAppAnalyticsSettings

Setelan yang terkait dengan tindakan konversi analisis aplikasi pihak ketiga.

Representasi JSON
{
  "providerName": string,
  "eventName": string
}
Kolom
providerName

string

Hanya output. Nama penyedia analisis aplikasi pihak ketiga.

eventName

string

Hanya output. Nama peristiwa konversi analisis aplikasi pihak ketiga.

GoogleAnalytics4Settings

Setelan yang terkait dengan tindakan konversi Google Analytics 4.

Representasi JSON
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
Kolom
eventName

string

Hanya output. Nama peristiwa GA 4.

propertyName

string

Hanya output. Nama properti GA 4.

propertyId

string (int64 format)

Hanya output. ID properti GA 4.