Gunakan resource Goal dan CampaignGoalConfig Google Ads API untuk mengonfigurasi sasaran terkait siklus proses pelanggan. Google Ads API mendukung sasaran akuisisi pelanggan dan sasaran retensi untuk mengelola penyesuaian nilai siklus proses pelanggan secara efisien melalui kampanye Google Ads Anda.
Jika akun Google Ads Anda menggunakan tracking konversi lintas-akun, Anda harus mengonfigurasi sasaran siklus proses tingkat pelanggan di akun konversi Google Ads, bukan langsung di akun Google Ads Anda. Namun, Anda tetap harus menetapkan konfigurasi tingkat kampanye di akun Anda. Hal ini mirip dengan cara Anda mengelola sasaran lain saat menggunakan tracking konversi lintas-akun.
Jenis sasaran siklus proses pelanggan
Sasaran siklus proses pelanggan dikonfigurasi di tingkat akun menggunakan resource Goal. Sasaran mewakili tujuan siklus proses tertentu dan ditentukan oleh goal_type.
Jenis sasaran siklus proses yang didukung adalah:
NEW_CUSTOMER_ACQUISITION- Untuk mengakuisisi pelanggan baru secara efisien dengan menetapkan penyesuaian nilai ke konversi mereka.
CUSTOMER_RETENTION- Untuk menjangkau kembali pelanggan lama, pelanggan bernilai tinggi, dan pelanggan yang tidak aktif.
LOYALTY_RETENTION- Untuk mendorong retensi dan engagement secara khusus di antara anggota program loyalitas.
Mengonfigurasi sasaran siklus proses pelanggan
Di tingkat pelanggan, konfigurasi sasaran siklus proses dengan membuat Goal. Maksimal hanya ada satu Goal per jenis sasaran (NEW_CUSTOMER_ACQUISITION, CUSTOMER_RETENTION, atau LOYALTY_RETENTION) di akun Google Ads.
Setelan sasaran Akuisisi Pelanggan Baru
Untuk menyiapkan Akuisisi Pelanggan Baru (NCA), tetapkan goal_type ke NEW_CUSTOMER_ACQUISITION dan konfigurasi setelan di kolom new_customer_acquisition_goal_settings menggunakan GoalService.
Setelan ini menggunakan CustomerLifecycleOptimizationValueSettings untuk menentukan penyesuaian nilai konversi bagi pelanggan yang diperoleh:
value_adjustment(oneof):additional_value(double): Nilai konversi inkremental yang akan ditambahkan ke konversi pembelian pertama pelanggan baru.value_multiplier(double): Pengganda yang akan diterapkan ke nilai konversi untuk pembelian pertama pelanggan baru (belum didukung).
high_lifetime_value_adjustment(oneof):additional_high_lifetime_value(double): Nilai konversi inkremental untuk pelanggan baru yang diidentifikasi sebagai pelanggan bernilai umur tinggi.high_lifetime_value_multiplier(double): Pengganda nilai konversi yang akan diterapkan untuk pelanggan baru bernilai umur tinggi (tidak didukung).
Nilai umur tinggi harus lebih besar dari nilai, jika ditetapkan.
def create_nca_goal(client: GoogleAdsClient, customer_id: str) -> None:
"""Sends an API request to add a new New Customer Acquisition Goal.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
"""
goal_operation: GoalOperation = client.get_type("GoalOperation")
goal = goal_operation.create
goal.goal_type = client.enums.GoalTypeEnum.NEW_CUSTOMER_ACQUISITION
# Configure the value adjustments.
goal.new_customer_acquisition_goal_settings.value_settings.additional_value = 50.0
goal.new_customer_acquisition_goal_settings.value_settings.additional_high_lifetime_value = 100.0
goal_service = client.get_service("GoalService")
goal_service.mutate_goals(
customer_id=customer_id, operations=[goal_operation]
)
Setelan sasaran Retensi Pelanggan
Untuk menyiapkan retensi pelanggan, tetapkan goal_type ke CUSTOMER_RETENTION dan konfigurasi setelan di kolom retention_goal_settings.
Sebelum membuat sasaran retensi, Anda harus memenuhi prasyarat yang dijelaskan di Tentang sasaran retensi. Hal ini mencakup memiliki kampanye Performa Maksimal dan daftar pengguna Customer Match.
def create_retention_goal(client: GoogleAdsClient, customer_id: str) -> None:
"""Sends an API request to add a new Customer Retention Goal.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
"""
goal_operation: GoalOperation = client.get_type("GoalOperation")
goal = goal_operation.create
goal.goal_type = client.enums.GoalTypeEnum.CUSTOMER_RETENTION
goal.retention_goal_settings.value_settings.additional_value = 50.0
goal.retention_goal_settings.value_settings.additional_high_lifetime_value = 100.0
goal_service = client.get_service("GoalService")
goal_service.mutate_goals(
customer_id=customer_id, operations=[goal_operation]
)
Tindakan ini akan membuat sasaran retensi baru di tingkat akun untuk akun klien yang ditentukan, yang akan diterapkan ke semua kampanyenya. Secara default, sasaran ini akan menargetkan semua pengguna dalam daftar pengguna Customer Match Anda.
Setelan sasaran Retensi Loyalitas
Untuk menyiapkan sasaran retensi loyalitas bagi anggota program loyalitas, tetapkan goal_type ke LOYALTY_RETENTION dan konfigurasi setelan di kolom loyalty_retention_goal_settings (LoyaltyRetentionGoal).
Untuk sasaran Retensi Loyalitas, hanya setelan value_multiplier yang didukung di value_settings menggunakan CustomerLifecycleOptimizationValueSettings:
def create_loyalty_retention_goal(client: GoogleAdsClient, customer_id: str) -> None:
"""Sends an API request to add a new Loyalty Retention Goal.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
"""
goal_operation: GoalOperation = client.get_type("GoalOperation")
goal = goal_operation.create
goal.goal_type = client.enums.GoalTypeEnum.LOYALTY_RETENTION
goal.loyalty_retention_goal_settings.value_settings.value_multiplier = 1.5
goal_service = client.get_service("GoalService")
goal_service.mutate_goals(
customer_id=customer_id, operations=[goal_operation]
)
Menentukan segmen audiens
Anda harus menggunakan resource UserListCustomerType untuk menentukan segmen audiens bagi sasaran siklus proses pelanggan (termasuk sasaran Akuisisi Pelanggan Baru, Retensi Pelanggan, dan Retensi Loyalitas). Anda harus mengaitkan setiap daftar pengguna dengan satu atau beberapa kategori dengan membuat UserListCustomerType untuk setiap kombinasi daftar pengguna dan kategori.
Gunakan UserListCustomerTypeService untuk membuat instance UserListCustomerType.
UserListCustomerTypeService hanya mendukung operasi create dan remove, jadi jika ingin memperbarui UserListCustomerType yang ada, Anda harus 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 instance UserListCustomerType. Mencoba menetapkan instance UserListCustomerType dengan kombinasi customer_type_category berikut 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 |
| LOYALTY_TIER_X_MEMBERS | LOYALTY_TIER_Y_MEMBERS |
Mengonfigurasi konfigurasi sasaran siklus proses kampanye
Di tingkat kampanye, Anda dapat mengonfigurasi penggantian atau opsi penargetan khusus kampanye menggunakan CampaignGoalConfig. Setelah memiliki sasaran tingkat akun, gunakan resource_name untuk membuat CampaignGoalConfig menggunakan metode mutate_campaign_goal_configs di CampaignGoalConfigService.
Setelan Akuisisi Pelanggan Baru kampanye
Untuk mengganti setelan atau mengonfigurasi penargetan untuk NCA di tingkat kampanye, konfigurasi kolom campaign_new_customer_acquisition_settings dengan jenis CampaignNewCustomerAcquisitionGoalSettings:
value_settings_override(Jenis:CustomerLifecycleOptimizationValueSettings): Penyesuaian nilai kustom untuk mengganti setelan tingkat akun.target_option(Jenis:CustomerLifecycleOptimizationMode): Mengontrol mode pengoptimalan siklus proses pelanggan. Opsi yang tersedia adalah:TARGET_ALL: Kampanye menargetkan pelanggan baru dan lama, tetapi mengajukan bid yang lebih tinggi untuk pelanggan baru menggunakan penyesuaian nilai yang dikonfigurasi.TARGET_SPECIFIC: Kampanye hanya menargetkan pelanggan baru. Penyesuaian bidding tidak berlaku untuk opsi ini.
def create_campaign_nca_config(
client: GoogleAdsClient,
customer_id: str,
goal_resource_name: str,
campaign_resource_name: str,
) -> None:
"""Sends an API request to add a new CampaignGoalConfig for NCA.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
goal_resource_name: the resource name of an existing NCA Goal.
campaign_resource_name: the resource name of an existing Campaign.
"""
operation: CampaignGoalConfigOperation = client.get_type("CampaignGoalConfigOperation")
goal_config = operation.create
goal_config.campaign = campaign_resource_name
goal_config.goal = goal_resource_name
# Set the target option to target both new and existing customers.
goal_config.campaign_new_customer_acquisition_settings.target_option = (
client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_ALL
)
# Optionally override value settings.
goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_value = 60.0
campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
campaign_goal_config_service.mutate_campaign_goal_configs(
customer_id=customer_id, operations=[operation]
)
Setelan retensi pelanggan kampanye
Untuk mengganti setelan atau mengonfigurasi penargetan untuk sasaran retensi di tingkat kampanye, konfigurasi kolom campaign_retention_settings dengan jenis CampaignRetentionGoalSettings:
value_settings_override(Jenis:CustomerLifecycleOptimizationValueSettings): Penyesuaian nilai kustom untuk mengganti setelan tingkat akun.target_option(Jenis:CustomerLifecycleOptimizationMode): Mengontrol mode pengoptimalan. Nilai defaultnya adalahTARGET_ALL. Agar dapat menetapkannya keTARGET_SPECIFIC, akun Anda harus berada di daftar yang diizinkan yang sesuai.
def create_campaign_retention_config(
client: GoogleAdsClient,
customer_id: str,
goal_resource_name: str,
campaign_resource_name: str
) -> None:
"""Sends an API request to add a new CampaignGoalConfig for Retention.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
goal_resource_name: the resource name of an existing Retention Goal.
campaign_resource_name: the resource name of an existing Campaign.
"""
operation: CampaignGoalConfigOperation = client.get_type("CampaignGoalConfigOperation")
goal_config = operation.create
goal_config.campaign = campaign_resource_name
goal_config.goal = goal_resource_name
# goal_config.campaign_retention_settings.target_option = (
# client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_SPECIFIC
# )
campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
campaign_goal_config_service.mutate_campaign_goal_configs(
customer_id=customer_id, operations=[operation]
)
campaign_retention_settings.target_option akan ditetapkan secara default ke TARGET_ALL jika tidak ditetapkan. Opsi untuk menetapkan ke TARGET_SPECIFIC hanya tersedia bagi pengguna yang berada di daftar yang diizinkan yang sesuai.
Setelan retensi loyalitas kampanye
Untuk mengganti setelan atau mengonfigurasi perilaku khusus anggota loyalitas di tingkat kampanye untuk sasaran LOYALTY_RETENTION, konfigurasi kolom campaign_loyalty_retention_settings dengan jenis CampaignLoyaltyRetentionGoalSettings di CampaignGoalConfig:
value_settings_override(Jenis:CustomerLifecycleOptimizationValueSettings): Penyesuaian nilai kustom untuk mengganti setelan nilai retensi loyalitas tingkat akun.enable_bid_adjustments_for_loyalty_members(Jenis:bool): Apakah akan mengaktifkan penyesuaian bid untuk anggota program loyalitas dalam kampanye ini.show_targeted_loyalty_member_benefits_in_pla(Jenis:bool): Apakah akan menampilkan manfaat anggota loyalitas yang ditargetkan dalam format Iklan Listingan Produk (PLA) di negara yang memenuhi syarat.
def create_campaign_loyalty_retention_config(
client: GoogleAdsClient,
customer_id: str,
goal_resource_name: str,
campaign_resource_name: str,
) -> None:
"""Sends an API request to add a new CampaignGoalConfig for Loyalty Retention.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
goal_resource_name: the resource name of an existing Loyalty Retention Goal.
campaign_resource_name: the resource name of an existing Campaign.
"""
operation: CampaignGoalConfigOperation = client.get_type("CampaignGoalConfigOperation")
goal_config = operation.create
goal_config.campaign = campaign_resource_name
goal_config.goal = goal_resource_name
# Enable bid adjustments and targeted loyalty benefits in PLAs.
goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members = True
goal_config.campaign_loyalty_retention_settings.show_targeted_loyalty_member_benefits_in_pla = True
campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
campaign_goal_config_service.mutate_campaign_goal_configs(
customer_id=customer_id, operations=[operation]
)
Validasi dan Error
Saat mengonfigurasi sasaran siklus proses pelanggan, batasan dan error berikut mungkin terjadi:
Error validasi sasaran
- Konfigurasi sasaran duplikat
- Membuat sasaran siklus proses duplikat saat sasaran sudah ada akan menghasilkan error
GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS(untuk NCA),GoalError.RETENTION_GOAL_ALREADY_EXISTS(untuk sasaran retensi), atauGoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS(untuk sasaran retensi loyalitas). - Setelan nilai tidak valid
- Saat mengonfigurasi setelan nilai sasaran siklus proses, jika nilai umur tinggi ada, nilai standar harus ada (
GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT). Selain itu, nilai umur tinggi harus lebih besar dari nilai, jika ditetapkan (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).
Error validasi konfigurasi sasaran kampanye
- Konflik penggantian nilai target tertentu
- Untuk sasaran Akuisisi Pelanggan Baru, jika
target_optionditetapkan keTARGET_SPECIFIC(untuk menargetkan pelanggan baru saja), penggantian nilai tingkat kampanye tidak boleh dikonfigurasi (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). Penyesuaian bidding tidak berlaku saat menargetkan hanya pelanggan baru. - Dukungan jenis kampanye nilai umur tinggi
- Penggantian nilai umur tinggi hanya boleh ditetapkan untuk jenis kampanye yang didukung (
CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE). - Sasaran yang tidak kompatibel
- Error akan ditampilkan jika kampanye mencoba menerapkan sasaran Pengoptimalan Siklus Proses Pelanggan yang tidak kompatibel secara bersamaan (
CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS). Tabel di bawah menguraikan kombinasi sasaran yang saling eksklusif yang memicu error ini:
| Jenis / Mode Sasaran Siklus Proses Pelanggan | Sasaran / Mode yang Tidak Kompatibel |
|---|---|
Retensi Pelanggan ("Hanya ajukan bid untuk pelanggan yang tidak aktif" / TARGET_SPECIFIC) |
Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru" / TARGET_SPECIFIC, "Ajukan bid yang lebih tinggi untuk pelanggan baru" / TARGET_ALL), Prospecting |
Retensi Pelanggan ("Ajukan bid yang lebih tinggi untuk pelanggan yang tidak aktif" / TARGET_ALL) |
Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru" / TARGET_SPECIFIC), Prospecting |
| Retensi Loyalitas (Pengganda Nilai) | Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru" / TARGET_SPECIFIC), Retensi Pelanggan ("Hanya ajukan bid untuk pelanggan yang tidak aktif" / TARGET_SPECIFIC), Prospecting, Laba Kotor |
| Retensi Loyalitas (Manfaat di PLA) | Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru" / TARGET_SPECIFIC), Prospecting, Laba Kotor |
| Prospecting | Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru" / TARGET_SPECIFIC, "Ajukan bid yang lebih tinggi untuk pelanggan baru" / TARGET_ALL) |
Mengambil sasaran siklus proses
Seperti resource lain di Google Ads API, gunakan metode search atau searchStream dari GoogleAdsService untuk mengambil sasaran siklus proses dan konfigurasi.
Kueri berikut mengambil detail setiap Goal yang dikonfigurasi di akun Google Ads API:
SELECT
goal.goal_id,
goal.goal_type,
goal.owner_customer,
goal.new_customer_acquisition_goal_settings.value_settings.additional_value,
goal.new_customer_acquisition_goal_settings.value_settings.additional_high_lifetime_value,
goal.retention_goal_settings.value_settings.additional_value,
goal.retention_goal_settings.value_settings.additional_high_lifetime_value,
goal.loyalty_retention_goal_settings.value_settings.value_multiplier
FROM goal
Demikian pula, kueri berikut mengambil detail setiap CampaignGoalConfig:
SELECT
campaign_goal_config.campaign,
campaign_goal_config.goal,
campaign_goal_config.goal_type,
campaign_goal_config.campaign_new_customer_acquisition_settings.target_option,
campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_value,
campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_high_lifetime_value,
campaign_goal_config.campaign_retention_settings.target_option,
campaign_goal_config.campaign_retention_settings.value_settings_override.additional_value,
campaign_goal_config.campaign_loyalty_retention_settings.value_settings_override.value_multiplier,
campaign_goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members,
campaign_goal_config.campaign_loyalty_retention_settings.show_targeted_loyalty_member_benefits_in_pla
FROM campaign_goal_config