Daftar sekarang untuk mengikuti workshop Performa Maksimal dan Google Ads API yang akan diselenggarakan pada 17 Juli.

Halaman ini diterjemahkan oleh Cloud Translation API.

Sasaran Siklus Proses

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 tetapkan resource_name-nya dan jangan tetapkan update_mask operasi.
Untuk memperbarui sasaran siklus proses menggunakan v15, isi create dengan sasaran, tetapkan resource_name sasaran, dan tetapkan update_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 dari CustomerLifecycleGoal.
Mulai v17:
- Kaitkan setiap daftar pengguna dengan satu atau beberapa kategori dengan membuat UserListCustomerType untuk setiap kombinasi daftar pengguna dan kategori.

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