Gunakan CustomerLifecycleGoal
dan
Referensi CampaignLifecycleGoal
dari
Google Ads API untuk mengonfigurasi sasaran yang terkait dengan siklus proses pelanggan. Mulai v15,
Google Ads API mendukung akuisisi pelanggan
sasaran untuk mencapai
mengakuisisi pelanggan baru melalui Penelusuran dan Performa Maksimal Google Ads
kampanye.
Jika akun Google Ads Anda menggunakan tracking konversi lintas-akun, Anda harus mengonfigurasi sasaran siklus proses pelanggan di kolom konversi Google Ads pelanggan akun Anda, bukan langsung di akun Google Ads. Anda harus tetap menyetel Namun, sasaran siklus proses kampanye tersebut di akun Anda. Hal ini mirip dengan bagaimana Anda mengelola sasaran lainnya saat menggunakan tracking konversi lintas-akun.
Menangani operasi pembuatan dan update (khusus v15)
Di Google Ads API v15, operasi yang didukung di
CustomerLifecycleGoalService
dan
CampaignLifecycleGoalService
sedikit berbeda dari layanan lain di Google Ads API. Alih-alih memiliki input
Operasi create
dan update
, v15
CustomerLifecycleGoalOperation
dan
CampaignLifecycleGoalOperation
hanya memiliki operasi create
, dan Anda menunjukkan intent menggunakan metode
update_mask
sebagai berikut:
Untuk membuat sasaran siklus proses menggunakan v15, isi
create
dengan sasaran tersebut, tetapi jangan setelresource_name
dan jangan setelupdate_mask
dari operasi.Untuk memperbarui sasaran siklus proses menggunakan v15, isi
create
dengan sasaran tersebut, tetapkanresource_name
sasaran, dan tetapkanupdate_mask
untuk mencantumkan yang ingin Anda perbarui.
Mengonfigurasi sasaran siklus proses pelanggan
Pada tingkat pelanggan, konfigurasikan sasaran siklus proses dengan membuat atau memperbarui
CustomerLifecycleGoal
Dapat hadir di
maksimal satu CustomerLifecycleGoal
per akun Google Ads. Tujuan
Kolom customer_acquisition_goal_value_settings.value
menentukan
penyesuaian nilai untuk ditambahkan ke konversi pembelian pertama pelanggan baru. Anda dapat
baca customer_acquisition_goal_value_settings.high_lifetime_value
dari
sasaran, tetapi kolom ini tidak dapat diubah di Google Ads API.
Menyegmentasikan audiens
Mulai Google Ads API v17, Anda harus menggunakan
UserListCustomerType
resource untuk disegmentasikan
audiens untuk sasaran siklus proses pelanggan. Mengonfigurasi audiens secara langsung di
resource CustomerLifecycleGoal
telah
tidak digunakan lagi. Berikut detailnya:
- Sebelum v17:
- Tambahkan daftar pengguna ke kumpulan
existing_user_lists
dariCustomerLifecycleGoal
.
- Tambahkan daftar pengguna ke kumpulan
- Dimulai dengan v17:
- Kaitkan setiap daftar pengguna dengan satu atau beberapa kategori dengan membuat
UserListCustomerType
untuk setiap kombinasi daftar pengguna dan kategori.
- Kaitkan setiap daftar pengguna dengan satu atau beberapa kategori dengan membuat
Di Google Ads API v17 dan yang lebih baru
Gunakan
UserListCustomerTypeService
ke
membuat instance UserListCustomerType
.
Jika Anda sudah mengisi
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
maka akun Anda akan berisi UserListCustomerType
terkait
instance Compute Engine.
UserListCustomerTypeService
hanya mendukung create
dan remove
sehingga jika ingin memperbarui UserListCustomerType
yang ada, Anda
perlu menghapusnya lalu membuat
yang baru dengan pembaruan yang diperlukan.
UserListCustomerType
hanya dapat ditetapkan ke satu daftar pengguna, tetapi
daftar pengguna dapat memiliki beberapa instance UserListCustomerType
terkait
selama tidak ada konflik antara UserListCustomerType
instance Compute Engine. Mencoba menetapkan instance UserListCustomerType
dengan
berikut ini kombinasi
customer_type_category
ke daftar pengguna yang sama akan menghasilkan
Error UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
:
customer_type_category pertama |
customer_type_category kedua |
---|---|
PEMBELI | CONVERTED_LEADS |
PEMBELI | QUALIFIED_LEADS |
PEMBELI | CART_ABANDONERS |
CONVERTED_LEADS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CONVERTED_LEADS |
DISENGAGED_CUSTOMERS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CART_ABANDONERS |
Di Google Ads API v16 dan versi sebelumnya
Tetapkan kolom berikut di
CustomerLifecycleGoal
:
lifecycle_goal_customer_definition_settings.existing_user_lists
menunjukkan daftar pengguna yang berisi pelanggan lama.Tujuan
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
menunjukkan daftar pengguna yang berisi pelanggan dengan nilai umur yang tinggi. Anda dapat membaca kolom ini, tetapi tidak dapat diubah di Google Ads API.
Perilaku resource bersama
Sebelum Google Ads API v16 dihentikan pada Januari 2025, penting untuk diingat bahwa
UserListCustomerType
dan kolom segmentasi audiens di
CustomerLifecycleGoal
adalah sumber daya bersama, artinya membuat sumber daya baru
Instance UserListCustomerType
di v17 dan yang lebih baru akan menghasilkan modifikasi
ke instance CustomerLifecycleGoal
di v16 dan yang lebih lama, dan dengan cara lain
di sekitar Anda.
Berikut cara kolom di kedua resource dipetakan:
Mengubah kolom `CustomerLifecycleGoal` di v16 | Efek samping pada `UserListCustomerType` di v17 |
---|---|
lifecycle_goal_customer_definition_settings.existing_user_lists
|
Membuat atau menghapus instance UserListCustomerType . Tujuan
Kolom user_list berisi resource daftar pengguna terkait
nama.
|
Mengubah `UserListCustomerType` di v17 | Efek samping pada kolom `CustomerLifecycleGoal` di v16 |
---|---|
Buat atau hapus instance UserListCustomerType .
|
Setiap nama resource akan ditambahkan ke, atau dihapus dari,
lifecycle_goal_customer_definition_settings.existing_user_lists
|
Buat atau hapus instance UserListCustomerType , dengan
customer_type_category disetel ke
HIGH_VALUE_CUSTOMERS
|
Setiap nama resource akan ditambahkan ke, atau dihapus dari,
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
|
Mengonfigurasi sasaran siklus proses kampanye
Di tingkat kampanye, konfigurasi sasaran siklus proses dengan membuat atau memperbarui
CampaignLifecycleGoal
Dapat hadir di
paling banyak satu CampaignLifecycleGoal
per kampanye.
Kolom customer_acquisition_goal_settings
di sasaran tingkat kampanye memungkinkan Anda
menetapkan mode pengoptimalan kampanye serta mengganti setelan nilai
dari sasaran pelanggan induk.
optimization_mode
dapat berupa salah satu nilai berikut:
TARGET_ALL_EQUALLY
- Kampanye ini menargetkan pelanggan baru dan lama secara setara. Ini adalah default mode pengoptimalan.
BID_HIGHER_FOR_NEW_CUSTOMERS
- Kampanye ini menargetkan pelanggan baru dan lama, tetapi mengajukan bid lebih tinggi untuk
pelanggan yang diprediksi baru dan tidak termasuk dalam salah satu
existing_user_lists
. TARGET_NEW_CUSTOMERS
- Kampanye hanya menargetkan pelanggan baru.
value_settings
sama dengan
customer_acquisition_goal_value_settings
pada sasaran tingkat pelanggan. Gunakan ini
setelan tingkat kampanye untuk mengganti nilai kampanye tertentu.
Mengambil sasaran siklus proses
Seperti halnya referensi lain di Google Ads API, gunakan search
atau searchStream
metode GoogleAdsService
untuk mengambil
sasaran siklus proses tertentu.
Kueri berikut mengambil detail setiap CustomerLifecycleGoal
dalam sebuah
Akun Google Ads:
SELECT
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.existing_user_lists,
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists,
customer_lifecycle_goal.customer_acquisition_goal_value_settings.value,
customer_lifecycle_goal.customer_acquisition_goal_value_settings.high_lifetime_value
FROM customer_lifecycle_goal
Demikian pula, kueri berikut mengambil detail dari setiap
CampaignLifecycleGoal
:
SELECT
campaign_lifecycle_goal.campaign,
campaign_lifecycle_goal.customer_acquisition_goal_settings.optimization_mode,
campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.value,
campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.high_lifetime_value
FROM campaign_lifecycle_goal