Gunakan referensi CustomerLifecycleGoal
dan CampaignLifecycleGoal
di Google Ads API untuk mengonfigurasi sasaran yang terkait dengan siklus proses pelanggan. Mulai v15, Google Ads API mendukung sasaran akuisisi pelanggan untuk mengakuisisi pelanggan baru secara efisien melalui kampanye Penelusuran dan Performa Maksimal Google Ads Anda.
Jika akun Google Ads Anda menggunakan tracking konversi lintas-akun, Anda harus mengonfigurasi sasaran siklus proses pelanggan di akun pelanggan konversi Google Ads, bukan secara langsung di akun Google Ads Anda. Namun, Anda tetap harus menetapkan sasaran siklus proses kampanye di akun Anda. Hal ini mirip dengan cara mengelola sasaran lain 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. Daripada memiliki operasi
create
dan update
terpisah, v15
CustomerLifecycleGoalOperation
dan
CampaignLifecycleGoalOperation
hanya memiliki operasi create
, dan Anda menunjukkan intent menggunakan
update_mask
sebagai berikut:
Untuk membuat sasaran siklus proses menggunakan v15, isi
create
dengan sasaran tersebut, tetapi jangan tetapkanresource_name
-nya dan jangan tetapkanupdate_mask
operasi.Untuk memperbarui sasaran siklus proses menggunakan v15, isi
create
dengan sasaran, tetapkanresource_name
sasaran, dan tetapkanupdate_mask
untuk mencantumkan kolom yang ingin Anda perbarui.
Mengonfigurasi sasaran siklus proses pelanggan
Di tingkat pelanggan, konfigurasi sasaran siklus proses dengan membuat atau memperbarui CustomerLifecycleGoal
. Hanya boleh ada maksimal satu CustomerLifecycleGoal
per akun Google Ads. Kolom
customer_acquisition_goal_value_settings.value
menentukan penyesuaian
nilai tambahan yang akan ditambahkan ke konversi pembelian pertama pelanggan baru. Anda dapat membaca customer_acquisition_goal_value_settings.high_lifetime_value
sasaran, tetapi kolom ini tidak dapat diubah di Google Ads API.
Menyegmentasikan audiens
Mulai Google Ads API v17, Anda harus menggunakan resource UserListCustomerType
guna menyegmentasikan audiens untuk sasaran siklus proses pelanggan. Konfigurasi audiens secara langsung di resource CustomerLifecycleGoal
tidak digunakan lagi. Berikut detailnya:
- Sebelum v17:
- Tambahkan daftar pengguna ke kumpulan
existing_user_lists
dariCustomerLifecycleGoal
.
- Tambahkan daftar pengguna ke kumpulan
- Mulai 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
untuk
membuat instance UserListCustomerType
.
Jika Anda sudah mengisi kolom CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
, akun Anda sudah akan berisi instance UserListCustomerType
yang terkait.
UserListCustomerTypeService
hanya mendukung operasi create
dan remove
,
jadi jika ingin mengupdate UserListCustomerType
yang ada, Anda harus
menghapusnya lalu membuat yang baru dengan update yang diperlukan.
UserListCustomerType
hanya dapat ditetapkan ke satu daftar pengguna, tetapi daftar pengguna dapat memiliki beberapa instance UserListCustomerType
terkait selama tidak ada konflik antara instance UserListCustomerType
. Mencoba menetapkan instance UserListCustomerType
dengan kombinasi customer_type_category
berikut ke daftar pengguna yang sama akan menyebabkan 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
akun Anda:
lifecycle_goal_customer_definition_settings.existing_user_lists
menunjukkan daftar pengguna yang berisi pelanggan lama.Kolom
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 resource bersama, yang berarti membuat instance
UserListCustomerType
baru di v17 dan yang lebih baru akan menghasilkan modifikasi
pada instance CustomerLifecycleGoal
di v16 dan yang lebih lama, dan sebaliknya.
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 . Kolom
user_list berisi nama resource daftar pengguna
yang terkait.
|
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 ditetapkan 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
. Hanya boleh ada maksimal 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 mode pengoptimalan default.
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 setelan tingkat kampanye ini untuk mengganti nilai kampanye tertentu.
Mengambil sasaran siklus proses
Seperti resource lain di Google Ads API, gunakan metode search
atau searchStream
dari GoogleAdsService
untuk mengambil
sasaran siklus proses.
Kueri berikut mengambil detail setiap CustomerLifecycleGoal
di 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 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